View source for Template:In lang/doc

{{Documentation subpage}}
{{High-use}}
{{Lua|Module:In lang}}

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

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.

==Usage==
Typical use of this template is inside {{tag|ref}} tags where the reference is not templated and the referenced source is non-English:
:<code><nowiki><ref>[https://www.example.com "Non English Journal Article"]. ''Non-English Journal''. '''12'''(3): 231–241 {{in lang|xx}}</ref></nowiki></code>
Also finds use in External links sections to mark non-English link-targets:
:<code><nowiki>[https://www.example.com Non English external link] {{in lang|xx}}</nowiki></code>
This template does not markup non-English text.  For that, use {{tlx|lang}} or an appropriate {{tld|lang-??}} template.

===Parameters===
This template accepts one or more positional language-tag parameters (<code>&lt;{{var|tag}}></code>) and two named parameters:
*{{tld|In lang|&lt;{{var|tag}}>|&lt;{{var|tag2}}>|{{var|...}}|link{{=}}|cap{{=}}}}
Most common use is a single language:
*{{tld|In lang|de}} → {{In lang|de}}
The positional parameters
* <code>&lt;{{var|tag}}></code> – required; <code>&lt;{{var|tag}}></code> is a valid [[ISO-639]] language tag or a valid [[IETF language tag]]; more than one language tag supported:
** <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}}
The named parameters are:
* <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}}
* <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}}

===Error messages===
This template has one error message of its own:
:<span style="color:#d33">error: <nowiki>{{In lang}}</nowiki> missing language tag</span> – displayed when the template is transcluded without an ISO 639 language tag 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}}.

==TemplateData==
{{TemplateData header}}

<templatedata>{
	"params": {
		"1": {},
		"2": {},
		"3": {},
		"4": {}
	},
	"description": "Produces the phrase \"(in LANGUAGE)\" with language codes.",
	"format": "inline"
}</templatedata>

===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:
:Category:Articles with &lt;{{var|language name}}>-language sources (&lt;{{var|tag}}>) – 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 sources in &lt;{{var|collective name}}> languages (&lt;{{var|tag}}>) – 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|tag}}> is the ISO 639 tag or IETF language tag.

==References==
{{Reflist}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Language templates]]
[[Category:Wikipedia multilingual support templates]]
[[Category:Language tag handling templates]]
}}</includeonly>