Languages:
Translations
StartupPage translation
The translation of JOSM start messages can be changed at the page of StartupPageSource.
This page has a special format:
- Each line "en:" starts a new translatable line.
- Each line with another language translates the previous English line.
- Each line without specifics is taken as is.
- Lines starting with "#" are ignored.
NOTE: There aren't always empty lines between the different sets. Be careful not to mix translations or forget some!
When changing English text please keep in mind that translations also need to be adapted. If you are not able to do so, then add an "x" in front of the language, so the translation is still available, but disabled.
Please sort the entries by the language abbreviation!
When you press preview or submit new revision, then the page has multiple sections containing the individual languages. Lines marked with EN show untranslated lines, lines marked with X show lines, which have been removed due to changed texts.
The table below shows translation status:
- Yellow: Translations need update
- Green: Everything up-to-date
- The numbers are:
- first: number of untranslated lines
- second: number of outdated translations
| ar | bg | cs | da | de | el | en | es | et | eu | fi | fr | hr | is | it | ja | nl | pl | pt | ru | sk | sv | uk | zh_CN | zh_TW |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 12 + 3 | 8 + 0 | 1 + 0 | 0 + 0 | 0 + 0 | 5 + 0 | 0 + 0 | 1 + 0 | 10 + 1 | 13 + 2 | 10 + 0 | 0 + 0 | 13 + 3 | 13 + 3 | 0 + 0 | 0 + 0 | 1 + 0 | 5 + 0 | 6 + 0 | 2 + 0 | 8 + 0 | 3 + 0 | 0 + 0 | 10 + 0 | 10 + 0 |
VersionHistory translation
The translation of older JOSM start messages can be changed at the page of VersionHistorySource.
The format is the same as above.
| ar | bg | cs | da | de | el | en | es | et | fi | fr | hr | is | it | ja | nl | pl | pt | ru | sk | sv | uk | zh_CN | zh_TW |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 99 + 0 | 79 + 1 | 8 + 0 | 58 + 0 | 0 + 0 | 85 + 0 | 0 + 0 | 0 + 0 | 62 + 1 | 44 + 0 | 0 + 0 | 99 + 0 | 99 + 0 | 25 + 0 | 47 + 1 | 44 + 0 | 63 + 0 | 75 + 0 | 0 + 0 | 92 + 0 | 76 + 0 | 43 + 0 | 61 + 0 | 78 + 0 |
Software translation
Translation of the program texts is done at Launchpad.
The Java translation has some specialities which must be remembered when translating:
- The ' sign is a special character. It must be escaped by another ', so '' means a single quote in resulting display.
- For languages with heavy usage of this character the typographic ’ may be used instead of the escaping (looks better when translating, in the final software a user will hardly see the difference).
- Don't use the message formating brackets {}, or when, then escape each with single quotes like '{' or '}'.
Changes made in Launchpad will be imported into JOSM for all languages which are already in JOSM. The JOSM team will try to update the text data at least every second week.
New languages will be added to JOSM when there are at least 2000 translated strings. Please start with main user interface to reach best results.
A short description how to add new language support for test purposes, when 2000 strings limit is not yet reached:
- Create the language files and store them in the plugin file (or JOSM core):
- Language files are stored in directory "data" of JOSM and named with the lowercase language code with extension .lang.
- These files are always a set. The English base file and the translation files must be created together or they will not work correctly.
- The Perl script i18n.pl must be called with a destination directory and the .po files to create translation data.
- Add the new language in init() function of I18n.java:
- A proper code for the plural mode of the language needs to specified.
- A description of the plural calculations can be found in the .po file downloaded from Launchpad.
- If none of the existing modes matches the language, add new one needs to be added in the PluralMode enumeration and in pluralEval() function.
- For some special languages it is necessary to add workaround code in LanguageInfo.java to translate between Java language code and the newer codes used on Launchpad
Current JOSM translation status active in the software (only JOSM core, no plugins) is shown in following table.
| language code | normal strings | plural number | plural strings | complete plural sets | total | |
|---|---|---|---|---|---|---|
| en | 5448 | 2 | 216 (216) | 108 | 100.0 |  
|
| bg | 2513 | 2 | 76 (216) | 38 | 45.7 |
|
| cs | 4716 | 3 | 294 (324) | 98 | 86.8 |
|
| da | 4670 | 2 | 216 (216) | 108 | 86.3 |
|
| de | 5448 | 2 | 216 (216) | 108 | 100.0 |
|
| el | 2941 | 2 | 130 (216) | 65 | 54.2 |
|
| en_AU | 3609 | 2 | 156 (216) | 58 | 66.5 |
|
| en_GB | 3689 | 2 | 166 (216) | 63 | 68.1 |
|
| es | 5257 | 2 | 216 (216) | 108 | 96.6 |
|
| et | 2096 | 2 | 78 (216) | 39 | 38.4 |
|
| eu | 2449 | 2 | 88 (216) | 44 | 44.8 |
|
| fi | 3337 | 2 | 162 (216) | 81 | 61.8 |
|
| fr | 5435 | 2 | 216 (216) | 108 | 99.8 |
|
| gl | 3536 | 2 | 134 (216) | 67 | 64.8 |
|
| id | 2150 | 1 | 35 (108) | 35 | 39.3 |
|
| it | 5436 | 2 | 216 (216) | 108 | 99.8 |
|
| ja | 4609 | 1 | 89 (108) | 89 | 84.6 |
|
| nb | 2382 | 2 | 62 (216) | 31 | 43.1 |
|
| nl | 5007 | 2 | 196 (216) | 98 | 91.9 |
|
| pl | 4148 | 3 | 246 (324) | 82 | 76.1 |
|
| pt_BR | 3710 | 2 | 174 (216) | 87 | 68.6 |
|
| ru | 5350 | 3 | 297 (324) | 99 | 97.8 |
|
| sk | 4890 | 3 | 318 (324) | 106 | 90.2 |
|
| sv | 2607 | 2 | 110 (216) | 55 | 48.0 |
|
| tr | 2043 | 1 | 31 (108) | 31 | 37.3 |
|
| uk | 5448 | 3 | 324 (324) | 108 | 100.0 |
|
| zh_CN | 5168 | 1 | 108 (108) | 108 | 95.0 |
|
| zh_TW | 4172 | 1 | 92 (108) | 92 | 76.7 |
|
JOSM online help
A list of all currently known online help pages can be found at Help Topics List. This list is automatically created, but may be incomplete nevertheless. See next section how translation works.
Page translation
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 contains the macro [[TranslatedPages]] at the top of the page. This macro creates a small menu containing all available languages.
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 an new menu point appears showing the translated revisions and newest one. When clicking on that link, the differences between that revision 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:
- 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.
Status table
- Red: There is an error with this page (see error list below)
- Yellow: Page needs update
- Green: Everything up-to-date
- Grey: Page is missing
Language specific translation notes
Each language has specific rules how the terms and texts of JOSM and OpenStreetMap needs to be translated.
