Help:Extension:Translate/ja



Translate 拡張機能は、翻訳作業を行うのに必要不可欠な機能で MediaWiki を強化します. コンテンツ ページやウィキのインターフェイスの翻訳に使用でき、さらに で使用されているように、その他のソフトウェア製品の翻訳にも使用できます. Translate 拡張機能は、使いやすい翻訳インターフェイスを備えています. また、コンテンツを扱いやすい単位に分割して、翻訳者に翻訳できるテキストのみを表示することで、翻訳が必要なテキスト コンテンツからコンテンツ構造を分離できます. それぞれの単位の変更内容は自動的に追跡されるため、特定のページについて、あるいはウィキ全体について、翻訳者が何を更新する必要があるかを瞬時に把握できます.

Translate 拡張機能は、translatewiki.net で、MediaWiki やその他のプロジェクトのユーザー インターフェイスを翻訳するために使用されています. translatewiki.net では毎月、何百人もの人たちが翻訳をしています. userbase.kde.org では、何千もの説明文書ページ本文を翻訳するために使用されています. Translate 拡張機能は簡単に使用できますが、大規模なプロジェクトにも適用でき、高度な報告、査読、ワークフローの各機能も提供します.

特徴


インターフェース: Translate 拡張機能の中心的な機能は、シンプルながらも機能的な翻訳インターフェースです. メッセージの定義や付随資料のような必要不可欠な情報とともに、他の言語での翻訳を見ることができます. もし定義が変更されれば、その変更が表示されるでしょう. 組み込みで検査を備え、括弧の不均衡や変数の未使用といったよくあるミスの防止を支援します. 設定により、Google 翻訳、Microsoft の Bing 翻訳、Apertium といった翻訳メモリや機械翻訳サービスからの提案を受けることもできます.

翻訳インターフェースの使い勝手は JavaScript と Ajax によって強化されています. バックエンドは、モバイルインターフェースや特定の種類のコンテンツに合わせられたインターフェースで使用できる WebAPI を提供します. Gettext po ファイル形式に対応する他のオフライン・オンラインツールでの翻訳のためのメッセージを出力することも可能です.

メッセージ群とタスク: 機能の大部分は、メッセージ群とタスクという2つの基本的な概念に基づいています.

メッセージ群はメッセージの集合を表します. ひとつのコンテンツページは、おそらくひとつのメッセージ群になるでしょう. その群において、最も単純な構造の場合、各段落はひとつのメッセージになるでしょう. 各 MediaWiki 拡張機能で使われるメッセージは translatewiki.net 上でのメッセージ群を形成します. 少数の巨大な拡張機能は複数の群を有しています. 「すべてのニュースレター」や「Translate 拡張機能のすべてのメッセージ」のような、群の群を作成することもできます. 統計やタスクの大部分はメッセージ群ベースで行われます.

タスク、言い換えればメッセージ群内のメッセージの異なる一覧は、異なる使い方を促進します. 通常、翻訳者は選択したメッセージ群内のすべての未翻訳メッセージが列挙されるタスクを使用しますが、メッセージを査読できるタスク、翻訳・未翻訳にかかわらずすべてのメッセージが列挙されるタスク、もあります.



Reporting and statistics: The extension has extensive reporting features ranging from a view of untranslated messages across all message groups in a given language to lists of translators per language with their activity level.

Content translation: If you have ever tried to translate content in MediaWiki without any tools, you know it does not scale. The translated versions get out of date and there is no way to track changes to the master page, so there are many half-translated and outdated translations without a clear overview of the overall status. Translators often feel discouraged when they can not work with small manageable pieces of text. Translators don't find what to work on or what needs updating. The users also get confused by outdated information.

This is all solved with the Translate extension and its page translation feature. It adds a bit of overhead to the pages that need translation, but the benefits far outweigh this. Essentially you only need to mark the parts of the page that need translation. The extension then splits such parts into paragraph sized units and creates a message group for them. After that translators can use all the features described above. In addition you can easily add a language bar with the tag or have links automatically go to the user's preferred language version (only) when it exists, by using links of the form Special:MyLanguage/Pagename.

詳しくは翻訳ページの立ち上げ方や翻訳についての詳細な文書を参照のこと.

開発者: この拡張機能は、よく使用される多くの翻訳ファイル形式への対応機能を内蔵しています. Java プロパティ形式や Gettext po ファイルなどです. 翻訳を効率的に取り込み/書き出しするための、ウィキ内とコマンド ラインの両方で使用できるツール群も含んでいます.

Search Translations: Without a search feature, it is difficult for translators to find relevant messages with the search query. Usually, translators know the messages they are looking for and it may be inconvenient for them to traverse through all the translations to find messages relevant to their search. Also, translators might want to know the translated messages in their language for the query in a source language.

This is solved by a search tool called Search Translations. Translators can enter a search query in any language and find the messages containing the query words. With this search feature, not only can the translators find messages containing the query words, but also messages that are translated or untranslated or outdated in their own language.

使用事例
Translate 拡張機能を使用すれば、ほとんどすべてのものを翻訳できます. もちろん映画の字幕のような特定の種類のコンテンツの翻訳に特化したツールはありますが（そのような翻訳は、それらのツールを使うことでよりうまく行えます）、一般に「Translate」は、ひとつの単語からひとつの大きな段落にわたる長さのメッセージに分割できるようなあらゆる種類の文章で、とてもよく機能します. メッセージが長くなるにつれ、翻訳しにくくなり連携作業は実に難しくなります.

The three primary use cases that the Translate extension supports are content translation, local interface translation and software translation. All of them are covered in the following sections, with links to tutorials and to reference documentation or in-depth topical help where available. Of the three use cases the interface translation has been utilized the least.

コンテンツの翻訳


Most wikis have content they would like to be available in multiple languages. Whether just a few or hundreds of pages, it doesn't matter. In order to prevent wasting translator's time, pages should be marked for translation only when they are reasonably stable. Each change that is made afterwards can affect tens or hundreds of old translations, and the time needed to update them adds up. Especially with volunteer translators, you should be aware of this aspect, and respect the time they spend making translations and updates, avoiding unnecessary work. If you use the Translate extension to translate pages, you are already well on your way to using the translator time available in the most effective and efficient way.

The way the Translate extension splits up a page into paragraph sized units does not leave too much freedom for translators to change the content. This is usually a good thing and is ideal where continuity and consistency of content across languages is desired. It can be worked around, but in principle this way of doing translations is not generally suitable, for example, for Wikipedia articles, which usually are totally independent of each other. Even if they originally start as a translation from a different language, they usually begin living their own independent life from the original version. With Translate, the original page is always the main version, and new content cannot be developed in translated versions.

With these limitations in mind there are still plenty of cases where this feature is a perfect match. Most, if not all, user documentation falls into this category as well as news-like content that does not change once written. If you have the Translate extension already installed and access rights configured, try creating a page and wrapping the whole text inside  and follow the links, or follow the tutorial How to prepare a page for translation.

多言語ウィキでのローカルインターフェイスの翻訳
One thing almost every wiki has customized is the sidebar. It is possible to create a message group for the custom sidebar messages and also for other local interface customisations.

One interesting expansion is the multilingual pages or templates built with the magic word. The translatewiki.net main page and some Wikimedia Commons templates are good examples of this. The magic word is an alternative to the content translation feature and it is more suitable to mark-up heavy pages just like the translatewiki.net main page. Another nice feature is that the language of the page automatically follows the user interface language, so there is no need for a language bar, although you might want to have an interface language selector instead.

これを設定するのは、現時点ではコンテンツの翻訳よりも少し複雑で、ソフトウェアの設定が必要ですが、インターフェイスのメッセージ群を作成する方法ですべて説明しています.

ソフトウェアの翻訳
The Translate extension is a good fit for translating software interface messages. At translatewiki.net, it is used to translate tens of software products from games to web applications. The Translate extension supports reading and updating translations from and to common formats used in web development including Java properties, Gettext and Yaml files.

Change tracking is also available for externally tracked files, because internally the extension uses a cached derivative version of the localisation files where the source text and its translations are stored, instead of using them directly in their original format. Translation administrators can either use the web interface or a command line interface to check new message definitions and "fuzzy" (request update of) translations when they need updating. This works regardless of the underlying file format or version control system (if any).

With simple command line tools, translation administrators can easily import even a large set of existing translations and with just one command they can export all translations in the correct format and in the correct directory structure. You can export directly to your VCS repository checkout, where you can easily commit changes and new files.

Search Translations
The tool comes with essential features that you can use to reach messages you need. The uses the tool to search through large data sets across multiple languages. It can help translators to search in a wiki's source language and get results in their language. The results themselves are categorized into four columns: message content matches, translated matches, messages which need translations and outdated translations respectively. The left panel allows users to narrow down search results based on language and group filters. A limit is set to not get all the results at once to avoid excessive resource usage and navigate through the next set of messages using Previous and Next button at the bottom of the tool.

You can put '*', the wildcard character at the end of the string that can always finish words for you and will give you the results of the search term before it. For instance, if you can remember only a part of terms, type what you can remember and add the * at the end - Search Translations takes care of the rest. You cannot use the wildcard searches in the middle of a term (e.g. Wiki* or Wiki*edia gives you the same results). As a translator, you may also already know about the message key which you can reach with a single click. Normally, the search returns translations that match any of the search terms. If the search returns many results, then it provides a notice for the users as an option to perform a search for messages that have all terms. It does not provide case sensitive search by default but you may tick the checkbox to make your search case sensitive.

翻訳者と翻訳管理者向け

 * 翻訳方法 [チュートリアル]
 * 翻訳をを実践する
 * 統計と報告
 * 品質保証
 * メッセージ群の状態
 * オフライン翻訳
 * [進行中] 用語集

翻訳管理者向け

 * 翻訳するページの準備方法 [チュートリアル]
 * ページ翻訳の管理
 * インターフェイスのメッセージ群 (地域化されたサイドバー、メインページ、テンプレート) [チュートリアル]
 * [進行中] メッセージ群の保守
 * YAML 設定形式
 * ファイル ベースのメッセージ群用に YAML 設定を書く方法 [チュートリアル]

開発者向けの参考文献

 * インストール 及び 設定の構成; 多くの場合、MediaWiki 言語拡張バンドルで充分のはずです.
 * [進行中] 開発者に翻訳を説明する
 * フック
 * [進行中] メッセージ群
 * [進行中] ファイル形式対応
 * 翻訳支援
 * [未執筆] Web API
 * 現在のところなし. 作成し、ここに挿入することができます.
 * 翻訳メモリ

関連

 * 翻訳告知
 * ローカライゼーションの個別質問:ハッカソンや訓練の場で出た開発者への地域化への一般的な質問
 * 翻訳Svg:SVGファイルの翻訳支援
 * ユニバーサル言語選択:特殊な字体の提供や翻訳方法の伝授

ToDo

 * m:Meta:Translate extension
 * 特定のタスクについては translate-doc を参照してください.