Difference between revisions of "Translation Policy"

From LibrePlanet
Jump to: navigation, search
(first draft...)
(draft...)
Line 1: Line 1:
 
-- DRAFT --
 
-- DRAFT --
  
== Terminology ==
+
== Introduction ==
  
In this document:
+
This documents defines the translation policy for the [http://libreplanet.org LibrePlanet] wiki.
 +
 
 +
Terminology used in this document:
 
;original [page]
 
;original [page]
 
;master page
 
;master page
Line 20: Line 22:
 
: is the name of the master page;
 
: is the name of the master page;
 
;<tt><LangCode></tt>
 
;<tt><LangCode></tt>
: is the (2-digit lowercase) code ([https://secure.wikimedia.org/wikipedia/en/wiki/List_of_ISO_639-1_codes ISO 639-1]) of the language used by the translation.
+
: is the 2-digits lowercase code ([https://secure.wikimedia.org/wikipedia/en/wiki/List_of_ISO_639-1_codes ISO 639-1]) of the language used by the translation.
  
So, the rule is: the translation page keeps the same (untranslated) name of the original page, plus a dot character followed by the 2-digit lowercase ISO 639-1 code of the language used by the translation.
+
So, the rule is: the translation page keeps the same (untranslated) name of the original page, plus a dot character followed by the 2-digits lowercase code (ISO 639-1) of the language used by the translation.
  
 
Example:
 
Example:
Line 29: Line 31:
 
== Language bar ==
 
== Language bar ==
  
 +
When some translation of a master page exist in the wiki, then either the master page or each of its translation pages should display (at their top) a language bar linking to all the available translations.
  
 +
To do this, the master page and all its translation pages should call (at their top) the [[Template:Languages]].
 +
 +
This template should be called in the following format:
 +
<pre>
 +
{{Languages|master page=<MasterPage>|language=<LangCode>}}
 +
</pre>
 +
where:
 +
;<tt><MasterPage></tt>
 +
: is the name of the master page;
 +
;<tt><LangCode></tt>
 +
: is the 2-digits lowercase code (ISO 639-1) of the language used for the content of the page from which the template itself is being called (no matter if it is the master page or one of its translations).
  
 +
Example:
 +
The '''<tt>Main_Page</tt>''' of this wiki has been written in English, so it should include at top: <br />
 +
<pre>
 +
{{Languages|master page=Main_Page|language=en}}
 +
</pre>
 +
and i.e. its Italian translation page should include at top:
 +
<pre>
 +
{{Languages|master page=Main_Page|language=it}}
 +
</pre>
  
 
== Aligning existing translation pages to this policy ==
 
== Aligning existing translation pages to this policy ==

Revision as of 20:48, 27 January 2011

-- DRAFT --

Introduction

This documents defines the translation policy for the LibrePlanet wiki.

Terminology used in this document:

original [page]
master page
- refer to the original page (in the language used by the author) from which the translations are made;
translation [page]
- refers to a page that contains a translation of an original page.

Naming of translation pages

A translation page should be named in the following format:

<MasterPage>.<LangCode>

where:

<MasterPage>
is the name of the master page;
<LangCode>
is the 2-digits lowercase code (ISO 639-1) of the language used by the translation.

So, the rule is: the translation page keeps the same (untranslated) name of the original page, plus a dot character followed by the 2-digits lowercase code (ISO 639-1) of the language used by the translation.

Example: The French translation of the Main_Page of this wiki should be named as Main_Page.fr.

Language bar

When some translation of a master page exist in the wiki, then either the master page or each of its translation pages should display (at their top) a language bar linking to all the available translations.

To do this, the master page and all its translation pages should call (at their top) the Template:Languages.

This template should be called in the following format:

{{Languages|master page=<MasterPage>|language=<LangCode>}}

where:

<MasterPage>
is the name of the master page;
<LangCode>
is the 2-digits lowercase code (ISO 639-1) of the language used for the content of the page from which the template itself is being called (no matter if it is the master page or one of its translations).

Example: The Main_Page of this wiki has been written in English, so it should include at top:

{{Languages|master page=Main_Page|language=en}}

and i.e. its Italian translation page should include at top:

{{Languages|master page=Main_Page|language=it}}

Aligning existing translation pages to this policy