GRASS-Wiki:Language policy: Difference between revisions
(→Category Languages/code: template trans) |
(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]]). | ||
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 | 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.