Template:Link language/doc

< Template:Link language

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

  1. REDIRECT Template:Template link code 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:

  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.

Examples

ISO 639-1 code for French:

  • Usage:
  1. REDIRECT Template:Template link code

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

  • Usage:
  1. REDIRECT Template:Template link code

IETF language tag code for Brazilian Portuguese:

  • Usage:
  1. REDIRECT Template:Template link code

Examples with cat-lang parameter

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

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

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

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

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

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 <syntaxhighlight lang="css" enclose="none">span.languageicon { font-weight: bold; }</syntaxhighlight>. That would result in

  1. REDIRECT Template:Template link code being displayed as (in French) instead of (in French).

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Link language

<templatedata>{ "description": "Displays a language name based on an ISO 639 code, often used after a foreign language reference following the manual of style.", "params": { "1": { "label": "language code", "description": "The ISO 639 language code or IETF language tag, e.g. 'fr' for French, 'pt-BR' for Brazilian Portuguese", "type": "string", "required": true } }, "format": "inline" }</templatedata>

See also

  1. REDIRECT Template:Template link code (e.g. {{fr icon}}, {{ast icon}}), descending from this one, are listed in Category:Language icon templates.
  1. REDIRECT Template:Template link code template.