Translations

JOSM translation is a whole divided into three parts, one of which is seen on every startup, another by the Software, and a third by Wiki or online help users. All these use different methods for translation.

StartupPage

The translation of JOSM start messages can be changed at StartupPageSource.

This page has a special format:

• Each line "en:" starts a new translatable line.
• Each line with another language abbreviation 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! Please sort the entries in each set by the lowercase language abbreviation, but keep "en:" first.

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 abbreviation, so the translation is still available as a draft, but disabled.

The previewed or saved page shows multiple sections sorted by language. Lines marked with EN show untranslated lines. Lines marked with X have been marked as draft line. Lines marked with BASE are missing in a nationalized translation and have been overridden with the language based translation (i.e. "ca" used instead of missing "ca@valencia").

The table below shows translation status of the Startup Page:

• Background: Yellow = Translations need update and Green = Everything up-to-date
• Numbers: First = untranslated lines, '+' separator and Second = draft lines.

ar	ast	be	bg	ca	ca@valencia	cs	da	de	el	en	en_AU	en_GB	es	et	eu	fa	fi	fr	hr	hu	is	it	ja	ko	lt	ms	nb	nl	pl	pt	pt_BR	ru	sk	sr@latin	sv	uk	vi	zh_CN	zh_TW
0 + 0	6 + 0	6 + 1	13 + 1	2 + 1	26 + 0	6 + 0	3 + 0	0 + 0	6 + 0	0 + 0	26 + 0	26 + 0	-1 + 1	6 + 0	16 + 2	26 + 0	7 + 0	0 + 0	15 + 3	-1 + 1	15 + 3	0 + 0	-1 + 1	0 + 0	5 + 0	6 + 6	6 + 0	0 + 0	5 + 1	0 + 0	0 + 0	2 + 1	0 + 0	5 + 0	14 + 2	0 + 0	25 + 0	0 + 0	0 + 0

Version history

The translation of older JOSM start messages can be changed at VersionHistorySource for the current year. For each former year a separate page exists (e.g. VersionHistorySource/2016) back to 2008.

The line format is the same as above.

The translation status of the VersionHistory is at the bottom of the English version of this page.

Software

Translation of the program texts including plugins is done at ​Launchpad. A few plugins are translated at ​transifex instead (as of January 2018 Mapillary, geojson and scripting).

The templates at Launchpad are updated each night together with the new latest build. Translations are imported before each new release (or more often when needed).

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).
  • This character is U+2019 named RIGHT SINGLE QUOTATION MARK
  • Under Linux this character is available with <ALT-GR>+<SHIFT>+<N>
  • Under Windows the character is available by pressing <ALT> and typing 0146 on keypad
• Don't use the message formating brackets {}, or when, then escape each with single quotes like '{' or '}'.

All strings have a reference to the place in source code where they appear. That can help to find proper translation. You find the sources here:

• main JOSM source or complete JOSM source
• [osm:source:applications/editors/josm/plugins JOSM plugins]
• sources starting with trans_ are converted from data files
  • trans_maps.java: our list of background imagery
  • trans_plugins.java: description texts of plugins
  • trans_presets.java: internal preset
  • trans_surveyor.java: [osm:source:applications/editors/josm/plugins/surveyor/resources/surveyor.xml surveyor plugin setup file]

Changes made in Launchpad will be imported into JOSM for all languages which are already in JOSM. Usually the JOSM team updates the text data once or twice just before the release of a new tested version (which is usually at the end of every month, see roadmap).

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 [osm:source:applications/editors/josm/i18n/i18n.pl 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 and server, no plugins) is shown in following table.

JOSM core		JOSM server data
language normal strings plural number plural strings complete plural sets total en English 10495 2 344 (344) 172 100.0 de Deutsch 10495 2 344 (344) 172 100.0 en_GB British 10495 2 344 (344) 165 100.0 es español 10495 2 344 (344) 172 100.0 nl Nederlands 10495 2 344 (344) 172 100.0 uk українська 10495 3 516 (516) 172 100.0 be беларуская 10492 3 516 (516) 172 99.9 ru русский 10492 3 516 (516) 172 99.9 pt português 10454 2 344 (344) 172 99.6 ar العربية 10172 6 1026 (1032) 171 97.1 pt_BR português brasileiro 10073 2 344 (344) 172 96.1 fr français 10017 2 342 (344) 170 95.6 cs čeština 9932 3 516 (516) 172 94.9 bg български 9238 2 339 (344) 169 88.4 hu magyar 9231 2 328 (344) 164 88.2 sk slovenčina 9145 3 516 (516) 172 87.7 zh_CN 简体中文 8864 1 172 (172) 172 84.7 it italiano 8682 2 340 (344) 170 83.2 da dansk 8652 2 344 (344) 172 83.0 zh_TW 正體中文 8631 1 164 (172) 164 82.5 pl polski 8591 3 482 (516) 158 82.4 en_AU Australian 8376 2 328 (344) 157 80.3 nb norsk bokmål 8138 2 339 (344) 169 78.2 ja 日本語 8004 1 167 (172) 167 76.6 id Bahasa Indonesia 7284 1 147 (172) 147 69.7 ko 한국어 7151 1 153 (172) 153 68.5 sv svenska 6611 2 324 (344) 162 64.0 ca català 6268 2 300 (344) 150 60.6 gl galego 6307 2 254 (344) 127 60.5 lt lietuvių 5723 3 453 (516) 151 56.1 ast asturianu 5485 2 278 (344) 139 53.2 fi suomi 5323 2 266 (344) 133 51.6 el Ελληνικά 5049 2 300 (344) 150 49.3 ca@valencia valencià 4764 2 282 (344) 141 46.6 fa فارسی 4260 2 117 (344) 45 40.4 sr@latin srpski 3948 3 357 (516) 119 39.1 km ភាសាខ្មែរ 3455 1 132 (172) 132 33.6 mr मराठी 3270 2 144 (344) 72 31.5 et eesti 2648 2 142 (344) 71 25.7 is Íslenska 2443 2 96 (344) 48 23.4		language normal strings plural number plural strings complete plural sets total en English 118 2 0 (0) 0 100.0 be беларуская 118 0 0 (0) 0 100.0 de Deutsch 118 0 0 (0) 0 100.0 en_GB British 118 0 0 (0) 0 100.0 es español 118 0 0 (0) 0 100.0 nl Nederlands 118 0 0 (0) 0 100.0 pt português 118 0 0 (0) 0 100.0 ru русский 118 0 0 (0) 0 100.0 uk українська 118 0 0 (0) 0 100.0 ar العربية 114 0 0 (0) 0 96.6 fr français 114 0 0 (0) 0 96.6 pt_BR português brasileiro 113 0 0 (0) 0 95.8 da dansk 112 0 0 (0) 0 94.9 pl polski 112 0 0 (0) 0 94.9 sk slovenčina 109 0 0 (0) 0 92.4 bg български 108 0 0 (0) 0 91.5 cs čeština 108 0 0 (0) 0 91.5 en_AU Australian 105 0 0 (0) 0 89.0 hu magyar 103 0 0 (0) 0 87.3 id Bahasa Indonesia 100 0 0 (0) 0 84.7 it italiano 98 0 0 (0) 0 83.1 zh_CN 简体中文 97 0 0 (0) 0 82.2 ja 日本語 82 0 0 (0) 0 69.5 ca català 80 0 0 (0) 0 67.8 ast asturianu 69 0 0 (0) 0 58.5 zh_TW 正體中文 69 0 0 (0) 0 58.5 ca@valencia valencià 67 0 0 (0) 0 56.8 nb norsk bokmål 61 0 0 (0) 0 51.7 km ភាសាខ្មែរ 53 0 0 (0) 0 44.9 sr@latin srpski 41 0 0 (0) 0 34.7 gl galego 37 0 0 (0) 0 31.4 ko 한국어 34 0 0 (0) 0 28.8 fi suomi 31 0 0 (0) 0 26.3 sv svenska 29 0 0 (0) 0 24.6 lt lietuvių 24 0 0 (0) 0 20.3 et eesti 16 0 0 (0) 0 13.6 el Ελληνικά 9 0 0 (0) 0 7.6 fa فارسی 8 0 0 (0) 0 6.8 is Íslenska 2 0 0 (0) 0 1.7 mr मराठी 1 0 0 (0) 0 0.8

Online help and Wiki pages

The JOSM online help is based on this websites Wiki. See Translations/Wiki for detailed information.

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.

Language specific notes

Here is a list of the rules and recommendations how the terms and texts of JOSM and OpenStreetMap should be translated.

Version history translation status

The translation status of the Version history is shown in the following tables. Please see Version history for details.

VersionHistorySource

ar	ast	be	bg	ca	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	ko	lt	ms	nb	nl	pl	pt	pt_BR	ru	sk	sr@latin	sv	uk	zh_CN	zh_TW
6 + 0	9 + 0	9 + 0	18 + 0	7 + 0	8 + 0	7 + 0	0 + 0	9 + 0	0 + 0	0 + 0	9 + 0	8 + 0	0 + 0	3 + 0	0 + 0	4 + 0	1 + 0	7 + 0	9 + 10	9 + 0	0 + 0	8 + 0	0 + 0	0 + 0	4 + 0	0 + 0	8 + 0	18 + 0	2 + 0	0 + 0	0 + 0

VersionHistorySource/2022

ar	ast	be	ca	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	ko	lt	ms	nb	nl	pl	pt_BR	ru	sk	sr@latin	uk	zh_CN	zh_TW
2 + 0	2 + 0	2 + 0	2 + 0	2 + 0	2 + 0	0 + 0	2 + 0	0 + 0	0 + 0	2 + 0	2 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	2 + 9	2 + 0	0 + 0	2 + 0	2 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2021

ar	ast	be	ca	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	ko	lt	ms	nb	nl	pl	pt_BR	ru	sk	sr@latin	uk	zh_CN	zh_TW
22 + 0	16 + 0	16 + 0	13 + 0	16 + 0	16 + 0	0 + 0	16 + 0	0 + 0	0 + 0	10 + 0	16 + 0	0 + 0	2 + 0	0 + 0	14 + 0	0 + 0	0 + 0	16 + 8	16 + 0	0 + 0	0 + 0	16 + 0	0 + 0	0 + 0	3 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2020

ast	be	ca	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	ko	lt	ms	nb	nl	pl	pt_BR	ru	sk	sr@latin	uk	zh_CN	zh_TW
17 + 0	26 + 0	26 + 0	15 + 0	26 + 0	0 + 0	26 + 0	0 + 0	0 + 0	26 + 0	26 + 0	0 + 0	0 + 0	5 + 0	3 + 0	0 + 0	0 + 0	24 + 7	19 + 0	0 + 0	2 + 0	26 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2019

ast	be	ca	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	ko	lt	nb	nl	pl	pt	pt_BR	ru	sk	sr@latin	uk	zh_CN	zh_TW
4 + 0	13 + 0	15 + 0	0 + 0	13 + 0	0 + 0	13 + 0	0 + 0	0 + 0	13 + 0	13 + 0	0 + 0	0 + 0	10 + 0	10 + 0	0 + 0	0 + 0	10 + 0	0 + 0	12 + 0	22 + 0	11 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2018

ast	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	ko	lt	nb	nl	pl	pt_BR	ru	sk	uk	zh_CN	zh_TW
13 + 0	0 + 0	23 + 0	0 + 0	23 + 0	0 + 0	0 + 0	23 + 0	16 + 0	0 + 0	0 + 0	10 + 0	0 + 0	0 + 0	0 + 0	31 + 0	0 + 0	6 + 0	23 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2017

ast	cs	da	de	el	en	es	et	fr	hu	it	ja	ko	lt	nl	pl	pt_BR	ru	sk	uk	zh_CN	zh_TW
2 + 0	0 + 0	24 + 0	0 + 0	29 + 0	0 + 0	0 + 0	29 + 0	8 + 0	0 + 0	7 + 0	27 + 0	38 + 0	0 + 0	0 + 0	0 + 0	29 + 0	0 + 0	0 + 0	2 + 0	0 + 0	0 + 0

VersionHistorySource/2016

ast	cs	de	el	en	es	et	fr	hu	it	ja	lt	nl	pl	pt_BR	ru	sk	uk	zh_CN	zh_TW
8 + 0	0 + 0	0 + 0	16 + 0	0 + 0	0 + 0	9 + 0	5 + 0	0 + 0	0 + 0	16 + 0	0 + 0	0 + 0	3 + 0	19 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2015

ast	be	bg	cs	da	de	el	en	es	et	fr	hu	it	ja	lt	nl	pl	pt	pt_BR	ru	sk	uk	zh_CN	zh_TW
0 + 0	14 + 0	16 + 0	0 + 0	20 + 0	0 + 0	15 + 0	0 + 0	0 + 0	16 + 0	0 + 0	0 + 0	0 + 0	1 + 0	0 + 0	0 + 0	0 + 0	16 + 0	12 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2014

ast	be	bg	ca	cs	da	de	el	en	es	et	fr	hu	it	ja	lt	nl	pl	pt	pt_BR	ru	sk	uk	zh_CN	zh_TW
19 + 0	26 + 0	19 + 0	19 + 0	0 + 0	0 + 0	0 + 0	22 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	7 + 0	22 + 0	0 + 0	0 + 0	22 + 0	0 + 0	7 + 0	0 + 0	0 + 0	0 + 0	0 + 0

VersionHistorySource/2013

bg	ca	cs	da	de	en	es	et	fr	hu	it	ja	nl	pl	ru	sk	uk	zh_CN	zh_TW
37 + 0	26 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	12 + 0	0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	16 + 3	0 + 1	22 + 0	0 + 0	37 + 0	36 + 0

VersionHistorySource/2012

bg	cs	da	de	el	en	es	et	fi	fr	hu	it	ja	nl	pl	pt	ru	sk	sv	uk	zh_TW
35 + 0	0 + 0	0 + 0	0 + 0	30 + 0	0 + 0	0 + 0	10 + 0	27 + 0	0 + 0	1 + 0	0 + 0	0 + 0	0 + 0	10 + 0	7 + 0	0 + 0	15 + 0	32 + 0	0 + 0	10 + 0

VersionHistorySource/2011

ar	bg	cs	da	de	el	en	es	et	fi	fr	it	ja	nl	pl	pt	ru	sk	sv	uk	zh_CN	zh_TW
38 + 0	30 + 1	0 + 0	0 + 0	0 + 0	23 + 0	0 + 0	0 + 0	25 + 1	32 + 0	0 + 0	11 + 0	0 + 0	0 + 0	18 + 0	38 + 0	0 + 0	30 + 0	38 + 0	0 + 0	14 + 0	27 + 0

VersionHistorySource/2010

bg	cs	da	de	en	es	et	fi	fr	it	ja	nl	pl	pt	ru	sv	uk	zh_CN	zh_TW
13 + 0	0 + 0	18 + 0	0 + 0	0 + 0	0 + 0	5 + 0	0 + 0	0 + 0	0 + 0	15 + 0	0 + 0	11 + 0	1 + 0	0 + 0	19 + 0	0 + 0	7 + 0	10 + 0

VersionHistorySource/2009

bg	cs	de	en	es	et	fi	fr	hr	is	it	ja	nl	pl	pt	ru	sv
25 + 0	0 + 0	0 + 0	0 + 0	0 + 0	20 + 0	1 + 0	0 + 0	24 + 0	24 + 0	3 + 0	18 + 0	0 + 0	24 + 0	24 + 0	0 + 0	9 + 0

VersionHistorySource/2008

cs	de	en	es	fr	it	ja	nl	pl	ru	sv
0 + 0	0 + 0	0 + 0	0 + 0	0 + 0	11 + 0	9 + 0	0 + 0	11 + 0	0 + 0	10 + 0