View source for Template:Language/archives/MultiPage/doc

{{Doc/subpage}}

{{Warning|Editors, please read this! If you have moved a {{t|lang}} page other than English, you must remove the old language category page (anything ends with Category:(Page Name):es or Category:(Page Name):(language code) for example).<br>Furthermore, if you also moving the English {{t|Lang}} page aswell, you must move the category back to the main ({{t|MultiPage}}) page to avoid showing the language subpage on category.}}

{{Bug|If the user changes the font size (other than 16px) on the web browser, the language toolbar will get overlapped with topicons (e.g. {{t|HLATools topicons}}). Similarly, the language toolbar will also be slightly off when users visit the redirected page. This is a limitations in MediaWiki software itself.}}

{{Todo|Add a {{t|Error}} message to warn editors who have previously added MultiPage, but forgot to remove {{t|Lang}}.}}

A translation template. Replacement for {{T|Lang}}.

The template will look for translation subpages and load one of them according to the interface language. The template will load the English version and display a message if the translation subpage does not exist. The template will only display a message if there are not any translations and the English version does not exist.

== Creating a new page ==
Just create an empty page, put a {{t|MultiPage}} on it, click on the translation button ( [[File:Icon-translate.png|12px|link=]] ) in the upper right corner and select the primary language. After making a choice, {{t|MultiPage}} will redirect you to edit the language subpage on which you will need to place your text and template {{t|Language subpage}} (placed on top).

== Usage on existing pages ==
'''Before using it on an existing page, or attempt to replace {{T|Lang}} with {{T|MultiPage}}, you should make sure that you have done the following steps:'''

# On the "My Cute Article" page, edit the page and replace {{t|Lang}} with {{t|Language subpage}} or {{t|Langsp}} (shortcut for {{T|Language subpage}}, which is faster to type). Do the same for the other translated page.
# Remove language suffixes ({{Code|<nowiki>:pt-br</nowiki>}}, {{Code|{{!}}suf{{=}}<nowiki>:</nowiki>de}}) from all language subpages, and if the template support Autolang, remove it from all templates as well. They are deprecated and no longer needed. {{Tip|You can use {{npp|4}} (or other software), and replace all ({{Code|<nowiki>:pt-br</nowiki>}}, {{Code|{{!}}suf{{=}}<nowiki>:</nowiki>de}}) with blank text.}}
# Remove language categories (for example, {{Code|<nowiki>[[Category:My Cute Category:ru]]</nowiki>}}) from all language subpages. They are deprecated and no longer needed.
# Move the English content of the My Cute Article page to its language subpage My Cute Article/en {{ModernImportant|Do not move associated talk page, however if there are talk pages on any languages other than English, you can move them.}}
# Move the page of the translated My Cute Article page to its language subpage My Cute Article/<[[#SupportedLanguages|language code]]> (for example, My Cute Article:zh-cn will become an My Cute Article/zh);
# Move English categories (without any language suffixes) to the base (main) page, aka the one with {{Code|<nowiki>{{MultiPage}}</nowiki>}} (for example, to the My Cute Article page);
# Move the shared or international templates to the base page;

: If the article pertains to an entity, move the {{code|{{t|This is a}}}} template to the root page. The template is automatically translated. For {{code|{{t|Entity}}}} or {{code|{{t|Format}}}} templates, replace it with {{T|This is a}} template.

After the above steps, place {{t|MultiPage}} on the base page above the categories and enjoy what you see.

{{Note|It is also recommended to clean and improve the code of the pages. For example, you could replace all {{Code|<nowiki>{{note}}</nowiki>}} with {{Code|<nowiki>{{Note}}</nowiki>}}, and add the tab spacing with some line breaks.}}

{{ModernImportant|Do not categorize the language subpages, and if they have any categories, remove them.}}

<!-- {{ModernImportant|Not fully supported with Categories, it may show empty subcategories of the language page.}} -->

== Using the parameter {{param|no-en-subpage}} ==
This parameter allows you to keep the English content on the main page, instead of moving the English content to the subpages. This is useful for pages that are move protected by wiki administrators.
=== Creating a new page ===
Just create a new page as normal, write down your content (in English). Then place the template before your content, and place {{t|MultiPage/end}} - a sub-template of {{t|MultiPage}} at the end of the content. Don't contain categories. For example:
{{CodeBlock|<nowiki>{{MultiPage|no-en-subpage=1}}
Example text.
{{MultiPage/end}}
[[Category:English]]
[[Category:Level Design]]</nowiki>}}
For creating pages for other languages, just click on the translation button ( [[File:Icon-translate.png|12px|link=]] ) in the upper right corner and select the language you want to translate. The content from English page will shows up, then you can start translating them. If nothing shows up, you may need to copy the content on the English page manually.

=== Usage on existing pages ===
Similar to the previous, but with differences:
* On main page (in English), place {{T|MultiPage}} before the content, and place {{tl2|MultiPage/end}} at the end of the content (See the example above). '''Don't move the English content to its language subpage''' (/en).
* The methods of other languages remain unchanged.

== Parameters and Examples ==
{| class="standard-table" style="width:100%"
!style="width:10%"|Parameter
!Description
!Example
|-
| align="center" | No Parameters
| Places a template.
|{{CodeBlock|{{((}}{{ROOTPAGENAME}}{{))}}}}
|-
| align="center" | {{Code|preset=2|{{param|title}}}}
| ''Optional:'' This parameter can be used to change the text of the page titlebar (logically, into the text that should be displayed for the language of the page).
{{Note|if {{Code|%short}} is specified, the long page title (e.g. Source/Docs) will be shortened to the current subpage (i.e. Docs)}}
{{Note|if a page has a translation and you want to specify the correct page title for that translation, specify the language suffix in {{param|title}} (for example, {{Code|<nowiki>| title:zh = SDK的安装)</nowiki>}}. To see all available language suffixes, see [[#Other]].}}
{{Warning|On some pages you may receive this error: '''Warning''': Display title "env_cubemap" overrides earlier display title <nowiki>"<code>Env cubemap</code>"</nowiki>. This can be due to the fact that the page uses a different template in which the page title is set. For example, {{Code|{{tl2|shortpagetitle}}}}.}}
| {{CodeBlock|<nowiki>{{MultiPage
| title = Main Page
}}</nowiki>}}
  {{CodeBlock|<nowiki>{{MultiPage
| title = %short
}}</nowiki>}}
  {{CodeBlock|<nowiki>{{MultiPage
| title = Level Design
| title:es = Diseño de mapa
}}</nowiki>}}
|-
| align="center" | {{Code|preset=2|{{param|margin-right}}}}
| ''Optional:'' The right margin of the buttons that are to the right top. 
| {{CodeBlock|<nowiki>{{MultiPage|title = Main Page|margin-right=26px}}</nowiki>}}
|- 
| align="center" | {{Code|preset=2|{{param|no-en-subpage}}}}
| ''Optional:'' If you don't move the original English page to the subpage {{Code|/en}}, and this will allow you stay the original content on the main page. Specify it as {{Code|1}} to take effect. {{Note|The template must be placed before the content, or it cannot be worked. You must place the template {{tl2|MultiPage/end}} at the end of the content. See also example.}}
| {{CodeBlock|<nowiki>{{MultiPage|no-en-subpage=1}}
{{Lorem}}
{{MultiPage/end}}</nowiki>}}
|}

== Examples ==
{{CodeBlock|{{((}}MultiPage{{))}}}}

{{Note|If you want to change the title, use the parameter {{Code|preset=2|{{param|title}}}} of {{T|Language subpage}} in language subpages so that the title will change automatically. Otherwise, you can
{{CodeBlock|{{((}}MultiPage{{!}}title {{=}} My sweet page{{))}}}} for non-translatable title.}}

== Approximate translations of each language ==
Only subpages (/en ...) and articles that are in the [[:Category:Languages|Languages]] category. 
<center>
{{Userbox|id={{Flag|en}}|info={{PAGESINCAT:English|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:English|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|pt-br}}|info={{PAGESINCAT:Brazilian Portuguese‎|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Brazilian Portuguese‎|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|zh}}|info={{PAGESINCAT:Chinese|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Chinese|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|hr}}|info={{PAGESINCAT:Croatian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Croatian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|cs}}|info={{PAGESINCAT:Czech|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Czech|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|nl}}|info={{PAGESINCAT:Dutch|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Dutch|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|eo}}|info={{PAGESINCAT:Esperanto|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Esperanto|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|et}}|info={{PAGESINCAT:Estonian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Estonian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|fi}}|info={{PAGESINCAT:Finnish|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Finnish|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|fr}}|info={{PAGESINCAT:French|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:French|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|ka}}|info={{PAGESINCAT:Georgian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Georgian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|de}}|info={{PAGESINCAT:German|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:German|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|el}}|info={{PAGESINCAT:Greek|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Greek|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|he}}|info={{PAGESINCAT:Hebrew|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Hebrew|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|hu}}|info={{PAGESINCAT:Hungarian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Hungarian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|it}}|info={{PAGESINCAT:Italian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Italian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|ja}}|info={{PAGESINCAT:Japanese|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Japanese|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|ko}}|info={{PAGESINCAT:Korean|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Korean|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|no}}|info={{PAGESINCAT:Norwegian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Norwegian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|pl}}|info={{PAGESINCAT:Polish|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Polish|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|pt}}|info={{PAGESINCAT:Portuguese|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Portuguese|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|ru}}|info={{PAGESINCAT:Russian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Russian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|es}}|info={{PAGESINCAT:Spanish|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Spanish|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|sv}}|info={{PAGESINCAT:Swedish|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Swedish|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|zh-tw}}|info={{PAGESINCAT:Taiwanese Mandarin‎|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Taiwanese Mandarin‎|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|tr}}|info={{PAGESINCAT:Turkish|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Turkish|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|uk}}|info={{PAGESINCAT:Ukrainian|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Ukrainian|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
{{Userbox|id={{Flag|vi}}|info={{PAGESINCAT:Vietnamese‎|pages}} out of {{NUMBEROFARTICLES}}, {{#expr:(({{formatnum:{{PAGESINCAT:Vietnamese‎|pages}}|R}} / {{formatnum:{{NUMBEROFARTICLES}}|R}}) * 100) round 2}}% translated.}}
</center>

== Other ==
<!-- Please remember to sort the ISO 639 language codes from A-Z if you are adding new languages -->
{| class="standard-table sortable" id="SupportedLanguages" style="width:100%"
|+ Currently Supported Languages
! Language
! Page name
! Icon
|- 
| English		||Page_name/en		||{{Flag|en}}
|- 
| Catalan		||Page_name/ca		||{{Flag|ca}}
|- 
| Czech			||Page_name/cs		||{{Flag|cs}}
|- 
| German		||Page_name/de		||{{Flag|de}}
|- 
| Greek			||Page_name/el		||{{Flag|el}}
|- 
| Esperanto		||Page_name/eo		||{{Flag|eo}}
|-
| Spanish		||Page_name/es		||{{Flag|es}}
|-
| Estonian		||Page_name/et		||{{Flag|et}}
|- 
| Finnish		||Page_name/fi		||{{Flag|fi}}
|- 
| French		||Page_name/fr		||{{Flag|fr}}
|- 
| Hebrew		||Page_name/he		||{{Flag|he}}
|- 
| Hindi			||Page_name/hi		||{{Flag|hi}}
|- 
| Hungarian		||Page_name/hu		||{{Flag|hu}}
|- 
| Croatian		||Page_name/hr		||{{Flag|hr}}
|- 
| Italian		||Page_name/it		||{{Flag|it}}
|- 
| Japanese		||Page_name/ja		||{{Flag|ja}}
|-
| Georgian		||Page_name/ka		||{{Flag|ka}}
|- 
| Khmer			||Page_name/km		||{{Flag|km}}
|- 
| Korean		||Page_name/ko		||{{Flag|ko}}
|- 
| Malay			||Page_name/ms		||{{Flag|ms}}
|- 
| Dutch			||Page_name/nl		||{{Flag|nl}}
|- 
| Norwegian		||Page_name/no		||{{Flag|no}}
|- 
| Polish		||Page_name/pl		||{{Flag|pl}}
|- 
| Portuguese		||Page_name/pt		||{{Flag|pt}}
|- 
| Portuguese (Brazilian)||Page_name/pt-br	||{{Flag|pt-br}}
|- 
| Russian		||Page_name/ru		||{{Flag|ru}}
|- 
| Swedish		||Page_name/sv		||{{Flag|sv}}
|- 
| Turkish		||Page_name/tr		||{{Flag|tr}}
|- 
| Ukrainian		||Page_name/uk		||{{Flag|uk}}
|- 
| Vietnamese		||Page_name/vi		||{{Flag|vi}}
|- 
| Simplified Chinese (PRC)	||Page_name/zh		||{{Flag|zh}}
|- 
| Traditional Chinese (Taiwan)	||Page_name/zh-tw	||{{Flag|zh-tw}}
|- 
|}

{{Doc/Sandbox other|[[Category:Translation templates]]}}