Template:Link language/doc
This is a documentation subpage for Template:Link language. It contains usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 7,000 pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please 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: |
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
- 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:
- 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
- Usage:
- REDIRECT Template:Template link code
- Output: (in French)
- Category: Articles with French-language external links
ISO 639-2 and ISO 639-3 code for Asturian:
- Usage:
- REDIRECT Template:Template link code
- Output: (in Asturian)
- Category: Articles with Asturian-language external links
IETF language tag code for Brazilian Portuguese:
- Usage:
- REDIRECT Template:Template link code
- 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 <syntaxhighlight lang="css" enclose="none">span.languageicon { font-weight: bold; }</syntaxhighlight>
. That would result in
- REDIRECT Template:Template link code being displayed as (in French) instead of (in French).
TemplateData
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
- 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
- REDIRECT Template:Template link code (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
- REDIRECT Template:Template link code template.
- Language codes cross-reference: list of ISO 639 codes.