View source for Extension:LanguageSelector/ja

{{Extension/ja
|name      = LanguageSelector
|status    = beta
|type1     = mywiki
|type2     = tag
|type3     = locale
|hook1     = AddNewAccount
|hook2     = BeforePageDisplay
|hook3     = GetCacheVaryCookies
|hook4     = ParserFirstCallInit
|hook5     = UserGetLanguageObject
|hook6     = BeforeInitialize
|hook7     = SkinTemplateToolboxEnd
|hook8     = SkinTemplateOutputPageBeforeExec
|author    = Daniel Kinzler
|username  = Duesentrieb
|mediawiki = 1.19 以降
|needs-updatephp = No
|download  = {{WikimediaDownload/ja|LanguageSelector}}
|readme    = {{git file|project=mediawiki/extensions/LanguageSelector|branch=27ed03c97df8a11b0465f74a567f45c7479a54ea|file=README|text=README}}
|changelog = 
|description = 匿名の訪問者も含めて、すべてのページ上で言語セレクタを提供します; 訪問者の言語を自動検出します
|parameters = * $wgLanguageSelectorDetectLanguage
* $wgLanguageSelectorLanguages
* $wgLanguageSelectorLocation
|example   = [http://translatewiki.net translatewiki.net]
|license=GPL
}}

The '''LanguageSelector'''拡張機能はログイン利用者だけでなく匿名利用者に対してもインターフェイス言語の検知能力と、それぞれのページ上の利用者言語の選択に対してメニューを提供します。セレクタをwikページとシステムメッセージに埋め込むために、&lt;languageselector&gt;の追加タグも提供します。

言語の検知はHTTPリクエストの一部としてブラウザによって送られたAccept-Languageヘッダーに基づきます。利用者は明示的に望む言語を設定することもできます - これは匿名訪問者は個別のクッキーによって、ログイン利用者に対しては利用者プリファレンスで取り扱われます。

多言語の内容のための包括的なサポートに関して、LanguageSelector[[Extension:Multilang|Multilang]] と[[Extension:Polyglot|Polyglot]]拡張機能を結びつけることができます。

{{Note/ja}} 匿名利用者に対する言語検知とクッキーベースの言語プリファレンスは現在'''does not work with page caching''' (MediaWikiのファイルキャッシュ、squidのようなリバースHTTPプロキシ、など)。'''degrade キャッシュパフォーマンスを悪化させ'''と不要にキャッシュをレンダリングして、閲覧者が'''ランダムな言語でページを見ている'''ことに導くことになる可能性があります。Mediawikiの内部キャッシュ(パーサー、リンク、クエリ、その他)は影響されません。

== インストールする ==

{{ExtensionInstall/ja
|registration=yes
|no-registration-version=1.35
}}

== 構成 ==

(拡張機能のファイルをインクルードした後で)LocalSettings.phpで次の設定を指定できます:

; $wgLanguageSelectorLanguages: 選択のために利用者に示される言語です。NULL(デフォルト)に設定した場合、([[Manual:$wgExtraLanguageNames/ja|$wgExtraLanguageNames]]によって)MediaWikiに知られるすべての言語が考慮されます。Polyglot拡張機能がインストールされ$wgPolyglotLanguagesが設定されている場合、その値はフォールバック(代替)として使われます。ほとんど無意味な100を超えるエントリーリストを選択するよりも$wgLanguageSelectorLanguagesをショートリストに設定することは利用者にとってより便利になることがあります。この変数は配列でなければならないので、次のように宣言できます:

<syntaxhighlight lang="php">
$wgLanguageSelectorLanguages=array("en", "es", "pt");
</syntaxhighlight> 

The codes "en", "es" and "pt" stand for English, Spanish and Portuguese respectively.

; $wgLanguageSelectorShowCode (since [[rev:55711]]): whether to show language codes before the native language name. Default is false;

; $wgLanguageSelectorDetectLanguage: 匿名訪問者に対する言語検モードです。可能な値:
* '''<code>LANGUAGE_SELECTOR_USE_CONTENT_LANG</code>''': 検知モードを使用せず、常にwikiの内容言語を使います(これはMediaWikiの通常の振る舞いです)。
* '''<code>LANGUAGE_SELECTOR_PREFER_CONTENT_LANG</code>''':  クライアントに承認された婆、wikiの内容言語、設定を使います。
* '''<code>LANGUAGE_SELECTOR_PREFER_CLIENT_LANG</code>''': それが$wgLanguageSelectorLanguagesにある場合、クライアントが望む言語を使う。
; $wgLanguageSelectorLocation: 言語セレクタウィジェットを投入する場所。言語セレクタをwikiのスタイルに導入するためにおそらくCSSスタイルを調整しなければならないことに注意して下さい。$wgLanguageSelectorLocationの可能な値:
* '''<code>LANGUAGE_SELECTOR_MANUAL</code>''': 言語セレクタを表示しない。自動検知機能のみを使いたい、もしくは限られたページ上のみでセレクタを使いたい、適切なシステムメッセージを設置することで手動で設置したい場合に便利です。
* '''<code>LANGUAGE_SELECTOR_AT_TOP_OF_TEXT</code>''': ページ内容のトップ上でドロップダウンボックスを設置する。これはデフォルトですが、but it looks quite ugly without extra CSS rules applied.
* '''<code>LANGUAGE_SELECTOR_IN_TOOLBOX</code>''': サイドバーのツールボックスの底にドロップダウンボックスを設置する。これはモノブック外装もしくはMonoBookTemplateToolboxEndフックを明示的にサポートする外装でのみ動作をします。
* '''<code>LANGUAGE_SELECTOR_AS_PORTLET</code>''': インターランゲージリンクが表示される方法と同じように、サイドバーのポートレットとして言語セレクタを設置します。モノブック外装で動作します。いくつかのSkinTemplateベースの外装でも動作するでしょう。
* '''<code>LANGUAGE_SELECTOR_INTO_SITENOTICE</code>''': sitenoticeテキストの終わりにドロップダウンボックスを設置する。追加のCSSを適用しないと不細工です。モノブック外装で動作します。いくつかのSkinTemplateベースの外装でも動作するでしょう。
* '''<code>LANGUAGE_SELECTOR_INTO_TITLE</code>''': ページタイトルの終わりでドロップダウンボックスを設置します。追加のCSSを適用しないと不細工です。モノブック外装で動作します。いくつかのSkinTemplateベースの外装でも動作するでしょう。
* '''<code>LANGUAGE_SELECTOR_INTO_SUBTITLE</code>''': サブタイトルの終わりにドロップダウンのボックスを設置します。追加のCSSを適用しないと不細工です。モノブック外装で動作します。いくつかのSkinTemplateベースの外装でも動作するでしょう。
* '''<code>LANGUAGE_SELECTOR_INTO_CATLINKS</code>''': カテゴリーボックスの終わりにドロップダウンのボックスを設置します。追加のCSSを適用しないと不細工です。モノブック外装で動作します。いくつかのSkinTemplateベースの外装でも動作するでしょう。

Example:
<syntaxhighlight lang="php">
$wgLanguageSelectorDetectLanguage = LANGUAGE_SELECTOR_USE_CONTENT_LANG;
$wgLanguageSelectorLocation = LANGUAGE_SELECTOR_IN_TOOLBOX;
</syntaxhighlight>

{{languages}}