GRASS-Wiki:Language policy: Difference between revisions

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:

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.
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. [[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.
If this procedure is yet unclear, please leave a comment in the discussion page.

Enjoy and happy translating :)

@@ Line 1: / Line 1: @@
-{{Languages}}
+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.
-This page describes the current multi-lingual policy on GRASS-Wiki.
-== Help: namespace ==
+== Page title ==
-Within the <code>Help:</code> namespace we are building a set of [[Project:PD help|public domain help pages]].  The aim is to provide a basic set of help pages that may be imported into new wikis covering the basic editing and usage instructions.  These should be translated into as many languages as possible.
+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]]).
-* English is the main reference language, and all root pages should be named and written in English.
+When you start translating a page to a new language, its name must follow this convention:
-* Other languages should be placed in an appropriately named sub-page of the English version. E.g. the French version of [[Help:Contents]] should be at [[Help:Contents/fr]] (not Help:Sommaire, Aide:Sommaire or Help:Sommaire/fr).
-* Language sub-pages should be named using the appropriate language code for that language (see [[#Language codes|below]]).
-* Sub-pages should ''only'' be used for translations into other languages, not for English content (e.g. you shouldn't use <code>Table editing/example</code> - use <code>Table editing example</code> or <code>Example of table editing</code> instead).
-* If an international version of a page exists but an English version does not, then please create a stub article for the English version as this aids navigation.
-* All pages in the help namespace should be tagged with the <code>{{[[template:Languages|Languages]]}}</code> template, which automatically creates links to all available translations.
-This system will be compatible with the planned [[Automating help page export|automated import/export of Help pages]], but may need a bit of working around to export/import non-English pages in the interim.
+ Original name/code
-== The main page ==
+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.
-The English version of our front page is located at [[MediaWiki]].  Translated versions are located at MediaWiki/code, where code is the language code (e.g. [[MediaWiki/fr]]).  Please see [[Project:Main page templates]] for more details about creating or editing this content.
+== Category Languages/code ==
-Importantly, the rules about language codes (see [[#Language codes|below]]) should be followed here as well.
+Translated pages are collected based on category "Languages/code", see e.g. list of pages translated to [[:Category:Languages/cs|Czech]].
-== Other namespaces ==
+The rule is: non-English pages must contain at bottom
-Apart from the Main Page, no policy has yet been decided about other namespaces.  For the time being, if you would like to create translations for pages in other namespaces then please do so as described for the Help: namespace, however content may be moved or deleted depending on the policy that is eventually adopted.
+  <nowiki>[[Category:Languages/code]]</nowiki>
-Discussion is ongoing at [[Project:Current issues#Localisation outside the Help: namespace|Project:Current issues]].
+i.e. for Czech it is [[:Category:Languages/cs]], German [[:Category:Languages/de]], etc.
-''Note that the rule that English content should not be placed in sub-pages does not apply to other namespaces.  This is one of the issues that needs resolving.''
+== Template "Trans" ==
+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 ==
-Throughout MediaWiki.org 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 '''(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 [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.
-Please also bear the following in mind:
-* If the language code is not found in Names.php then we should not host help pages in that language.
-* If you want to add a language that is not present, first get it added to the software (by making a request at [[Bugzilla]]) and only add pages here once the changes have been accepted.
-* 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. <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 :)'''