Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

Export in CSV format

<languages />
<div lang="en" dir="ltr" class="mw-content-ltr">
This page describes the current '''multi-lingual policy on MediaWiki.org'''.
</div>
[[Image:Geographylogo.svg|{{dir|{{pagelang}}|left|right}}|150px|<span lang="en" dir="ltr" class="mw-content-ltr">Languages</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
== Help: namespace ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The <code>Help:</code> namespace contains a set of [[Special:MyLanguage/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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* English is the main reference language, and all root pages should be named and written in English.
* 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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

{{anchor|translate-extension}}
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Translate extension ===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">We use the {{ll|Extension:Translate|Translate}} extension for hundreds of pages.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">These use the subpage convention, with <nowiki>{{#translation:}}</nowiki> for categories.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
The system is recommended at least for most visited pages and all new help, manual and (main) extension pages, but no policy has been established on this yet.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*To translate: just go to [[Special:LanguageStats]] and start translating.
*To administer translations: [[Special:PageTranslation]], [[Special:AggregateGroups]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can request a page to be added to translation by preparing it for translation, then a translation administrator will have to enable it (see the tutorial [[Special:MyLanguage/Help:Extension:Translate/Page translation example|How to prepare a page for translation]]); otherwise, ask directly to one of the [[Project:Translation administrators|translation administrators]] to do it.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Old system===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Other languages should be placed in an appropriately named sub-page of the English version. For example, the French version of [[Help:Contents]] should be at [[Help:Contents/fr]] (not Help:Contenu, Aide:Contenu or Help:Contenu/fr).
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Language sub-pages should be named using the appropriate language code for that language (see [[#langcodes|below]]).
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* All pages in the help namespace should be tagged with the <code>{{tl|Languages}}</code> template, which automatically creates links to all available translations.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Convert to Translate===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">The pages with existing translations are usually worth being made into translatable pages.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Prepare the (English) root page for translation (see [[#translate-extension|the Translate extension section]]) and, as soon as it's marked for translation, manually import the old translations from the history of subpages to the translation units (by clicking <code>{{int|translate-tag-translate-link-desc}}</code>).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The new feature [[Special:PagePreparation]] + [[Special:PageMigration]] facilitates this (currently available only for translation administrators).</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
A list of pages translated with the old system, to be migrated to the new, is in the works at [[Project:Language policy/Migration list]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
More detailed instructions:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* For a full introduction, read the [[Special:MyLanguage/Help:Extension:Translate|basic help]], [[Special:MyLanguage/Help:Extension:Translate/Translation example|translation tutorial]], [[Special:MyLanguage/Help:Extension:Translate/Page translation example|page translation tutorial]] and [[Special:MyLanguage/Help:Extension:Translate/Page translation administration|translation reference manual]].
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Login or register on mediawiki.org: all your work will happen on this wiki. Pick one page to migrate to Translate from [[Project:Language_policy/Migration_list|the migration list]] (on the list's talk page, you can ask any question). Polish the English text as fit/possible to avoid migrating very obsolete/low quality text, skip pages where unsure. Prepare the page for translation (i.e. add {{tag|translate|open}} tags etc.)  following the page translation tutorial linked above; then edit the migration list, writing next to the page's title that you've done it.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* A [[Special:ListUsers/translationadmin|translation administrator]] (you?) will now approve ("mark") the page for translation at their discretion. When it's approved, complete the job: copy the old translations to corresponding units with Special:Translate (as a translator would do in the translation tutorial linked above). You don't need to know the language you're migrating, only to identify which paragraph corresponds to which, even though it's not a loyal translation (machine translation can help grasp the meaning if the layout of the page doesn't provide enough hints).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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 [[Template:Main page]] for content of main page; you can translate it there.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Importantly, the rules about language codes (see [[#langcodes|below]]) should be followed here as well.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Other namespaces ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For some discussions, see [[Project:Village Pump/Archive 2#Languages|Languages]] and [[Project:Village Pump/Flow/2012#c-Nemo_bis-2012-10-21T09:23:00.000Z-Translate_extension|Translate extension]] at the village pump.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''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.''
</div>

{{anchor|langcodes}}
<div lang="en" dir="ltr" class="mw-content-ltr">
== Language codes ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Throughout MediaWiki.org you should use the language codes specified by the MediaWiki software when creating language-specific content (see [[phab:diffusion/MW/browse/master/includes/Languages/Data/Names.php|Names.php]] for the full and up-to-date list).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Please also bear the following in mind:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* If the language code is not found in Names.php then we should not host help pages in that language.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* If you want to add a language that is not present, first get it added to the software (by making a request at [[Special:MyLanguage/Phabricator|Phabricator]]) and only add pages here once the changes have been accepted.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* 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 [[Special:MyLanguage/Phabricator|Phabricator]], and if this results in it being changed we will move the pages to match.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Note that some language codes in Names.php are now deprecated (e.g. <code>zh-yue</code> has been replaced with <code>yue</code>).  In these cases only the most recent code should be used.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Generally, translating language variants (e.g. <code>zh-hans</code>) is discouraged and should be added into the main page (e.g. <code>zh</code>) where possible.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>
* {{ll|Project:Translation}}
* [[Special:TranslatorSignup]] — <span lang="en" dir="ltr" class="mw-content-ltr">Translator's register form</span>
* {{ll|Project:PD help}}

[[Category:MediaWiki Communication{{#translation:}}]]