Difference between revisions of "Template:In lang/doc"

From blackwiki
Jump to navigation Jump to search
imported>A876
(minor wordings. split some paragraphs.)
imported>DePiep
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
{{lua|Module:Lang|Module:Lang/utilities}}
+
{{High-use}}
 +
{{Lua|Module:In lang}}
  
 
'''Template:In lang''' is used to denote that a text source is written in a specific language.
 
'''Template:In lang''' is used to denote that a text source is written in a specific language.
Line 7: Line 8:
  
 
To note a span of text in a different language, {{tlx|lang}} or one of the {{tld|[[:Category:Lang-x templates|lang-x]]}} templates ({{tlx|lang-fr}}, {{tlx|lang-ast}}, etc.) should be used instead.
 
To note a span of text in a different language, {{tlx|lang}} or one of the {{tld|[[:Category:Lang-x templates|lang-x]]}} templates ({{tlx|lang-fr}}, {{tlx|lang-ast}}, etc.) should be used instead.
 
This template ''replaces'' the many {{tld|<{{var|xx}}> icon}} templates with a single parameterized template as a result of this [[Wikipedia:Templates for discussion/Log/2019 July 5#Link language wrappers|TfD]]; cf.:
 
:{{tlx|de icon}} → {{de icon}}
 
:{{tld|in lang|de}} → {{in lang|de}}
 
  
 
==Usage==
 
==Usage==
 
This template accepts one or more positional language-code parameters (<{{var|code}}>) and two named parameters:
 
This template accepts one or more positional language-code parameters (<{{var|code}}>) and two named parameters:
:{{tlc|in lang|<{{var|code}}>|<{{var|code2}}>|{{var|...}}|link{{=}}|cap{{=}}}}
+
* Code: {{Tlx|{{BASEPAGENAME}}|<{{var|code}}>|<{{var|code2}}>|{{var|...}}|link{{=}}|cap{{=}}}}
 +
* Produces: {{tld|{{BASEPAGENAME}}|de}} → {{In lang|de}}
  
 
===Parameters===
 
===Parameters===
 
* <code>&lt;{{var|code}}></code> – required; <code>&lt;{{var|code}}></code> is a valid [[ISO-639]] language code or a valid [[IETF language tag]]; more than one language code supported:
 
* <code>&lt;{{var|code}}></code> – required; <code>&lt;{{var|code}}></code> is a valid [[ISO-639]] language code or a valid [[IETF language tag]]; more than one language code supported:
** <code><nowiki>{{in lang|cs|en|de|fr|es|ca-valencia|pl|ru|ja|zh}}</nowiki></code> →
+
** <code><nowiki>{{In lang|cs|en|de|fr|es|ca-valencia|pl|ru|ja|zh}}</nowiki></code> →
::: {{in lang|cs|en|de|fr|es|ca-valencia|pl|ru|ja|zh}}
+
::: {{In lang|cs|en|de|fr|es|ca-valencia|pl|ru|ja|zh}}
 
* <code>link</code> – accepts the single value <code>yes</code>; creates link to language article
 
* <code>link</code> – accepts the single value <code>yes</code>; creates link to language article
** {{tlc|in lang|nv|link{{=}}yes}} → {{code |lang=moin|{{in lang|nv|link=yes}}}} → {{in lang|nv|link=yes}}
+
** {{tlc|In lang|nv|link{{=}}yes}} → {{code |lang=moin|{{In lang|nv|link=yes}}}} → {{In lang|nv|link=yes}}
 
* <code>cap</code> – accepts the single value <code>yes</code>; capitalizes the first letter of "In":
 
* <code>cap</code> – accepts the single value <code>yes</code>; capitalizes the first letter of "In":
** {{tlc|in lang|pt-BR|cap{{=}}yes}} → {{in lang|pt-BR|cap=yes}}
+
** {{tlc|In lang|pt-BR|cap{{=}}yes}} → {{In lang|pt-BR|cap=yes}}
  
 
===Error messages===
 
===Error messages===
 
This template has one error message of its own:
 
This template has one error message of its own:
:<span style="font-size:100%; font-style:normal;" class="error">error: <nowiki>{{in lang}}</nowiki> missing language tag</span> – displayed when the template is transcluded without an ISO 639 language code or IETF language tag.
+
:<span style="font-size:100%; font-style:normal;" class="error">error: <nowiki>{{In lang}}</nowiki> missing language tag</span> – displayed when the template is transcluded without an ISO 639 language code or IETF language tag.
 
All other error messages related to the use of this template are emitted by [[Module:Lang]] and are documented at {{cl|Lang and lang-xx template errors}}.
 
All other error messages related to the use of this template are emitted by [[Module:Lang]] and are documented at {{cl|Lang and lang-xx template errors}}.
  
Line 35: Line 33:
 
:Category:Articles with &lt;{{var|collective name}}> languages-collective sources (&lt;{{var|code}}>) – for language collectives<ref>{{cite web |url=https://iso639-3.sil.org/about/scope#Collections%20of%20languages |title=ISO 639-3: Scope of denotation for language identifiers: Collections of languages |website=SIL International |access-date=5 December 2019}}</ref>
 
:Category:Articles with &lt;{{var|collective name}}> languages-collective sources (&lt;{{var|code}}>) – for language collectives<ref>{{cite web |url=https://iso639-3.sil.org/about/scope#Collections%20of%20languages |title=ISO 639-3: Scope of denotation for language identifiers: Collections of languages |website=SIL International |access-date=5 December 2019}}</ref>
 
where &lt;{{var|language name}}> and &lt;{{var|collective name}}> is the name used in the template's rendering and &lt;{{var|code}}> is the ISO 639 code or IETF language tag.
 
where &lt;{{var|language name}}> and &lt;{{var|collective name}}> is the name used in the template's rendering and &lt;{{var|code}}> is the ISO 639 code or IETF language tag.
 
These categories differ from the categories added by the {{tlc|&lt;{{var|xx}}> icon}} templates because not all uses of this template will be related to external links.
 
 
==See also==
 
* {{tl|Link language}}
 
  
 
==References==
 
==References==
Line 46: Line 39:
 
<includeonly>{{Sandbox other||
 
<includeonly>{{Sandbox other||
 
<!-- Categories below this line, please; interwikis at Wikidata -->
 
<!-- Categories below this line, please; interwikis at Wikidata -->
 
+
[[Category:Language templates]]
 +
[[Category:Wikipedia multilingual support templates]]
 +
[[Category:Language tag handling templates]]
 
}}</includeonly>
 
}}</includeonly>

Latest revision as of 20:12, 28 October 2020

Template:In lang is used to denote that a text source is written in a specific language.

For citations using a citation template ({{cite web}}, {{cite news}}, {{cite journal}}, etc.), that template's |language= parameter 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

This template accepts one or more positional language-code parameters (<code>) and two named parameters:

  • Code: {{In lang|<code>|<code2>|...|link=|cap=}}
  • Produces: {{In lang|de}}(in German)

Parameters

  • <code> – required; <code> is a valid ISO-639 language code or a valid IETF language tag; more than one language code supported:
    • {{In lang|cs|en|de|fr|es|ca-valencia|pl|ru|ja|zh}}
(in Czech, English, German, French, Spanish, Valencian, Polish, Russian, Japanese, and Chinese)
  • link – accepts the single value yes; creates link to language article
    • {{In lang|nv|link=yes}}<span class="languageicon">(in [[Navajo language|Navajo]])</span>(in Navajo)
  • cap – accepts the single value yes; capitalizes the first letter of "In":
    • {{In lang|pt-BR|cap=yes}}(In Portuguese)

Error messages

This template has one error message of its own:

error: {{In lang}} missing language tag – displayed when the template is transcluded without an ISO 639 language code or IETF language tag.

All other error messages related to the use of this template are emitted by Module:Lang and are documented at Category:Lang and lang-xx template errors.

Categories

Transclusions in mainspace articles will add the article to the appropriate subcategory of Category:Articles with non-English-language sources. There are two forms of these subcategories:

Category:Articles with <language name>-language sources (<code>) – for individual languages[1] and for macrolanguages[2]
Category:Articles with <collective name> languages-collective sources (<code>) – for language collectives[3]

where <language name> and <collective name> is the name used in the template's rendering and <code> is the ISO 639 code or IETF language tag.

References

  1. "ISO 639-3: Scope of denotation for language identifiers: Individual languages". SIL International. Retrieved 5 December 2019.
  2. "ISO 639-3: Scope of denotation for language identifiers: Macrolanguages". SIL International. Retrieved 5 December 2019.
  3. "ISO 639-3: Scope of denotation for language identifiers: Collections of languages". SIL International. Retrieved 5 December 2019.