Page translation
| This site replaces the former Compute Canada documentation site, and is now being managed by the Digital Research Alliance of Canada. Ce site remplace l'ancien site de documentation de Calcul Canada et est maintenant géré par l'Alliance de recherche numérique du Canada. |
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 Translate. Tutorials for this extension can be found 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.
How does one mark a new page for translation ?
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 <translate> </translate> tags.
- Ensure that the tag <languages /> appear at the very top of the page. This will show a box
- Go in “View” mode, and then click on the “Mark this page for translation”
- Review the translation units.
- Try to ensure that no wiki code (tables, tags, etc.) gets translated. This can be done by breaking the page in multiple <translate> </translate> sections.
- In the “Priority languages” section, write either “fr” or “en” as the priority language, that is, the language into which it needs to be translated.
- Click on “Mark this version for translation”
How does one mark changes to a page 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 <!--T:3-->. 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 <translate> </translate> tags.
- Go in “View” mode. You should see the text “This page has changes since it was last marked for translation.” at the top of the page. Click on “marked for translation”.
- Review the translation units.
- Try to ensure that no wiki code (tables, tags, etc.) gets translated. This can be done by breaking the page in multiple <translate> </translate> sections.
- In the “Priority languages” section, write either “fr” or “en” as the priority language, that is, the language into which it needs to be translated.
- Click on “Mark this version for translation”