Template:Language/archives/Lang2/doc

This is a documentation subpage for Template:Language.
Don't forget to purge the contents of the base page upon creating or editing this subpage.

Purge base's cache

A translation template. Successor to both {{Lang}} (itself was forked to create {{Lang2}}) and {{MultiPage}}, while solving most of the limitations in both templates. Currently the template is largely incomplete and cannot be used in any pages until bugs or issues is fixed. Also this template only support very few languages as it was being rewritten to only support languages that are most popular, and to cleaning up code before adding new languages.

Differences

Features	{{Lang}}	{{Lang2}} (this template)	{{MultiPage}}	{{Page}}
Language subpage location	English: None (base page) Other languages: Page_name{{:}}Lang	English: None (base page) Other languages: Page_name/Lang	All, including English are located in Page_name/Lang. The base page itself just contains {{MultiPage}}.	Rely on {{Strings}} or {{Autolang}}, meant that all other languages are hidden in the base page.
Requires purge?	Base page only, in order to display the language icons if the translated page (except English) is edited or created. [confirm]	Same as {{Lang}}[confirm].	Required	No
Category translation support	Yes, has separate translated category page which only list translated pages.	Unknown	Yes, but translated pages are not added to the translated category page, unlike {{Lang}}.	Unknown
Preview languages	Yes	Yes	Yes	English only

Usage

For existing pages using {{Lang}}:

1. On the "Half-Life 2" page for example, edit all page, including translated one and replace {{Lang}} with {{Lang2}}.
2. Remove suf-based language suffixes (|suf=: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 Notepad++ (or other software), and replace all (|suf=:de) with blank text.
3. Remove the language suffixes on the language categories from all language subpages. For example, [[Category:My Cute Category:ru]] will become.
4. Move the page of the translated page (the one with |suf=:<language code> suffix) to new suffix My Cute Article/<language code> (for example, My Cute Article:zh-cn will become an My Cute Article/zh);
5. Move the shared or international templates (such as navboxes, topicons, etc...) to the base page;

Todo: Should we bring back separate language categories (which Lang uses) or remove it like MultiPage?

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

Parameters and Examples

Parameter	Description	Example
{{{1}}}	The page that the template create multi-language links according to. It is required for other translation page. The contents of it should be the full name of the page the template is being applied on, including namespaces such as Help:, Template:, User:, etc. It should not include any language suffixes, however, such as /ru, /es, /zh, etc. Note:Capitalization matters, even on the first letter of the page name! Underscores must be replaced with spaces. ai_changehintgroup must be written as Ai changehintgroup. However, this parameter can be omitted if the page name is without a suffix. Confirm:Is this fixed with Lang2? If not, feel free to fix this issues if you can. Tip:You can use {{Lang2|{{FULLPAGENAME}}}} instead of writing the article name, unless there are any issues mentioned above.	{{Lang2|{{FULLPAGENAME}}}} {{Lang2|Template:Lang2}}
{{{2}}} ~ {{{8}}}	These parameters are used to link subpages (such as L4D2 Level Design/Add-on Notes, L4D Level Design/Panic Events, Half-Life: Alyx Workshop Tools/Animgraph/AnimGraph Introduction, etc.). Just replace "/" with "|" to link correctly. See the examples for details how to use them. Note:The subpages must be moved to a correctly name so that the template can link them. Non-English subpage names must follow this format: <page1><lang code>/<page2><lang code>/..., such as L4D Level Design/Panic Events/zh	{{Lang2|L4D2 Level Design|Add-on Notes}} {{Lang2|L4D Level Design|Panic Events}} {{Lang2|Half-Life: Alyx Workshop Tools|Animgraph|AnimGraph Introduction}}
{{{title}}}	This parameter can be used to change the page title (logically, into the text that should be displayed for the language of the page). Warning:On some pages you may receive this error: Warning: Display title "env_cubemap" overrides earlier display title "<code>Env cubemap</code>". This can be due to the fact that the page uses a different template in which the page title is set.	{{Lang2|title=Template:Lang2}}
{{{$title}}}	This parameter can be used to change the text of the page titlebar and place the title under the <code> tag - {{Lang2|Template:Lang2|$title=$model}}.	{{Lang2|$title=Template:Lang2}}
{{{notitle}}}	This parameter can be used to change the title of the site page itself, but not for the title of the article itself.	{{Lang2|notitle=1}}
{{{noborder}}}	This parameter can be set to 1 to hide the border around lang icons. If you don't plan on using it, don't bother defining it.	{{Lang2|noborder=1}}
{{{select}}}	The selection mode of the title. 1 is the one-click selection (just like clicking the "1").	{{Lang2|Template:Lang2|select=1}}
{{{up}}}	Todo: Document it.	[Todo]

Currently Supported Languages

• Coming soon.
• Also, this template automatically adds a page language category at the bottom of the page.