wiki:Translations/Wiki

Version 4 (modified by Hb---, 2 weeks ago) (diff)

Big statistics table moved to Translations/Statistics

Wiki translation

The system for providing JOSM users Help is based on this Wiki. It deals with the exact dialog or context the user currently faces. It can offer the appropriate topic when the user clicks source:trunk/images/help.png or strokes F1. Our common goal is to help the user in his own language.

The JOSM pages follow the simple method to add the language code in front of page name. You can find (and add) the language codes at the page TracLanguages.

Each English base page has the macro [[TranslatedPages]] at its top. This macro creates a small menu containing links to all translated pages with the same wikiname.

Each translated page has the same macro, but containing the revision of the base page like in following picture:

When the revision of the base page is newer than the translated revision (someone updated English page), then below the language links in menu a new menu point appears showing the translated revisions and newest one. When clicking on that link, the differences between these revisions are displayed. These can then be used to update the translation. During updating the revision in the translated page needs to be increased to the newest one and the additional links disappears.

Some notes:

  • It is possible to access image from English base page (or any other page) also in translated page by using the page in the link: [[Image(wiki:Styles:Mappaint_deprecated.png)]] deprecated icon
    • It is nice if screenshots are offered in the native language although the English version is also accepted and less work.
  • Links inside the texts should go to translated pages or to English page when not yet translated (marked with (En) or something alike)
  • Pages should be consistent, so when adding new stuff, update the English base page also (except for language specific things)

See the macro description for more information about this macro.

Pages can be marked as incomplete or old when the parameter outdated is added to the translation macro (separated by a comma from other parameters). Behind the parameter a text describing the reason must be appended with an equal sign. Commas must be escaped with a backslash.

Example: [[TranslatedPages(revision=12,outdated=Translation is incomplete\, last part missing.]]

Outdated messages from the English base page can be copied in translation, but probably it is better to have them at base page only. This allows to separate translation related issues (translated pages) from content related issues (base page).

The list of outdated pages shows all outdated pages and the related comments.

The following are automatically generated statistics showing errors in the [[TranslatedPages]] macro or outdated and missing pages.

Language codes

Language codes in JOSM follow the method used by launchpad and many other open source translations. These are:

  • Two letter codes from ISO 639-1 in lower case, i.e. de.
  • Three letter codes from ISO 639-2 in lower case when there is no two letter code, i.e. ast.
  • Above language code followed by an underscore and upper case country code according to ISO 3166-1, i.e. pt_BR.
  • Above language code followed by an at sign and lower case dialect, i.e. ca@valencia.

The codes are slightly modified in different places:

  • For use in Java manifest and XML file keys the "@" sign is replaced by a "-" i.e. ca-valencia.
  • For use in Wiki page titles, the first letter (also after signs) is upper case, i.e. Pt_BR or Ca-Valencia.

The translation state of the whole wiki can be seen on the Statistics page.

Attachments (2)

Download all attachments as: .zip