User Tools

Site Tools


en:translation

This is an old revision of the document!


Translation of this User Guide

Requirements

If you would like to help translating this user guide into another language, please contact us. We will then register an account for you and you can start right away.

In order to help translating this user guide, you should have a basic knowledge about Wiki systems, that's all.

Getting started

After you received an account for this Wiki, you can start your translation by simply opening an existing English page, changing the language to your translation language (using the language selector at top left) and creating this page in your language. If your target language is not listed there, please inform our team to get it enabled.

When you start creating the page, the Wiki system will automatically insert a FIXME placeholder to remind, that the translation of the page is ongoing and will paste the English page underneath. You should use this as a starting point and one-by-one translate the page.

Once you are done with translation you can remove the FIXME placeholder on top of the page.

Formatting Guideline

Wherever possible, this Wiki uses the normal syntax rules of DokuWiki, but due to the usage of the multilingual translation plugin, some specialties need to be considered:

  • At some places in the user guide anchors (initiated with #) are used to reference a certain paragraph on a page from within the page itself but also from other pages (e.g. cachedetails#top_bar_menu). The DokuWiki system automatically enables anchors for all headlines (e.g. ==== Top Bar Menu ====) , which is a nice feature in general but can make translation cumbersome, as those anchors will change once you translate these headlines.
    Therefore we are using just another anchor plugin additionally and used it to define a not-to-be-translated anchor below each headline (e.g. {{anchor:top_bar_menu}}). This means that you can freely translate the headlines to your language but do not need to care about anchors used in any links on the page. Just leave the anchor tag unchanged on your translated page.
  • In order to serve different languages the DokuWiki translation plugin uses dedicated namespaces for each language (e.g. en:cachedetails for English, de:cachedetails for German). So all your translation pages need to be in or below the namespace representing the ISO-code of your language. This will happen automatically if you start creating the pages as described above. Normally it would also be necessary to change the namespace of every link used within the pages, to target the correct language.
    We tried to make this obsolete by only using relative links (e.g. .:cachedetails instead of en:cachedetails). This means all the links you initially have on a new page when starting your translation should already target the namespace of your language, you don't need to change any of them.
  • Please be aware, that most of the screenshots used throughout this guide might need to be localized as well as they are in English only. If you are not able to create the corresponding screenshots, just leave the original image link as it is (an English screenshot will be better than no screenshot at all).
    All images which are localized shall be stored below the namespace of that language to allow easy distinction. Additionally all images which need no localization (e.g. icon images) are already stored in the [root] namespace and can be used in all languages.
  • Besides the different content pages, there is also a page called sidebar which contains the quick navigation links you can see left of the content. To translate this page, simply open the english sidebar and start translating this page as initially described.
  • When translating the user guide please kindly keep your formatting as close as possible to the original, only translating the word but not changing the layouts, boxes, etc. This will allow an easier tracking of outdated translations, once the original page was changed.

Don't be afraid

Just start editing…don't be afraid to break something. Due to the Wiki typical revision system you will always be able to restore unwanted changes by reverting to an older revision of the page.

Useful tools

This website uses cookies. These cookies are used to store your login status (if enabled) and your personal preferences (such as language selection). There are no tracking cookies or other scripts involved. By using the website, you agree with storing cookies on your computer. If you do not agree please leave the website or delete the cookies anytime you want as they are not essential to use this website.More information about cookies
en/translation.1529925966.txt.gz · Last modified: 2018/06/25 13:26 by lineflyer