Template:Language/doc: Difference between revisions

Latest revision as of 18:44, 12 August 2026

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Language.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာမန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha / ўзбекча ∙ Tiếng Việt ∙ 中文 ∙ 中文（简体） ∙ 中文（繁體） ∙ 中文（臺灣） ∙ +/−

Template based on the #language parser (help page). It returns a language name in the user's language, or in any other language specified by a second parameter.

Usage

Template parameters

Parameter	Description		Default	Status
`1`	Language code (most of the time—but not always—this is an ISO code). See https://phabricator.wikimedia.org/diffusion/ECLD/browse/master/CldrMain/CldrMainEn.php for a list		empty	optional
`2`	Language in which the language name should be returned (if different from the user's preferred language).		`{{int:lang}}`	optional

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

Examples

`{{language\|ar}}` → Arabic `{{language\|ar\|de}}` → Arabisch `{{language\|ar\|en}}` → Arabic `{{language\|ar\|fr}}` → arabe `{{language\|ar\|he}}` → ערבית `{{language\|ar\|zh-Hans}}` → 阿拉伯语	`{{language\|en}}` → English `{{language\|en\|de}}` → Englisch `{{language\|en\|en}}` → English `{{language\|en\|fr}}` → anglais `{{language\|en\|he}}` → אנגלית `{{language\|en\|zh-Hans}}` → 英语

@@ Line 1: / Line 1: @@
-{{documentation subpage}}
+{{TemplateBox
+|name = language
+|desc={{LangSwitch|default=Template based on the <code>#language</code> parser ([[mw:Help:Magic_words#Miscellaneous|help page]]). It returns a language name in the user's language, or in any other language specified by a second parameter.|fr=Modèle basé sur l'analyseur <code>#language</code> ([[mw:Help:Magic_words#Miscellaneous|page d'aide]]). Il renvoie un nom de langue dans la langue de l'utilisateur ou dans n'importe quelle autre langue spécifiée par un second paramètre.|zh=基于 <code>#language</code> 解析器 ([[mw:Help:Magic_words#Miscellaneous|帮助页面]]) 的模板。可返回某个语言代码对应的名称，可以按用户的语言显示，也可以用第二个参数指定显示结果的语言。}}
-This template will return the name of a language given the language code. This template is made specifically for the language codes used in MediaWiki (not necessarily ISO codes, but see {{tl|Language/ISO 639/en}}).
+|1=1
+|1d-en=Language code (most of the time—but not always—this is an [[:w:ISO 639-3|ISO code]]). See https://phabricator.wikimedia.org/diffusion/ECLD/browse/master/CldrMain/CldrMainEn.php for a list
+<!-- look for "MediaWiki extension CLDR" if this has turned invalid in the future -->
+|1d-fr=Code de langue (la plupart du temps—mais pas toujours—les codes ISO). Voir la liste https://phabricator.wikimedia.org/diffusion/ECLD/browse/master/CldrMain/CldrMainFr.php
+<!-- recherchez "extension MediaWiki CLDR "si cela est invalide à l'avenir -->
+|1d-zh=语言代码（通常是 [[:w:zh:ISO 639-3|ISO 代码]]，但也有例外）。详细列表请见 https://phabricator.wikimedia.org/diffusion/ECLD/browse/master/CldrMain/CldrMainEn.php
-This template is being migrated to core function <nowiki>{{#language}}</nowiki>.  The [[:Category:Page using language code unsupported by language parser]] is populated by this template.
+|2=2
+|2d-en=Language in which the language name should be returned (if different from the user's preferred language).
+|2d-fr=Langue dans laquelle le nom de la langue doit être retourné (si différente de la langue préférée de l'utilisateur).
+|2d-zh=此模板输出结果的语言（如果与用户偏好设置中的语言不一致）。
+|2def=<code><nowiki>{{int:lang}}</nowiki></code>
+|seealso=[[User:Rocket000/Languages/more]] for potentially missing languages
+|namespace=all<!-- or only template ?-->
+|usergroup=all
+}}
-==Examples==
-The second parameter can be used to set the desired output language, otherwise it will return the name in the user's interface language (if a translation exists).
-{|width="100%" border="0" cellspacing="0" cellpadding="0" class="wikitable" style="background:transparent"
-|-
-|width="50%" valign="top"|
-* <nowiki>{{language|ar}}</nowiki> → {{language|ar}}
-* <nowiki>{{language|ar|de}}</nowiki> → {{language|ar|de}}
-* <nowiki>{{language|ar|en}}</nowiki> → {{language|ar|en}}
-* <nowiki>{{language|ar|fr}}</nowiki> → {{language|ar|fr}}
-* <nowiki>{{language|ar|he}}</nowiki> → {{language|ar|he}}
-* <nowiki>{{language|ar|zh-hans}}</nowiki> → {{language|ar|zh-hans}}
-|width="50%" valign="top"|
-* <nowiki>{{language|en}}</nowiki> → {{language|en}}
-* <nowiki>{{language|en|de}}</nowiki> → {{language|en|de}}
-* <nowiki>{{language|en|en}}</nowiki> → {{language|en|en}}
-* <nowiki>{{language|en|fr}}</nowiki> → {{language|en|fr}}
-* <nowiki>{{language|en|he}}</nowiki> → {{language|en|he}}
-* <nowiki>{{language|en|zh-hans}}</nowiki> → {{language|en|zh-hans}}
-|-
-|width="50%" valign="top"|
-* <nowiki>{{language|is}}</nowiki> → {{language|is}}
-* <nowiki>{{language|is|de}}</nowiki> → {{language|is|de}}
-* <nowiki>{{language|is|en}}</nowiki> → {{language|is|en}}
-* <nowiki>{{language|is|fr}}</nowiki> → {{language|is|fr}}
-* <nowiki>{{language|is|he}}</nowiki> → {{language|is|he}}
-* <nowiki>{{language|is|zh-hans}}</nowiki> → {{language|is|zh-hans}}
-|width="50%" valign="top"|
-* <nowiki>{{language|zh-hant}}</nowiki> → {{language|zh-hant}}
-* <nowiki>{{language|zh-hant|de}}</nowiki> → {{language|zh-hant|de}}
-* <nowiki>{{language|zh-hant|en}}</nowiki> → {{language|zh-hant|en}}
-* <nowiki>{{language|zh-hant|fr}}</nowiki> → {{language|zh-hant|fr}}
-* <nowiki>{{language|zh-hant|he}}</nowiki> → {{language|zh-hant|he}}
-* <nowiki>{{language|zh-hant|zh-hans}}</nowiki> → {{language|zh-hant|zh-hans}}
-|}
-You can also use this template's subpages directly to achieve the same effect (which is also easier on the servers, but you need to know the UI language code to use as the fallback for the target translation, as the syntax above uses the second parameter to determine the fallback applicable to it, in order to generate the subpage names). Given that the current UI language code is <code><nowiki>{{int:Lang}}</nowiki>={{int:Lang}}</code>, the examples above are then equivalent to:
+== Examples ==
 {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wikitable" style="background:transparent"
 |-
 |width="50%" valign="top"|
-* <nowiki>{{language/{{Fallback|Language|{{int:Lang}}}}|ar}}</nowiki> → {{language/{{Fallback|Language|{{int:Lang}}}}|ar}}
+* <code><nowiki>{{language|ar}}</nowiki></code> → {{language|ar}}
-* <nowiki>{{language/de|ar}}</nowiki> → {{language/de|ar}}
+* <code><nowiki>{{language|ar|de}}</nowiki></code> → {{language|ar|de}}
-* <nowiki>{{language/en|ar}}</nowiki> → {{language/en|ar}}
+* <code><nowiki>{{language|ar|en}}</nowiki></code> → {{language|ar|en}}
-* <nowiki>{{language/fr|ar}}</nowiki> → {{language/fr|ar}}
+* <code><nowiki>{{language|ar|fr}}</nowiki></code> → {{language|ar|fr}}
-* <nowiki>{{language/he|ar}}</nowiki> → {{language/he|ar}}
+* <code><nowiki>{{language|ar|he}}</nowiki></code> → {{language|ar|he}}
-* <nowiki>{{language/zh-hans|ar}}</nowiki> → {{language/zh-hans|ar}}
+* <code><nowiki>{{language|ar|zh-Hans}}</nowiki></code> → {{language|ar|zh-Hans}}
-|width="50%" valign="top"|
-* <nowiki>{{language/{{Fallback|Language|{{int:Lang}}}}|en}}</nowiki> → {{language/{{Fallback|Language|{{int:Lang}}}}|en}}
-* <nowiki>{{language/de|en}}</nowiki> → {{language/de|en}}
-* <nowiki>{{language/en|en}}</nowiki> → {{language/en|en}}
-* <nowiki>{{language/fr|en}}</nowiki> → {{language/fr|en}}
-* <nowiki>{{language/he|en}}</nowiki> → {{language/he|en}}
-* <nowiki>{{language/zh-hans|en}}</nowiki> → {{language/zh-hans|en}}
-|-
-|width="50%" valign="top"|
-* <nowiki>{{language/{{Fallback|Language|{{int:Lang}}}}|is}}</nowiki> → {{language/{{Fallback|Language|{{int:Lang}}}}|is}}
-* <nowiki>{{language/de|is}}</nowiki> → {{language/de|is}}
-* <nowiki>{{language/en|is}}</nowiki> → {{language/en|is}}
-* <nowiki>{{language/fr|is}}</nowiki> → {{language/fr|is}}
-* <nowiki>{{language/he|is}}</nowiki> → {{language/he|is}}
-* <nowiki>{{language/zh-hans|is}}</nowiki> → {{language/zh-hans|is}}
 |width="50%" valign="top"|
-* <nowiki>{{language/{{Fallback|Language|{{int:Lang}}}}|zh-hant}}</nowiki> → {{language/{{Fallback|Language|{{int:Lang}}}}|zh-hant}}
+* <code><nowiki>{{language|en}}</nowiki></code> → {{language|en}}
-* <nowiki>{{language/de|zh-hant}}</nowiki> → {{language/de|zh-hant}}
+* <code><nowiki>{{language|en|de}}</nowiki></code> → {{language|en|de}}
-* <nowiki>{{language/en|zh-hant}}</nowiki> → {{language/en|zh-hant}}
+* <code><nowiki>{{language|en|en}}</nowiki></code> → {{language|en|en}}
-* <nowiki>{{language/fr|zh-hant}}</nowiki> → {{language/fr|zh-hant}}
+* <code><nowiki>{{language|en|fr}}</nowiki></code> → {{language|en|fr}}
-* <nowiki>{{language/he|zh-hant}}</nowiki> → {{language/he|zh-hant}}
+* <code><nowiki>{{language|en|he}}</nowiki></code> → {{language|en|he}}
-* <nowiki>{{language/zh-hans|zh-hant}}</nowiki> → {{language/zh-hans|zh-hant}}
+* <code><nowiki>{{language|en|zh-Hans}}</nowiki></code> → {{language|en|zh-Hans}}
 |}
-Note that with this syntax, the use of the {{Tl|Fallback}} template is avoided in most cases because we know that templates do exist for all target languages specified in parameter 2 (de, en, fr, he, zh-hans), and that these templates contain a translation for all the languages specified in parameter 1 (ar, en, is, zh-hant). This is not necessarily true for all UI languages needed by users (notably for some rare UI languages, or newly added languages), for which a fallback translation to another language must be looked for.
+== See also ==
+*{{tl|Lang}}
+*{{tl|Multilingual link}}<includeonly>
-==Subpages==
+[[Category:Internationalization templates|{{PAGENAME}}]]
-{{Special:PrefixIndex/Template:Language/}}
-==See also==
+[[w:Template:Language]]
-* {{x|language}} - returns the local name of the language
+</includeonly>
-* [[svn:/trunk/phase3/languages/Names.php]]
-* {{tl|Language/ISO 639/en}} - returns the language name given a ISO 639 code (as opposed to the codes used in MediaWiki). Works for all 639-1, 639-2, 639-3 codes (you may have trouble editing it because of the size). Similar to [[:en:Template:Language]] and [[:fr:Modèle:Langue-local]].

CodexBot (talk | contribs)