Joomla! Documentation - User contributions [en]

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:08:49Z

Koji Hijikuro:

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.

== インターフェース ==
ページの翻訳が可能な場合、以下の図・翻訳状況を見ることができます。

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/3/ja

2016-03-15T05:08:48Z

Koji Hijikuro:

== インターフェース ==
ページの翻訳が可能な場合、以下の図・翻訳状況を見ることができます。

Translations:JDOC:Page Translation Quickstart Guide/7/ja

2016-03-15T05:08:24Z

Koji Hijikuro: Created page with "Localised view of link in Dutch"

Localised view of link in Dutch

Translations:JDOC:Page Translation Quickstart Guide/6/ja

2016-03-15T05:08:17Z

Koji Hijikuro: Created page with "en"

Translations:JDOC:Page Translation Quickstart Guide/5/ja

2016-03-15T05:08:15Z

Koji Hijikuro: Created page with "Localised view of link in English"

Localised view of link in English

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:07:57Z

Koji Hijikuro:

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.

== インターフェース ==
ページの翻訳が可能な場合、以下の図や、翻訳状況を見ることができます。

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/4/ja

2016-03-15T05:07:56Z

Koji Hijikuro:

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:07:25Z

Koji Hijikuro: Created page with "ja"

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.

== インターフェース ==
ページの翻訳が可能な場合、以下の図や、翻訳状況を見ることができます。

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-ja.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/4/ja

2016-03-15T05:07:25Z

Koji Hijikuro: Created page with "ja"

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:06:51Z

Koji Hijikuro: Created page with "== インターフェース == ページの翻訳が可能な場合、以下の図や、翻訳状況を見ることができます。"

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.

== インターフェース ==
ページの翻訳が可能な場合、以下の図や、翻訳状況を見ることができます。

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/3/ja

2016-03-15T05:06:50Z

Koji Hijikuro: Created page with "== インターフェース == ページの翻訳が可能な場合、以下の図や、翻訳状況を見ることができます。"

== インターフェース ==
ページの翻訳が可能な場合、以下の図や、翻訳状況を見ることができます。

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:03:57Z

Koji Hijikuro: Created page with "既に翻訳者として登録済みの人は、翻訳サンドボックスで遊んでみましょう."

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.

== The Interface ==
If a page is ready to translate you will see (images below) or a variation (based on view of page):

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/2/ja

2016-03-15T05:03:57Z

Koji Hijikuro: Created page with "既に翻訳者として登録済みの人は、翻訳サンドボックスで遊んでみましょう."

既に翻訳者として登録済みの人は、[[S:MyLanguage/JDOC:Translation Sandbox|翻訳サンドボックス]]で遊んでみましょう.

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:02:05Z

Koji Hijikuro:

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

If you are already a signed up as a translator, you can play in the [[S:MyLanguage/JDOC:Translation Sandbox|Translation Sandbox]].

== The Interface ==
If a page is ready to translate you will see (images below) or a variation (based on view of page):

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/1/ja

2016-03-15T05:02:05Z

Koji Hijikuro:

ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|ドキュメントの翻訳者]] のページで、ユーザー名を追加登録して下さい。

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T05:00:42Z

Koji Hijikuro:

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|Documentation Translators]] のページで、ユーザー名を追加登録して下さい。

If you are already a signed up as a translator, you can play in the [[S:MyLanguage/JDOC:Translation Sandbox|Translation Sandbox]].

== The Interface ==
If a page is ready to translate you will see (images below) or a variation (based on view of page):

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/1/ja

2016-03-15T05:00:42Z

Koji Hijikuro:

ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|ページ翻訳の詳細]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|Documentation Translators]] のページで、ユーザー名を追加登録して下さい。

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T04:57:19Z

Koji Hijikuro: Created page with "ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、S:MyLanguage/JDOC:Page Translation Explained|Page..."

<noinclude><languages /></noinclude>
ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|Page Translation Explained]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|Documentation Translators]] のページで、ユーザー名を追加登録して下さい。

If you are already a signed up as a translator, you can play in the [[S:MyLanguage/JDOC:Translation Sandbox|Translation Sandbox]].

== The Interface ==
If a page is ready to translate you will see (images below) or a variation (based on view of page):

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/1/ja

2016-03-15T04:57:19Z

ドキュメントの翻訳を始める際に、このページをご覧下さい。より詳細な翻訳に関しては、[[S:MyLanguage/JDOC:Page Translation Explained|Page Translation Explained]]を見て下さい。翻訳者として参加した方は、[[JDOC:Documentation Translators|Documentation Translators]] のページで、ユーザー名を追加登録して下さい。

JDOC:Page Translation Quickstart Guide/ja

2016-03-15T04:53:13Z

Koji Hijikuro: Created page with "JDOC:ページ翻訳クイックスタートガイド"

<noinclude><languages /></noinclude>
This page should help get a translator quickly started with documentation translations. For the more detailed version of page translation, see [[S:MyLanguage/JDOC:Page Translation Explained|Page Translation Explained]]. To signup as a translator, please go to [[JDOC:Documentation Translators|Documentation Translators]] add your username.

If you are already a signed up as a translator, you can play in the [[S:MyLanguage/JDOC:Translation Sandbox|Translation Sandbox]].

== The Interface ==
If a page is ready to translate you will see (images below) or a variation (based on view of page):

<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
</div>

<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
</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]].
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
</div>

Now you are ready to translate, click any link in the separated message units.
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
</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).}}

A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".

This page name is not in a namespace when it looks like this: "Name of page".

{| 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" translated "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" translated "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.}}

The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|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>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[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|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.

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>.

====Important Link Tips====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
An example would be:

<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]
is translated as
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
or
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</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>.

===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>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]

'''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.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.

== 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.}}

The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.

===Do This===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
<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===
There are a few things you should not do.

'''Please do not do this'''

Translate the word 'Category' or the name of the category.
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
'''Or this'''

Translate just the name of the category.
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</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>

====Do This====

Keep the name of the image and just add the language code to the end:
<pre>
español would be 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>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</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>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
</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.

== Templates ==
Templates are reusable pieces of code which have a predictable result.

<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

Would look like this:

{{tip|title=This is a tip|This is the body content of a tip!}}

===Do This===

For the above example:
<pre>
{{tip|title=This is a tip|This is the body content of a tip!}}
</pre>

You would have to do the following:
<pre>
{{tip|title=<translate the title>|<translate the body content>}}
</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.
*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.

<noinclude>
[[Category:Documentation Translation]]
</noinclude>

Translations:JDOC:Page Translation Quickstart Guide/Page display title/ja

2016-03-15T04:53:12Z

Koji Hijikuro: Created page with "JDOC:ページ翻訳クイックスタートガイド"

JDOC:ページ翻訳クイックスタートガイド

JDOC:Documentation Translators

2016-03-08T14:36:32Z

Koji Hijikuro: /* ja - 日本語 - Japanese */

[[File:JDOC translation icon.png|right]]
Here, people '''translating''' {{SITENAME}} can sign up as a translator. Please be sure to read the required reading list below.

After you add your username to the list below under the appropriate language heading, a [[JDOC:Translation Administrators|Translation Administrator]] will assign your username translator permissions. After your username is added as a translator you can start translating! Please be on the look out for a [[Template:Translator welcome|welcome message]] with more information posted to your user talk page.{{-}}

== Required Reading ==
* Getting started, read [[JDOC:Page Translation Quickstart Guide|Page Translation Quickstart Guide]]
* Detailed explanation of translating, [[JDOC:Page Translation Explained|Page Translation Explained]].
* Our [[JDOC:Language policy|Language policy]]
* [[JDOC:Translator Tips|Translator Tips]]
* Having an [[JDOC:Translation Questions|issue or need help]]?

{{tip|text=Dear translators! Please [[Special:TranslatorSignup|register for translator notifications about your language]]. You are placed on a list to receive notices about new/updated pages that need translation.|title=A Tip for Translators}}

===UserName===
Adicione seu nome de usuário abaixo em um idioma que você deseja traduzir e você será adicionado ao [[Special:ListUsers/translator|grupo de Tradutores]].

===Add Your Language===
If your language isn't listed below, please add it using the format:

<code><lang code> - Localised language name - English language name </code>

Use the syntax, <code><nowiki>* {{User|YourUsername}}</nowiki> - requested</code>

When a Translation Administrator adds you as a translator, they will remove the "- requested" from your username.

==Current Translations Teams==

Documentation language codes are different from Joomla! language codes, they are ISO 639-1 2 letter code. A small quantity of 4 letter language codes are used as an exception, but these language codes are all lowercase.

=== ar - عربي - arabe ===
* {{User|Badreddine Azrar}}
* {{User|ghilo}}
* {{User|HawraMilani}}
* {{User|Hicham72}}
* {{User|hossen}}

=== af - Afrikaans ===
*{{User|JoeSA}}

=== bg - Български - Bulgarian ===
* {{User|bdimov}}
* {{User|Mastwd}}

=== ca - Català - Catalan ===
* {{User|el_libre}}
* {{User|Jcollver}}
* {{User|Johnnydement}}

=== da - Dansk - Danish ===
* {{User|Jespertoender}}
* {{User|ot2sen}}
* {{User|rbuelund}}
* {{User|tienloantran}}

=== de - Deutsch - German ===
* {{User|Assmann}}
* {{User|Balzercomp}}
* {{User|ceus1984}}
* {{User|FrankyD}}
* {{User|fruppel}}
* {{User|gorgonz}}
* {{User|jehacgn}}
* {{User|joomla-agency}}
* {{User|Ka3media}}
* {{User|King_Louis_1}}
* {{User|Kolvar}}
* {{User|m-b-o}}
* {{User|michaelmyk}}
* {{User|Paterna}}
* {{User|plocher}}
* {{User|Prof.Logout}}
* {{User|SeigetsuShoen}}
* {{User|Sisko1990}}
* {{User|Stefanie}}
* {{User|Tkahl}}
* {{User|UCFnet002}}
* {{User|Webberry}}
* {{User|zero24}}

=== es - Español - Spanish ===
* {{User|Abulafia}}
* {{User|carcam}}
* {{User|cristobal.vio}}
* {{User|Crsanchez}}
* {{User|danielperaza}}
* {{User|framon}}
* {{User|Irene.lopez}}
* {{User|isidrobaq}}
* {{User|ivanramosnet}}
* {{User|Javiparati}}
* {{User|Jcollver}}
* {{User|Leo_Soto}}
* {{User|netandsoftware}}
* {{User|pfvidal}}
* {{User|VictorYork87}}
* {{User|viena}}
* {{User|Willin}}

=== et - Eesti - Estonian ===
* {{User|Eraser}}

=== fa - فارسی - Persian ===
* {{User|Grand}}
* {{User|Heydari}}
* {{User|Levelup}}
* {{User|mhehm}}

=== fr - Français - French ===
* {{User|BerCalva}}
* {{User|BigStef}}
* {{User|Daniel}}
* {{User|Dylis}}
* {{User|Erix}}
* {{User|MATsxm}}
* {{User|Opware2000}}
* {{User|Perete}}
* {{User|Rajoz}}
* {{User|Sandra97}}
* {{User|Simon}}
* {{User|Webdjam}}

=== ga - Gaeilge - Irish ===
* {{User|rvbgnu}}

=== he - עברית - Hebrew ===
* {{User|ydl}}
* {{User|shirdesign}}

=== hi - हिंदी - Hindi ===
* {{User|Syhussaini}}

=== hu - Magyar - Hungarian ===
* {{User|Balazs}}

=== hy - Հայերեն - Armenian ===
* {{User|Aaleksanyants}}

=== id - Bahasa Indonesia - Indonesian ===
* {{User|dw1Rianto}}
* {{User|Micokelana}}
* {{User|sikumbang}}

=== it - Italiano - Italian ===
* {{User|alexred}}
* {{User|alikon}}
* {{User|CinziaDesign}}
* {{User|donato}}
* {{User|nemo_bis}} (occasionally)
* {{User|Paolo Alberti}}
* {{User|robertolongo}}
* {{User|ste}}

=== ja - 日本語 - Japanese ===
* {{User|Nori}}
* {{User|Richell}}
* {{User|Yama}}
* {{User|Koji Hijikuro}}

=== nl - Nederlands - Dutch ===
* {{User|Alex0703}}
* {{User|Arkomat}}
* {{User|bcdesign}}
* {{User|crommie}}
* {{User|Grubosoft}}
* {{User|Hvdmeer}}
* {{User|Josien}}
* {{User|Lara}}
* {{User|Lianne}}
* {{User|ManuAmpe}}
* {{User|marionnijhuis}}
* {{User|Marnix}}
* {{User|MartijnM}}
* {{User|Meta}}
* {{User|metdick}}
* {{User|Mtb}}
* {{User|n9iels}}
* {{User|Nico-van-Leeuwen}}
* {{User|Onderzoekspraktijk}}
* {{User|Rineke}}
* {{User|Schrijvers123}}
* {{User|slibbe}}
* {{User|Stitch123}}
* {{User|webmiep}}
* {{User|webcatsolutions}}
* {{User|willoweb}}
* {{User|wimstrik}}

=== pl - Polski - Polish ===
* {{User|Derek}}
* {{User|justyna}}

=== pt - Português - Portuguese ===
* {{User|Djesus}}
* {{User|Horus_68}}
* {{User|Mansil}}

=== pt-br - Português Brasil - Brazilian Portuguese ===
* {{User|Airton}}
* {{User|AleMorettiSan}}
* {{User|Anabarcellos}}
* {{User|Ariadnepinheiro}}
* {{User|Belisards}}
* {{User|Dagoberto}}
* {{User|DiLeu}}
* {{User|Filipetorres}}
* {{User|Gleisonsoares}}
* {{User|Helvecio}}
* {{User|Henrydouglas}}
* {{User|Murilotimo}}
* {{User|VitorAdonai}}
* {{User|Vizetti}}
* {{User|Welkson Ramos}}

=== ro - Română - Romanian ===
* {{User|andreeastefan}}

=== ru - Русский - Russian ===
* {{User|AlexSmirnov}}
* {{User|Antonio3}}
* {{User|b2z}}
* {{User|Dosfanat}}
* {{User|Kanta}}
* {{User|Nikitm}}
* {{User|Serg SSN}}
* {{User|Vyatka}}

=== sv - Svenska - Swedish ===
* {{User|Propellerhuvud}}
* {{User|Sgagner}}

=== sw - Kiswahili - Swahili ===
* {{User|Ayeko}}

=== th - ไทย - Thai ===
* {{User|Supachai_chai}}
* {{User|Mrs.siam}}
* {{User|Ariesanywhere}}

=== tr - Türkçe - Turkish ===
* {{User|Enes}}
* {{User|Ugur}}
* {{User|Umitkenan}}

=== ukr - Українська - Ukrainian ===
* {{User|Olesya6968ak}}

=== ur - ur-PK - اردو - Urdu Pakistan ===
* {{User|hoornayyer}}

=== vi - Tiếng Việt - Vietnamese ===
* {{User|huyhoa}}

=== zh - 中文 - Chinese ===
* {{User|asika32764}}
* {{User|eyesofkids}}
* {{User|myskies}}
* {{User|Wulijun01234}}
* {{User|Zhang19min88}}

==Translation Administrators==

The responsibilities of a Translation Administrator will require slightly more attention to the documents for translation. Translation Administrators should feel comfortable with using wiki markup, made hundreds of contributions to their specific language and assisted others in translation of docs. Administrators will need to check the documentation every few days and perform any required tasks. These tasks include re-marking pages in en-GB with edit changes, tracking language units which need translation and welcoming new translators. Ideally, we should have at least one Translation Administrator who will not be tied to any specific language and when the time comes, one Translation Administrator for active language teams. [[JDOC_talk:Documentation Translators|Volunteer as a Translation Administrator here]].

===Current Volunteer Translation Administrators===
{{:Special:ListUsers/translationadmins}}

==Common Language Codes==
<div class="small-4 columns"> afr - Afrikaans - Afrikaans
</div><div class="small-4 columns"> ar - عربي - Arabic
</div><div class="small-4 columns"> bg - Български - Bulgarian
</div><div class="small-4 columns"> bg - Български - Bulgarian
</div><div class="small-4 columns"> bn - বাংলা - Bengali
</div><div class="small-4 columns"> bo - བོད་ཡིག - tibetan
</div><div class="small-4 columns"> ca - Català - Catalan
</div><div class="small-4 columns"> ce - Nohçi - Chechen
</div><div class="small-4 columns"> da - Dansk - Danish
</div><div class="small-4 columns"> de - Deutsch - German
</div><div class="small-4 columns"> es - Español - Spanish
</div><div class="small-4 columns"> fa - فارسی - Persian
</div><div class="small-4 columns"> fi - - Finnish
</div><div class="small-4 columns"> fr - Français - French
</div><div class="small-4 columns"> hu - Magyar - Hungarian
</div><div class="small-4 columns"> hy - Հայերեն - Armenian
</div><div class="small-4 columns"> id - Bahasa Indonesia - Indonesian
</div><div class="small-4 columns"> is - Íslenska - Icelandic
</div><div class="small-4 columns"> it - Italiano - Italian
</div><div class="small-4 columns"> ja - 日本語 - Japanese
</div><div class="small-4 columns"> ko - 한국어 - Korean
</div><div class="small-4 columns"> lb - Lëtzebuergesch - Luxembourgish
</div><div class="small-4 columns"> min - Baso Minangkabau - Minang
</div><div class="small-4 columns"> ml - liviox alvax - Malayalam
</div><div class="small-4 columns"> mr - मराठी - Marathi
</div><div class="small-4 columns"> ms - Bahasa Melayu - Malay
</div><div class="small-4 columns"> nl - Nederlands - Dutch
</div><div class="small-4 columns"> pl - Polski - Polish
</div><div class="small-4 columns"> pt - Português - Portuguese
</div><div class="small-4 columns"> pt-br - Português do Brasil - Brazilian Portuguese
</div><div class="small-4 columns"> ro - Română - Romanian
</div><div class="small-4 columns"> ru - Русский - Russian
</div><div class="small-4 columns"> sl - Slovenščina - Slovenianjtökók
</div><div class="small-4 columns"> sq - Shqip - Albanian
</div><div class="small-4 columns"> sv - Svenska - Swedish
</div><div class="small-4 columns"> sw - Kiswahili - Swahili
</div><div class="small-4 columns"> ta - தமிழ் - Tamil
</div><div class="small-4 columns"> th - ไทย - Thai
</div><div class="small-4 columns"> tr - Türkçe - Turkish
</div><div class="small-4 columns"> vi - Tiếng Việt - Vietnamese
</div><div class="small-4 columns"> zh 中文 Chinese
</div>

<noinclude>
[[Category:Documentation Wiki Policies and Guidelines]]
[[Category:Documentation Translation]]
</noinclude>