Nwuan a̱tyin ka a li Ta‌̱mpi‌̱let:Language with name/for/doc

{{Documentation subpage}}
{{template shortcut|langnf}}
{{ombox |text=This template is in transition.  The second positional parameter which takes the language name of the text that is translated is deprecated.  Use the first positional parameter to hold the ISO 639 or IETF language tag for that language and leave the second positional parameter blank.
}}
== Usage ==
This template provides a translation into English of a non-English term or phrase, and optionally links to the article on the foreign language.

==Parameters==

<code><nowiki>{{</nowiki>Language with name/for|&lt;{{var|language tag}}>|&lt;{{var|non-English text}}>|&lt;{{var|term or phase}}>}}</code> – note blank second positional parameter

There are thee positional parameters:
# the ISO 639 or IETF language tag of the language of <code>&lt;{{var|non-English text}}></code> (positional parameter <code><nowiki>{{{2}}}</nowiki></code>).  See [[#note|note]].
# <code><nowiki>&lt;{{var|non-English text}}></nowiki></code> – {{tlx|lang}} will apply proper html markup for this text using the language tag specified in <code><nowiki>{{{1}}}</nowiki></code>
# the English translation of <code>&lt;{{var|non-English text}}></code>.  Do not include quote marks; those are provided automatically by the template.

and several named parameters:
*{{para|term1}} – alias of <code><nowiki>{{{3}}}</nowiki></code> (<code>&lt;{{var|term or phase}}></code>)
*{{para|term2}} .. {{para|term{{var|n}}}} – additional 'or'-like translations; each rendered in single quotes; quoted terms separated by '&lt;space>/&lt;space>'
*{{para|italic-term}} – <code>yes</code> or <code>no</code>; default is <code>no</code>; useful for multi-term translations when all should be italicized
*{{para|lang-name}} – for those cases where ISO 639 does not have a language tag; <code><nowiki>{{{1}}}</nowiki></code> (<code>&lt;{{var|language tag}}></code>) is ignored; {{tld|lang}} wraps <code><nowiki>{{{2}}}</nowiki></code> (<code>&lt;{{var|non-English text}}></code>) with html using <code>mis</code> (uncoded language) tag.  See [[#note|note]].
*{{para|break}} – <code>yes</code> or <code>no</code>; default is <code>no</code>; inserts {{tag|br|s}} between the non-English text and the language name
*{{para|paren}} – accepts one of two values:
*:<code>none</code>; omits parens around '&lt;{{var|language-name}}> for &lt;{{var|term or phase}}>'
*:<code>left</code>; template provides the left parenthesis only; the right is omitted

This template also accepts all parameters supported by {{tld|lang}} except {{para|code}} and {{para|text}}.

{{anchor|note}}'''Note''': When there is an ISO 639 language tag for the non-English text's language, use that tag; do not use {{para|lang-name}}.  When ISO 639 does not have a language that applies to the non-English text use {{para|lang-name}} for the non-English language name.  This template applies proper html markup to the non-English text only when given a proper language tag.  When language name is provided by {{para|lang-name}} this template sets the html <code>lang=</code> attribute to <code>mis</code> (uncoded language).

Do this:
:<code><nowiki>{{langnf|es|Casa|house}}</nowiki></code>
::{{xt|{{langnf|es|Casa|house}}}}
:::{{code|{{langnf|es|Casa|house}}}}
Do not do this:
:<code><nowiki>{{langnf||Casa|house|lang-name=Spanish}}</nowiki></code>
::{{!xt|{{langnf||Casa|house|lang-name=Spanish}}}}
:::{{code|{{langnf||Casa|house|lang-name=Spanish}}}}

==Examples==
Basic use:
:<code><nowiki>{{langnf|es|Casa|house}}</nowiki></code>
::{{langnf|es|Casa|house}}
Using {{para|lang-name|Massachusett}}:
:<code><nowiki>{{langnf||kuncannowet|breast|lang-name=Massachusett}}</nowiki></code> – note empty <code><nowiki>{{{1}}}</nowiki></code>
::{{langnf||kuncannowet|breast|lang-name=Massachusett}}
Using {{para|break|yes}}:
:<code><nowiki>{{langnf|es|Casa|house|break=yes}}</nowiki></code>
::{{langnf|es|Casa|house|break=yes}}
Using {{para|paren|none}}:
:<code><nowiki>{{langnf|es|Casa|house|paren=none}}</nowiki></code>
::{{langnf|es|Casa|house|paren=none}}
Using {{para|paren|left}}:
:<code><nowiki>{{langnf|fr|'''L'Aurore'''|The Dawn|paren=left}}; {{IPA-fr|loʁɔʁ|IPA}})</nowiki></code>
::{{langnf|fr|'''L'Aurore'''|The Dawn|paren=left}}; {{IPA-fr|loʁɔʁ|IPA}})
Using {{para|term1|house}}, {{para|term2|hut}}, {{para|term3|mansion}}:
:<code><nowiki>{{langnf|es|Casa|term1=house|term2=hut|term3=mansion}}</nowiki></code>
::{{langnf|es|Casa|term1=house|term2=hut|term3=mansion}}
Using {{para|term1|house}}, {{para|term2|hut}}, {{para|term3|mansion}}, and {{para|italic-term|yes}}:
:<code><nowiki>{{langnf|es|Casa|term1=house|term2=hut|term3=mansion|italic-term=yes}}</nowiki></code>
::{{langnf|es|Casa|term1=house|term2=hut|term3=mansion|italic-term=yes}}

==Errors==
This template detects errors.  Those articles that have {{tlx|language with name/for}} errors are added to {{clc|Language with name/for errors}}.  When errors are detected, this template emits error messages:
*{{color|#d33|missing language tag or language name}} – this template requires one of positional parameter 1 (<code><nowiki>{{{1}}}</nowiki></code>) or {{para|lang-name}}.  To resolve this error, provide an appropriate language tag in <code><nowiki>{{{1}}}</nowiki></code> or an appropriate language name in {{para|lang-name}}.  See [[Template:Language with name/for|template documentation]] for specific requirements for these parameters.
*{{color|#d33|only one of <kbd><nowiki>{{{1}}}</nowiki></kbd> and <kbd><nowiki>|lang-name=</nowiki></kbd> allowed}} – because a template with both of positional parameter 1 (<code><nowiki>{{{1}}}</nowiki></code>) and {{para|lang-name}} may be conflicting, only one of these is allowed; use the most appropriate.  See template documentation for specific requirements for these parameters.
*{{color|#d33|missing English translation}} – an English-language translation in <code><nowiki>{{{3}}}</nowiki></code> or {{para|term1}} of the non-English text is required.  To resolve this error, provide an appropriate translation.

== Bu nwuan ==
* {{Tl|Lang}}
* {{tl|Lang-x}}, a̱fi̱p wu

<includeonly>{{Sandbox other||
<!-- Categories and interwikis go here: -->
[[Category:Wikipedia multilingual support templates]]
}}</includeonly>