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.

Shortcuts

{{Link lang}}
{{LL}}
{{ll}}

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 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.

Usage

{{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:

Module:Lang/data – special override codes / names (looks here first)
Module:Language/data/iana languages – as defined by the IETF-sanctioned IANA registry
Module:Language/data/ISO 639-3 – as defined in ISO 639-3
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.

Examples

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

Examples with cat-lang parameter

{{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

User-defined CSS

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).

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Link language in articles based on its TemplateData.

TemplateData for Link language

Displays a language name based on an ISO 639 code, often used after a foreign language reference following the manual of style.

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
language code	`1`	The ISO 639 language code or IETF language tag, e.g. 'fr' for French, 'pt-BR' for Brazilian Portuguese	String	required