GRASS-Wiki:Language policy: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
m (Reverted edits by Ghlimassuh (talk) to last revision by Neteler)
 
(14 intermediate revisions by 5 users not shown)
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/id", 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.
We have the template [[Template:Trans|Trans]] for master pages which are undergoing the process of translation. Please add it if you don't complete the translation so that you/others can easily find it back:
 
<nowiki>{{Trans|Russian|English}}</nowiki>
 
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 majority 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.
== Detailed procedure ==
If you want to translate a Wiki page, then:
# Generate a new page with language suffix, e.g. /de. For example, to generate the page <nowiki>http://grass.osgeo.org/wiki/Help_with_3D/de</nowiki>, just enter this URL in your browser. The page won't exist yet and you can open it for editing. See also [http://meta.wikimedia.org/wiki/Help:Starting_a_new_page Starting a new page].
# copy the Wiki-Code of the (english) original page into the new page (use "editing" in the original page to see it). In this example, copy the Wiki code from http://grass.osgeo.org/wiki/Help_with_3D into http://grass.osgeo.org/wiki/Help_with_3D/de
# Add the language category at page bottom, e.g. <nowiki>[[Category:Languages/de]]</nowiki>, then start translating. If you don't manage to finish the translation, add the "work in progress" template at page top (<nowiki>{{Trans|Deutsch|English}}</nowiki>). This <nowiki>{{Trans|Deutsch|English}}</nowiki> will generate an entry <blockquote> This page is in progress of translating to Deutsch from English</blockquote> in the page to notify the potential readers.
# If this procedure is yet unclear, please leave a comment in the discussion page.
'''Enjoy and happy translating :)'''

Latest revision as of 15:09, 15 May 2013

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/id", 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"

We have the template Trans for master pages which are undergoing the process of translation. Please add it if you don't complete the translation so that you/others can easily find it back:

{{Trans|Russian|English}}

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 majority 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.

Detailed procedure

If you want to translate a Wiki page, then:

  1. Generate a new page with language suffix, e.g. /de. For example, to generate the page http://grass.osgeo.org/wiki/Help_with_3D/de, just enter this URL in your browser. The page won't exist yet and you can open it for editing. See also Starting a new page.
  2. copy the Wiki-Code of the (english) original page into the new page (use "editing" in the original page to see it). In this example, copy the Wiki code from http://grass.osgeo.org/wiki/Help_with_3D into http://grass.osgeo.org/wiki/Help_with_3D/de
  3. Add the language category at page bottom, e.g. [[Category:Languages/de]], then start translating. If you don't manage to finish the translation, add the "work in progress" template at page top ({{Trans|Deutsch|English}}). This {{Trans|Deutsch|English}} will generate an entry

    This page is in progress of translating to Deutsch from English

    in the page to notify the potential readers.
  4. If this procedure is yet unclear, please leave a comment in the discussion page.

Enjoy and happy translating :)