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

From blackwiki
Jump to navigation Jump to search
imported>Gonnym
(copied text about the citation templates and lang from Template:Link language)
imported>A876
(minor wordings. split some paragraphs.)
Line 2: Line 2:
 
{{lua|Module:Lang|Module:Lang/utilities}}
 
{{lua|Module:Lang|Module:Lang/utilities}}
  
'''Template:In lang''' is used to denote that a text source is written in a specific language. For citations, the {{Para|language}} parameter of the various citation templates ({{tlx|cite web}}, {{tlx|cite news}}, {{tlx|cite journal}}, 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.
+
'''Template:In lang''' is used to denote that a text source is written in a specific language.
  
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.:
+
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.
 +
 
 +
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}}
 
:{{tlx|de icon}} → {{de icon}}
 
:{{tld|in lang|de}} → {{in lang|de}}
 
:{{tld|in lang|de}} → {{in lang|de}}
  
== Usage ==
+
==Usage==
The 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{{=}}}}
 
:{{tlc|in lang|<{{var|code}}>|<{{var|code2}}>|{{var|...}}|link{{=}}|cap{{=}}}}
  
 
===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|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 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===
 
===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>{{</nowiki>in lang}} 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}}.
  
 
===Categories===
 
===Categories===
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:
+
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|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>
 
: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. 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.
+
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==
 
==See also==

Revision as of 06:44, 24 January 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.

This template replaces the many {{<xx> icon}} templates with a single parameterized template as a result of this TfD; cf.:

{{de icon}}Template:De icon
{{in lang|de}}(in German)

Usage

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

{{in lang|<code>|<code2>|...|link=|cap=}}

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.

These categories differ from the categories added by the {{<xx> icon}} templates because not all uses of this template will be related to external links.

See also

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.