Template:Lang: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(english flag liked to have extra spacing.)
No edit summary
 
(225 intermediate revisions by 19 users not shown)
Line 1: Line 1:
<noinclude><div style="position:relative;top:-32px;margin-bottom: -40px;float:right;text-align:right;padding:2px;line-height:11px;background:#262626;"><!--
{{Tdeprecated|LanguageBar}}
-->{{#ifexist: Template:Lang:cs | [[File:cs.png|alt=Čeština|link=Template:Lang:cs]]&nbsp;| }}<!--
{{Todo|See [[Template_talk:Lang#Un-Deprecating Lang]]. Undeprecating Lang and add some features which was used in {{T|MultiPage}}, such as more languages (including changing {{Code|zh-cn}} to {{Code|zh}}), pages using {{Code|/lang}} instead of {{Code|<nowiki>:lang</nowiki>}} which makes it easier to find language subpages on "Page information", aswell as adding new languages, all without requiring users to purge the page.<br>
-->{{#ifexist: Template:Lang:de | [[File:de.png|alt=Deutsch|link=Template:Lang:de]]&nbsp;| }}<!--
As of 2024, both templates are being superseded by {{T|LanguageBar}}, which use "prefix" instead of "suffix" for language codes.}}
-->{{#ifexist: Template:Lang:es | [[File:es.png|alt=Español|link=Template:Lang:es]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:fr | [[File:fr.png|alt=Français|link=Template:Lang:fr]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:hu | [[File:hu.png|alt=Magyar|link=Template:Lang:hu]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:it | [[File:it.png|alt=Italiano|link=Template:Lang:it]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:nl | [[File:nl.png|alt=Nederlands|link=Template:Lang:nl]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:no | [[File:no.png|alt=Norsk|link=Template:Lang:no]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:pl | [[File:pl.png|alt=Polski|link=Template:Lang:pl]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:pt | [[File:pt.png|alt=Português|link=Template:Lang:pt]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:pt-br | [[File:pt-br.png|alt=Português-Brasileiro|link=Template:Lang:pt-br]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:ru | [[File:ru.png|alt=Русский|link=Template:Lang:ru]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:ua | [[File:ua.png|alt=Українська|link=Template:Lang:ua]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:sv | [[File:sv.png|alt=Svenska|link=Template:Lang:sv]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:tr | [[File:tr.png|alt=Türkçe|link=Template:Lang:tr]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:jp | [[File:jp.png|alt=日本語|link=Template:Lang:jp]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:zh-cn | [[File:cn.png|alt=简体中文|link=Template:Lang:zh-cn]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:zh-tw | [[File:tw.png|alt=简体中文|link=Template:Lang:zh-tw]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:ko | [[File:ko.png|alt=한국어|link=Template:Lang:ko]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:ka | [[File:ka.png|alt=ქართული ენა|link=Template:Lang:ka]]&nbsp;| }}<!--
-->{{#ifexist: Template:Lang:he | [[File:he.png|alt=עִברִית|link=Template:Lang:he]]&nbsp;| }}</div>
This template is an improved version of [[:Template:Otherlang2]]. It retains all the functionality, adds Hebrew properly, and ''automatically'' detects which languages a page has been translated into. It works on English and non-English pages, with or without namespaces. Otherlang2 may still be used, in the rare case that a translated page does not follow the wiki's [[Valve Developer Community:Alternative Languages|standard method]] for translated page titles.


Unlike otherlang2, this template requires an unnamed parameter to be defined to work. The contents of it should be the full name of the page the template is being applied on, including namespaces such as '''Help:'''. It should not include any language suffixes, however, such as ''':ru'''. Capitalization matters, even on the first letter of the page name! Underscores must be replaced with spaces. <code>ai_changehintgroup</code> must be written as <code>Ai changehintgroup</code>.
{{Doc}}
<includeonly>


The <code>title</code> 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).
<onlyinclude>{{#ifeq: {{NAMESPACE}} | Template
| [[Category:TODO remove lang]]
| {{LanguageBar|{{#if:{{{title|}}}| title}} = {{{title}}}}}[[Category:TODO rewrite lang to LanguageBar]]
}}</onlyinclude>


The <code>noborder</code> parameter can be set to <code>1</code> to hide the border around icons. If you don't plan on using it, don't bother defining it.
</includeonly>
 
Here's an example for a hypothetical Spanish page called '''Category:Hello:es''':
<pre>{{lang
|Category:Hello
|title=Categoría:Hola
|noborder=1
}}</pre>
This will add icons for all the versions of this page in different languages. It will also change the displayed title to a Spanish version of the name, and hide the icon borders.
 
 
Currently supported languages:
{| class="standard-table"
! Language !! Page name !! Icon
|-
|English                ||Page_name          ||[[File:En.png]]
|-
|Chinese (PRC)          ||Page_name:zh-cn    ||[[File:Cn.png]]
|-
|Chinese (Taiwan)      ||Page_name:zh-tw    ||[[File:Tw.png]]
|-
|Czech                  ||Page_name:cs      ||[[File:Cs.png]]
|-
|Dutch                  ||Page_name:nl      ||[[File:nl.png]]
|-
|French                ||Page_name:fr      ||[[File:Fr.png]]
|-
|Georgian              ||Page_name:ka      ||[[File:Ka.png]]
|-
|German                ||Page_name:de      ||[[File:De.png]]
|-
|Hebrew                ||Page_name:he      ||[[File:He.png]]
|-
|Hungarian              ||Page_name:hu      ||[[File:Hu.png]]
|-
|Italian                ||Page_name:it      ||[[File:It.png]]
|-
|Japanese              ||Page_name:jp      ||[[File:Jp.png]]
|-
|Korean                ||Page_name:ko      ||[[File:Ko.png]]
|-
|Norwegian              ||Page_name:no      ||[[File:No.png]]
|-
|Polish                ||Page_name:pl      ||[[File:Pl.png]]
|-
|Portuguese            ||Page_name:pt      ||[[File:Pt.png]]
|-
|Portuguese (Brazilian) ||Page_name:pt-br    ||[[File:Pt-br.png]]
|-
|Russian                ||Page_name:ru      ||[[File:Ru.png]]
|-
|Ukrainian              ||Page_name:ua      ||[[File:ua.png]]
|-
|Spanish                ||Page_name:es      ||[[File:Es.png]]
|-
|Swedish                ||Page_name:sv      ||[[File:Sv.png]]
|-
|Turkish                ||Page_name:tr      ||[[File:Tr.png]]
|}
 
For information on how the template detects other languages, view this page's source code.
 
----</noinclude><!--
{{{1}}}: page's full name, including any namespace, but excluding any language suffix
{{ARTICLEPAGENAME}}: page's full name, including any namespace and/or language suffix
[X language suffix]: JUST a language suffix, which is different for every language
 
title
-->{{#if: {{{title|}}} | {{DISPLAYTITLE:{{{title}}}}} }}<!--
 
html to make the buttons appear in the header space
--><div style="position:relative;top:-32px;margin-bottom: -40px;float:right;text-align:right;padding:2px;line-height:11px;background:#262626;<!--
 
optional taking away of the icon borders
-->{{#if: {{{noborder|}}} | margin-top:5px;border:0; | border:1px solid #65635F;border-bottom:0;}}"><!--
 
For English:
Test if {{{1}}} is equal to {{ARTICLEPAGENAME}}.
-If they match, then we must be on the English page already, therefore don't display the English icon.
-If they do not match, show the English link, cause this is NOT the English page.
We're not going to test if the English page exists or not. It damn well better.
-->{{#ifeq: {{{1}}} | {{ARTICLEPAGENAME}} | | [[File:en.png|alt=English|link={{{1}}}]]}}<!--
 
Other languages are a little more complex:
Test if the page {{{1}}}:[X language suffix] exists.
-If the page does exist, check if we're on that page right now by testing if {{{1}}}:[X language suffix] is equal to {{ARTICLEPAGENAME}}.
--If they match, don't show the icon for this language, because we're already on that page.
--If they do not match, show the icon for the language, because that page exists AND we currently are not on it.
-If the page does not exist, don't show the icon for it obviously.
 
Czech - cs
-->{{#ifexist: {{{1}}}:cs | <!--
  -->{{#ifeq: {{{1}}}:cs | {{ARTICLEPAGENAME}} | | [[File:cs.png|alt=Čeština|link={{{1}}}:cs]]&nbsp;}}<!--
--> | }} <!--
 
German - de
-->{{#ifexist: {{{1}}}:de | <!--
  -->{{#ifeq: {{{1}}}:de | {{ARTICLEPAGENAME}} | | [[File:de.png|alt=Deutsch|link={{{1}}}:de]]&nbsp;}}<!--
--> | }}<!--
 
Spanish - es
-->{{#ifexist: {{{1}}}:es | <!--
  -->{{#ifeq: {{{1}}}:es | {{ARTICLEPAGENAME}} | | [[File:es.png|alt=Español|link={{{1}}}:es]]&nbsp;}}<!--
--> | }}<!--
 
French - fr
-->{{#ifexist: {{{1}}}:fr | <!--
  -->{{#ifeq: {{{1}}}:fr | {{ARTICLEPAGENAME}} | | [[File:fr.png|alt=Français|link={{{1}}}:fr]]&nbsp;}}<!--
--> | }}<!--
 
Hungarian - hu
-->{{#ifexist: {{{1}}}:hu | <!--
  -->{{#ifeq: {{{1}}}:hu | {{ARTICLEPAGENAME}} | | [[File:hu.png|alt=Magyar|link={{{1}}}:hu]]&nbsp;}}<!--
--> | }}<!--
 
Italian - it
-->{{#ifexist: {{{1}}}:it | <!--
  -->{{#ifeq: {{{1}}}:it | {{ARTICLEPAGENAME}} | | [[File:it.png|alt=Italiano|link={{{1}}}:it]]&nbsp;}}<!--
--> | }}<!--
 
Dutch - nl
-->{{#ifexist: {{{1}}}:nl | <!--
  -->{{#ifeq: {{{1}}}:nl | {{ARTICLEPAGENAME}} | | [[File:nl.png|alt=Nederlands|link={{{1}}}:nl]]&nbsp;}}<!--
--> | }}<!--
 
Norwegian - no
-->{{#ifexist: {{{1}}}:no | <!--
  -->{{#ifeq: {{{1}}}:no | {{ARTICLEPAGENAME}} | | [[File:no.png|alt=Norsk|link={{{1}}}:no]]&nbsp;}}<!--
--> | }}<!--
 
Polish - pl
-->{{#ifexist: {{{1}}}:pl | <!--
  -->{{#ifeq: {{{1}}}:pl | {{ARTICLEPAGENAME}} | | [[File:pl.png|alt=Polski|link={{{1}}}:pl]]&nbsp;}}<!--
--> | }}<!--
 
Portuguese - pt
-->{{#ifexist: {{{1}}}:pt | <!--
  -->{{#ifeq: {{{1}}}:pt | {{ARTICLEPAGENAME}} | | [[File:pt.png|alt=Português|link={{{1}}}:pt]]&nbsp;}}<!--
--> | }}<!--
 
Brazilian Portuguese - pt-br
-->{{#ifexist: {{{1}}}:pt-br | <!--
  -->{{#ifeq: {{{1}}}:pt-br | {{ARTICLEPAGENAME}} | | [[File:pt-br.png|alt=Português-Brasileiro|link={{{1}}}:pt-br]]&nbsp;}}<!--
--> | }}<!--
 
Russian - ru
-->{{#ifexist: {{{1}}}:ru | <!--
  -->{{#ifeq: {{{1}}}:ru | {{ARTICLEPAGENAME}} | | [[File:ru.png|alt=Русский|link={{{1}}}:ru]]&nbsp;}}<!--
--> | }}<!--
 
Ukrainian - ua
-->{{#ifexist: {{{1}}}:ua | <!--
  -->{{#ifeq: {{{1}}}:ua | {{ARTICLEPAGENAME}} | | [[File:ua.png|alt=Українська|link={{{1}}}:ua]]&nbsp;}}<!--
--> | }}<!--
 
Swedish - sv
-->{{#ifexist: {{{1}}}:sv | <!--
  -->{{#ifeq: {{{1}}}:sv | {{ARTICLEPAGENAME}} | | [[File:sv.png|alt=Svenska|link={{{1}}}:sv]]&nbsp;}}<!--
--> | }}<!--
 
Turkish - tr
-->{{#ifexist: {{{1}}}:tr | <!--
  -->{{#ifeq: {{{1}}}:tr | {{ARTICLEPAGENAME}} | | [[File:tr.png|alt=Türkçe|link={{{1}}}:tr]]&nbsp;}}<!--
--> | }}<!--
 
Japanese - jp
-->{{#ifexist: {{{1}}}:jp | <!--
  -->{{#ifeq: {{{1}}}:jp | {{ARTICLEPAGENAME}} | | [[File:jp.png|alt=日本語|link={{{1}}}:jp]]&nbsp;}}<!--
--> | }}<!--
 
Simplified Chinese - zh-cn
-->{{#ifexist: {{{1}}}:zh-cn | <!--
  -->{{#ifeq: {{{1}}}:zh-cn | {{ARTICLEPAGENAME}} | | [[File:cn.png|alt=简体中文|link={{{1}}}:zh-cn]]&nbsp;}}<!--
--> | }}<!--
 
Taiwanese Mandarin - zh-tw
-->{{#ifexist: {{{1}}}:zh-tw | <!--
  -->{{#ifeq: {{{1}}}:zh-tw | {{ARTICLEPAGENAME}} | | [[File:tw.png|alt=简体中文|link={{{1}}}:zh-tw]]&nbsp;}}<!--
--> | }}<!--
 
Korean - ko
-->{{#ifexist: {{{1}}}:ko | <!--
  -->{{#ifeq: {{{1}}}:ko | {{ARTICLEPAGENAME}} | | [[File:ko.png|alt=한국어|link={{{1}}}:ko]]&nbsp;}}<!--
--> | }}<!--
 
Georgian - ka
-->{{#ifexist: {{{1}}}:ka | <!--
  -->{{#ifeq: {{{1}}}:ka | {{ARTICLEPAGENAME}} | | [[File:ka.png|alt=ქართული ენა|link={{{1}}}:ka]]&nbsp;}}<!--
--> | }}<!--
 
Hebrew - he
-->{{#ifexist: {{{1}}}:he | <!--
  -->{{#ifeq: {{{1}}}:he | {{ARTICLEPAGENAME}} | | [[File:he.png|alt=עִברִית|link={{{1}}}:he]]&nbsp;}}<!--
--> | }}</div>

Latest revision as of 17:57, 7 May 2025

Red x.png
This template (and its redirect) is Wikipedia icon Deprecated. Its use is not recommended and its functionality may be compromised.
Please use {{LanguageBar}} instead.
You can help our editors by replacing or deleting this template on the Pages that use this template. Once no more pages use this template, it should be Marked for deletion.
Todo: See Template_talk:Lang#Un-Deprecating Lang. Undeprecating Lang and add some features which was used in {{MultiPage}}, such as more languages (including changing zh-cn to zh), pages using /lang instead of :lang which makes it easier to find language subpages on "Page information", aswell as adding new languages, all without requiring users to purge the page.
As of 2024, both templates are being superseded by {{LanguageBar}}, which use "prefix" instead of "suffix" for language codes.
English (en)Deutsch (de)Esperanto (eo)Español (es)Français (fr)Suomi (fi)Hrvatski (hr)Magyar (hu)Italiano (it)日本語 (ja)한국어 (ko)Nederlands (nl)Polski (pl)Português (pt)Português do Brasil (pt-br)Русский (ru)Slovenčina (sk)Svenska (sv)Türkçe (tr)Українська (uk)Tiếng Việt (vi)中文 (zh)中文（臺灣） (zh-tw)
Curly brackets white.pngTemplate Documentation [view] [edit]
Icon-translate.png Available doc translations
View
Page history
…

This template is an improved version of {{Otherlang2}}. It retains all the functionality and automatically detects which languages a page has been translated into. It works on English and non-English pages, with or without namespaces. Otherlang2 may still be used, in the rare case that a translated page does not follow the wiki's standard method for translated page titles. As of 2023 (and still ongoing), it is slowly being replaced by {{MultiPage}}, which supports more languages and they are fully ISO 639 compliant.

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-cn, etc.
Note.pngNote: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.
{{lang|Template:Lang}}
{{{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.pngNote:Do not link subpages with "/"! Use "|" instead of "/". Therefore, the template can link the pages correctly.
Note.pngNote: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:zh-cn/Panic Events:zh-cn
{{lang|L4D2 Level Design|Add-on Notes}}
{{lang|L4D Level Design|Panic Events}}
{{lang|Half-Life: Alyx Workshop Tools|Animgraph|AnimGraph Introduction}}
{{{title}}} 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).
Warning.pngWarning: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.
{{lang|title=Template:Lang}}
{{{$title}}} This parameter can be used to change the text of the page titlebar and place the title under the <code> tag - {{lang|Template:Lang|$title=$model}}.
{{lang|$title=Template:Lang}}
{{{notitle}}} This parameter can be used to change the title of the site page itself, but not for the title of the article itself.
{{lang|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.
{{lang|noborder=1}}
{{{select}}} The selection mode of the title. 1 is the one-click selection (just like clicking the "1").
{{lang|Template:Lang|select=1}}
{{{up}}}
Todo: Document it.
 [Todo]

Examples

Here's an example for a hypothetical Spanish page called Category:Hello:es:

{{lang|Category:Hello|title=Categoría:Hola}}

This will add icons for all the versions of this page in different languages. It will also change the displayed title to a Spanish version of the name.

Currently Supported Languages

Currently Supported Languages
Language Page name Icon
English Page_name English (en)
Esperanto Page_name:eo Esperanto (eo)
Catalan Page_name:ca Català (ca)
Czech Page_name:cs Čeština (cs)
German Page_name:de Deutsch (de)
Spanish Page_name:es Español (es)
Estonian Page_name:et Eesti (et)
French Page_name:fr Français (fr)
Hungarian Page_name:hu Magyar (hu)
Italian Page_name:it Italiano (it)
Dutch Page_name:nl Nederlands (nl)
Norwegian Page_name:no Norsk (no)
Polish Page_name:pl Polski (pl)
Portuguese Page_name:pt Português (pt)
Portuguese (Brazilian) Page_name:pt-br Português do Brasil (pt-br)
Russian Page_name:ru Русский (ru)
Ukrainian Page_name:uk Українська (uk)
Swedish Page_name:sv Svenska (sv)
Turkish Page_name:tr Türkçe (tr)
Japanese Page_name:ja 日本語 (ja)
Chinese (PRC) Page_name:zh-cn 中文 (zh)
Chinese (Taiwan) Page_name:zh-tw 中文（臺灣） (zh-tw)
Korean Page_name:ko 한국어 (ko)
Georgian Page_name:ka Ქართული (ka)
Hebrew Page_name:he עברית (he)
  • Also, this template automatically adds a page language category at the bottom of the page.
Note.pngNote:Most, not all of them of these language codes are compliant ISO 639 codes.
The above documentation is transcluded from Template:Lang/doc. (Edit | Page history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Template:Lang&oldid=475543"