Дидани манбаъи Шаблон:Native name/doc

<noinclude>{{Documentation subpage}}</noinclude>
<!----EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE---->

An inline formatting template, based on {{tl|lang}} and {{tl|ISO 639 name}}, for indicating the language in which a native name has been given. By default, the native name is displayed in italics, followed by the language's name in a smaller-sized parenthesis. For example:
: {{native name{{\sandbox}}|de|Deutschland}}

The template's defaults can be overridden and the parenthesis excluded, in which case there may be no visible changes to the text where it's used. An [[HTML]] ''[[Span and div|span]]'', however, still identifies the native name as a linguistic element, meaning that web browsers and [[screen reader]]s can select a particular font, formatting, pronunciation, etc, for it.

== Syntax ==

; Common
: {{tc|native name|''[[ISO 639]] language code''|''the native name''}}

The code for the example at the start of this documentation would, therefore, be:
: <code><nowiki>{{native name|de|Deutschland}}</nowiki></code>

== Parameters ==

Required parameters shown in '''''bold italics'''''.

{| class="wikitable sortable" style="cellpadding:0.2em;text-align:left;line-height:1.3em;"
! Parameter name
! Description and example/s
|-
| '''''[first unnamed]'''''
| The [[ISO 639]] code for the native language. French, for instance, is "fr"; Spanish is "es"; Arabic is "ar"; etc.
|-
|style="white-space:nowrap;"| '''''[second unnamed]'''''
| The native name, in the native language (with accents, etc).
|-
| ''italics''<br/>{{smaller|(or ''italic'')}}
| Set to "off" or "no" to disable displaying the native name in italics.
: {{para|italics|off}}
|-
| ''paren''<br/>{{smaller|(or ''icon'')}}
| Set to "omit", "off" or "no" to suppress the appearance of the native language's name in a parenthesis after the native name.
: {{para|paren|omit}}
|-
| ''nbsp''
| Set to "omit" or "no" to suppress the addition of a second space between the native name and the native language's name in brackets.<br/>Generally works in tandem with the ''italics'' or ''italic'' and/or ''paren'' or ''icon'' switches, as the automatic addition of the second<br/>space prevents the native name in italics from appearing to lean into the following bracket.
: {{para|nbsp|omit}}
|-
| ''parensize''<br/>{{smaller|(previously ''fontsize'')}}
| Use to specify a font-size for the parenthesis.
: {{para|parensize|90%}}
|-
| ''nolink''
| Set to anything (e.g. "on") to suppress the appearance of the native language's name as a link.
|}

; More complex examples
Code and result for the same name "Deutschland" above but with ''italics'' and ''nbsp'' switched off, ''nolink'' switched on and a ''parensize'' of 90%:
: <code><nowiki>{{native name|de|Deutschland|italics=off|nbsp=omit|nolink=on|parensize=90%}}</nowiki></code>
: {{native name{{\sandbox}}|de|Deutschland|italics=off|nbsp=omit|nolink=on|parensize=90%}}

Retaining no italics but suppressing the parenthesis:
: <code><nowiki>{{native name|de|Deutschland|italics=off|paren=omit}}</nowiki></code>
: {{native name{{\sandbox}}|de|Deutschland|italics=off|paren=omit}}
This result is the same as if the {{tl|lang}} template had been used.

== Other examples ==

{| class="wikitable"
! Code !! Result
|-
| <pre>
{{Infobox settlement
| name = The Hague
| native_name = {{native name|nl|Den Haag}}
}}
</pre>
|style="vertical-align:middle;"|
{{Infobox settlement
| name = The Hague
| native_name = {{native name{{\sandbox}}|nl|Den Haag}}
}}
|-
| <pre>
{{Infobox country
| conventional_long_name = French Republic
| native_name = {{native name|fr|République française|paren=omit}}
}}
</pre>
|style="vertical-align:topmiddle;"|
{{Infobox country
| conventional_long_name = French Republic
| native_name = {{native name{{\sandbox}}|fr|République française|paren=omit}}
}}
|}

== Annotated code ==

<pre style="overflow:auto;">
                             ( ← 80 characters → )
--------------------------------------------------------------------------------
                                                                         Notes
   {{lang
    |   {{{1}}}<!--                                                       [a]
 -->|   {{#switch:{{{italics|{{{italic|}}}}}}|off|no=|''}}<!--
     -->{{{2}}}<!--                                                       [b]
     -->{{#switch:{{{italics|{{{italic|}}}}}}|off|no=|''}}
   }}<!--

-->{{#switch:{{{paren|{{{icon|}}}}}} |omit|off|no= <!--                   [c]
 -->|#default=&#38;nbsp;<!--
     -->{{#switch:{{{italics|{{{italic|}}}}}} |off|no= <!--               [d]
      -->|{{#switch|{{{nbsp|}}}|omit|no=|&#38;nbsp;}}<!--                     [e]
     -->}}<!--
     --><span class="languageicon" style="font-size:{{{parensize|[default]}}};
                                          font-weight:normal;"><!--
         -->{{#if:{{{nolink|}}} |({{ISO 639 name|{{{1}}}}}) <!--          [f]
          -->|  {{#ifexist:Template:ISO 639 name {{{1}}} <!--             [g]
              -->| ([[{{ISO 639 name|{{{1}}}}} language|{{ISO 639 name|{{{1}}}}}]])
                 | (language?)<!--                                        [h]
         -->}}  }}<!--
     --></span><!--
-->}}


--------------------------------------------------------------------------------
Notes legend
 [a] {{{1}}} = ISO 639 language code.
 [b] {{{2}}} = the foreign-language name/phrase, displayed in italics unless
                                                        italics/italic = off/no.
 [c] If paren/icon = omit/off/no, omit following parenthesis;
 [d] else if name/phrase is in italics
 [e] and nbsp isn't omit/no, add an extra space (to ensure italics doesn't lean
                                                          into the parenthesis).
 [f] If nolink set, display unlinked language name in the parenthesis;
 [g] else if an article for this language exists, link to it as "[[(name)
      language|(name)]]" in the parenthesis (eg "([[French language|French]])");
 [h] else return the error query "(language?)".
--------------------------------------------------------------------------------
</pre>

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
[[Category:Wikipedia formatting and function templates]]

[[bn:টেমপ্লেট:Native name]]
[[mk:Шаблон:Изворно име]]
}}</includeonly>