JDOC

Page Translation Quickstart Guide/ja: Difference between revisions

From Joomla! Documentation

← Older edit
No edit summary
mNo edit summary
 
(188 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<noinclude><languages /></noinclude>
<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。
ドキュメント翻訳を始める際は、まずこのページをご覧ください。ページ翻訳に関する詳細は[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を参照ください。翻訳者として登録するには[[JDOC:Documentation Translators|ドキュメントの翻訳者]] にてユーザー名を登録してください。


既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.
<div class="mw-translate-fuzzy">
ユーザーIDが承認されれば、[https://docs.joomla.org/index.php?title=Special%3ALanguageStats&x=D&language=en&suppresscomplete=1&group=page-Chunk30%3AHelp+screen+column+header+Search+Term 言語別翻訳状況]で自分の言語に翻訳するドキュメントを見つけることができます。
</div>
翻訳用のドキュメントを新しいウィンドウで開くと、翻訳する部分のリストが表示されます。上部には、翻訳しているドキュメントへのリンクがあります。これを新しいウィンドウで開いて照らし合わせながら、一方の画面で翻訳し、もう一方の画面で何を翻訳したかを確認できます。
 
翻訳者登録が済んだら[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で使い方を練習してみましょう。
 
ドキュメントの一部が翻訳用にどのようにマークされているかを知っておくとよいでしょう。
一般的にはこのようになります
<code><nowiki><translate><T:number>Text to translate</translate></nowiki></code> 翻訳する際は ''Text to translate''の部分を翻訳します <code><nowiki><translate></translate></nowiki></code>は翻訳が必要な部分にマークが付けられ、<code><nowiki><T:number></nowiki></code>はシステムによって行われます。


== インターフェース ==
== インターフェース ==
ページの翻訳が可能な場合、以下の図・翻訳状況を見ることができます。
翻訳が可能なページで、全く未翻訳の場合は「このページを翻訳」、翻訳が途中のページには、その下の画像のような表示がページの上部に表示されています。


<div class="panel" style="max-width:340px;">
<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
[[File:JDOC-translate-page-notice-ja.png|翻訳できるページにはこのような記述があります]]
</div>
</div>


<div class="panel" style="max-width:600px;">
<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
[[File:JDOC-translate-page-notice-nl-ja.png|日本語でローカライズされた場合の進捗を表す記述]]
</div>
</div>


After you click the translation link, you will then see the following interface for translation. Documentation now has a ULS (Universal Language Selector) installed which will automatically set the user interface to their localised language. This is based on the browser (its language setting) and/or geographic location. The language setting may also be overridden manually by selecting the user icon (top right) and from the dropdown click on the language at the very top. You may also go to your user [[Special:Preferences#mw-prefsection-personal-i18n|personal preferences for language]].
「このページを翻訳」もしくは「翻訳」の文字をクリックしたら、以下の画像のような翻訳インターフェイスが表示されます。ドキュメントにはULS (Universal Language Selector) がインストールされていて、自動的にローカライズ言語が設定されています。これはブラウザ設定（言語設定）や地理的位置に基づいています。言語設定は、ユーザーアイコン（1番右上）を選択し、ドロップダウンリストの一番上にある言語をクリックして手動で上書きすることもできます。また個別に[[Special:Preferences#mw-prefsection-personal-i18n|言語設定]]から行うこともできます。
<div class="panel">
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
[[File:JDOC-translator interface-first-view-ja.png]]
</div>
</div>


Now you are ready to translate, click any link in the separated message units.
パーツ単位で任意のリンクをクリックして、翻訳にとりかかりましょう。
<div class="panel">
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
[[File:JDOC-translator interface-editing-view-en.png]]
</div>
</div>


You may click the suggested text to add it automatically to the edit window. Then you may edit the text. The suggested text is provided by translation services for free. There is no guarantee there will be suggested text. The suggestion query may time out at the translation services server.
右横に表示された「提案」で候補にある翻訳をクリックして自動的に編集画面に翻訳を入れることができます。そこから適宜テキストを修正できます。翻訳候補テキストは翻訳サービスが無料で提供していますが、すべてのパーツに翻訳候補が入っているとは限りません。翻訳候補のクエリは翻訳サービスサーバがタイムアウトして表示されないことがあります。


When you are satisfied with your translation, save it. You can also skip sections if you only want to translate some of the message groups.
翻訳ができあがったら「翻訳を保存」ボタンを押して保存します。別の部分を翻訳したい場合は「次へスキップ」ボタンを押して今翻訳中のパーツをスキップできます。


==Page Titles==
==ページタイトル==
Page titles '''can and should''' be translated. They are the first message group at the top of the editing interface.
ページタイトルは '''翻訳できるので翻訳'''してください。タイトルは編集画面のメッセージグループの上部にある太字の部分です。
{{warning|title=Important!|'''Do not translate the namespace!''' This is anything in a title proceeding and including the : (colon).}}
{{warning|title=重要！|'''ネームスペースは翻訳せず省いてください！''' : （コロン）より前の部分はタイトルの処理上表示されています。}}


A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".
ページ名がネームスペースの後ろに入っている場合　→　"'''Prefix:'''ページ名"


This page name is not in a namespace when it looks like this: "Name of page".
ネームスペースが入っていないページ名　→　"ページ名"


{| class="wikitable"
{| class="wikitable"
! Correct? !! Title Examples
! 正誤 !! タイトルの例
|-
|-
| '''Yes!!!'''
| '''正'''
|"J2.5:Title of a Page" translated "Título de la página"
|"J2.5:Title of a Page" → "ページのタイトル"


"J2.5:Title of a Page" translated "Titel einer Seite"
"J2.5:Title of a Page" → "Titel einer Seite"
|-
|-
| '''NO!'''
| '''誤'''
|"J2.5:Title of a Page" translated "J2.5:Título de la página"
|"J2.5:Title of a Page" → "J2.5:ページのタイトル"


"J2.5:Title of a Page" translated "J2.5:Titel einer Seite"
"J2.5:Title of a Page" → "J2.5:Titel einer Seite"
|}
|}


== Links ==
== リンク ==
{{warning|title=Important Information about links|Please review this carefully, linking between pages will affect browsing in any language different than the source language. The objective is to provide links localised in the browsing user's language, linking to the browsing user's language view of a translated page.}}
{{warning|title=リンクに関する重要な情報|必ず確認してください。ページ間のリンクは、ソース言語とは異なる任意の言語での閲覧に影響を及ぼします。閲覧者がそのユーザの言語に翻訳されたドキュメントで閲覧できるようにするのが目的です。}}


The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|Translating Links]].
以下の情報が簡単な概要となっています。より詳細な説明については[[S:MyLanguage/JDOC:Translating_Links|リンクの翻訳]]を参照ください。


===Standard Internal Page Links===
===標準内部ページリンク===
Hyperlinks to another page are easy in the source language, they are page names between <code><nowiki>[[ (brackets) ]]</nowiki></code> or the variations as listed below. Good source page standards for page links will start to include the proper link markup for translated navigation.
ソース言語で別のページへリンクさせるのは簡単です。<code><nowiki>[[ (brackets) ]]</nowiki></code>ページ名をこのようにブラケットで囲む、またアレンジ方法は以下に記載されています。ページリンクのための良いソースページ規格は、翻訳されたナビゲーションに適切なリンクのマークアップが含まれるようにします。


#<code><nowiki>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox]]</nowiki></code> は [[JDOC:Translation Sandbox]] となります。
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> は [[JDOC:Translation Sandbox|Translation Sandbox]] となります。
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translator Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> は [[JDOC:Translation Sandbox|Translator Sandbox]] となります。


Links from a translated page to a page in the same language must be run through a localisation link processor.
翻訳されたページから同じ言語でリンクさせるにはローカリゼーションリンクプロセッサを介して実行する必要があります。


#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox]]</nowiki></code> becomes [[Special:MyLanguage/JDOC:Translation Sandbox]]{{-}}This above really isn't a nice looking link, nor is it shown in the reader's language. To improve the user experience, see the Dutch translation example link below.
#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox]]</nowiki></code> は [[Special:MyLanguage/JDOC:Translation Sandbox]] となります。{{-}}上記は読み手の言語にもなっておらず、あまり見栄えの良いリンクではありません。ユーザーエクスペリエンスを改善するためには、以下のオランダ語の翻訳例のリンクを参照してください。
#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]</nowiki></code> becomes [[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]{{-}}Now a Dutch reader will see the link in their language. Just the same as above, you can name the link anything.
#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]</nowiki></code> は [[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]] となります。{{-}}これでオランダ語で閲覧する人は自国の言語でリンクを読むことができます。上記のように、リンクの任意名を付けることができます。


There is an alias to the word <code>Special:</code>, so you may also use just the letter <code>S:</code> as a short version of <code>Special:</code>.
<code>Special:</code> にはエイリアスがあります。<code>S:</code> とだけ書いて<code>Special:</code> の短縮バージョンとして利用できます。


====Important Link Tips====
====需要なリンクのヒント====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* 常にこのように <pre>[[Special:MyLanguage/<source language pagename>|<ここに訳>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
* またはこのように書いてください。<pre>[[S:MyLanguage/<source language pagename>|<ここに訳>]]</pre>
An example would be:
例:


<pre>
<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]  
[[JDOC:Translation Sandbox|Translation Sandbox]]  
   is translated as
   は
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
  or
  または
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
となります。
</pre>
</pre>


'''So Remember''': Always add Special:MyLanguage/ in front of the the <nowiki><source page name></nowiki>. The <nowiki><source page name></nowiki> is always untranslated. Always add a | if it is missing and then the translation of <nowiki><source page name></nowiki>.
'''まとめ''': 常に <nowiki><source page name></nowiki>の前に Special:MyLanguage/ を付加してください。<nowiki><source page name></nowiki> は常に翻訳不要です。リンクの翻訳がない場合は「|」を追加してその後ろに翻訳テキストを入れてください。
この<code><nowiki>Special:MyLanguage/</nowiki></code>は原文ですでに付加されていることが多いです。つまり原文に<code><nowiki>Special:MyLanguage/JDOC:Translation Sandbox|<translate>Translation Sandbox</translate></nowiki></code>がある場合は、<code><nowiki>Translation Sandbox</nowiki></code>だけを翻訳すればよくURLの代わりに表示されます。


===External Links===
===外部リンク===
External links are easy to translate. They are written like this in the source language.
外部リンクの翻訳は簡単です。これらはソース言語で、次のように書かれています。


# <code><nowiki>http://www.php.net</nowiki></code> becomes http://www.php.net
# <code><nowiki>https://www.php.net/</nowiki></code> は https://www.php.net/ となります。
# <code><nowiki>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]
# <code><nowiki>[https://www.php.net/ PHP情報について]</nowiki></code> は [https://www.php.net/ PHP情報について] となります。


'''What to translate?'''  
'''何を翻訳すればいいの？'''  
# This is a standard URL and will not require translating. <code><nowiki>http://www.php.net</nowiki></code> It is a regular hyperlink and must be written as such. No translation required.
# これは標準的なURLですので翻訳を必要としません。 <code><nowiki>https://www.php.net/</nowiki></code> は通常のハイパーリンクであり、そのように記述する必要がありますが翻訳は不要です。
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.
# <code><nowiki>[https://www.php.net/ PHP情報について]</nowiki></code> これは'''PHP情報について'''の部分のみ翻訳が必要です。


== Categories ==
== カテゴリ ==
{{warning|title=Categories Require a Specific Method!|One thing to be aware of is that when translating a page, any 'category' links in the page should be modified to also include the appropriate language code.}}
{{warning|title=カテゴリはでは特定の方法を必要とします！|注意すべきことの1つは、ページを翻訳する際、ページ内の任意の「カテゴリ」リンクはまた、適切な言語コードを含むように修正すべきであることです。}}


The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.
カテゴリの翻訳はとても簡単です。'''/<language code>''' をカテゴリ名の最後に付けるだけです。


===Do This===
===こうやります===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
例えば、英語からスペイン語（言語コードはes）にページを翻訳する場合でそのページに次のカテゴリが含まれている時：
<pre><nowiki>[[Category:Development]]</nowiki></pre>
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
'''/es''' をカテゴリ名の最後に付ける必要があります。
<pre><nowiki>[[Category:Developement/es]]</nowiki></pre>
<pre><nowiki>[[Category:Developement/es]]</nowiki></pre>


Category pages can be translated as well (which should be quick - most are blank except for containing a parent category) and will be part of a special categorisation project when ready.
カテゴリページは同様に（ほとんどが親カテゴリを含むを除く空白）翻訳することができ、場合によって特別な分類プロジェクトの一部に準備されます。


===Do Not Do This===
　 '''/ja|開発''' ををカテゴリ名の最後に付ければ日本語になります
There are a few things you should not do.
<pre><nowiki>[[Category:Developement/ja|開発]]</nowiki></pre>


'''Please do not do this'''
===禁止事項===
やるべきではない事例です。


Translate the word 'Category' or the name of the category.
'''こんなことはしないでください。'''
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
 
'Category' またはカテゴリ名までも翻訳してしまっている例
<pre><nowiki>[[Category:Development]] → [[Categorie:開発]]</nowiki></pre>
{{-}}
{{-}}
'''Or this'''
'''ほかにも'''


Translate just the name of the category.
カテゴリ名だけ翻訳してしまっている例
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</nowiki></pre>
<pre><nowiki>[[Category:Development]] → [[Category:開発]]</nowiki></pre>


== Images ==
== 画像 ==


It is expected translated page will want to show images localised in the language of the page. This is encouraged because it improves the user's experience. Documentation only asks translators to follow a naming pattern of images consistent with the source language of a page.
翻訳されたページはページの画像もその言語にローカライズされたものが表示されていることが望ましいです。ユーザーエクスペリエンス改善のため推奨されています。ドキュメントは、ページのソース言語と一致した画像の命名パターンに従うように翻訳してください。


===Image Naming===
===画像名===


Using an image used above on this page which is written as:  
このページで使用している画像は以下の様なファイル名となっています:  
<pre><nowiki>[[File:JDOC-translator_interface-editing-view.png]]</nowiki></pre>
<pre><nowiki>[[File:JDOC-translator_interface-editing-view.png]]</nowiki></pre>


====Do This====
====こうやります====


Keep the name of the image and just add the language code to the end:  
画像のファイル名はそのままで、末尾に言語コードを付加するだけです:  
<pre>
<pre>
español would be es <nowiki>[[File:JDOC-translator_interface-editing-view-es.png]]</nowiki>
スペイン語は es <nowiki>[[File:JDOC-translator_interface-editing-view-es.png]]</nowiki>
italiano would be it <nowiki>[[File:JDOC-translator_interface-editing-view-it.png]]</nowiki>
イタリア語は it <nowiki>[[File:JDOC-translator_interface-editing-view-it.png]]</nowiki>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
ポルトガル語は pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</pre>
</pre>
If the file is not a localised file type (e.g Screenshot of an interface) and is a graphic of something universal (e.g. a ball or arrow), you should not have to rename the image. If the image has a caption, you may have to translate the caption.
ファイルがローカライズされたファイルタイプでない場合（例：画面のスクリーンショット）や普遍的な何かの図形（例：ボールや矢印）の場合、画像をリネームする必要はありません。画像にキャプションが付いている場合は、キャプションを翻訳する必要があります。


<pre>
<pre>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
は
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
<nowiki>[[File:ball.png|caption=<この部分だけ翻訳>]]</nowiki>
となります。
</pre>
</pre>


After you finish translating a page with images you will localise. You should view the page in the language you just translated it too and click on the "red" file links. This will allow you to upload the localised version of the file.
画像を含めて翻訳が完了したら、次はローカライズです。その言語に翻訳されたページを確認し、リンクになっている"赤い"ファイル名をクリックします。ここでローカライズされた画像をアップロードできます。
 
多くの場合、翻訳するドキュメント内の画像には、翻訳用にマークされた言語IDがすでに含まれています。<code><nowiki>[[File:JDOC-translator_interface-editing-view-<translate>en</translate>.png]]</nowiki></code>'''en'''をあなたのローカル言語ID (日本語なら '''ja''')に変更して保存します。翻訳したいローカライズされたアイテムが画像にない場合は'''en''' は '''en''' のままで保存して元の画像を保持します。
====禁止事項====
現時点では時間がない等でローカル画像を挿入しない場合、「en」を「ja」に変更しないでください。「ja」にして保存してしまうと、代替文字が赤字で表示されることになり、画像が表示されなくなります。
日本語版の画像が準備でき次第、「ja」に変更して画像を登録してください。
 
== チャンク ==
 
チャンクは、複数の場所で使用できるドキュメントです。 大きなチャンクがありますが、それらのほとんどは小さなドキュメントであり、1行しかない場合もあります。 たとえば、多くのヘルプ画面で同じフィールドが使用されているヘルプ画面の列ヘッダーに使用されます。
 
===チャンクの使い方===
 
ドキュメントでチャンクを使用するのは非常に簡単です。参照→ https://docs.joomla.org/Chunk30:Help_screen_Show_Title 次のコードを使用してドキュメントで使用できます。
<pre><nowiki>{{Chunk30:Help_screen_Show_Title/<translate>en</translate>}}</nowiki></pre>
これをドキュメントで使用すると、次のようになります。
{{Chunk30:Help_screen_Show_Title/<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>}}
「'''en'''」を日本語の場合は言語ID「'''ja'''」に変更するわけですが、翻訳後、チャンクが日本語で利用できない場合、文字が赤くリンクされます。リンクをクリックしてもそのページにはドキュメントがない旨のメッセージが表示されます。その時は以下のようにします。
日本語の言語コード「/'''ja'''」をURLから削除します。そうすれば英語のチャンクになります。先頭の見出しだけでも良いので、先にそのチャンクを日本語に翻訳すれば、チャンクの日本語ページが作成され、先程の言語コード「/'''ja'''」をURLに追加してもページが存在するため、文字が赤くならず、存在するページとしてドキュメントを表示できます。
パラメータを使用して、チャンクをより洗練された方法で使用する方法があります。このようにして、独自の言語でチャンクにパラメーターを渡すことができます。 これは次のようにコードを書きます：
<pre><nowiki>{{Chunk30:Help_screen_toolbar_icon_Save/<translate>en</translate>|<translate>menu item</translate>}}</nowiki></pre>
このチャンクのソースは次のとおりです。
<pre><nowiki>*'''Save'''. Saves the {{{1|item}}} and stays in the current screen.</nowiki></pre>
これをドキュメントで使用すると、結果は次のようになります。
{{Chunk30:Help_screen_toolbar_icon_Save/<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>|メニューアイテム}}
このように '''en''' を変更することで希望する言語に変更することができ、'''menu item'''は'''item'''で使用されます。


== Templates ==
== テンプレート ==
Templates are reusable pieces of code which have a predictable result.
テンプレートは予測可能な結果を持っている再利用可能なコードの一部です。


<pre>
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
{{tip|title=これはヒントです|これはヒントの内容です！}}
</pre>
</pre>


Would look like this:
このようになります：


{{tip|title=This is a tip|This is the body content of a tip!}}
{{tip|title=これはヒントです|これはヒントの内容です！}}


===Do This===
===こうやります===


For the above example:
上記の例の場合：
<pre>
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
{{tip|title=これはヒントです|これはヒントの内容です！}}
</pre>
</pre>


You would have to do the following:
次の操作を実行する必要があります：
<pre>
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
{{tip|title=<タイトルを翻訳>|<本文を翻訳>}}
</pre>
</pre>


===Do Not Do This===
===禁止事項===
Here is a list of don't do's.
禁止事項の一覧です。


*Never translate the template's name. The template {{tl|tip}} is called by the word 'tip' following the double set of curly brackets. If you translate the word tip, the translation would call a non-existent template name.
*テンプレート名は絶対に変更しないでください。テンプレート{{tl|tip}} は中括弧の二重セットを書いて'tip' という単語を呼び出しています。tip という単語を訳してしまうと、翻訳が存在しないテンプレートの名前を呼ぶことになります。
*Never translate the variables used in a template, only the value assigned to the variable. In the example of the {{tl|tip}} template, the word 'title' is the variable.
*テンプレートで使用される変数を翻訳しないでください。変数に割り当てられた値だけを翻訳してください。 {{tl|tip}} テンプレートを例にすると、 'title' が変数です。


<noinclude>
<noinclude>
[[Category:Documentation Translation]]
[[Category:Documentation Translation/ja|ドキュメント翻訳]]
</noinclude>
</noinclude>

Latest revision as of 09:11, 21 July 2022

Other languages:

ドキュメント翻訳を始める際は、まずこのページをご覧ください。ページ翻訳に関する詳細はページ翻訳の詳細を参照ください。翻訳者として登録するにはドキュメントの翻訳者 にてユーザー名を登録してください。

ユーザーIDが承認されれば、言語別翻訳状況で自分の言語に翻訳するドキュメントを見つけることができます。

翻訳用のドキュメントを新しいウィンドウで開くと、翻訳する部分のリストが表示されます。上部には、翻訳しているドキュメントへのリンクがあります。これを新しいウィンドウで開いて照らし合わせながら、一方の画面で翻訳し、もう一方の画面で何を翻訳したかを確認できます。

翻訳者登録が済んだら翻訳サンドボックスで使い方を練習してみましょう。

ドキュメントの一部が翻訳用にどのようにマークされているかを知っておくとよいでしょう。 一般的にはこのようになります <translate><T:number>Text to translate</translate> 翻訳する際は Text to translateの部分を翻訳します <translate></translate>は翻訳が必要な部分にマークが付けられ、<T:number>はシステムによって行われます。

インターフェース

翻訳が可能なページで、全く未翻訳の場合は「このページを翻訳」、翻訳が途中のページには、その下の画像のような表示がページの上部に表示されています。

翻訳できるページにはこのような記述があります

日本語でローカライズされた場合の進捗を表す記述

「このページを翻訳」もしくは「翻訳」の文字をクリックしたら、以下の画像のような翻訳インターフェイスが表示されます。ドキュメントにはULS (Universal Language Selector) がインストールされていて、自動的にローカライズ言語が設定されています。これはブラウザ設定（言語設定）や地理的位置に基づいています。言語設定は、ユーザーアイコン（1番右上）を選択し、ドロップダウンリストの一番上にある言語をクリックして手動で上書きすることもできます。また個別に言語設定から行うこともできます。

パーツ単位で任意のリンクをクリックして、翻訳にとりかかりましょう。

右横に表示された「提案」で候補にある翻訳をクリックして自動的に編集画面に翻訳を入れることができます。そこから適宜テキストを修正できます。翻訳候補テキストは翻訳サービスが無料で提供していますが、すべてのパーツに翻訳候補が入っているとは限りません。翻訳候補のクエリは翻訳サービスサーバがタイムアウトして表示されないことがあります。

翻訳ができあがったら「翻訳を保存」ボタンを押して保存します。別の部分を翻訳したい場合は「次へスキップ」ボタンを押して今翻訳中のパーツをスキップできます。

ページタイトル

ページタイトルは 翻訳できるので翻訳してください。タイトルは編集画面のメッセージグループの上部にある太字の部分です。

重要！

ネームスペースは翻訳せず省いてください！ : （コロン）より前の部分はタイトルの処理上表示されています。


ページ名がネームスペースの後ろに入っている場合　→　"Prefix:ページ名"

ネームスペースが入っていないページ名　→　"ページ名"

正誤 タイトルの例
正 "J2.5:Title of a Page" → "ページのタイトル"

"J2.5:Title of a Page" → "Titel einer Seite"

誤 "J2.5:Title of a Page" → "J2.5:ページのタイトル"

"J2.5:Title of a Page" → "J2.5:Titel einer Seite"

リンク

リンクに関する重要な情報

必ず確認してください。ページ間のリンクは、ソース言語とは異なる任意の言語での閲覧に影響を及ぼします。閲覧者がそのユーザの言語に翻訳されたドキュメントで閲覧できるようにするのが目的です。


以下の情報が簡単な概要となっています。より詳細な説明についてはリンクの翻訳を参照ください。

標準内部ページリンク

ソース言語で別のページへリンクさせるのは簡単です。[[ (brackets) ]]ページ名をこのようにブラケットで囲む、またアレンジ方法は以下に記載されています。ページリンクのための良いソースページ規格は、翻訳されたナビゲーションに適切なリンクのマークアップが含まれるようにします。

  1. [[JDOC:Translation Sandbox]] は JDOC:Translation Sandbox となります。
  2. [[JDOC:Translation Sandbox|Translation Sandbox]] は Translation Sandbox となります。
  3. [[JDOC:Translation Sandbox|Translator Sandbox]] は Translator Sandbox となります。

翻訳されたページから同じ言語でリンクさせるにはローカリゼーションリンクプロセッサを介して実行する必要があります。

  1. [[Special:MyLanguage/JDOC:Translation Sandbox]] は Special:MyLanguage/JDOC:Translation Sandbox となります。
    上記は読み手の言語にもなっておらず、あまり見栄えの良いリンクではありません。ユーザーエクスペリエンスを改善するためには、以下のオランダ語の翻訳例のリンクを参照してください。
  2. [[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]] は Vertaling Sandbox となります。
    これでオランダ語で閲覧する人は自国の言語でリンクを読むことができます。上記のように、リンクの任意名を付けることができます。

Special: にはエイリアスがあります。S: とだけ書いてSpecial: の短縮バージョンとして利用できます。

需要なリンクのヒント

  • 常にこのように 
    [[Special:MyLanguage/<source language pagename>|<ここに訳>]]
  • またはこのように書いてください。
    [[S:MyLanguage/<source language pagename>|<ここに訳>]]

例: 

[[JDOC:Translation Sandbox|Translation Sandbox]] 
  は
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
 または
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
 となります。

まとめ: 常に <source page name>の前に Special:MyLanguage/ を付加してください。<source page name> は常に翻訳不要です。リンクの翻訳がない場合は「|」を追加してその後ろに翻訳テキストを入れてください。 このSpecial:MyLanguage/は原文ですでに付加されていることが多いです。つまり原文にSpecial:MyLanguage/JDOC:Translation Sandbox|<translate>Translation Sandbox</translate>がある場合は、Translation Sandboxだけを翻訳すればよくURLの代わりに表示されます。

外部リンク

外部リンクの翻訳は簡単です。これらはソース言語で、次のように書かれています。

  1. https://www.php.net/ は https://www.php.net/ となります。
  2. [https://www.php.net/ PHP情報について] は PHP情報について となります。

何を翻訳すればいいの？

  1. これは標準的なURLですので翻訳を必要としません。 https://www.php.net/ は通常のハイパーリンクであり、そのように記述する必要がありますが翻訳は不要です。
  2. [https://www.php.net/ PHP情報について] これはPHP情報についての部分のみ翻訳が必要です。

カテゴリ

カテゴリはでは特定の方法を必要とします！

注意すべきことの1つは、ページを翻訳する際、ページ内の任意の「カテゴリ」リンクはまた、適切な言語コードを含むように修正すべきであることです。


カテゴリの翻訳はとても簡単です。/<language code> をカテゴリ名の最後に付けるだけです。

こうやります

例えば、英語からスペイン語（言語コードはes）にページを翻訳する場合でそのページに次のカテゴリが含まれている時： 

[[Category:Development]]

/es をカテゴリ名の最後に付ける必要があります。 

[[Category:Developement/es]]

カテゴリページは同様に（ほとんどが親カテゴリを含むを除く空白）翻訳することができ、場合によって特別な分類プロジェクトの一部に準備されます。

　 /ja|開発 ををカテゴリ名の最後に付ければ日本語になります 

[[Category:Developement/ja|開発]]

禁止事項

やるべきではない事例です。

こんなことはしないでください。

'Category' またはカテゴリ名までも翻訳してしまっている例 

[[Category:Development]] → [[Categorie:開発]]

ほかにも

カテゴリ名だけ翻訳してしまっている例 

[[Category:Development]] → [[Category:開発]]

画像

翻訳されたページはページの画像もその言語にローカライズされたものが表示されていることが望ましいです。ユーザーエクスペリエンス改善のため推奨されています。ドキュメントは、ページのソース言語と一致した画像の命名パターンに従うように翻訳してください。

画像名

このページで使用している画像は以下の様なファイル名となっています: 

[[File:JDOC-translator_interface-editing-view.png]]

こうやります

画像のファイル名はそのままで、末尾に言語コードを付加するだけです: 

スペイン語は es [[File:JDOC-translator_interface-editing-view-es.png]]
イタリア語は it [[File:JDOC-translator_interface-editing-view-it.png]]
ポルトガル語は pt [[File:JDOC-translator_interface-editing-view-pt.png]]

ファイルがローカライズされたファイルタイプでない場合（例：画面のスクリーンショット）や普遍的な何かの図形（例：ボールや矢印）の場合、画像をリネームする必要はありません。画像にキャプションが付いている場合は、キャプションを翻訳する必要があります。 

[[File:ball.png|caption=This is a ball]]
は
[[File:ball.png|caption=<この部分だけ翻訳>]]
となります。

画像を含めて翻訳が完了したら、次はローカライズです。その言語に翻訳されたページを確認し、リンクになっている"赤い"ファイル名をクリックします。ここでローカライズされた画像をアップロードできます。

多くの場合、翻訳するドキュメント内の画像には、翻訳用にマークされた言語IDがすでに含まれています。[[File:JDOC-translator_interface-editing-view-<translate>en</translate>.png]]enをあなたのローカル言語ID (日本語なら ja)に変更して保存します。翻訳したいローカライズされたアイテムが画像にない場合はen は en のままで保存して元の画像を保持します。

禁止事項

現時点では時間がない等でローカル画像を挿入しない場合、「en」を「ja」に変更しないでください。「ja」にして保存してしまうと、代替文字が赤字で表示されることになり、画像が表示されなくなります。 日本語版の画像が準備でき次第、「ja」に変更して画像を登録してください。

チャンク

チャンクは、複数の場所で使用できるドキュメントです。 大きなチャンクがありますが、それらのほとんどは小さなドキュメントであり、1行しかない場合もあります。 たとえば、多くのヘルプ画面で同じフィールドが使用されているヘルプ画面の列ヘッダーに使用されます。

チャンクの使い方

ドキュメントでチャンクを使用するのは非常に簡単です。参照→ https://docs.joomla.org/Chunk30:Help_screen_Show_Title 次のコードを使用してドキュメントで使用できます。 

{{Chunk30:Help_screen_Show_Title/<translate>en</translate>}}

これをドキュメントで使用すると、次のようになります。

{{Chunk30:Help_screen_Show_Title/

en

}}

「en」を日本語の場合は言語ID「ja」に変更するわけですが、翻訳後、チャンクが日本語で利用できない場合、文字が赤くリンクされます。リンクをクリックしてもそのページにはドキュメントがない旨のメッセージが表示されます。その時は以下のようにします。 日本語の言語コード「/ja」をURLから削除します。そうすれば英語のチャンクになります。先頭の見出しだけでも良いので、先にそのチャンクを日本語に翻訳すれば、チャンクの日本語ページが作成され、先程の言語コード「/ja」をURLに追加してもページが存在するため、文字が赤くならず、存在するページとしてドキュメントを表示できます。 パラメータを使用して、チャンクをより洗練された方法で使用する方法があります。このようにして、独自の言語でチャンクにパラメーターを渡すことができます。 これは次のようにコードを書きます： 

{{Chunk30:Help_screen_toolbar_icon_Save/<translate>en</translate>|<translate>menu item</translate>}}

このチャンクのソースは次のとおりです。 

*'''Save'''. Saves the {{{1|item}}} and stays in the current screen.

これをドキュメントで使用すると、結果は次のようになります。

{{Chunk30:Help_screen_toolbar_icon_Save/

en

|メニューアイテム}}

このように en を変更することで希望する言語に変更することができ、menu itemはitemで使用されます。

テンプレート

テンプレートは予測可能な結果を持っている再利用可能なコードの一部です。 

{{tip|title=これはヒントです|これはヒントの内容です！}}

このようになります：

これはヒントです

これはヒントの内容です！

こうやります

上記の例の場合： 

{{tip|title=これはヒントです|これはヒントの内容です！}}

次の操作を実行する必要があります： 

{{tip|title=<タイトルを翻訳>|<本文を翻訳>}}

禁止事項

禁止事項の一覧です。

  • テンプレート名は絶対に変更しないでください。テンプレート{{tip}} は中括弧の二重セットを書いて'tip' という単語を呼び出しています。tip という単語を訳してしまうと、翻訳が存在しないテンプレートの名前を呼ぶことになります。
  • テンプレートで使用される変数を翻訳しないでください。変数に割り当てられた値だけを翻訳してください。 {{tip}} テンプレートを例にすると、 'title' が変数です。
Retrieved from "https://docs.sandbox.joomla.org/index.php?title=JDOC:Page_Translation_Quickstart_Guide/ja&oldid=939823"