GRASS-Wiki:Language policy: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
(polished; one TODO left)
Line 1: Line 1:
This page describes the current multi-lingual policy on GRASS-Wiki.
You want to translate pages of this Wiki? Great, read on! This page describes the current multi-lingual policy on GRASS-Wiki. All pages get auto-indexed after a few minutes and the language link appears on the left in the menu.


== Page title ==
== Page title ==


The English version of our front page is located at [[GRASS-Wiki]]. Translated versions are located at GRASS-Wiki/code, where code is the language code (e.g. [[GRASS-Wiki/cs]]).
The English version of our front page is located at [[GRASS-Wiki]]. Translated versions are located at GRASS-Wiki/code, where code is the language code (e.g. [[GRASS-Wiki/cs]] for Czech language). It is important to follow the language codes rules in order to enable Mediawiki to auto-index the translation (for language codes, see [[#Language codes|below]]).


Importantly, the rules about language codes (see [[#Language codes|below]]) should be followed here as well. When you start translating a new page, its name must follow this convention
When you start translating a page to a new language, its name must follow this convention:


  Original name/code
  Original name/code


for example, a page with the Czech translation of [[GRASS Community]] will be called "GRASS Community/cs".
for example, a page with the Czech translation of [[GRASS Community]] will be called "GRASS Community/cs", Indonesian is "GRASS Community/cs", for German it becomes "GRASS Community/de" etc.


== Category Languages/code ==
== Category Languages/code ==
Line 15: Line 15:
Translated pages are collected based on category "Languages/code", see e.g. list of pages translated to [[:Category:Languages/cs|Czech]].
Translated pages are collected based on category "Languages/code", see e.g. list of pages translated to [[:Category:Languages/cs|Czech]].


The rule is: non-English pages must contain
The rule is: non-English pages must contain at bottom


  <nowiki>[[Category:Languages/code]]</nowiki>
  <nowiki>[[Category:Languages/code]]</nowiki>
Line 21: Line 21:
i.e. for Czech it is [[:Category:Languages/cs]], German [[:Category:Languages/de]], etc.
i.e. for Czech it is [[:Category:Languages/cs]], German [[:Category:Languages/de]], etc.


== Template Trans ==
== Template "Trans" ==


When you are translating a page, please include also template [[Template:Trans|Trans]]. This template will be removed when the translation of the page is finished.
TODO: add here what's the cope of this template
 
When you are translating a page, please include also template [[Template:Trans|Trans]]. This template is to be removed when the translation of the page is finished.


== Language codes ==
== Language codes ==


Throughout GRASS-Wiki you should use the language codes specified by the MediaWiki software when creating language-specific content (see [http://svn.wikimedia.org/svnroot/mediawiki/trunk/phase3/languages/Names.php Names.php] for the full and up-to-date list).
Throughout the GRASS-Wiki, you should use the language codes specified by the MediaWiki software when creating language-specific content (see [http://svn.wikimedia.org/svnroot/mediawiki/trunk/phase3/languages/Names.php Names.php] for the full and up-to-date list).


Please also bear the following in mind:
Please also bear the following in mind '''(but this won't apply to the lajority of languages!)''':


* If the language code is not found in Names.php then we should not host help pages in that language
* If the language code is not found in Names.php then we should not host help pages in that language (since the indexing mechanism would fail)


* If you want to add a language that is not present, first get it added to the software (by making a request at [http://www.mediawiki.org/wiki/Bugzilla Bugzilla]) and only add pages here once the changes have been accepted.
* If you want to add a language that is not present in Mediawiki, first get it added to the software (by making a request at [http://www.mediawiki.org/wiki/Bugzilla Bugzilla]) and only add pages here once the changes have been accepted and the GRASS Wiki been updated accordingly.


* If MediaWiki uses the 'incorrect' code for a language then you should also (for consistency) use that incorrect code here.  If you think a code is incorrect you should discuss it on [http://www.mediawiki.org/wiki/Bugzilla Bugzilla], and if this results in it being changed we will move the pages to match.
* If MediaWiki uses the 'incorrect' code for a language then you should also (for consistency) use that incorrect code here.  If you think a code is incorrect you should discuss it on [http://www.mediawiki.org/wiki/Bugzilla Bugzilla], and if this results in it being changed we will move the pages to match.


* Note that some language codes in Names.php are now deprecated (e.g. <tt>zh-yue</tt> has been replaced with <tt>yue</tt>).  In these cases only the most recent code should be used.
* Note that some language codes in Names.php are now deprecated (e.g. <tt>zh-yue</tt> has been replaced with <tt>yue</tt>).  In these cases only the most recent code should be used.

Revision as of 08:01, 8 July 2008

You want to translate pages of this Wiki? Great, read on! This page describes the current multi-lingual policy on GRASS-Wiki. All pages get auto-indexed after a few minutes and the language link appears on the left in the menu.

Page title

The English version of our front page is located at GRASS-Wiki. Translated versions are located at GRASS-Wiki/code, where code is the language code (e.g. GRASS-Wiki/cs for Czech language). It is important to follow the language codes rules in order to enable Mediawiki to auto-index the translation (for language codes, see below).

When you start translating a page to a new language, its name must follow this convention:

Original name/code

for example, a page with the Czech translation of GRASS Community will be called "GRASS Community/cs", Indonesian is "GRASS Community/cs", for German it becomes "GRASS Community/de" etc.

Category Languages/code

Translated pages are collected based on category "Languages/code", see e.g. list of pages translated to Czech.

The rule is: non-English pages must contain at bottom

[[Category:Languages/code]]

i.e. for Czech it is Category:Languages/cs, German Category:Languages/de, etc.

Template "Trans"

TODO: add here what's the cope of this template

When you are translating a page, please include also template Trans. This template is to be removed when the translation of the page is finished.

Language codes

Throughout the GRASS-Wiki, you should use the language codes specified by the MediaWiki software when creating language-specific content (see Names.php for the full and up-to-date list).

Please also bear the following in mind (but this won't apply to the lajority of languages!):

  • If the language code is not found in Names.php then we should not host help pages in that language (since the indexing mechanism would fail)
  • If you want to add a language that is not present in Mediawiki, first get it added to the software (by making a request at Bugzilla) and only add pages here once the changes have been accepted and the GRASS Wiki been updated accordingly.
  • If MediaWiki uses the 'incorrect' code for a language then you should also (for consistency) use that incorrect code here. If you think a code is incorrect you should discuss it on Bugzilla, and if this results in it being changed we will move the pages to match.
  • Note that some language codes in Names.php are now deprecated (e.g. zh-yue has been replaced with yue). In these cases only the most recent code should be used.