Changes between Version 4 and Version 10 of Translations/Wiki


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

Legend:

Unmodified
Added
Removed
Modified

  • Translations/Wiki

    v4 v10  
    11[[TranslatedPages]]
    2 = Wiki translation =
     2= Wiki Translation =
    33
    4 The system for providing JOSM users [wiki:/Help] is based on this Wiki.
    5 It deals with the exact dialog or context the user currently faces.
    6 It can offer the appropriate [wiki:DevelopersGuide/HelpSystem/HelpTopicsList topic] when the user clicks [[Image(source:trunk/images/help.png,link=wiki:Help,24,valign=middle)]] or strokes `F1`.
     4The system for providing JOSM users [wikitr:/Help] is based on this Wiki.
     5It deals with the exact context under the mouse pointer.
     6It can offer the appropriate [wikitr:/DevelopersGuide/HelpSystem/HelpTopicsList topic] when the user clicks [[JOSMImage(help,link=wikitr:Help,24,valign=middle)]] or strokes `F1`.
    77Our common goal is to help the user in his own language.
    88
    9 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 [wiki:TracLanguages].
     9The 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.
    1010
    11 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.
     11Each 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 page name. [[BR(The macro needs to be written false to avoid it from runing here)]]
    1212
    13 Each translated page has the same macro, but containing the revision of the base page like in following picture:
     13This macro is also used on each translated page.
     14Additionally it contains the revision of the base page as parameter.
     15See the following example:
    1416
    1517[[Image(revision.png)]]
    … …  
    2325
    2426Some notes:
    25 * 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)]]}}} [[Image(wiki:Styles:Mappaint_deprecated.png)]]
     27* All links to wiki pages should use the `wikitr:` as realm. This realm delivers an URL to a translated page if available. If the target is not yet translated, then a URL to the English base page is delivered, combined with a marker. \\
     28 `[wikitr:/Translations/Wiki Translated Wiki Translation]` will always lead the reader to a valid page.
     29* Images from the English base page can easily be on translated pages. To address them, use the page name as realm and place a colon in front of the filename: `[[Image(Translations/Wiki:diff.png)]]`
    2630 * It is nice if screenshots are offered in the native language although the English version is also accepted and less work.
    27 * Links inside the texts should go to translated pages or to English page when not yet translated (marked with (En) or something alike)
    28 * Pages should be consistent, so when adding new stuff, update the English base page also (except for language specific things)
     31* Pages should be consistent, so when adding new stuff on a translated page, please update the English base page also (except for language specific things).
    2932
    3033See the [WikiMacros#TranslatedPages-macro macro description] for more information about this macro.
    3134
    32 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.
     35Pages can be marked as incomplete or old with adding the `outdated` parameter to the translation macro.
     36A message describing the incompleteness and what to do is the value of this parameter.
     37The parameter name must be separated with a comma from other parameters.
     38The parameter value is separated with an equal sign from the name.
     39Commas inside the value must be escaped with a backslash.
    3340
    3441Example:
    35 `[[TranslatedPages(revision=12,outdated=Translation is incomplete\, last part missing.]]`
     42`[[``TranslatedPages(revision=12,outdated=Translation is incomplete\, last part missing.)]]`
    3643
    3744Outdated 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).
    3845
    39 The [wiki:OutdatedPages list of outdated pages] shows all outdated pages and the related comments.
    40 
    41 The following are automatically generated statistics showing errors in the `[[TranslatedPages]]` macro or outdated and missing pages.
     46The [wikitr:/OutdatedPages list of outdated pages] shows all outdated pages and the related comments.
     47Its translated variants shows this information only for the target language and for the English base pages.
    4248
    4349=== Language codes ===
    … …  
    4955* Above language code followed by an at sign and lower case dialect, i.e. `ca@valencia`.
    5056
    51 
    5257The codes are slightly modified in different places:
    5358* For use in Java manifest and XML file keys the "@" sign is replaced by a "-" i.e. `ca-valencia`.
    5459* For use in Wiki page titles, the first letter (also after signs) is upper case, i.e. `Pt_BR` or `Ca-Valencia`.
    5560
    56 The translation state of the whole wiki can be seen on the [wiki:/Translations/Statistics Statistics] page.
    57 {{{
    58 #!comment
    59 The following statistics were moved to the link seen above this comment.
    60 Language specific
    61 
    62 === Status table ===
    63 
    64  * Red: There is an error with this page (see error list below)
    65  * Yellow: Page needs update
    66  * Green: Everything up-to-date
    67  * Grey: Page is missing
    68 
    69 When translating this page, don't copy the macro as is, but use  [[TranslatedPages(showstatus,lang=De)]] (for German), so only the relevant information for your language is printed.
    70 
    71 [[TranslatedPages(showstatus,skipmissing)]]
    72 
    73 [[TranslatedPages(showproblems,silent)]]
    74 }}}
     61The translation state of the whole wiki can be seen on the [wikitr:/Translations/Statistics Statistics] page.