Joomla! Documentation - User contributions [en]

JDOC:Page Translation Quickstart Guide/ru

2015-08-20T15:54:48Z

Serg SSN: Created page with "Если вы уже записались в качестве переводчика, вы можете потренироваться в S:MyLanguage/JDOC:Translation Sandb..."

<noinclude><languages /></noinclude>
Эта страница должна помочь переводчику быстрее сделать первые шаги с переводами документации. Относительно более подробной версии перевода страницы, см. [[S:MyLanguage/JDOC:Page Translation Explained|Page Translation Explained]]. Чтобы зарегистрироваться переводчиком, перейдите, пожалуйста, на [[JDOC:Documentation Translators|Documentation Translators]] и добавте имя пользователя.

Если вы уже записались в качестве переводчика, вы можете потренироваться в [[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 langauge 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/ru

2015-08-20T15:54:48Z

Если вы уже записались в качестве переводчика, вы можете потренироваться в [[S:MyLanguage/JDOC:Translation Sandbox|Translation Sandbox]].

JDOC:Page Translation Quickstart Guide/ru

2015-08-20T15:23:11Z

Serg SSN: Created page with "Эта страница должна помочь переводчику быстрее сделать первые шаги с переводами документации...."

<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 langauge 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/ru

2015-08-20T15:23:10Z

Эта страница должна помочь переводчику быстрее сделать первые шаги с переводами документации. Относительно более подробной версии перевода страницы, см. [[S:MyLanguage/JDOC:Page Translation Explained|Page Translation Explained]]. Чтобы зарегистрироваться переводчиком, перейдите, пожалуйста, на [[JDOC:Documentation Translators|Documentation Translators]] и добавте имя пользователя.

JDOC:Page Translation Quickstart Guide/ru

2015-08-20T15:07:47Z

Serg SSN: 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 langauge 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/ru

2015-08-20T15:07:47Z

Serg SSN: Created page with "JDOC:страница перевода Руководства по быстрому пуску"

JDOC:страница перевода Руководства по быстрому пуску

JDOC:Documentation Translators

2015-08-12T15:23:32Z

Serg SSN: /* ru - Русский - Russian */

[[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}}

===Add Your Username===
Add your username below under a language you want to translate and you will be added to the [[Special:ListUsers/translator|Translator user group]].

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

=== 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|rbuelund}}
* {{User|tienloantran}}

=== de - Deutsch - German ===
* {{User|FrankyD}}
* {{User|gorgonz}}
* {{User|joomla-agency}}
* {{User|Ka3media}}
* {{User|Paterna}}
* {{User|Sisko1990}}
* {{User|Stefanie}}
* {{User|Tkahl}}

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

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

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

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

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

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

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

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

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

=== 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|Dagoberto}}
* {{User|DiLeu}}
* {{User|Filipetorres}}
* {{User|Gleisonsoares}}
* {{User|Helvecio}}
* {{User|Henrydouglas}}
* {{User|Murilotimo}}
* {{User|Welkson Ramos}}

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

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

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

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

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

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

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

=== zh - 中文 - Chinese ===
* {{User|asika32764}}
* {{User|eyesofkids}}
* {{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>