Extension:ExternalGuidance

**MediaWiki 拡張機能マニュアル**
ExternalGuidance; リリースの状態: 安定
実装	ページの操作
説明	ウィキペディアのコンテンツはさまざまな方法で外部に公開されています。このプロジェクトでは、人々が元の記事に戻って編集できるようにします。
作者	Santhosh Thottingal, Pau Giner, Jan Drewniak and others
最新バージョン	1.0.0 (2018-12-18)
MediaWiki	1.32+
データベースの変更	いいえ
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード ; Git [?]: Git master をダウンロード; リポジトリを参照 (GitHub); コミット履歴; リポジトリの貢献者 (GitHub); コードレビュー; ; README.md
	パラメーター $wgExternalGuidanceKnownServices; $wgExternalGuidanceSiteTemplates; $wgExternalGuidanceEnableContextDetection; $wgExternalGuidanceMTReferrers; $wgExternalGuidanceDomainCodeMapping;
	使用するフック BeforePageDisplay; ResourceLoaderGetConfigVars;
Quarterly downloads	5 (Ranked 144th)
	translatewiki.net で翻訳を利用できる場合は、ExternalGuidance 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

This page is a translated version of the page Extension:ExternalGuidance and the translation is 24% complete.

ウィキペディアのコンテンツはさまざまな方法で外部に公開されています。このプロジェクトでは、人々が元の記事に戻って編集できるようにします。

External third-party tools transform and deliver our content with different purposes such as providing an automatic translated version, provide a voice version, and many others.

This contributes to provide access to knowledge to more people, but it often makes it challenging for the consumers of such content to contribute their knowledge.

External Guidance adjust the content delivered to these external tools to include ways for users to contribute to it.

目標と適用範囲

External Guidance is intended to support the following goals:

Communicate the nature of the content delivered. Users accessing content that originates from a Wikimedia project should be aware of the origin of the content, and how it is different from the original content.

Surface that it is possible to contribute. We want to keep the user expectations that our content is collaborative, and users can still participate even when it is delivered externally.

Guide users on how to contribute. Participation in this context may require some additional steps and context information, and we want to guide users through the process.

The specific ways to support these goals will depend on the specific external use of the content, and specific initiatives will be created to support each type of use. The first initiative to support is the external delivery of machine translated pages.

External guidance for machine translated pages

Workflow diagrams showing External Guidance integration with Google Translate search results. You can check the interactive version.

Several machine translation services provide options to translate web pages. Examples include Google Translate, Bing Translator, Yandex Translate, among others. In many cases the contribution experience is not ideal with options not working when delivered from the translation service servers or generating confusion. For example, it is unclear whether "edit" should lead to edit the original (in a language the user may not know) or the target language version (which may not exist or be different from the translation if it does).

As translated pages get exposed to more users (e.g., being exposed as part of their search results) we want to apply the following adjustments when the content is delivered for the translation of an external service:

Indicate that the content is an automatic translation distinguishing from a regular community-created article, and whether a local version of such content exists or not.
Remove non-working elements to focus on the content the user is accessing.
Surface an entry point for contribution that provides access to a page where the different possibilities for contribution are explained with enough context for the user to decide.

Mechanisms for tagging and measuring the impact of these contributions allow communities to better understand and control the editing activity generated from translated pages.

You can get more information on the details and track the progress of the project on Phabricator.

インストール

ダウンロードして、ファイルをextensions/フォルダー内のExternalGuidanceという名前のディレクトリ内に配置します。
開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExternalGuidance
以下のコードを LocalSettings.php ファイルの末尾に追加します:
```
wfLoadExtension( 'ExternalGuidance' );
```
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

フィードバック

We're looking for feedback on this extension. Security, performance, etc...

Please post feedback to the talk page.

この拡張機能は 1 つ以上のウィキメディアのプロジェクトで使用されています。これはおそらく、この拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。この拡張機能がインストールされている場所を確認するには、ウィキメディアの設定ファイル CommonSettings.php および InitialiseSettings.php 内で、この拡張機能の名前を探してください。特定のウィキにインストールされている拡張機能の完全な一覧は、そのウィキの Special:Version ページにあります。