Changes between Version 70 and Version 80 of Translations


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Translations

    v70 v80  
    22
    33= Translations =
    4 
    5 JOSM translation is a whole divided into three parts, one of which is seen on every [wiki:Translations#StartupPage startup], another by the [wiki:Translations#Software Software], and a third by [wiki:Translations/Wiki Wiki] or online help users.
     4Translation is a whole divided into three parts, one of which is seen on every [#StartupPage startup] in JOSM, another by the [#Software Software] user interface and OSM data, and a third called [wikitr:Translations/Wiki Wiki] for Online help.
    65
    76[[PageOutline(2-10,Table of Contents)]]
    87
    9 == Wiki and Online help ==
    10 
    11 A good start for you to contribute is this Wiki. It serves as [wiki:Help Online Help] for JOSM, too. Please see the details on [[Translations/Wiki]]. You can start working right now — like on every good wiki.
    12 
    13 Some [wiki:Translations#Languagespecificnotes English specific notes] are on the bottom of this page.
     8The state of the translation over time is shown on [wikitr:/Translations/Statistics].
    149
    1510
     11== Wiki and Online help ==
     12A good start for you to contribute is this Wiki. It serves as [wikitr:/Help Online Help] for JOSM, too. Please see the details on [wikitr:/Translations/Wiki]. You can start working right now — like on every good wiki.
     13
     14Some [#Languagespecificnotes English specific notes] are on the bottom of this page.
     15
     16A list of all currently known online help pages can be found at the [wiki:/DevelopersGuide/HelpSystem/HelpTopicsList List of help topics]. This list is created automatically, but may be incomplete.
     17
     18Note: Some of the plugins used in this wiki (e.g. the Spam filter) are, like JOSM, translated at [https://translations.launchpad.net/tracplugins/trunk/ Launchpad].
     19
    1620== StartupPage ==#StartupPage
    17 
    18 The translation of [wiki:StartupPage JOSM start messages] can be changed at [wiki:StartupPageSource].
     21The translation of [wikitr:/StartupPage JOSM start messages] can be changed at [wiki:StartupPageSource].
    1922
    2023This page has a special format:
    … …  
    2932
    3033The previewed or saved page shows multiple sections sorted by language.
    31 Lines marked with '''EN''' show untranslated lines.
    32 Lines marked with '''X''' have been marked as draft line.
    33 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").
     34Lines marked with **EN** show untranslated lines.
     35Lines marked with **X** have been marked as draft line.
     36Lines 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").
    3437
    35 The translation of older [wiki:VersionHistory JOSM start messages] can be changed at [wiki:VersionHistorySource] for the current year. For each former year a separate page exists (e.g. [wiki:VersionHistorySource/2021]) back to 2008. The line format is the same as above.
     38The translation of older [wikitr:/VersionHistory JOSM start messages] can be changed at [wiki:VersionHistorySource] for the current year. For each former year a separate page exists (e.g. [wiki:VersionHistorySource/2021]) back to 2008. The line format is the same as above.
    3639
    37 The state of the translation over time is shown on [wikitr:/Translations/Statistics].
    3840
    3941== Software ==#Software
    40 
    4142Translation of the program texts including plugins is done at [https://translations.launchpad.net/josm/trunk/ Launchpad]. A few plugins are translated at [https://www.transifex.com/josm/josm/dashboard/ Transifex] instead (as of January 2018 Mapillary, geojson and scripting). See #8645 for plans about what platform to use.
    4243
    43 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).
     44The templates at Launchpad for translation are updated each night together with the new [/latest] build. The translated strings are imported into JOSM before each new [/tested] version is released (which is usually at the end of every month, see [/roadmap]) or more often when needed).
    4445
    45 The Java translation has some specialities which must be remembered when translating:
    46  * The ' sign [https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/text/MessageFormat.html is a special character]. It must be escaped by another ', so !'' means a single quote in resulting display.
    47  * 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).
     46The Java translation has some specialties which must be remembered when translating:
     47 * The `'` sign [https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/text/MessageFormat.html is a special character]. It must be escaped by another `'`, so `''` means a single quote in resulting display.
     48 * 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).
    4849  * This character is U+2019 named RIGHT SINGLE QUOTATION MARK
    49   * Under Linux this character is available with <ALT-GR>+<SHIFT>+<N>
    50   * Under Windows the character is available by pressing <ALT> and typing 0146 on keypad
    51  * Don't use the message formatting brackets {}, or when, then escape each with single quotes like '{' or '}'.
     50  * Under Linux this character is available with ''`<ALT-GR>+<SHIFT>+<N>`''
     51  * Under Windows the character is available by pressing ''`<ALT>`'' and typing `0146` on keypad
     52 * Don't use the message formatting brackets `{}`, or when, then escape each with single quotes like `'{'` or `'}'`.
    5253
    5354All 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:
    … …  
    6061 * trans_surveyor.java: [source:osm/applications/editors/josm/plugins/surveyor/resources/surveyor.xml surveyor plugin setup file]
    6162
    62 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]).
    63 
    64 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.
     63New languages can be started at Launchpad at any time. They will be added to the JOSM binary when there are at least 2000 translated strings. Please start with main user interface to reach best results.
    6564
    6665A short description how to add new language support for test purposes, when 2000 strings limit is not yet reached:
    6766* Create the language files and store them in the plugin file (or JOSM core):
    68  * Language files are stored in directory "data" of JOSM and named with the lowercase language code with extension '''.lang'''.
     67 * Language files are stored in directory "data" of JOSM and named with the lowercase language code with extension **.lang**.
    6968 * These files are always a set. The English base file and the translation files must be created together or they will not work correctly.
    70  * The Perl script [source:osm/applications/editors/josm/i18n/i18n.pl i18n.pl] must be called with a destination directory and the '''.po''' files to create translation data.
     69 * The Perl script [source:osm/applications/editors/josm/i18n/i18n.pl i18n.pl] must be called with a destination directory and the **.po** files to create translation data.
    7170* Add the new language in init() function of [source:trunk/src/org/openstreetmap/josm/tools/I18n.java I18n.java]:
    7271 * A proper code for the plural mode of the language needs to specified.
    73  * A description of the plural calculations can be found in the '''.po''' file downloaded from Launchpad.
    74  * If none of the existing modes matches the language, add new one needs to be added in the PluralMode enumeration and in pluralEval() function.
     72 * A description of the plural calculations can be found in the **.po** file downloaded from Launchpad.
     73 * If none of the existing modes matches the language, a new one needs to be added in the PluralMode enumeration and in pluralEval() function.
    7574 * For some special languages it is necessary to add workaround code in [source:trunk/src/org/openstreetmap/josm/tools/LanguageInfo.java LanguageInfo.java] to translate between Java language code and the newer codes used on Launchpad
    7675
     76
    7777== Language specific notes ==#Languagespecificnotes
    78 
    7978Please see the [wikitr:/Glossary].