Help

Translation: Difference between revisions
No edit summary
Line 1: Line 1:
*see also: [http://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration Page translation administration]
{{Toc right}}
== Preparing a Page for Translation (Admins/Preparers) ==
* Make sure you know the name of the page;
* Go to Prepare page for translation: Special:PagePreparation;<br />
Example:
http://vanisource.org/wiki/Special:PagePreparation
*Type or paste the page name in the box and (don't press enter) click blue 'Prepare' button;
*Click the green 'Save' button;
*Note the line: 'The page was saved. You can edit it' and click the 'edit' link;


== Tagging a Page for Translation ==
=== Tag placement ===
*Add '''<nowiki><languages /></nowiki>''' to produce a list of all translations of the page;
*Leave the following tag: '''<nowiki><languages/></nowiki>''' at the top of the page;
*Anyone can mark the '''translatable parts''' by wrapping them inside '''<nowiki><translate>...</translate></nowiki>''' tags;
*Cut the '''<nowiki><translate></nowiki>''' tag (deleting the blank line left behind) and paste it on its own line (create a blank line for it if necessary) at the point you wish the translation to begin;
*The translatable page will be listed on '''Special:PageTranslation''' as ready for marking.
*Delete any other '''<nowiki></translate> and <translate></nowiki>''' tags including the blank lines left from the deletes (please note next step);
*Do not delete the last '''<nowiki></translate></nowiki>''' tag found at the bottom of the page;
*Preview then save page;
*The translatable page will be listed on '''Special:PageTranslation''' as ready for marking.<br />
Example:
http://vanisource.org/wiki/Special:PageTranslation


=== Tag placing ===
== Marking a Page for Translation ==
*If possible, try to put the '''tags on their own lines''', with no empty lines between the content and the tags.;
*Go to '''Special:PageTranslation''';
*If not possible, do like this for example:
*Under 'Pages proposed for translation', choose a page and click (mark for translation);
 
*Uncheck the first box next to 'Allow translation of page title' as most pages titles will not be translated;
<nowiki>{{Template|<translate>Some localised parameter</translate>}}</nowiki>
*Go to bottom of the page and click the button 'Mark this version for translation' Do not fill in the other fields;
 
*The system will update the translatable page source by adding unit markes for each translation unit (paragraph).<br />
== Marking by an Translation Admin ==
Example:
*After the tagging, a '''translation administrator''' marks the page for translation by choosing what will be translated;
<nowiki><!--T:1--></nowiki>, <nowiki><!--T:2--></nowiki> etc.
*The system will update the translatable page source by adding unit markes (<nowiki><!--T:#--></nowiki>) for each translation unit.


=== Unit Markers Added by System ===
=== Unit Markers Added by System ===
*Never add unit markers yourself;
*Unit markers define the sections that are or have been translated;
*Markers are always on the line before a unit; or, if unit starts with a header then after the first header on the same line.  
*Markers are always on the line before a unit (paragraph); or, if unit starts with a header then after the first header on the same line for each translation unit.
Example:
 
  <nowiki>
  <nowiki>
  <translate>
  <translate>
  == Birds == <!--T:1-->
  == Birds == <!--T:1-->
  Birds are animals which....
  Birds are animals which....
 
  <!--T:2-->
  <!--T:2-->
  Birds can fly and...
  Birds can fly and...
  </translate></nowiki>
  </translate></nowiki>
== Editing a Source Page ==
If a translateable page needs to be edited never add unit markers yourself. After saving, follow the instructions above for [[#Preparing a Page for Translation|'Preparing a Page for Translation']].


=== Deleting whole Units ===
=== Deleting whole Units ===
*If you delete whole units, also remove the unit marker.
*If you edit the source page and delete whole units, also remove the unit markers.


=== Moving units ===
=== Moving Units ===
*You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.
*You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.


Line 39: Line 52:


=== How to Translate ===
=== How to Translate ===
# Go to Special:Translate;
*Go to Special:Translate;<br />
# Click the name of any message group that has untranslated pages. (Each translatable page is a message group, but there can be other kinds of message groups too);
Example:
#Follow translating process and use suggetions that are appropriate. Suggestions are automatically generated from previous translations.
  http://vanisource.org/wiki/Special:Translate
*Click the name of any message group that has untranslated pages. (Each translatable page is a message group, but there can be other kinds of message groups too);
*Follow translating process and use suggetions that are appropriate. Suggestions are automatically generated from previous translations.


=== Reviewing ===
=== Reviewing ===


:Filled (black) check-mark means that you have already marked the translation as reviewed.
:Filled (black) check-mark means that you have already marked the translation as reviewed;
:Empty check-mark (white on gray background) means that you will be the first reviewer of the translation.
:Empty check-mark (white on gray background) means that you will be the first reviewer of the translation;
:Gray check-mark means that the translation has been already reviewed by others, but not by you.
:Gray check-mark means that the translation has been already reviewed by others, but not by you;
*Consistency in translating words, phrases and concepts aids clarity of suggestions given by translation memory (suggestions);
*Consistency in translating words, phrases and concepts aids clarity of suggestions given by translation memory (suggestions);
*The number of people who have reviewed a translation is shown near the review action for each message;
*The number of people who have reviewed a translation is shown near the review action for each message;
Line 55: Line 70:


=== Variables ===
=== Variables ===
*Syntax is '''<nowiki><tvar|name>contents</></nowiki>'''. For translators these will show up only as $name, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages. Example:
*Syntax is '''<nowiki><tvar|name>contents</></nowiki>'''. For translators these will show up only as $name, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages.<br />
 
Example:
  <nowiki>
  <nowiki>
  <translate>
  <translate>
Line 64: Line 79:
=== Also need to understand ===
=== Also need to understand ===


*Categories
*Categories;
*Messaging
*Messaging;
*[https://www.mediawiki.org/wiki/Help:Extension:Translate/Message_group_states Message group states]
*[https://www.mediawiki.org/wiki/Help:Extension:Translate/Message_group_states Message group states];
*[https://www.mediawiki.org/wiki/Help:Extension:Translate/Statistics_and_reporting Statistics and reporting]
*[https://www.mediawiki.org/wiki/Help:Extension:Translate/Statistics_and_reporting Statistics and reporting];
*May be interesting: [http://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector Universal Language Selector]
*May be interesting: [http://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector Universal Language Selector].


==== Notes: ====
== Notes ==
*see also: [http://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration Page translation administration].


*Make all editors translators
=== Tips ===
*Group name: Translation Admin
*To take advantage of some features which allow automatic choosing of pages that have been translated into your languge, set your preferred language in your user preferences. Link is available at the very top of all pages to the right of your user name.<br />
Example:
http://vanipedia.org/wiki/Special:Preferences

Revision as of 17:15, 19 October 2014


Preparing a Page for Translation (Admins/Preparers)

  • Make sure you know the name of the page;
  • Go to Prepare page for translation: Special:PagePreparation;

Example: 

http://vanisource.org/wiki/Special:PagePreparation
  • Type or paste the page name in the box and (don't press enter) click blue 'Prepare' button;
  • Click the green 'Save' button;
  • Note the line: 'The page was saved. You can edit it' and click the 'edit' link;

Tag placement

  • Leave the following tag: <languages/> at the top of the page;
  • Cut the <translate> tag (deleting the blank line left behind) and paste it on its own line (create a blank line for it if necessary) at the point you wish the translation to begin;
  • Delete any other </translate> and <translate> tags including the blank lines left from the deletes (please note next step);
  • Do not delete the last </translate> tag found at the bottom of the page;
  • Preview then save page;
  • The translatable page will be listed on Special:PageTranslation as ready for marking.

Example: 

http://vanisource.org/wiki/Special:PageTranslation

Marking a Page for Translation

  • Go to Special:PageTranslation;
  • Under 'Pages proposed for translation', choose a page and click (mark for translation);
  • Uncheck the first box next to 'Allow translation of page title' as most pages titles will not be translated;
  • Go to bottom of the page and click the button 'Mark this version for translation' Do not fill in the other fields;
  • The system will update the translatable page source by adding unit markes for each translation unit (paragraph).

Example: 

<!--T:1-->, <!--T:2--> etc.

Unit Markers Added by System

  • Unit markers define the sections that are or have been translated;
  • Markers are always on the line before a unit (paragraph); or, if unit starts with a header then after the first header on the same line for each translation unit.
 <translate>
 == Birds == <!--T:1-->
 Birds are animals which....

 <!--T:2-->
 Birds can fly and...
 </translate>

Editing a Source Page

If a translateable page needs to be edited never add unit markers yourself. After saving, follow the instructions above for 'Preparing a Page for Translation'.

Deleting whole Units

  • If you edit the source page and delete whole units, also remove the unit markers.

Moving Units

  • You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.

Translating

How to Translate

  • Go to Special:Translate;

Example: 

 http://vanisource.org/wiki/Special:Translate
  • Click the name of any message group that has untranslated pages. (Each translatable page is a message group, but there can be other kinds of message groups too);
  • Follow translating process and use suggetions that are appropriate. Suggestions are automatically generated from previous translations.

Reviewing

Filled (black) check-mark means that you have already marked the translation as reviewed;
Empty check-mark (white on gray background) means that you will be the first reviewer of the translation;
Gray check-mark means that the translation has been already reviewed by others, but not by you;
  • Consistency in translating words, phrases and concepts aids clarity of suggestions given by translation memory (suggestions);
  • The number of people who have reviewed a translation is shown near the review action for each message;
  • Users can only review translations they haven't made themselves. Multiple people can review any translation.

Advanced

Variables

  • Syntax is <tvar|name>contents</>. For translators these will show up only as $name, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages.

Example: 

 <translate>
 Income this month <code><tvar|income>{{FORMATNUM:3567800}}</></code> EUR
 </translate>

Also need to understand

Notes

Tips

  • To take advantage of some features which allow automatic choosing of pages that have been translated into your languge, set your preferred language in your user preferences. Link is available at the very top of all pages to the right of your user name.

Example: 

http://vanipedia.org/wiki/Special:Preferences
Retrieved from "https://vanipedia.org/w/index.php?title=Help:Translation&oldid=16273"