Authoring guidelines: Difference between revisions

= Translation = <!--T:6-->

To translate a page, one first writes the content in the original language. Second, the page is marked for translation. Then, a ''human'' translates the page using organizational tools provided by the wiki extension [https://www.mediawiki.org/wiki/Extension:Translate Translate]. Tutorials for this extension can be found [https://www.mediawiki.org/wiki/Help:Extension:Translate here]. Finally, a second human reviews the translation. If a page has not yet been translated, users can see the page in the original language. If a translation has not yet been reviewed, users can see the non-reviewed translation.

Marking a page for translation will trigger an analysis of the content of the wiki page. The page content will be split by the extension into so-called translation units. Translation units can be a title, a paragraph, an image, etc. These small units can then be translated one by one, ensuring that a modification to a page does not trigger the translation of the whole page. This also allows tracking of what percentage of a page is translated, or outdated.  

When you have written a page, you should tag it for translation. Here are the steps to do so:

#Ensure that the wiki code to be translated is enclosed within &lt;translate&gt; &lt;/translate&gt; tags.  

#Click on “Mark this version for translation”

First, try to mark a page for translation only once it is stable.  

Second, if you do have to make a change to a page that has been translated, make sure you do NOT change the tags of the form &lt;!--T:3--&gt;. Those are automatically generated.  

Once you have done your edits, you can mark the changes to be translated by doing the following :  

#Ensure that the new text to be translated is enclosed within &lt;translate&gt; &lt;/translate&gt; tags.