Translation Policy

From LibrePlanet
Revision as of 00:50, 27 May 2011 by Nook35 (talk | contribs) (Naming of translation pages)
Jump to: navigation, search

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.

การตั้งชื่อของหน้าการแปล

หน้าการแปลควรตั้งชื่อในรูปแบบดังต่อไปนี้

<MasterPage>. <LangCode>
</ pre>
ที่ :
; <tt> <MasterPage> </ tt>
: เป็นชื่อของเพจต้นแบบ;
; <tt> <LangCode> </ tt>
: การใช้ภาษาที่ใช้ในการแปล : รหัสตัวพิมพ์เล็ก 2 หลัก ([/ / secure.wikimedia.org/wikipedia/en/wiki/List_of_ISO_639-1_codes ISO 639-1 https]) เป็น

ดังนั้นกฎคือ : หน้าการแปลทำให้ชื่อ (แปล) เดียวกันของหน้าต้นฉบับพร้อมจุดตัวอักษรตามด้วยรหัสตัวพิมพ์เล็ก 2 หลัก (ISO 639-1) ของภาษาที่ใช้ในการแปล

นี้จะส่งผลดีผลการค้นหาสับสนน้อยลงและความสอดคล้องมากขึ้นของวิกิพีเดีย

ตัวอย่าง :
แปลภาษาอิตาลีของ '''<tt> Main_Page '' </ tt>'ของวิกิพีเดียนี้ควรตั้งชื่อเป็น '''<tt> Main_Page.it <tt / >'''.

== Language bar ('Languages' template) ==

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>}}

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}}

its Italian translation page should include at top:

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

Please, note that in both cases the template is called referring to the same master page (this keep them all related each other!), but for the page in English it is used the code 'en' while for the page in Italian it is used the code 'it'.

Semantic language properties

When using the Template:Languages, both the Semantic MediaWiki properties 'Language code' and 'Content language' for the calling page are set to the <LangCode> parameter value. These properties could then be used in semantic queries and searches within this wiki.

In other words, following the example above, when including in a page:

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

it not only will display the language bar, but it also will assign the 'it' value to both the semantic properties 'Language code' and 'Content language' for that page. This means that this page will be matched when searching/querying the Semantic MediaWiki for those pages having the 'Language code' or the 'Content language' property set to 'it'.

Renaming/moving a master page

In order to keep the Template:Languages working as expected when renaming/moving a master page, then the "old" master page should NOT be deleted and a redirection to the "new" master page should be set. This is needed because the translation pages including the Template:Languages still refer to the "old" master page name after it has been renamed/moved.

Only if all the references to the "old" master page in its translation pages were updated with the "new" master page name, then the redirection of the "old" master page is not required.

Example: To rename the Group:LibrePlanetTest\FooPage master page in Group:LibrePlanetTest\FooPageNew keeping at the same time the language bar correctly displaying its translation pages, the 'FooPage' should NOT deleted and its content should be replaced with:

#REDIRECT [[Group:LibrePlanetTest\FooPageNew]]

Aligning existing translation pages to this policy

If a master page has one or more translation, then they should be checked in order to be aligned to this policy.

To do this:

  1. the names of all the translation pages should be aligned to the naming format described above:
    • create a new page for the translation, giving it the "right" name accordingly with the <MasterPage>.<LangCode> format;
    • cut 'n paste ALL the content from the "old" translation page (that with the "wrong" name) to the "new" page just created (that with the "right" name);
    • redirect the "old" translation page to the "new" one;
  2. either the master page and all its translation pages should be checked in order to add a call to the Template:Languages (using the calling format described above) if such a call it is missing or wrong.