Help:Extension:Translate/Page translation example/ja

Welcome! After completing this tutorial you will know how to create and manage translatable pages using the Translate extension. We aim to keep this tutorial as short as possible, while introducing all the basic concepts and tasks. After completing this tutorial you can use the in-depth documentation about page translation feature.

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

このページでは架空の自治体 Fréttinga について説明しています. 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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day.
 * 1. 自分のウィキのページ Fréttinga に移動して作成をクリックします.
 * 2. 上記の内容を貼り付けて保存します.

手順 2：準備
Now we have a page with some text. If the page is still going to be subject to lots of changes and major refactoring, it may be better to wait until the edits slow down to a normal level before adding the page into the translation system. This is to avoid too much work for translators as they need to keep up with all the changes.

&lt;translate> 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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. &lt;/translate>
 * 3. ページ Fréttinga を編集します
 * 4. 以下に示したように、本文全体を &lt;translate>...&lt;/translate> のタグで囲みます
 * 5. ページを保存します

手順 3：翻訳を有効化
After saving the page, you will see a link at the top of the page saying "Mark this page for translation" (or "This page contains changes which are not marked for translation." if you are not a translation administrator). Click on that link. The page has been automatically split into four translation units. The first unit is the title of the page, the second is the first paragraph, the third is the header of the second paragraph, and the fourth is the text of the second paragraph. These are the basics items of translatable pages: each unit is independent; it can and must be translated as a whole; changes to the page content are tracked into the unit level. Units can be rearranged or deleted.

There is also a view of the page translation page template; this will be covered in later steps. You can give names to the translation units, but in this example, we choose to stick with the defaults.


 * 6. リンク「このページを翻訳対象に指定」をクリックします
 * 7. ページの本文が 3 つの単位に正しく分かれていることを確認します
 * 8. 「この版を翻訳対象に指定」ボタンをクリックします
 * 9. ページに戻ります

翻訳者がページを翻訳するための新たなリンク「このページを翻訳」が上部に表示されます. 例としてこのページを使用している翻訳のチュートリアルを参照して、翻訳を少し試してください. そしてここに戻ってきて次の手順に進んでください.

手順 4: 変更する
Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too. When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. &lt;languages /> &lt;translate> &lt;!--T:1--> 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 summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively in the following summer. &lt;/translate>


 * 10. 上記で強調したように少し書き加えます
 * 11. 上部のリンク「翻訳対象に指定済み」をクリックします
 * 12. 変更内容をじっくり確認します
 * 13. 「翻訳対象に指定」ボタンをクリックします
 * 14. 元のページに戻ります

前の手順で提案したように翻訳した場合は、その翻訳へのリンクがページの上部に表示されます. 翻訳が 100% 最新ではないことも表示される可能性があります. 翻訳済み版のページには、新しい段落が英語で表示され、その変更された部分が強調されます (スクリーンショット参照). 翻訳画面に移動すると、その翻訳単位に要修正の印が付いていることが分かります.

The translation template view helps you to see what parts of the page are constant in all language versions (the "translation page template", i.e. the parts outside translate tags) and also shows you if units have been moved around or deleted.

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

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

手順 5：他のウィキ要素を追加
これで基礎的な翻訳対象ページができましたが、非常に味気ないページです. そこで、通常のウィキページのように画像などの要素を追加して、それらが翻訳にどんな影響を与えるか見てみましょう.

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

&lt;languages /> &lt;translate> &lt;!--T:1--> 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 and tourists like to visit it in the summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop and a car ferry visits the island from the mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877 &lt;/translate>
 * 15. 以下に示したように、ページに画像、カテゴリ、箇条書きを追加します
 * 16. ページを保存します
 * 17. ページの上部のリンク「翻訳対象に指定済み」をクリックします
 * 18. 意図した通りに見えるか、変更点を検証します
 * 19. 「この版を翻訳対象に指定」ボタンをクリックします
 * 20. 翻訳対象のページに戻ります

Here you can see that we left most of the image markup outside of a translation unit and have it in the translation page template instead. This is usually okay, but sometimes translators may want to change the image, especially if it contains linguistic content (text). In those cases it's usually easiest to include the whole markup in a unit (as we did for the category). When the translation of a unit involves or interacts with markup it's a good idea to write a small tip to the translators about it. You can do this with the following steps.


 * 21. 上部のリンク「このページを翻訳」をクリックします
 * 22. 言語「qqq - メッセージについてのドキュメント」を選択します
 * 23. メッセージ「A typical view of Fréttinga」を含むメッセージ名をクリックします
 * 24. 「Description of an image」と入力して「保存」をクリックします

In this example, the whole category assignment is a translation unit. This lets translators change it to or whatever naming convention you want to use for categories. If it were outside the translation template, you would have all the pages Foo, Foo/de, Foo/ru, Foo/ta and so on in the same category. Sometimes this is okay, but usually it distracts the users. Make sure your translators know what the local convention is.

Similarly, for links there are many ways to do it. We used " Special:MyLanguage/Seagull ", which automatically redirects to the translated version of the page depending on the users' interface language (if that translation exists). This isn't an ultimate solution, because users will always be redirected to the interface language they're using, not to the language they are currently reading. Special:MyLanguage also interferes with Special:WhatLinksHere and makes it not work. The good thing about Special:MyLanguage is that you always get some version of the page, even if the requested translation doesn't exist.

最後に
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.

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.

You have now created a translatable page and tried all of the common actions that can be performed on translatable pages. For more information, or if you want to understand the feature more deeply, please continue reading on the in-depth documentation of page translation feature. It also contains discussion about different ways of handling links, categories and templates, or pros and cons of using larger or smaller translation units.