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

From blackwiki
Jump to navigation Jump to search
imported>Gonnym
m
imported>Gonnym
(copied text about the citation templates and lang from Template:Link language)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
{{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.
  
 
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.:
 
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:
 
The 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 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><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 first letter in the rendering:
**{{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===
Line 31: Line 33:
  
 
==See also==
 
==See also==
*{{tl|Link language}}
+
* {{tl|Link language}}
  
 
==References==
 
==References==
{{reflist}}
+
{{Reflist}}
  
<includeonly>{{sandbox other||
+
<includeonly>{{Sandbox other||
 
<!-- Categories below this line, please; interwikis at Wikidata -->
 
<!-- Categories below this line, please; interwikis at Wikidata -->
  
 
}}</includeonly>
 
}}</includeonly>

Revision as of 16:41, 19 January 2020

Template:In lang is used to denote that a text source is written in a specific language. 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 {{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

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

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

Parameters

  • <code> – required where <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 first letter in the rendering:
    • {{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.