Help:Extension:Translate/Page translation example/ja

ようこそ! このチュートリアルを完了すると、翻訳ページの作成方法や、Translate 拡張機能を使用した翻訳ページ管理の方法を理解できるようになります. 私たちはこのチュートリアルを、基礎的な概念や作業を網羅しつつできるだけ短くすることを目指しています. このチュートリアルを完了した後は、ページ翻訳機能についてのより詳細な説明文書をご覧になることもできます.

手順 1: 始める前に
このチュートリアルでは、翻訳用の拡張機能が既にインストールされ設定されていることを想定しています. 翻訳が必要なページを既に思い浮かべているかもしれませんし、以下の例のページで練習することもできます. 以下の例では、このチュートリアルの手順を自分のウィキで試すことができます.

このページでは架空の自治体 Fréttinga について説明しています.

以下は、それに関連するwikicodeです.

Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.


 * 1. Go to the page  in your wiki (or a draft page) and click create.
 * 2. 上記の内容を貼り付けて保存してください.

手順 2: 準備
なんらかの文章のあるページができました.

変更箇所が多かったり、大胆に編集される可能性がある場合、翻訳システムを追加する前に、編集状況が通常程度に落ち着くまで待った方がいいかもしれません. これは、すべての変更内容に追随するという大変な作業を翻訳者にさせるのを避けるためです.

このページは翻訳可能ですか？それでは、翻訳を依頼する方法を見てみましょう.


 * 3. を編集する
 * 4. 以下のように、コンテンツ全体をタグで囲みます.
 * 5. ページを保存する

 Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. 

すべての要素に タグや  のようなマーカーを追加する必要はありません. 翻訳拡張機能にお任せください.

手順 3: 翻訳を有効化
ページを保存すると、あなたが翻訳管理者である場合は、ページ上部に「このページを翻訳対象に指定」というリンクが表示されます. そうではない場合は「このページには翻訳対象に指定されていない変更があります. 」というリンクが表示されます. あなたが翻訳管理者であるならば、「このページを翻訳対象に指定」というリンクをクリックしてください. ページは自動的に4つの翻訳単位に分割されます. 1つめの翻訳単位はページ名、2つめは第1段落、3つめは第2段落の見出し、4つめは第 2段落の本文です. これらは翻訳対象ページの基礎的な項目であり、「各翻訳単位は独立している」・「まとめて翻訳できる」・「ページ本文の変更は翻訳単位ごとに追跡される」といった3つの特徴があります. 翻訳単位は再配置したり削除したりすることもできます.

ページ翻訳のページテンプレートの表示もあります. これについては、後のステップで説明します. 翻訳ユニットには名前を付けることができますが、この例ではデフォルトのままにしておきます.


 * 6. Click the "Mark this page for translation" link
 * 7. ページ本文が3つのユニットに正しく分割されていることを確認する.
 * 8. Click the "Mark this version for translation" button (注意: このためには 翻訳管理者 になる必要があります)
 * 9. ページに戻る

Now you will see a new link at the top, "Translate this page", that lets translators translate the page. You might have a look at the translation tutorial which uses this page as an example and try out few translations now. Then return here for the next step.

変化が翻訳や翻訳ユニットに与える影響を把握する
変更の追跡は非常に重要な機能なので、いくつか変更を加えて、その動作を確認してみましょう. 編集のためにページを開くと、のようなマーカーで修正されていることがわかります. これらは拡張機能によって追加され、どのユニットがどのユニットであるかを識別するのに役立ちます. これにより、それらのユニットを並べ替えたり、編集したりすることができます. ページを編集する際には、マーカーはそのままにしておき、所属するユニットとの位置関係を変更しないようにする必要があります. ユニットを移動する場合は、ユニットマーカーも移動してください.

ユニットを削除する場合は、マーカーも削除してください. 新しい段落を追加すると、ソフトウェアによって新しいマーカーが追加されます. 手動で行うと、ソフトウェアを混乱させる可能性がありますので、行わないでください. あなたが削除したマーカーは、既存の翻訳でもボットによって自動的に削除されます.

既存の翻訳ユニットに軽微な変更（数語の追加や段落へのリンクの追加）を行う場合、マーカーはそのままにしてください. 段落全体を変更した場合（削除して作り直した場合）、マーカーを削除します. このように、翻訳者は、あいまいな翻訳を見直したり、新しい翻訳を作成したりと、さまざまな仕事をすることができます.

改造しよう!
ここでは、あなたが何をするのか:


 * 10. 上記のように、いくつかの追加を行います.
 * 11. Click the "marked for translation" link at the top
 * 12. 変化を観察する
 * 13. Click the "Mark for translation" button (注意: このためには 翻訳管理者 になる必要があります)
 * 14. 元のページに戻る

前のステップで提案したように翻訳を行った場合、その翻訳がページ上部にリンクされているのが確認できます. また、翻訳が100％最新でないこともおわかりいただけると思います. 翻訳ビューに移動すると、本体に更新が必要なマークが表示されていますね.

古くなった翻訳はピンク色の背景で強調表示されます. 翻訳が不完全であることが利用者に分かります.

翻訳の雛形の表示では、ページのどの部分が全言語版で共通する定数かを理解するのを支援します (「翻訳ページの雛形」は翻訳タグの外側の部分のこと). さらに、翻訳単位が移動/削除された場合も教えてくれます.

多数のページを更新する可能性があるため、翻訳済み版をすべて更新するのにわずかに時間がかかります.

以上が基礎知識ですが、このチュートリアルでは、よく直面する事項についてさらに説明します.

画像、カテゴリー、翻訳マーカー付きリストの追加
今、基本的な翻訳可能なページがありますが、非常に退屈です. 画像や他のものを追加して、より通常のwikiページのように見えるようにし、それらの要素が翻訳とどのように相互作用するかを見てみましょう.

さらに単位マーカーを含む段落を除去して箇条書きに置き換えるとどうなるか、見てみましょう.


 * 15. Add an image, a category and a list to the page as shown below
 * 16. Save the page
 * 17. Click the link "marked for translation" at the top of the page
 * 18. Verify that the changes look as intended
 * 19. Click the "Mark this version for translation" button
 * 20. Return to the translatable page

文書の翻訳
Allowing to translate only the picture title:

Or allowing to change the image file in the translated page (for localized version for exemple) and the title:

画像のマークアップの大部分を翻訳単位の外にしたことで、その部分が翻訳ページの雛形に入ることが分かるでしょう. (注意: 翻訳ページの雛形は、異なる翻訳ページの間では変更されません) 通常はこれで問題ありませんが、翻訳者が画像を変更したい場合、特に画像が文字情報 (テキスト) を含んでいる場合があります. その場合は、翻訳単位にマークアップ全体を含めるのが最も簡単な解決方法です (上記のカテゴリの記述と同様に).

翻訳単位の翻訳がマークアップと関係がある場合は、それについて翻訳者向けに少し記述することをお勧めします. これは以下の手順で行えます.


 * 21. Click "Translate this page" link at the top
 * 22. Select "qqq - Page documentation" language
 * 23. Click the message name which contains the message "A typical view of Fréttinga"
 * 24. Write "Description of an image" and click "Save"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

リンクについて
同様に、リンクについてもさまざまな方法があります. 利用者のインターフェイス言語に応じて翻訳版に自動的にリダイレクト (翻訳が存在する場合) される  を使用してきました. 現在閲覧しているページの言語ではなく、使用しているインターフェイスの言語のページに常にリダイレクトされるため、これは究極の解決策ではありません. さらに、Special:MyLanguage は Special:WhatLinksHere (リンク元) と干渉し、リンク元が正しく表示されなくなります. Special:MyLanguage の利点は、表示しようとした翻訳ページが存在しない場合でも、何らかの言語のページが常に表示される点です.

カテゴリについて
この例では、カテゴリ指定全体が翻訳単位になっています. これにより、翻訳者が のように、またはカテゴリに使用したい命名規約に従って、自由に変更できるようになります. カテゴリ指定が外側 (つまり翻訳の雛形) にある場合は、Foo、Foo/de、Foo/ru、Foo/ta などのページすべてが同じカテゴリに入ります. これで問題ない場合もありますが、これでは通常、利用者が混乱します. ローカルでの命名規則について翻訳者に周知しておくようにしてください.

タイトルについて
タイトルと本文を別要素として扱うには、タイトルとその後に続く段落との間に、(空の行がない場合のみ) 空の行を1行追加してください.

以下の例だと1つの翻訳単位しかつくられません.

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

次の例では2つの翻訳単位が作成され、その一方がタイトルとなります.

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

空白行を追加することで、翻訳者はいつ休憩できるかが分かるようになります. さらに、ウィキテキストの問題を防止します.

Operating on the whole page and its translations
It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Managing all wiki's pages translations with Special pages
Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

Now, you know !
翻訳対象ページを作成できるようになり、翻訳対象ページで実行可能なよく使用される操作をすべて体験しました.

Going deeper ?
その他の情報を得たい場合や、機能をさらに深く理解したい場合は、続けてページ翻訳機能についての詳細な説明文書をお読みください. そちらのページでは、リンク、カテゴリ、テンプレートを扱うさまざまな方法や、翻訳単位の大きさについての賛否両論、のような議論も記載しています.

関連項目

 * Help:Extension:Translate/ページの翻訳管理