Difference between revisions of "Translation Policy"

From LibrePlanet
Jump to: navigation, search
m (Minor improvements to English syntax in an explanation; thanks to Jeanne Rasata of FSF, who clarified how to make such changes.)
m
 
Line 1: Line 1:
 +
{{Info}}
 
{{Languages|master page=Translation Policy|language=en}}{{lang_en}}
 
{{Languages|master page=Translation Policy|language=en}}{{lang_en}}
  

Latest revision as of 08:54, 16 January 2022

Globe-Lp-logo.png
This page documents an official policy of LibrePlanet Wiki.
It describes a widely accepted standard that all editors should normally follow. Changes can be proposed and discussed in the Discussion Channels.


Important note - Before you add or edit a translation of this page or any other page in this wiki, please read the following instructions carefully. Please, DO NOT edit this page if you are not REALLY sure about what you are doing.

Introduction

This documents defines the translation policy for the LibrePlanet wiki.

Terminology used in this document:

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

Naming of translation pages

A translation page should be named using 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.

This will result in better searches findings, less confusion and more consistency of the wiki.

Example: The Italian translation of the Main_Page of this wiki should be named as Main_Page.it.

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.

The Template:Languages 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-digit lowercase code (ISO 639-1) of the language used for the content of the page from which the template itself is being called (whether 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 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 keeps them all related to each other!), but the page in English will use the language code 'en', while the page in Italian will use the language 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.

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' properties 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 translations, 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.