View source for Translating/HowTo/lang-ja

{{ Translation
  | lang = ja
  | source = Translating/HowTo
  | version = 80498 <!-- previously 58244 79575 80110　-->}}
{{Ongoing Translation}}
<!--
翻訳作業をややこしい作業にしている多くの問題があります。wiki自身の正に特長(原本が変化しやすい）が問題をややこしくしています。以下はwikiの中において均質な構造を維持するための手続きを示しています。以下の手続きが全ての人にさほど多くのオーバーヘッドを生ずることなく[[Translating|翻訳作業]]において協力を可能にしてくれることを願っています。
-->    
<!-- /* ID# 80110:原文はなんか絶望的でくらい。*/
翻訳作業は通常に難しい故に、多くの努力が必要です。原文が変化しやすいwikiの特徴は、それをさらに複雑にします。それらの問題は、いくつかの簡単なルールを応用し、翻訳で一致した作業方法を取り入れる事で賄う事が出来ます。このページに書いてある手順を基礎に誰もが気楽に[[Translating|翻訳作業]]に参加できるよう心から願っています。
-->
<!-- /* ID# 80498:原文はとてもいい響きがする。 */ -->
翻訳プロジェクトに参加するのはとても楽しく実り多いこともあります。しかし、原文が変化しやすいwikiの特徴は翻訳者の作業を困難にする場合もあります。それから来る問題は、いくつかの簡単なルールを応用し、翻訳で一致した作業方を取り入れることで賄えます。このページに書いてある手順を基礎に誰もが気楽に[[Translating|翻訳作業]]に参加できるよう心から願っています。

{{anchor|Step-by-step}}
== ステップバイステップ ==

wikiの観点からすると、翻訳ページを生成する基本的な３つのステップがあります：すなわち
# [[#Setting up the source page|ソースページの修正]] &mdash; 該当ページがまだ一度も翻訳されていない場合;
# [[#Modifying the language bar|参照の追加]] &mdash; 標準的的なやり方で翻訳ページを指定しリンクを張る; そして
# [[#Setting up the translated page|翻訳ページの状態設定]] &mdash; いくつかの補助的な構造情報の追加.
多くの場合、[[translators|翻訳者]]は最後の２つのステップをこなすだけでいいはずです。(翻訳の設定とリンクの追加）

wikiページの[[#Anatomy of a wiki-page|構造]] と、[[#Full finished example|完全に仕上げられた例]]は、このページの最後のほうで見ることができます。

{{ Translated text |
From the point-of-view of the wiki, there are basically three tasks to hook up a translated page:
# [[#Setting up the source page|modify the source page]] &mdash; if it has never been translated;
# [[#Modifying the language bar|adding a reference]] &mdash; point/link to the translation in a standard way; and
# [[#Setting up the translated page|conditioning the translated page]] &mdash; adding some helper structure.
Most of the time, [[translators]] will only deal with the last two steps (setting up and linking the translation). 

You can see an overview of the [[#Anatomy of a wiki-page|relevant structure]] of a page, and a [[#Full finished example|full finished example]] towards the end of this page.
| display = none}}

{{anchor|Setting up the source page}}
=== 元となるページの準備 ===

翻訳者であるあなたはOLPCチームによって維持されているページの翻訳を考えていると仮定します。すなわち[[Template:OLPC|<nowiki>{{OLPC}}</nowiki>]]テンプレート&mdash;このページはページ群を[[:Category:Pages maintained by OLPC]]カテゴリにグループ分けするものです&mdash;への参照を有し、多くの場合導入用ページか各国のコミュニティにとって明らかにより有用な情報を含んでいるページです。

もし翻訳しようとしているページに言語バーがあったならば、[[#Modifying the language bar]]の次の手続きにスキップして構いません。

<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <span style="font-size:80%">''(翻訳ページがまだ存在しない場合)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|}
</div>

{{anchor|Adding the language bar}}
==== 言語バーの追加 ====

ごく稀にではありますが、まだ誰も翻訳をしていないページを翻訳しようとすることがあるかもしれません。このような場合、オリジナルのページに翻訳ナビゲーションバーを追加する必要があります。

以下の例のように、オリジナルページの編集モードに入り、<nowiki>{{OLPC}}</nowiki>タグの下に'''<nowiki>{{Translations}}</nowiki>'''タグを追加してください。終わったら"save"を押して保存してから編集モードを抜けます。

<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <span style="font-size:80%">''(翻訳されたページがまだ存在しない場合)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 '''<nowiki>{{Translations}}</nowiki>'''
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|}
</div>

{{anchor|Setting up the /translations}}
==== /translationsページの準備 ====

次に画面上に新たに表示されているバーにある<tt><nowiki>[[Original page/translations]]</nowiki></tt>というリンクをクリックして翻訳ページ群をグループ化してくれる特別なページを編集します。編集の内容は以下のような感じです。すなわち<nowiki>[[Original page/translations]]</nowiki>という文字列を追加して下さい。ここで"Original page"は翻訳をしようとしているページのタイトルで置き換えます。

<div style="font-size:80%; ">
{| cellspacing=0

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page/translations]]</nowiki>

|- valign="top"
| 
 <nowiki>[[Original page|english]] | [[</nowiki>Original page/lang-[[#lang|xx]]|[[#language name|shortNativeName]]<nowiki>]]</nowiki>
|}
</div>

"save"を押して保存して編集モードを抜けると、バーの中の文字が赤いリンクになっているはずです。これはリンク切れ・リンク破損を意味し、この次にあなたの翻訳作業を待っている状態です。なので心配しないで下さい。次のステップでこれを修正できます。

{{ Translated text |

'''NOTE''': Although any name can be give to the translated page (ie: instead of "''[[The OLPC Wiki/lang-es]]''" it could be named as "''[[El Wiki de la OLPC]]''"), there is a clear advantage in sticking with the ''/lang-[[#lang|xx]]'' structure. The ''/lang-[[#lang|xx]]'' method allows a creation of ''<nowiki>#REDIRECT</nowiki>'' in the native language of the version made by the translator. Pages that do not use the ''/lang-[[#lang|xx]]'' structure do exit. Often these are leftovers from the times when there was no consensus on the structure and ways of adding translations.

    | display = none }}

'''注意'''： 翻訳されたページは好きに名前を付けていいですが、 (例："<tt>[[The OLPC Wiki/lang-es]]</tt>の代わりに<tt>[[El Wiki de la OLPC]]</tt>など) 翻訳者が選んだ言語で#REDIRECTが作成出きるため、<tt>/lang-[[#lang|xx]]</tt>の形式を使う方が優越です。<tt>/lang-[[#lang|xx]]</tt>を使わないページも存在しますが、それらは、過去に共通の形式や、一致した翻訳の追加方法がなかった時の残り物です。

{{anchor|Modifying the language bar}}
=== 言語バーの修正 ===

言語バーは下にある例のような形になっています。翻訳が可能なページは言語バーの右端に
<tt>'''+/-'''</tt>と記してあるリンクがあります。（以下の例には表示なし）このリンクは言語バーの編集ページへと継ぎます。言語バーに新しい言語を追加する時などの際に新リンクを追加する場合は、この<tt>'''+/-'''</tt>リンクをたどって編集ページへ進んで下さい。そこで適当なコードを記入し新しい言語の追加などの編集作業を行う事ができます。
<div style="font-size:80%; margin-left:10%; margin-right:10%; ">
{{Translations | {{:Bitfrost/translations}}}}
</div>

新しい言語ページへのリンクを追加する時に記入列を<tt>/lang-[[#lang|xx]]</tt>にともなった英字列の順序にするよう気をつけて下さい。（例えば、<tt>/lang-de</tt>は"english"より先行になりますので、その前に並びます。）言語リンクの間にあるセパレータ"|"の両側にはスペースがあるので、その事も忘れないで下さい。もっと詳しく知りたい時は[[#Setting up the/translations|<tt>翻訳の説明</tt>]]をご覧下さい。

{{anchor|Setting up the translated page}}
=== 翻訳ページの準備 ===

翻訳をする際に翻訳者は好きな様に編集や翻訳をする自由が捧げられていますが、タダ一つだけ守って頂けたいルールがあります。それは、翻訳されたページは[[Template:Translation|<nowiki>{{Translation}}</nowiki>]]として
宣言しなければなりません。ここでは単数を使っているのでご注意下さい。複数形の[[Template:Translations|<nowiki>{{Translation</nowiki>'''''s'''''<nowiki>}}</nowiki>]]は元のオリジナルページで使われ、これを基礎に様々な翻訳に分かれて行く構造になっています。

そのほかに翻訳作業の質を上げるのに役立つ方法がいくつかあります。　まず、作成時にページのリンクが簡単で優しく使えるようにすると便利です。その次に、原文を翻訳ページ内に保存しておくと査読の際に便利であったり、メンテナンスにも役立つ時があります。

ページをセットアップする時にもっとも手っ取り早いなやり方は、原文の'''wiki-text'''を単純にコピーして翻訳ページに張り付ける方法です。その場合、編集リンクをたどるか、またはページがロックされているなら''view source''を応用して下さい。その後、全ページを丸ごとコピーして新ページに張り付けます。

{{anchor|Adding the [[Template:Translation|Translation template]]}}
==== [[Template:Translation|Translation template]]の追加 ====

<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <nowiki>[[</nowiki>Original page/lang-[[#lang|xx]]<nowiki>]]</nowiki><span style="font-size:80%"><br>''(translated page name)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{Translations}}</nowiki>
 
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|
 <nowiki>{{OLPC}}</nowiki>
 '''<nowiki>{{</nowiki>Translation'''
  '''&#124; lang = [[#lang|xx]]'''
  '''&#124; source = [[#source|Original page]]'''
  '''&#124; version = [[#version|yyyy]]<nowiki>}}</nowiki>'''
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|}
</div>

もっと詳しいパラメータの説明は下にある[[#Notes|Notes (ノート)]]をご覧下さい。 '''lang''' &mdash;は[http://www.iana.org/assignments/language-subtag-registry IANA language code (IANA言語コード）]を使います。ほとんどは2文字だけの長さで、それ以上の区切りは必要ありません。&mdash;例：ブラジル系ポルトガル語の場合''<tt>lang-pt-BR</tt>''ではなく、ただシンプルで中立的にするために''<tt>lang-pt</tt>''とします。

{{anchor|Adding the [[Template:Ongoing Translation|Ongoing Translation template]]}}
==== [[Template:Ongoing Translation|Ongoing Translation template]]の追加 ====

<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <nowiki>[[</nowiki>Original page/lang-[[#lang|xx]]<nowiki>]]</nowiki><span style="font-size:80%"><br>''(translated page name)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{Translations}}</nowiki>
 
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{</nowiki>Translation
  &#124; lang = [[#lang|xx]]
  &#124; source = [[#source|Original page]]
  &#124; version = [[#version|yyyy]]<nowiki>}}</nowiki>
 '''<nowiki>{{</nowiki>Ongoing Translation<nowiki>}}</nowiki>'''
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|}
</div>

[[Template:Ongoing Translation|<nowiki>{{Ongoing Translation}}</nowiki>]]の主な役目は、ほかのユーザにそのページの翻訳はまだ未完成だと伝える事です。その情報を元に未翻訳のテキストや査読不足の部分などの存在があらかじめ予期できます。他にも、別の翻訳者が編集や査読、それにコメント追加などの活動に参加してもうためのお知らせとして、[[:Category:Ongoing Translation|Ongoing Translation category]]にページを加える役目も果たしております。

{{anchor|Translating section headers}}
==== セクションヘッダの翻訳 ====

セクションヘッダを翻訳する際に最も効率のいい方法は、それらのヘッダをアンカーとして保存して、その下に翻訳されたヘッダを書き入れます。

例として、原文のセクションヘッダが"Some Section Header"で、ドイツ語に"Einige Paragraph Kopfzeile"と訳されます。その場合、原文の"Some Section Header"をカーリーブレースの間に囲んで以下の様に保存します。

    <nowiki>{{anchor|Some Section Header}}</nowiki>

その後、訳されたヘッダ"Einige Paragraph Kopfzeile"を下に書き入れます。両方を合わせて完成すると下記の例に似た形になります。

    <nowiki> {{anchor|Some Section Header}} </nowiki>
    <nowiki>== Einige Paragraph Kopfzeile ==</nowiki>


<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <nowiki>[[</nowiki>Original page/lang-[[#lang|xx]]<nowiki>]]</nowiki><span style="font-size:80%"><br>''(translated page name)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{Translations}}</nowiki>
 
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{</nowiki>Translation
  &#124; lang = [[#lang|xx]]
  &#124; source = [[#source|Original page]]
  &#124; version = [[#version|yyyy]]<nowiki>}}</nowiki>
 <nowiki>{{</nowiki>Ongoing Translation<nowiki>}}</nowiki>
 
 '''<nowiki>{{anchor|Some header}}</nowiki>'''
 <nowiki>== Un titular ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 '''<nowiki>{{anchor|Another header}}</nowiki>'''
 <nowiki>== Otro titular ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|}
</div>


{{anchor|Translating links}}
==== リンクの翻訳 ====

リンクを翻訳する場合、原文のリンクはパイプリンクを使って保存します。原文と訳文の間に"|"シンボルをおき、両方がパイプを通してつながります。例として、もし原文の"some-link"がドイツ語で"einige-link"と訳されるなら下の様な形をとります。

    <nowiki>[[some-link|einige-link]]</nowiki>

結果的に訳されたリンク"einige-link"を追うと、パイプを通し原文の"some-link"へと進みます。
Wikiを読む読者には、訳されたリンク"einige-link"だけしか見えません。

{{anchor|Linking to a page in particular language}}
==== 特定の言語ページへのリンク ====

特定の言語に翻訳されているページへのリンクを作成したいなら、/lang-xxを使ってそのページへ継いで下さい。

    <nowiki>[[some-link/lang-de|einige-link]]</nowiki>

{{anchor|Translating texts}}
==== テキストの翻訳 ====

通常のテキスト翻訳では、原文を[[Template:Translated_text|<nowiki>{{Translated text}}</nowiki>]]関数の中に入れると便利です。原文を表に出すか出さないかは"display = ''value''"パラメータで操作できます。

原文を裏に隠す ( display = none )

    <nowiki>
    {{ Translated text |
     
　　    　　原文テキスト
　　　　    もっと、原文テキスト
　　　　    さらにもっと、原文テキスト
　　　　    最後の原文テキスト
      
       | display = none }}
    </nowiki>


原文を表に出す ( display = block )

    <nowiki>
    {{ Translated text |
     
　　   　　原文テキスト
　　　   　もっと、原文テキスト
　　　　   さらにもっと、原文テキスト
　　　　   最後の原文テキスト
      
       | display = block }}
    </nowiki>

詳しい説明は[[Template:Translated_text|ここ]]をご覧下さい。


<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <nowiki>[[</nowiki>Original page/lang-[[#lang|xx]]<nowiki>]]</nowiki><span style="font-size:80%"><br>''(translated page name)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{Translations}}</nowiki>
 
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{</nowiki>Translation
  &#124; lang = [[#lang|xx]]
  &#124; source = [[#source|Original page]]
  &#124; version = [[#version|yyyy]]<nowiki>}}</nowiki>
 <nowiki>{{</nowiki>Ongoing Translation<nowiki>}}</nowiki>
 
 '''<nowiki>{{anchor|Some header}}</nowiki>'''
 <nowiki>== Un titular ==</nowiki>
 
 Algo de texto bla... <br>bla... <nowiki>[[</nowiki>#Another header'''|Otro titular'''<nowiki>]]</nowiki> <br>... blah
 <nowiki>{{ Translated text |</nowiki>
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 &#124; display = [[#display|block]]<nowiki>}}</nowiki>
 
 '''<nowiki>{{anchor|Another header}}</nowiki>'''
 <nowiki>== Otro titular ==</nowiki>
 
 Algo más de texto bla... <br>bla... <nowiki>[[</nowiki>Another page'''/lang-[[#lang|xx]]|Otra página'''<nowiki>]]</nowiki> <br>y <nowiki>[[</nowiki>Another page'''/lang-[[#lang|xx]]#section|sección'''<nowiki>]]</nowiki> <br>... bla
 <nowiki>{{ Translated text |</nowiki>
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
 &#124; display = [[#display|block]]<nowiki>}}</nowiki>
|}
</div>

{{anchor|Handling translated links that point to a non-existant page}}
==== 翻訳されたリンクがまだ存在しないページへ続くときの対策 ====

初めて作成するとき翻訳されたリンクは、まだ存在しないページへよく継ぐ場合が多いでしょう。あまり心配しないで下さい。これには、二つの対策方があります。
* [[Special:Wantedpages]]を通して、全てwikiにまかす。
* dedicated redirects作成のため、さらに翻訳作業をおこなう。
一番目の選択は簡単に行う事が出来ますが、読者を'create page option' (ページ作成オプション)へ継ぐため、とても迷惑な事になります。その上、それらの'wanted pages' (ページ作成願い)は他の'missing translated pages' (存在しない翻訳されたページ)と一緒のリストに含まれるため、特定の言語ページを探査する際に困難になります。

お勧めする方法は二番めの選択で、<tt><nowiki>[[</nowiki>Foo/lang-[[#lang|xx]]<nowiki>]]</nowiki></tt>から<tt><nowiki>[[Foo]]</nowiki></tt>へのリダイレクトを作り、そのリダイレクトを特定の言語専用のカテゴリへ付け加えます。

<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[</nowiki>Another page/lang-[[#lang|xx]]<nowiki>]]</nowiki>

|- valign="top"
|
 <nowiki>#REDIRECT [[Another page]]</nowiki>
 <nowiki>[[</nowiki>Category:Translations wanted lang-[[#lang|xx]]<nowiki>]]</nowiki>
|}
</div>

'''警告'''：'''絶対に確かめないといけない'''のは、原文が'''リダイレクト'''へリンク'''されていない'''事です。もしそうである場合、ターゲットを本物のページに変えて、そこで<tt>/lang-[[#lang|xx]]</tt>サブページを作ります。例えば、もし、<tt><nowiki>[[Foo]]</nowiki></tt>が<tt><nowiki>[[Bar]]</nowiki></tt>へのリダイレクトだとしたら<tt><nowiki>[[</nowiki>Foo/lang-[[#lang|xx]]<nowiki>]]</nowiki></tt>ではなく、代わりに<tt><nowiki>[[</nowiki>Bar/lang-[[#lang|xx]]<nowiki>]]</nowiki></tt>を作り必要に応じて'referencing link' (リファレンシング リンク)を変えます。

それには三つの目的があります。まず初めに、そのページは少なくとも読者を正しいページへ送ります。(たとえそれが違う言語であっても。）次に、言語専用のカテゴリは、'what is missing' (欠けているページ)の探査を簡単にすることができます。最後に、toolbox (ツールボックス)から'What links'(どんなリンク）を使って、その欠けているページへの参照の数がいくらあるかを探し出すこととができます。それを基礎に翻訳作業で一体どこで何が必要になっているかある程度分かります。

まだ存在しない翻訳の宣伝をしても意味がないので、/translationsページに'fake translation redirect' (フェーク翻訳リダイレクト)は'''付け加えない'''でください。リダイレクトが実際の翻訳に(たとえ作業中だあっても）なった後にだけ、リンクを言語ナビゲーションバーに追加してください。

{{anchor|Full example of a wiki-page}}
== wikiページの完全なサンプル ==

{{anchor|Anatomy of a wiki-page}}
=== wikiページの改造 ===

<div style="font-size:80%; ">
{| 
{{ Translated text |
|+ This 'sample' page includes all of the elements that require some level of consideration when translating
   | display = none }}

|+ ここにあるサンプルページは翻訳作業中に、ある程度考慮に入れるべき全ての要素を表示しています。

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! Notes on the structure

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 
 '''<nowiki>== Some header ==</nowiki>'''
 
 Some text blah... <br>blah... '''<nowiki>[[#Another header]]</nowiki>''' <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... '''<nowiki>[[Another page]]</nowiki>''' <br>and '''<nowiki>[[Another page#section|section]]</nowiki>''' <br>... blah
| <br>
{{ Translated text |
; <tt><nowiki>== Some header ==</nowiki></tt> : section headers act as anchors, and their translation is sensitive as they ''anchor'' incomming links.
   | display = none }}
; <tt><nowiki>== Some header ==</nowiki></tt> : セクションヘッダはアンカーとして活用され、それの翻訳文はつながってくるリンクをアンカーしますので感度があります。
{{ Translated text |
; <tt><nowiki>[[#Another header]]</nowiki></tt> : intra-page section linking may be simple to maintain as it's within the same page (you can search&replace local references) but will break external inbound links if changed.
   | display = none }}
; <tt><nowiki>[[#Another header]]</nowiki></tt> : ページ内で各セクションをリンクするなら、同じページ内ですから(ローカル　リファレンスのサーチ & リプレースができ)わりと簡単にできますが、代わりに、もし変更があったらページ外へのリンクは途切れてしまいます。
{{ Translated text |
; <tt><nowiki>[[Another page]]</nowiki></tt> : the most common problem with links to other pages is to know how the page title has been translated...
   | display = none }}
; <tt><nowiki>[[Another page]]</nowiki></tt> : 他のページへのリンクに関して最も出くわす問題は、一体どんな形でページのタイトルが訳されたかを知ることです...
{{ Translated text |
; <tt><nowiki>[[Another page#section|section]]</nowiki></tt> : links to specific sections in other pages pose the conflated problem of knowing ''both'' the target page name '''and''' the section name's translations.
   | display = none }}
; <tt><nowiki>[[Another page#section|section]]</nowiki></tt> : ほかのページに存在する特定のセクションへのリンクは、問題としてターゲット・ページ名および翻訳されたセクション名の両方を知らなければなりません。
|}
</div>

{{anchor|Full finished example}}
=== 完全に仕上がった状態の例 ===
<div style="font-size:80%; ">
{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page]]</nowiki> !! <nowiki>[[</nowiki>Original page/lang-[[#lang|xx]]<nowiki>]]</nowiki><span style="font-size:80%"><br>''(translated page name)''</span> !! Translated text deleted...<span style="font-size:80%"><br>''(not really recommended)''</span>

|- valign="top"
| 
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{Translations}}</nowiki>
 
 
 <nowiki>== Some header ==</nowiki>
 
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 
 
 <nowiki>== Another header ==</nowiki>
 
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
|
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{</nowiki>Translation
  &#124; lang = [[#lang|xx]]
  &#124; source = [[#source|Original page]]
  &#124; version = [[#version|yyyy]]<nowiki>}}</nowiki>
 <nowiki>{{</nowiki>Ongoing Translation<nowiki>}}</nowiki>
 
 <nowiki>{{anchor|Some header}}</nowiki>
 <nowiki>== Un titular ==</nowiki>
 
 Algo de texto bla... <br>bla... <nowiki>[[#Another header|Otro titular]]</nowiki> <br>... blah
 <nowiki>{{ Translated text |</nowiki>
 Some text blah... <br>blah... <nowiki>[[#Another header]]</nowiki> <br>... blah
 &#124; display = [[#display|block]]<nowiki>}}</nowiki>
 
 <nowiki>{{anchor|Another header}}</nowiki>
 <nowiki>== Otro titular ==</nowiki>
 
 Algo más de texto bla... <br>bla... <nowiki>[[</nowiki>Another page/lang-[[#lang|xx]]|Otra página<nowiki>]]</nowiki> <br>y <nowiki>[[</nowiki>Another page/lang-[[#lang|xx]]#section|sección<nowiki>]]</nowiki> <br>... bla
 <nowiki>{{ Translated text |</nowiki>
 Some other text blah... <br>blah... <nowiki>[[Another page]]</nowiki> <br>and <nowiki>[[Another page#section|section]]</nowiki> <br>... blah
 &#124; display = [[#display|block]]<nowiki>}}</nowiki>
|
 <nowiki>{{OLPC}}</nowiki>
 <nowiki>{{</nowiki>Translation
  &#124; lang = [[#lang|xx]]
  &#124; source = [[#source|Original page]]
  &#124; version = [[#version|yyyy]]<nowiki>}}</nowiki>
 
 <nowiki>{{anchor|Some header}}</nowiki>
 <nowiki>== Un titular ==</nowiki>
 
 Algo de texto bla... <br>bla... <nowiki>[[#Another header|Otro titular]]</nowiki> <br>... blah
 
 <nowiki>{{anchor|Another header}}</nowiki>
 <nowiki>== Otro titular ==</nowiki>
 
 Algo más de texto bla... <br>bla... <nowiki>[[</nowiki>Another page/lang-[[#lang|xx]]|Otra página<nowiki>]]</nowiki> <br>y <nowiki>[[</nowiki>Another page/lang-[[#lang|xx]]#section|sección<nowiki>]]</nowiki> <br>... bla
|}
</div>

Supporting pages:

<div style="font-size:80%; ">
{| cellspacing=0

|- valign="top" style="background:lightgray; "
! <nowiki>[[Original page/translations]]</nowiki>

|- valign="top"
| 
 <nowiki>[[Original page|english]] | [[</nowiki>Original page/lang-[[#lang|xx]]|[[#language name|shortNativeName]]<nowiki>]]</nowiki>
|}

{| 

|- valign="top" style="background:lightgray; "
! <nowiki>[[</nowiki>Another page/lang-[[#lang|xx]]<nowiki>]]</nowiki>
! <nowiki>[[Another page]]</nowiki>

|- valign="top"
|
 <nowiki>#REDIRECT [[Another page]]</nowiki>
 <nowiki>[[Category:Missing translation]]</nowiki>
|
 ''some untranslated page...''
 ''maybe the content is mutating rapidly,''
 ''or is peripheric to the main corpus, etc.''
|}
</div>

== ノート ==

{{anchor|language name}}
{{ Translated text |
; shortNativeName : should be in the native language; <tt>español</tt> instead of <tt>spanish</tt>.
   | display = none }}
; shortNativeName (ショート・ネイティブ・ネーム) : つづりはその国の母国語であるべき：例えば"spanish"ではなく"español"。

{{anchor|[[Template:Translation|Translation template]] notes}}
=== [[Template:Translation|Translation template]] notes (翻訳テンプレート ノーツ) ===

{{ Translated text |
For the full documentation, please see [[Template:Translation]].
   | display = none }}
完全なドキュメンテーションが必要なら[[Template:Translation]]をご覧下さい。

{{anchor|lang}}
{{ Translated text |
; lang : This parameter identifies the target language of the translation. See [http://www.iana.org/assignments/language-subtag-registry IANA's lang codes].
: It serves several purposes, and is used in several contexts although it should be done in a homogeneous way.
: We are currently using ISO 639-1 codes (two-letter codes), although we should probably migrate to 639-3 (three letter codes).
   | display = none }}
; lang (言語) : このパラメータは翻訳のターゲット言語を識別します。[http://www.iana.org/assignments/language-subtag-registry IANA言語コード]をご覧下さい。それにはいくつかの目的があり、均質的に進めなければなりませんが、いくつかのコンテクストに使われます。現在使われているコードはISO 639-1 (2文字コード)です。しかしISO 639-3 (3文字コード)へ移る必要があるでしょう。

{{anchor|source}}
{{ Translated text |
; source : is the name of the page (not the link&mdash;in other words, without the enclosing square brackets).
   | display = none }}
; source (ソース) : ページ名です。リンクではありませんから、それから角かっこを外した文です。
{{anchor|version}}
<!--
; version : is a bit of a tricky until you understand it, but extremely helpful.
: The number associated with the parameter comes from the '''original''' page, and has been made explicit in the blue language navigation bar at its right: <tt>'''[ID# ''yyyyy'']'''</tt>.
: Pages in the wiki have a ''numeric id'', and each edition creates a new ID. So when you start translating a page, you want to register which ''version'' you started from. When at some point the source page is modified, its current version will have a higher version number. If you follow the ''changes'' link in the translation blue bar, the system will report all the changes done in that page from the ID# you started from. Once you update the translation, '''do not forget to update''' the version # to match the latest sync'ed to number!
: So when you compare the differences between two pages, internally you are comparing two IDs between them. 
: For example [http://wiki.laptop.org/index.php?title=Template%3ATranslation&diff=35092&oldid=39128 this diff] is actually comparing two pages, NOT two versions of the same page&mdash;admitedly, they are very similar.
-->
{{ Translated text |
; version : Each original page has a unique version number. These version numbers appear on the far right of the 'blue language navigation bar', and appear in the form: <nowiki>[</nowiki>ID# yyyyy<nowiki>]</nowiki>

: When a page edit is submitted, the version number for that particular page is incremented.

: A translated page on the other hand does not have a visible version number on its own. It must be manually assigned by the translator when an edit is submitted. The version number of a translated page is the same as the version number of the original page which it is based on.

: For example if the original page has a version number ID<nowiki>#</nowiki> 54321, and the translatation is based on this particular version, the translated page is given the version number ID<nowiki>#</nowiki> 54321.

: The version number for the translated page is entered at the top of the page as a parameter for the [[Template:Translation|<nowiki>{{</nowiki>Translation<nowiki>}}</nowiki>]] function.

: <nowiki>{{</nowiki> Translation
::       | lang    = de
::       | source  = Translating/HowTo
::       | '''version = 54321''' <nowiki>}}</nowiki>

: There is one use which results directly from the above manual assignment of a version number to the translated page. It allows the translator to easily lookup what new translations are needed by following the 'changes' link located to the far right of the 'blue language navigation bar'.

: Suppose translator 'A' is making a translation of page [[Bitfrost]] with version number ID# 65535 into español. As per this guide, translator 'A' assigns version number ID# 65535 to the Bitfrost/lang-es español translated page. Meanwhile editor 'B' arrives and edits the original [[Bitfrost]] page and its version number is incremented to ID# 6553'''6'''. Translator 'A' then can see what new translations are necessary by followoing the 'changes' link located on the blue nav bar. The 'changes' link compares the differences of two versions of the original page ID# 6553'''5''' and ID# 6553'''6'''. By observing the resulting output, translator 'A' could easily see what new text needs to be translated.
   | display = none }}

; version (バージョン) : 各原文はそれにだけ与えられた唯一のバージョン番号があります。このバージョン番号は青色の言語ナビゲーション・バーの右端にあり、<nowiki>[</nowiki>ID# yyyy<nowiki>]</nowiki>の形式をとります。

: ページ編集が提出される際にそのページのバージョン番号が増加します。

: 翻訳ページの場合はまた別で、目に見えるバージョン番号はありません。編集を提出する際に、翻訳者が手動で記入しなければなりません。翻訳ページのバージョン番号は翻訳を元にした原文のバージョン番号と一致しています。

: 例として、もし、原文のバージョン番号がID<nowiki>#</nowiki> 54321で、それを元にした翻訳ページは同じバージョン番号ID# 54321が与えられます。

: 翻訳されたページのバージョン番号はページ最上に[[Template:Translation|<nowiki>{{</nowiki>Translation<nowiki>}}</nowiki>]]関数のパラメータとして記入されます。

: <nowiki>{{</nowiki> Translation
::       | lang    = de
::       | source  = Translating/HowTo
::       | '''version = 54321''' <nowiki>}}</nowiki>　　<------- '''ここ'''です。

: 手動で記入する翻訳ページへのパージョン番号から直接得られる一つの利用法があります。　翻訳が煽青色の言語ナビバーの右端に設置してある'changes' (変更)リンクをたどり、手軽にどの様な新翻訳が必要なのかを確かめることができます。

: 例えば、翻訳者'A'がバージョン番号ID<nowiki>#</nowiki> 65535の[[Bitfrost]]ページをespañolに翻訳するとします。このガイドのとおり翻訳者'A'は原文にちなんでespañolに翻訳されたページ/lang-esにバージョン番号ID# 65535を与えます。もし、その間に編集者'B'が原文の[[Bitfrost]]を編集して、そのページのバージョン番号がID# 6553'''6'''に変わるとします。翻訳者'A'は青色の言語ナビバーの右端にある'changes' (変更)リンクをたどって、どの様な新しい翻訳が必要なのかを見ることができます。 'changes'(変更)リンクは原文のバージョン番号ID# 6553'''5'''とID# 6553'''6'''の違いを比較します。 翻訳者'A'は、そこから出るアウトプットを元に容易く翻訳が必要な新テキストを見る事が出来ます。

{{anchor|[[Template:Translated text|Translated text]] template notes}}
=== [[Template:Translated text|Translated text]]テンプレートノート ===

{{anchor|display}}
{{ Translated text |
; display : is used to show or hide the enclosed translated text.
: While doing the translation, it comes in handy for comparing the original with the translation. When finished, you can replace the ''block'' with ''none'' and the source text is not displayed. Although it adds quite a bit of text and 'noise' to the source of the translated page, it comes in handy when trying to update or synchronize it with any changes in the original page&mdash;after all, this IS a wiki and pages are supposed to mutate!
   | display = none }}
; display : これでテキストを隠したり、表に出したりします。
: 翻訳を行っているときに原文と翻訳文が比較出来ると便利です。作業が終わった後に''<nowiki>'</nowiki>block<nowiki>'</nowiki>''を''<nowiki>'</nowiki>none<nowiki>'</nowiki>''に変えることができます。その場合、原文は裏に隠れます。翻訳ページのソースにある程度のテキストとノイズを追加しますが、アップデートやシンクロナイズの際に約に立ちます。そうは言っても、wikiですのでページなどは当たり前に変化するべきです。

[[Category:Language support]]
[[Category:HowTo]]