|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.
- 1 When to apply translation
- 2 Enable translation of a page (Wiki editors)
- 3 Translate (a part) of a wiki page (Wiki translators)
- 4 Under the hood
- 5 Usefull Links
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> 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
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> ]]
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
<!--T:1-->. 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. 
After the creation of the
</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.
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):
- Special page for translating MediaWiki and beyond
- 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
- Keeps the localised messages as up to date as possible
- 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.