Template:Link language/doc

From Hârn
Jump to navigation Jump to search

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, one of the {{lang-x}} templates ({{lang-fr}}, {{lang-ast}}, etc.) should be used instead.

Usage[edit source]

{{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 {{link language|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[edit source]

ISO 639-1 code for French:

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

IETF language tag code for Brazilian Portuguese:

Examples with cat-lang parameter[edit source]

{{link language|bla|cat-lang=Blackfoot}}(in Script error: The function "name_from_tag" does not exist.)

{{link language|ilo|cat-lang=Ilocano}}(in Script error: The function "name_from_tag" does not exist.)

{{link language|ksh|cat-lang=Colognian}}(in Script error: The function "name_from_tag" does not exist.)

{{link language|nan|cat-lang=Min-nan}}(in Script error: The function "name_from_tag" does not exist.)

{{link language|prs|cat-lang=Persian}}(in Script error: The function "name_from_tag" does not exist.)

User-defined CSS[edit source]

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 Script error: The function "name_from_tag" does not exist.) instead of (in Script error: The function "name_from_tag" does not exist.).

TemplateData[edit source]

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

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.

ParameterDescriptionTypeStatus
language code1

The ISO 639 language code or IETF language tag, e.g. 'fr' for French, 'pt-BR' for Brazilian Portuguese

Stringrequired

See also[edit source]

External links[edit source]