Help:Extension:Translate/Unstructured element translation/ja

This page explains how to make translating of customised wiki interfaces messages a bit more manageable with the Translate extension. It applies to any part of the wiki which you want to automatically provide in the user's interface language. The most typical example is the sidebar, because there can be only one, but the same method can be used for the main page, if you want to have all translations of it under the same title, or even templates.

This method is applicable also to wiki content where full page translation just doesn't fit, like pages heavy in markup or templates, whose markup you don't want to expose to translators. This all revolves around interface messages, or the magic word, that allows you to include interface messages anywhere where you can write wikitext. This magic word allows to automatically substitute the interface message, whether standard, customised or new, in the user interface language.

You can use it to bring the power of the automatic localisation of the wiki's interface to the wiki's content, but doesn't solve the problem for anonymous users, who cannot change the interface language by default. See the note about language selector extension below.

ページの翻訳と比較して、この手法にはいくつかの難点があります:


 * 1) MediaWiki developers usually discourage the usage of  because it fragments the cache. Instead of storing one cached rendered version of a page, when  is used it needs to be cached potentially in hundreds of different languages.
 * 2) It is harder to setup, requiring access to wiki configuration.
 * 3) 古くなった翻訳を自動的に追跡する機能がなく、新しいメッセージが追加/削除された際に完成度の統計が無効になるかもしれません.
 * 4) メッセージ群にメッセージを追加したり、メッセージを翻訳したりできるのは、ウィキ管理者のみです. This means that the system is suitable only for pages which don't change often, or administrators will have a lot of work.

The good thing is that it works most of the time and you can still get the job done. There are two tutorials that provide examples of the common use cases. Before that there is section which details how to set up a message group, something which is always needed when using this method.

Setup
サーバー管理者はこの手順を完了する必要があります. 以下のスニペットをウィキの設定に追加する必要があります. The message group id,, must be unique, so don't reuse the same id for multiple groups. The second parameter to the  refers to the Mediawiki:Sidebar-messages page. The label is shown in dropdowns and other places where you can select a message group. The description is shown in Special:Translate. Those are the values you can and should change to suitable values when adding a new custom message group.

地域化されたサイドバーのチュートリアル
We assume that the setup step has already been done. Then you should follow the sidebar customisation guide carefully. Let's assume the following simple sidebar was created: And MediaWiki:Sidebar-commonpages contains, and MediaWiki:Sidebar-faq contains.
 * sidebar-commonpages
 * FAQ|sidebar-faq

Then all we need to do is to go to MediaWiki:Sidebar-messages (or whatever was defined in the previous step) and write there: sidebar-commonpages sidebar-faq That is, the names of the system messages, without the "MediaWiki:" namespace prefix, separated by whitespace.

Then go to Special:Translate/wiki-sidebar (or whatever was defined in the previous step; see Special:Translate for list of defined groups). Now it is possible to translate the messages into other languages. Since all the messages are in the MediaWiki-namespace, only a wiki administrator can edit the list of messages and actually translate them.

地域化されたメインページのチュートリアル
Another use case is page with lots of markup or templates. See the main page of [translatewiki:|translatewiki.net] for example. The advantage of this method is that the language automatically appears in the user's interface language. The drawback is that to change the language in which the page is displayed, the interface language must be changed.

作業手順は前述のチュートリアルと同様です:


 * 1) Setup a new message group
 * 2) ウィキページを開きます
 * 3) 翻訳対象の部分を  に置換して、その内容を MediaWiki:Mainpage-messagename に移動します
 * 4) MediaWiki:Mainpage-messages (or what was defined in the setup) に移動して、メッセージ名を空白区切りで追加します
 * 5) これで完了です. Special:Translate でメインページを翻訳してください.

例を示します. 以下の内容の Main Page を作成します:  is a community for chefs and bakers that love chocolate. We currently have full of chocolate. そしてこれを以下のように変更します: 

以下の内容の MediaWiki:Mainpage-slogan を作成します: is a community for chefs and bakers that love chocolate. 以下の内容の MediaWiki:Mainpage-pagecount を作成します: We currently have full of chocolate. 以下の内容の MediaWiki:Mainpage-messages を作成します: mainpage-slogan mainpage-pagecount これで完了です! 新しいメッセージを、いつでも追加/除去できます.

言語の選択
Not only the user can't choose what localised version of the page to read unless changing their preferences, but anonymous users can't set their user interface language and always use the wiki's default language. A page translated with this system will be in the default content language, if you don't provide anonymous users a way to select their language.

幸運なことに解決策があります. Extension:LanguageSelector を使用すると、利用者の好みの言語を推測でき、利用者が手動で他の言語を選択したり、その設定を Cookie に保存することもできます. これには (ほぼデバッグのみに使用する)  パラメーターのようなトリックは不要です.