Help:Extension:Translate/Page translation administration/ja

'''目的. '''ページ翻訳機能はウィキページの他言語への翻訳の制御を可能にします. これは個々の翻訳の内容が通常翻訳元ページと同一であることを意味します. 異なるウィキペディアの異なる言語版の項目のように、たがいに完全に独立な場合とは対照的です. ページは主言語1つから他の言語へと翻訳されることが想定されていますが、他の言語での翻訳がある場合、翻訳者はそれを利用することもできます.

Why. Without any help, translating more than a few pages into other languages becomes a time-waster at best, an unmaintainable mess at worst. With the page translation feature you can avoid the mess and bring structure to the translation process. The core idea is that the source text is segmented into smaller units, each of which will be translated individually. When the source text is segmented into units, all changes can be isolated and translators only need to update the translations of units which have had changes in source text. This also enables translators to work on units of manageable size and share the work between multiple translators or continue the translation in later sessions, because they don't need to do all at once.

Who. This page elaborates on the page translation tutorial by providing deeper insight on how the system works, and suggests best practices for a wide variety of cases. This page is intended for page translation administrators and generally for everyone who edits the source text of translatable pages, even if they don't have the access to the administrative features of approving changes for translation.

翻訳対象ページの一連の流れ
'''役割. '''ウィキページを執筆し翻訳する過程では複数の人が関わります. 最初の執筆者がページを作り、誰かが誤字を訂正し、ページ翻訳管理者がページに翻訳の印をつけ、翻訳者が翻訳し、誰かがページに変更を加え、ページ翻訳管理者がこの変更に翻訳の印をつけ、翻訳者が翻訳を更新します. これらの役割は多少重複することもありますが、翻訳を支障なく行えるようにするための最終的な責任はページ翻訳管理者にあります. ページ翻訳管理者は、ページが翻訳にむけて準備できているかを判断し、セグメント分けが適切であることを確かめ、変更を承認 (または訂正) します.

'''準備. '''何かの翻訳がほしい場合、まずその内容を書く必要があります. Translate 拡張機能を使わずに翻訳をしていた場合、下記の翻訳の移行に関する節をご覧ください. 大量の翻訳を高速にしたい場合は、翻訳元テキストがよい形になっていることが必要不可欠です. ページに翻訳可能の印をつける前に、校正を他の人に頼み、できればテキストをより明確かつ簡潔にするよう言語の専門家に他のんでください. 難解な語彙や翻訳が難しい文があると多くの場合ボランティアの翻訳はうまく行きません. マークアップも翻訳者にとって面倒になりえますが、翻訳管理者としてこうした問題は回避できます. 下記のマークアップの扱い方についての節をご覧ください. 当然ながら翻訳元テキストに変更を加えると、他の既存の翻訳すべてで更新が強制されます. このため、ページの内容が安定するまで待つほうがよいでしょう. 一方、変更は起こるものであり、システムはそれに対応できます. 下記の変更の扱い方についての節をご覧ください.

'''タグ付け. '''テキストが他の観点で翻訳に向けて準備できていれば、誰でも翻訳可能な部分を&lt;translate> タグで囲み、&lt;languages /> をページに追加することができます. 後者はページに全翻訳の一覧と、進捗と更新の状況を示すパーセンテージの表示を追加します. これ以外に翻訳があるということを示唆するものはありません. 下記の実際のタグ付けの方法もご覧ください. システムはタグがつけられたことを検知し、その後ページには翻訳可能の印をつけるためのリンクができます. さらに、閉じタグを忘れた場合などに保存の前に警告がでて止められるようになります. 翻訳可能なページはさらに Special:PageTranslation に「ready for marking」として表示されます.

Marking. After the tagging, a translation administrator marks the page for translation. The interface is explained in Page translation example. The translation administrator's responsibility is to make sure that the segmentation makes sense and that tagging has been proper. The page can be marked again if it has changed in the meanwhile. See below how to make changes that cause minimal disruptions. The marking of the page starts a background process that uses MediaWiki's job queue. This process goes over each translation page and regenerates it: changes in the translation page template will be reflected and outdated translations will be replaced temporarily with the original source text. On the contrary, the translation interface is updated immediately.

Changes. Users can continue making changes to the translatable page source. The changes will be visible to users viewing the page in the source language, but translations are done against the translation units extracted from the last version of the translatable page which has been marked for translation: the translation pages are reported to be 100 % up to date if all translation units have been translated, even if the source page has new changes. You can easily see whether there are unmarked changes when viewing the translatable page in the source language: there is a notice at the top which says that you can translate this page and also links to changes if there are any.

翻訳元言語. 翻訳元言語の言語コードが付いた翻訳対象ページもあります. これは、翻訳元ページに使用される翻訳関連の特殊なタグやその他のマークアップを含んでいません. このページはインターフェイスからリンクされませんが、例えばページ (一般に翻訳の雛形) を参照読み込みする際やそれを書き出す際に役立ちます.

Closed translation requests. Some translatable pages have a content that is only interesting for a certain period of time. For example announcements and regular status updates, like the Wikimedia monthly highlights. You can keep those pages around with translations, but hide them from the translation interface. This does not prevent further translations to the pages, but it greatly reduces the chance that a user accidentally starts translating the page. Discouraging and its reversion are done from Special:PageTranslation.

Prioritizing languages. You can also define a list of languages that you specifically want translations into; leaving the language list empty is interpreted as all languages allowed. The page will behave like a discouraged page (see previous paragraph) for the languages not in the priority list and, when translating into them, translators will be given a notice. You can also prevent the translation in other languages, say if translations are actually used elsewhere and you won't be able to use them but in some languages.

'''グループ化. '''関連するページ同士をグループ化できます. これらのグループ (集約群) は、他のすべてのメッセージ群と同様に振る舞います. 各群には、その群自身の統計があり、下位群のすべてのメッセージを含んでいます (この翻訳対象ページの場合). この機能は現在 Special:AggregateGroups にあります. Special:Translate のメッセージ群セレクター内の Special:LanguageStats では、既定では集約メッセージ群が折りたたまれた状態です.

'''移動. '''他のあらゆるページを移動できるのと同様に、翻訳対象ページも移動できます. 移動させる際、翻訳対象ではないすべての下位ページも移動させるかどうか、選択できます. 移動では、多数の関連ページを移動させるためにバックグラウンド ジョブを使用します. 移動中は、ページの翻訳ができません. 移動が完了すると、ページ翻訳記録に記録されます.

'''削除. '''移動と同様に、削除も通常の場所からアクセスできます. 翻訳対象ページ全体を削除するか、1 つの翻訳ページのみを削除するか、そこの削除ボタンから選択できます. 関連する翻訳単位ページも削除されます. 移動と同様、バックグラウンド プロセスがページを徐々に削除していきます. 削除が完了すると、ページ翻訳記録に記録されます. 削除するには、"delete" 権限および "pagetranslation" 権限が必要ですが、個別の翻訳単位ページについては標準的な "delete" 権限で削除できます.

Reverting. Similarly, reverting incorrect edits works as usual (including rollback button): you only have to edit the affected translation unit and the translation page will be updated as well. To find the edit to the translation unit from the edit to the translation page, just click the "" link for the editor and look for an edit at a similar time.

'''保護. '''翻訳対象ページを保護できます. 翻訳ページについては、保護することも、翻訳対象ページの保護を翻訳ページにまで拡張することもできません. 翻訳のこれ以上の編集を阻止するには、唯一の優先言語として翻訳元言語を追加して、他の言語への翻訳を無効にしてください. 上記の 優先言語化を参照してください. これらの 2 つの操作を行うことで、翻訳元ページ、翻訳ページ、その翻訳単位ページのすべての変更を阻止できます. 各翻訳単位ページを保護することはできますが、賢明ではありません.

翻訳対象指定の解除. 翻訳対象の指定を解除することもできます. まず、そのページから翻訳タグをすべて除去する必要があります. さらに、そのページを翻訳対象から外すために、Special:PageTranslation を使用するか、または翻訳対象ページ上部のリンクをたどります. これによりページ翻訳関連のあらゆる構造が除去されますが、既存のすべてのページが自由に編集できる状態で同じ場所に残ります. この操作はお勧めできません.

翻訳対象ページの構造
翻訳ページを翻訳することで、多数のページが生成されます. これらのページはそれぞれ 広い意味で 翻訳対象ページを構成する部品だと言えます. これらのページのページ名は、翻訳対象 のページ名で決まります:


 * (翻訳元ページ)
 * (「翻訳先ページ」と「マークアップを除いた翻訳元ページのコピー」を合わせたもの)
 * (すべての翻訳単位ページ)

In addition to this, there are the translation page template and the sources of translation units, extracted from the source page and stored in the database. The system keeps track of which versions of the source page contain translation tags and which version of them have been marked for translation.

Every time a translation unit page is updated, the system will also regenerate the corresponding translation page. This will result in two edits. The translation unit page edit is hidden by default in recent changes and can be shown by choosing show translations from the translation filter. Any action other than editing (like deleting and moving) the translation unit pages will not trigger the regeneration of the corresponding translation page.

If you need the copy of the source page without markup, e.g. to be pasted in another wiki without Translate, the text will be displayed or saved.
 * identify the source language code (for English, en ) and visit ;
 * click the "" button to reach an address like this and replace  with   in the address bar, press enter:

セグメント化
全般的な原則:


 * 1) 翻訳するテキストは、すべて translate タグで囲むことになっています. 1 つのページが、タグの対を複数含む場合があります.
 * 2) translate タグの外側のすべてのテキストは、どの言語への翻訳ページでも変更されません. この静的なテキストに、各翻訳単位が埋め込まれる場所を示す印を付けたものを、翻訳ページの雛形と呼びます.
 * 3) テキスト内のマークアップが多すぎると、翻訳者が翻訳しにくくなります. マークアップが多数ある場合は、よりこまめに translate タグを配置してください.
 * 4) translate タグ内のテキストは、1 行以上の空行がある位置 (つまり 2 個以上の改行文字がある位置) で複数の翻訳単位に分割されます.

Restrictions. The page translation feature places some restrictions on the text. There should not be any markup that spans over two or more translation units. In other words, each paragraph should be self-contained. This is currently not enforced in the software, but violating it will cause invalid rendering of the page, the severity depending on whether MediaWiki itself is able to fix the resulting html output or not.

Parsing order. Beware, the translate tags work differently from other tags, because they do not go through the parser. This should not cause problems usually, but may if you are trying something fancy. In more detail, they are parsed before any other tags like &lt;pre> or &lt;source>, with the exception of &lt;nowiki> which is recognized by the Translate extension in some circumstances (such as rendering a page) but not in others (such as generating the list on Special:PageTranslation of pages containing &lt;translate>). If you want to have the literal expression "&lt;translate>" in the source text, you should escape it like "&amp;lt;translate>".

'''タグの配置. '''可能であれば、タグの前後で改行して、なおかつタグと本文の間に空行を作らないようにします. これが不可能な場合があり、それは例えば、マークアップで囲まれた本文を翻訳したいものの、それ自身はマークアップではない場合です. これにも解決策があります. 例えば:

To make this work, the extension has a simple whitespace handling: whitespace is preserved, except if an opening or closing translate tag is the only thing on a line. In that case the newline after the opening tag or before the closing tag is eaten. This means that they don't cause extra space in the rendered version of the page.

'''変数. '''テンプレートの変数と類似した、変数を使用できます. 変数の構文は &lt;tvar|変数名>内容 です. 翻訳者には  のみが表示され、翻訳ページでは、変数は翻訳対象ページで定義された値に自動的に置換されます (ゆえに、変数は翻訳ページ全体で使用できるグローバル「定数」です). 変数は、翻訳単位の途中で、翻訳できない箇所を隠す用途にも使用されます. 頻繁に更新する必要がある数値のようなものに対しても使用できます. 翻訳対象ページのソースを変更して、そのページを翻訳対象に再指定することで、すべての翻訳ページの数値を更新できます. その数値が翻訳単位ページに含まれていないため、翻訳を無効化する必要がありません.

マークアップの例
以下に、特殊なウィキマークアップを扱うためのお勧めの方法を列挙します.

{| class=wikitable 翻訳しない: Category:Cars
 * カテゴリ
 * カテゴリを追加する方法は 2 つあります: 翻訳ページの雛形に追加する方法と、翻訳単位の 1 つとして追加する方法です. 翻訳ページの雛形内にカテゴリがある場合は、結果的に、どの言語への翻訳でも同じカテゴリになります. 翻訳単位内にカテゴリがある場合は、翻訳でのカテゴリの命名規則を利用者に指導しておいてください. 右に、命名規則の候補を 2 つ示します. これらは、採用するための技術的な手段とは独立しています.


 * すべての翻訳文を同じカテゴリに (言語が少ない場合のみ).
 * カテゴリ名は翻訳しません (翻訳テンプレート内にそのまま書けるようにするため).

言語接尾辞を追加する翻訳: Category:Cars/ja (推奨しますが未対応)

There are some such templates available on the wikis which use the Translate extension, but they won't be dealt with here. Translated categories' description pages still have to be created.
 * カテゴリ名は翻訳しません (ページ名と同様).
 * 言語ごとに 1 カテゴリ.
 * ページ翻訳はカテゴリ自身の翻訳に使用される場合があります. カテゴリは互いにリンクされ、見出しが翻訳されます (リンク内のカテゴリ名などを除く).
 * This option is not yet supported out of the box by the Translate extension. You need to either instruct your translators to add the language code suffix to the category markup in the translation, or leave the category out of translation and write your own templates which add the language code automatically.

誤: == &lt;translate>Culture&lt;/translate> ==
 * 見出し
 * Headers can in principle be tied to the following paragraph, but it is better to have them separated. This way someone can quickly translate the table of contents before going into the contents. When tagging headers, it is important to include the header markup inside the tags, or MediaWiki will no longer identify them properly, for example when trying to edit a specific section of the source page. The markup also immediately gives translator a context: he/she is translating a header.
 * Headers can in principle be tied to the following paragraph, but it is better to have them separated. This way someone can quickly translate the table of contents before going into the contents. When tagging headers, it is important to include the header markup inside the tags, or MediaWiki will no longer identify them properly, for example when trying to edit a specific section of the source page. The markup also immediately gives translator a context: he/she is translating a header.

正: &lt;translate>== Culture ==&lt;/translate> 翻訳の提案: &lt;translate>

Culture
Lorem ipsum dolor. &lt;/translate>

&lt;translate> &lt;/translate>
 * 画像
 * テキストのような特定の言語のコンテンツを含む画像の場合、翻訳単位内に完全な画像の構文として含めてください. それ以外の画像の場合は、説明のタグを付けるのみでかまいませんが、翻訳対象に指定したあとにメッセージのドキュメントとしてヒントを記述してください (ヒントは省略可).
 * テキストのような特定の言語のコンテンツを含む画像の場合、翻訳単位内に完全な画像の構文として含めてください. それ以外の画像の場合は、説明のタグを付けるのみでかまいませんが、翻訳対象に指定したあとにメッセージのドキュメントとしてヒントを記述してください (ヒントは省略可).


 * リンク
 * リンクは、それが存在する段落に含めることができます. これにより、リンクラベルを変更できるだけではなく、リンク先も翻訳済み版に変更できます (存在する場合).
 * リンクは、それが存在する段落に含めることができます. これにより、リンクラベルを変更できるだけではなく、リンク先も翻訳済み版に変更できます (存在する場合).

If the target page is (or should be) also translatable, you should link to it by prepending  to its title. Only the link label will need to be translated, because this automatically redirects users to the translation page in their own interface language, as selected for instance via the UniversalLanguageSelector. However, to achieve a constant behavior the syntax must be used for all links.

見出しが翻訳されるため、見出しに対して自動的に生成される ID に頼ることはできません. 自分でアンカーを追加してください. 翻訳の雛形の外側 (translate タグの内側) に見出しを配置する場合は、リンク先として使用する各見出しの前後で、数の translate タグ対を使用してページを複数に分割する必要があります. 内部リンク: &lt;translate> Helsinki is capital of Finland. &lt;/translate>

翻訳対象ページへのリンク: &lt;translate> It has marvelous beaches with a lot of seagulls. &lt;/translate> 外部リンク: &lt;translate> PHP (website) is a programming language. &lt;/translate> ページ内リンク: &lt;translate>

Culture
Lorem ipsum dolor.

...

For more about food, see section about culture. &lt;/translate>

&lt;translate> &lt;translate> &lt;/translate>
 * 箇条書き
 * Lists can get long, so might want to split them into multiple parts with for example five items or less in each as follows. Do so only if the items are sufficiently independent to be translate separately in all languages, don't create "lego messages": for instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags. Do not insert new lines as this will break the HTML output.
 * Lists can get long, so might want to split them into multiple parts with for example five items or less in each as follows. Do so only if the items are sufficiently independent to be translate separately in all languages, don't create "lego messages": for instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags. Do not insert new lines as this will break the HTML output.
 * General principles
 * Headings
 * Images
 * Tables
 * Categories&lt;/translate>
 * Links
 * Templates


 * 数値
 * 数値やその他の非言語的な要素は、翻訳対象の外に配置して変数に変更できます. これには複数の利点があります:
 * 数値やその他の非言語的な要素は、翻訳対象の外に配置して変数に変更できます. これには複数の利点があります:

&lt;translate> Income this month  EUR &lt;translate> これにより、通貨の変換を伴う数値の地域化を妨げてしまうことにご注意ください. を使用することで、翻訳先言語に合うように数値が正しく整形されます.
 * 翻訳を無効化することなく、数値のみを更新できます.
 * 数値の変更が無視されるため、翻訳メモリがより的確に機能します.


 * テンプレート
 * Templates have varying functions and purposes, so the best solution depends on what the template is for. If the template is not a part of longer paragraph, it should be left out, unless it has parameters that need to be translated. If the template has no linguistic content itself, you don't need to do anything for the template itself.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Template:Translatable navigation template, because you cannot include the template by anymore. This is not yet provided by the Translate extension itself, but that is in the plans.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Template:Translatable navigation template, because you cannot include the template by anymore. This is not yet provided by the Translate extension itself, but that is in the plans.

Another way is to use the unstructured element translation to translate the template, but then the language of the template will follow the user's interface language, not the language of the page he is viewing.
 * }

翻訳元テキストの変更
全般的な原則:


 * 変更を避ける
 * できるだけ変更を少なくする
 * 自分で翻訳単位マーカーを追加しない

Unit markers. When page is marked for translation, the system will update the translatable page source and add unique identifiers for each translation unit. See example below. These markers are crucial for the system, which uses them to track changes to each translation unit. You should never add unit markers yourself. The markers are always on the line before the unit; or, if it starts with a header, after the first header on the same line. The different placement for headers is needed to keep section editing working as expected.

&lt;translate>

Birds
&lt;!--T:1--> Birds are animals which....

&lt;!--T:2--> Birds can fly and... &lt;/translate> Changing unit text. Changing is the most common operation for translation units. You can fix spelling mistakes, correct grammar or do other changes to the unit. When re-marking the page for translation, you will see the difference in the unit text. The same difference is also shown to translators when they update their translations. For simple spelling fixes and other cases where you don't want the existing translations to be removed from translation pages, you can avoid invalidating them: translators will still see the difference if they ever update the translation for any reason.

'''新しいテキストの追加. '''translate タグの内側にテキストを自由に追加できます. システムが新しい翻訳単位を認識できるようにするために、隣接する翻訳単位と翻訳単位の間に空行が 1 行あることを確認してください. 既存の translate タグの内側ではなく、タグの前後に新しいテキストを追加することもできます. 繰り返しますが、翻訳単位マーカーはシステムが追加するため、自分では追加しないでください.

'''テキストの削除. '''翻訳単位全体を削除できます. 削除すると、翻訳単位マーカーも除去されます.

Splitting units. You can split existing units by adding an empty line in the middle of a unit, or by placing translate tags so that they split the unit. You can either keep the unit marker with the first unit or remove it altogether. In the first case, translators see the old text when updating the old translation. If you removed the unit marker, both units will behave as if no translation ever existed, after the page is re-marked for translation.

'''翻訳単位の統合. '''翻訳単位を統合する場合は、1 つの翻訳単位マーカーのみを残してそれ以外の翻訳単位マーカーをすべて除去してください.

'''翻訳単位の移動. '''翻訳単位の翻訳結果を無効にすることなく、その翻訳単位を移動させることができます: 翻訳単位マーカーとその翻訳単位の残りの部分を一緒に移動させるだけで完了です.

Before marking the new version of the page for translation, ensure that the best practices are followed, especially that translators get a new translation unit if the content has changed. Also make sure that there are no unnecessary changes to prevent wasting translators time. If the source page is getting many changes, it may be worthwhile to wait for it to stabilize, and push the work for translators only after that.

使用されていない翻訳単位の翻訳は自動的には削除されませんが、残った翻訳が問題を引き起こすことはありません.

ページ翻訳への移行
If you have been translating pages before using the page translation system, you might want to migrate the pages to the new system, at least the ones you expect to have new translations and want statistics for. You will probably have existing templates for language switching and maybe different page naming conventions.

You can start migration by cleaning up, tagging and marking the source page. You can keep the existing language-switching templates while you migrate the old translations. If your pages follow the language code subpages naming convention, they will be replaced with the source text after marking the source page for translation, but you'll still be able to access translations from history.

This manual task has been partly automated by Special:PageMigration, which shows the source and target units besides each other and allows the user to adjust the units by providing a set of features mentioned later in this page.

How to use?

 * 1) Go to Special:PageMigration
 * 2) Enter the title of the page and the language code. For example, "Help:Special pages" & "fr"
 * 3) The source text which was divided into units by Translate and the imported translations will be shown besides each other with some initial alignment.
 * 4) Use the actions available for each unit to manually do the remaining alignment
 * 5) As translated units editable, do required manual improvements (for add translation variables, fix links and markup, etc.)
 * 6) Click on the "" button. This will create pages under the Translations namespace of the form  . The old translations have been imported into Translate.
 * 7) Else, if you wish to abort the importing, click on the 'Cancel' button.

Actions available
Each row consisting of source and target unit has a set of action icons. They are used as follows:
 * 1) Add: Clicking on this action icon adds a new empty unit below the current one. Use this feature if you want to split the current unit and need a unit below.
 * 2) Swap: Clicking on this action icon swaps the content of the current unit with the unit below it. You can use this feature when the units get aligned improperly due to different ordering of sections. Or when you need to drag a unit below or above. In either case, remember it swaps with the unit below and does not create any additional units.
 * 3) Delete: Clicking on this action icon completely removes the corresponding target unit from the page and shifts the remaining target units up by one unit. Use this to remove unwanted content like code or imported translations which are present completely in the source language. Note: this irrevocable action (in the current session).

Troubleshooting

 * 1) If you mark a page for translation and immediately go to the special page and try to import translations, you may get an error message like "". This is because FuzzyBot didn't fuzzy the messages on the old page yet: the tool won't find an edit by FuzzyBot on the translation page. In this case, simply wait for FuzzyBot to do its job. Once an edit is seen, you can proceed with the imports.
 * 2) Please wait for some time after pressing the "" button. While the button remains gray background, there is a process of import non-empty units. Once the button becomes colored again, import is completed.

Tips

 * 1) Migration will be easier if you first (before the mark to translation) check whether existing translations are similar to the original English text, and manually edit the structure of pages: break paragraphs and lists, add the missing headers (even if empty).
 * 2) Will be useful to check the result in the core translation interface - some of the units may be immediately marked as obsolete because of errors markup or if not all of the translation variables was added.
 * 3) Translation of the page title will have to be added manually. If you do not know very well the language of the imported page, you can try to find the translation of the page title among the "links here" or sometimes in redirects. Note: Please don't translate the namespace, keep it untranslated.