Help:Wiki Translation: Difference between revisions

    From KDE TechBase
    (rule of thumb)
    No edit summary
     
    (12 intermediate revisions by 4 users not shown)
    Line 1: Line 1:
    {{Remember|3=Warning|1=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|important notes]].
    This article describes how to '''translate articles into other languages'''. Please make sure to also read the last section called [[#Important Notes|important notes]].


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


    Reference:  [http://www.opticentre.net/FAQ/Languages/List-of-language-abbreviations/ list of language abbreviations].
    Reference:  [http://translatewiki.net/wiki/Special:SupportedLanguages list of language abbreviations].


    == Step 2: Create the Article ==
    == Step 2: Create the Article ==


    Sometimes a link in the language navigation bar already exists. In that case, simply click on the link you want to translate. If no, create the article manually:
    Sometimes a link in the language navigation bar already exists. In that case, simply [http://support.mozilla.com/en/kb/Browsing+basics#clicking_a_link follow the link] you want to translate. Otherwise, create the article manually:
    * [[Development/Tutorials (de)]]
    * [[Development/Tutorials (de)]]
    As initial content simply use the content of the corresponding english page.
    '''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 ==
    == Step 3: Language Navigation Bar ==


    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:
    * <nowiki>{{Template:I18n/Language Navigation Bar|Development/Tutorials}}</nowiki>
    '''(obsolete link removed)'''
    This magic line expands to the language navigation bar for the article <tt>Development/Tutorials</tt>.
    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? ==
    == Step 4: Language Missing? ==
    Line 25: 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.
    Line 41: Line 43:
      3. Development/Tutorials_(de)
      3. Development/Tutorials_(de)
    The english content of (2) uses relative wiki links like <tt>/Debugging</tt>. Translating ''Debugging'' in (3) might result in
    The english content of (2) uses relative wiki links like <tt>/Debugging</tt>. Translating ''Debugging'' in (3) might result in
      Development/Tutorials_(de)/Debugging      # or
      Development/Tutorials_(de)/Debugging      # wrong, or
      Development/Tutorials_(de)/Debugging_(de)
      Development/Tutorials_(de)/Debugging_(de) # wrong
    '''This is wrong.'''
    '''This is wrong.'''


    The rule of thumb is that the language abbreviation always apears at the very end of the article, that is the '''right link''' is supposed to be  
    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)
      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).
    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 [[KDE_TechBase:Contributors#Translation_Teams|translation teams]]'''.

    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.