Translation (wiki): Difference between revisions View history

Latest revision as of 05:47, 19 August 2016

This new page is currently undergoing modifications. Content is being prepared by one or more users. Do not make any changes before you send a private message to this user. Please use the talk page for thoughts and ideas on setting up this content.

Translation on the wiki is not yet working properly.

What is there to learn about translating this wiki.

When to apply translation

Translation can be used in country's or area's where multiple languages are used. Belgium is a good example: about 50-50 French-Dutch and also a small part German.

Enable translation of a page (Wiki editors)

Steps you have to take to enable translations on a particular page.

Prepare your main page

Translated pages are derived pages from a main page in an other language. The main language for the waze wiki is English and the base page must be written in this language! Every change in the main page will set of a chain of events to translate this change to the derived translated pages.

Add a language bar

On top of the page, you can add a language bar where users can switch between the available languages for the page. A languages bar is added on the place where you insert the <languages /> tag on the page.

Propose text in the page for translation

Once your main page is in English, you can mark the text that needs to be translated with <translate> and </translate> tags. You can use more then one tag on a page.

Text, images and other objects that does not need translation you can place outside the <translate> and </translate> tags.

The Translation tags could also be used in descriptions of images:

[[File:Benelux Header.png
 | 700px
 | Link = Benelux
 | <translate>This is the Benelux header</translate>
]]

Translation units

Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like . These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too. When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. [1]

Translation administrator

After the creation of the <translate> and </translate> tags or if the text is changed, an translation administrator has to approve the text to be translated. This is to avoid waste of time for the translators.

Translate (a part) of a wiki page (Wiki translators)

Steps you have to take to translate a particular page.

More explanation is comming soon sirKitKat (talk) 13:55, 21 February 2014 (UTC)

Under the hood

Translating pages on the wiki is done with the help of the MediaWiki Language Extension Bundle.

Extension in this bundle provide the necessary tools for translating a wiki. The following extensions are part of the bundle (Version MLEB 2013.09):

Translate: Special page for translating MediaWiki and beyond

Babel: Adds the #babel parser function to allow automated generation of a babel userbox column with the ability to include custom templates

Clean Changes: More compact display of the recent changes list

Language Names: Extension which provides localised language names based on CLDR data

LocalisationUpdate: Keeps the localised messages as up to date as possible

UniversalLanguageSelector: Gives the user several ways to select a language and to adjust language settings

More info over installed extensions can be found in the Special Version page.

@@ Line 1: / Line 1: @@
+{{construction|contact=https://www.waze.com/forum/ucp.php?i=pm&mode=compose&u=4200819 |contacttype=user |open=no |talk=yes}}
+{{mbox
+ | text = Translation on the wiki is not yet working properly.
+}}
 What is there to learn about translating this wiki.
@@ Line 4: / Line 9: @@
 Translation can be used in country's or area's where multiple languages are used. Belgium is a good example: about 50-50 French-Dutch and also a small part German.
-== How to use ==
+== Enable translation of a page (Wiki editors)==
+Steps you have to take to enable translations on a particular page.
+=== Prepare your main page ===
+Translated pages are derived pages from a main page in an other language. The main language for the waze wiki is '''English''' and the base page must be written in this language! Every change in the main page will set of a chain of events to translate this change to the derived translated pages.
+=== Add a language bar ===
+On top of the page, you can add a language bar where users can switch between the available languages for the page. A languages bar is added on the place where you insert the <code>&lt;languages /></code> tag on the page.
+=== Propose text in the page for translation ===
+Once your main page is in English, you can mark the text that needs to be translated with <code>&lt;translate></code> and <code>&lt;/translate></code> tags. You can use more then one tag on a page.
+Text, images and other objects that does not need translation you can place outside the <code>&lt;translate></code> and <code>&lt;/translate></code> tags.
+The Translation tags could also be used in descriptions of images:
+ <nowiki>[[File:Benelux Header.png
+ | 700px
+ | Link = Benelux
+ | </nowiki>'''&lt;translate>'''This is the Benelux header'''&lt;/translate>'''<nowiki>
+]]</nowiki>
+=== Translation units ===
+Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like <code>&lt;!--T:1--&gt;</code>. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too. When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. [http://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example#Step_4:_Making_changes]
+=== Translation administrator ===
+After the creation of the <code>&lt;translate></code> and <code>&lt;/translate></code> tags or if the text is changed, an translation administrator has to approve the text to be translated. This is to avoid waste of time for the translators.
+== Translate (a part) of a wiki page (Wiki translators)==
 Steps you have to take to translate a particular page.
+''More explanation is comming soon [[User:SirKitKat|sirKitKat]] ([[User talk:SirKitKat|talk]]) 13:55, 21 February 2014 (UTC) ''
 == Under the hood ==
@@ Line 33: / Line 66: @@
 More info over installed extensions can be found in the [[Special:Version|Special Version]] page.
+== Usefull Links ==
+* [[Translation Sandbox]]
+* [[Special:Translate]]
+* [[Special:TranslationStats]]
+* [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example Page translation example]
+[[Category:Translation]]
+[[Category:Wiki guide]]

Search