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

From blackwiki
Jump to navigation Jump to search
imported>DePiep
 
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
{{lua|module:lang|module:lang/utilities}}
+
{{High-use}}
 +
{{Lua|Module:In lang}}
  
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.:
+
'''Template:In lang''' is used to denote that a text source is written in a specific language.
:{{tlx|de icon}} → {{de icon}}
 
:{{tld|in lang|de}} → {{in lang|de}}
 
== Usage ==
 
  
The template accepts one or more positional language-code parameters (<{{var|xx}}>) plus several named parameters:
+
For citations using a citation template ({{tlx|cite web}}, {{tlx|cite news}}, {{tlx|cite journal}}, etc.), that template's {{Para|language}} parameter should be used instead.
:<code><nowiki>{{in lang|&lt;{{var|code}}>|&lt;{{var|code2}}>|...|link=|cap=}}</nowiki></code>
+
 
:{{tlc|in lang|&lt;{{var|code}}>|&lt;{{var|code2}}>|{{var|...}}|link{{=}}|cap{{=}}}}
+
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.
 +
 
 +
==Usage==
 +
This template accepts one or more positional language-code parameters (&lt;{{var|code}}>) and two named parameters:
 +
* Code: {{Tlx|{{BASEPAGENAME}}|&lt;{{var|code}}>|&lt;{{var|code2}}>|{{var|...}}|link{{=}}|cap{{=}}}}
 +
* Produces: {{tld|{{BASEPAGENAME}}|de}} → {{In lang|de}}
  
 
===Parameters===
 
===Parameters===
*<code>&lt;{{var|code}}></code> – required where <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|it|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|it|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 first letter in the rendering:
+
* <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===
 +
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.
 +
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}}.
  
 
===Categories===
 
===Categories===
Transclusions in mainspace articles will add the article to 'Category:Articles with &lt;{{var|language name}}>-language sources' where &lt;{{var|language name}}> is the name of the language used in the rendering.  This differs 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.
+
Transclusions in mainspace articles will add the article to the appropriate subcategory of {{cl|Articles with non-English-language sources}}. There are two forms of these subcategories:
 +
:Category:Articles with &lt;{{var|language name}}>-language sources (&lt;{{var|code}}>) – for individual languages<ref>{{cite web |url=https://iso639-3.sil.org/about/scope#Individual%20languages |title=ISO 639-3: Scope of denotation for language identifiers: Individual languages |website=SIL International |access-date=5 December 2019}}</ref> and for macrolanguages<ref>{{cite web |url=https://iso639-3.sil.org/about/scope#Macrolanguages |title=ISO 639-3: Scope of denotation for language identifiers: Macrolanguages |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.
  
<includeonly>{{sandbox other||
+
==References==
 +
{{Reflist}}
 +
 
 +
<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.