Help:Wiki Translation: Difference between revisions

    From KDE TechBase
    No edit summary
    No edit summary
     
    (One intermediate revision by the same user not shown)
    Line 20: Line 20:


    The article must contain the following template line in order to show the language navigation bar:
    The article must contain the following template line in order to show the language navigation bar:
    <CODE>{{Template:I18n/Language Navigation Bar|Development/Tutorials}}</CODE>
    '''(obsolete link removed)'''
    This magic line expands to the language navigation bar for the article [[Development/Tutorials]]. Note, that the line does not contain the language abbreviation.
    This magic line expands to the language navigation bar for the article [[Development/Tutorials]]. Note, that the line does not contain the language abbreviation.


    Line 27: Line 27:
    If the language is missing, please search for the right abbreviation (see Step 1). In the example above this abbreviation is " (de)".
    If the language is missing, please search for the right abbreviation (see Step 1). In the example above this abbreviation is " (de)".


    Edit [[Template:I18n/Language Navigation Bar]] and add a line for the language you want to translate:
    Edit Template:I18n/Language Navigation Bar and add a line for the language you want to translate:
      <nowiki><span lang="de">[[{{{1}}}_(de)|Deutsch]]</span></nowiki>
      <nowiki><span lang="de">[[{{{1}}}_(de)|Deutsch]]</span></nowiki>
    Replace 'de' by the language abbreviation and adapt the visible name.
    Replace 'de' by the language abbreviation and adapt the visible name.

    Latest revision as of 12:48, 15 July 2012

     
    Remember
    This article is obsolete. Please follow the links in the sidebar under "Translator Help Pages" to use the new translation system.


    This article describes how to translate articles into other languages. Please make sure to also read the last section called important notes.

    Step 1: Language Abbreviations

    As an example let us assume you want to translate the following page to german:

    The language abbreviation for german is de, thus, all articles will have the ending " (de)" (with a leading space).

    Reference: list of language abbreviations.

    Step 2: Create the Article

    Sometimes a link in the language navigation bar already exists. In that case, simply follow the link you want to translate. Otherwise, create the article manually:

    As initial content simply use the content of the corresponding english page. This way, no content is missing, and other readers can help with the translation.

    Step 3: Language Navigation Bar

    The article must contain the following template line in order to show the language navigation bar: (obsolete link removed) This magic line expands to the language navigation bar for the article Development/Tutorials. Note, that the line does not contain the language abbreviation.

    Step 4: Language Missing?

    If the language is missing, please search for the right abbreviation (see Step 1). In the example above this abbreviation is " (de)".

    Edit Template:I18n/Language Navigation Bar and add a line for the language you want to translate:

    <span lang="de">[[{{{1}}}_(de)|Deutsch]]</span>
    

    Replace 'de' by the language abbreviation and adapt the visible name.

    Important Notes

    As the wiki uses subpages it is likely that translators run into the following issue.

    Assume the following pages exist:

    1. Development/Tutorials
    2. Development/Tutorials/Debugging
    

    Further assume you want to translate (1) to german (postfix de).

    The final page will be

    3. Development/Tutorials_(de)
    

    The english content of (2) uses relative wiki links like /Debugging. Translating Debugging in (3) might result in

    Development/Tutorials_(de)/Debugging      # wrong, or
    Development/Tutorials_(de)/Debugging_(de) # wrong
    

    This is wrong.

    The rule of thumb is that the language abbreviation always appears at the very end of the article, that is the right link is supposed to be

    Development/Tutorials/Debugging_(de)
    

    So be sure you adapt the links in the article to use absolute paths everywhere (i.e. no leading slash '/' in the wiki links).

    Quality Assurance

    The system administrators and contributors try to keep a close watch at the content, but with foreign languages this is sometimes getting hard. It would be good, if you add yourself to the Watch list (just click Watch). That way you will be noticed by mail whenever the article was changed. This will help to keep the wiki clean of e.g. spam, which unfortunately already happened.

    Also, consider to add yourself to the translation teams.