Template:Link language/doc

This is a documentation subpage for Template:Link language. It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 7,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS.

This template uses Lua: Module:Lang (sandbox)

This template is used to indicate to readers that an external link is in a foreign language.

It should generally be placed after the external link, although this is not set in stone; for more information, see the Manual of Style. English is the default language, and does not need to be noted using this template, unless there is a reason the reader would assume the link to be in a foreign language (e.g. a foreign title).

For citations, the |language= parameter of the various citation templates ({{cite web}}, {{cite news}}, {{cite journal}}, etc.) should be used instead.

To note a span of text in a different language, {{lang}} or one of the {{lang-x}} templates ({{lang-fr}}, {{lang-ast}}, etc.) should be used instead.

{{link language|<language code>}}
{{link language|<language code>|cat-lang=<language name>}}

The language code is usually an ISO 639 code but it may be any valid IETF language tag. Note that language codes do not always coincide with country codes; see the list of ISO 3166-1 codes. The language name displayed is obtained via {{#invoke:Lang|name_from_tag}} which uses the following data:

1. Module:Lang/data – special override codes / names (looks here first)
2. Module:Language/data/iana languages – as defined by the IETF-sanctioned IANA registry
3. Module:Language/data/ISO 639-3 – as defined in ISO 639-3
4. Module:Language/data/wp languages – specific to Wikipedia

Articles using this template are automatically added to a language-specific hidden category. For example, an article using {{in lang|fr}} is added to Category:Articles with French-language external links. The |cat-lang= parameter may be used in cases where the language name displayed is different from the language name in the category.

ISO 639-1 code for French:

• Usage: {{link language|fr}}
• Output: (in French)
• Category: Articles with French-language external links

ISO 639-2 and ISO 639-3 code for Asturian:

• Usage: {{link language|ast}}
• Output: (in Asturian)
• Category: Articles with Asturian-language external links

IETF language tag code for Brazilian Portuguese:

• Usage: {{link language|pt-BR}}
• Output: (in Brazilian Portuguese)
• Category: Articles with Portuguese-language external links

{{in lang|bla|cat-lang=Blackfoot}} → (in Blackfoot)

• Category: Articles with Blackfoot-language external links
• Note: Siksika language redirects to Blackfoot language

{{in lang|ilo|cat-lang=Ilocano}} → (in Ilocano)

• Category: Articles with Ilocano-language external links
• Note: Ilokano language redirects to Ilocano language

{{in lang|ksh|cat-lang=Colognian}} → (in Kölsch)

• Category: Articles with Colognian-language external links
• Note: ksh should display as (in Kölsch); Kölsch language redirects to Colognian dialect; also see Ripuarian language

{{in lang|nan|cat-lang=Min-nan}} → (in Min Nan Chinese)

• Category: Articles with Min-nan-language external links
• Note: nan should display as (in Min Nan Chinese); Min Nan Chinese language and Min-nan language redirect to Southern Min; also see Taiwanese Hokkien

{{in lang|prs|cat-lang=Persian}} → (in Dari)

• Category: Articles with Persian-language external links
• Note: Dari language is also known as Dari Persian or Afghan Persian; also see Persian language

Logged in users can change the appearance of the template's output using CSS with the languageicon class. For example, edit Special:MyPage/common.css and add span.languageicon { font-weight: bold; }. That would result in {{link language|fr}} being displayed as (in French) instead of (in French).

• Categories created for use with this template are listed in Category:Articles with non-English-language external links.
• Templates calling Link language with "cat-lang" parameter
• Templates in the form {{xx icon}} (e.g. {{fr icon}}, {{ast icon}}), descending from this one, are listed in Category:Language icon templates.
• Template:Link language/Notes is a documentation page which may be used with any {{xx icon}} template.
• Language codes cross-reference: list of ISO 639 codes.