Template:Native name/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
← Older edit
VisualWikitext
meta>CsDix
updating
Ookami (talk | contribs)
1,664 edits
m 61 revisions imported
 
(39 intermediate revisions by 15 users not shown)
Line 1: Line 1:
<noinclude>{{documentation subpage}}</noinclude>
<noinclude>{{Documentation subpage}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
<!----EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE---->
Convenience template, based on {{tl|lang}}, to indicate the language of a place's native name. The language is appended as a parenthesis, in{{spaced ndash}}by current defaults{{spaced ndash}}italics and a slightly smaller size:
{{lua|Module:Lang}}
: {{native name|de|Deutschland}}
An inline formatting template, based on {{tl|lang}}, 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 parentheses. For example:
: {{native name{{\sandbox}}|de|Deutschland}}


The template's defaults can be overridden and the parenthesis even excluded, in which case there may be no visible changes to the text where it's used. It still, however, identifies the native name as a linguistic element using the [[HTML]] ''[[Span and div|span]]'' tag, which web browsers and [[screen reader]]s can use to select an appropriate font, pronunciation, etc.
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.


== Usage ==
== Syntax ==


===Syntax===
; Common
; Common
{{pre|{{((}}native name{{!}}''[[ISO 639]] language code''{{!}}''the native name''{{))}} }}
: {{tc|native name|<{{var|[[IETF language tag]]}}>|<{{var|the native name}}>}}


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


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


Line 22: Line 24:
|-
|-
| '''''[first unnamed]'''''
| '''''[first unnamed]'''''
| The [[ISO 639]] code for the native language. French, for instance, is "fr"; Spanish is "es"; Arabic is "ar"; etc.
| The [[IETF language tag]] code for the native language. French, for instance, is "fr"; Spanish is "es"; Arabic is "ar"; etc.
|-
|-
| '''''[second unnamed]'''''
|style="white-space:nowrap;"| '''''[second unnamed]'''''
| The native name, in the native language (with accents, etc).
| The native name, in the native language (with accents, etc.).
|-
|-
| ''italics''<br/>or ''italic''
| ''italics''<br/>{{smaller|(or ''italic'')}}
| Set to "off" (or "no") to disable displaying the native name in italics.
| Set to "off" or "no" to disable displaying the native name in italics.
: <code><nowiki>|italics=off</nowiki></code>
: {{para|italics|off}}
|-
|-
| ''paren''<br/>or ''icon''
| ''paren''<br/>{{smaller|(or ''icon'')}}
| Set to "off" (or "no") to suppress the appearance of the native language's name in barackets after the native name.
| Set to "omit", "off" or "no" to suppress the appearance of the native language's name in a parenthesis after the native name.
: <code><nowiki>|paren=off</nowiki></code>
: {{para|paren|omit}}
|-
|-
| ''nbsp''
| ''nbsp''
| Set to "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 space prevents the native name in italics from appearing to lean into the following bracket.
| 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.
: <code><nowiki>|nbsp=no</nowiki></code>
: {{para|nbsp|omit}}
|-
|-
| ''fontsize''
| ''parensize''<br/>{{smaller|(previously ''fontsize'')}}
| Use to set a font-size for the language name in brackets that differs from the default.
| Use to specify a font-size for the parenthesis. Per [[MOS:FONTSIZE]], do not make this text smaller in infoboxes, since the text is already at 88% of normal.
: <code><nowiki>|fontsize=80%</nowiki></code>
: {{para|parensize|90%}}
|-
|-
| ''nolink''
| ''nolink''
| Set to anything (usually "yes") to suppress the appearance of the native language's name as a link.
| Set to anything (e.g. "on") to suppress the appearance of the native language's name as a link.
|-
| ''script'' (deprecated)
| when needed, include [[ISO 15924]] in <code><nowiki>{{{1}}}</nowiki></code> IETF language tag; e.g. 'sr-Cyrl' <s>Specifies the [[ISO 15924]] script. E.g. "Cyrl", "Arab", "Hans"...</s>
|}
|}


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


== More examples ==
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.


{{pre|{{((}}Infobox settlement<br />
== Other examples ==
&nbsp;{{!}}name{{=}}The Hague<br />
&nbsp;{{!}}native_name{{=}}'''{{((}}native name{{!}}nl{{!}}Den Haag{{))}}'''<br />
{{))}}}}


results in
{| class="wikitable"
 
! Code !! Result
<table class="infobox geography vcard" style="width:23em; text-align:left; float:left; clear:both;">
|-
<tr>
| <pre>
<th colspan="2" style="width:100%; text-align:center; font-size:1.25em; white-space:nowrap"><span class="fn org">The Hague</span><br />
{{Infobox settlement
<span class="nickname">{{native name|nl|Den Haag}}</span></th>
| name = The Hague
</tr>
| native_name = {{native name|nl|Den Haag}}
</table>
}}
 
</pre>
<p style="clear:both">while</p>
|style="vertical-align:middle;"|
 
{{Infobox settlement
{{Pre|{{((}}Infobox settlement<br />
| name = The Hague
&nbsp;{{!}}name{{=}}French Republic<br />
| native_name = {{native name{{\sandbox}}|nl|Den Haag}}
&nbsp;{{!}}native_name{{=}}'''{{((}}native name{{!}}fr{{!}}République française{{!}}icon{{=}}no{{))}}'''<br />
}}
{{))}}}}
|-
 
| <pre>
results in
{{Infobox country
 
| conventional_long_name = French Republic
<table class="infobox geography vcard" style="width: 22em; font-size: 88%; float: left; clear: both;">
| native_name = {{native name|fr|République française|paren=omit}}
<tr class="adr">
}}
<th colspan="3" align="center" class="mergedtoprow" style="line-height:1.2em; padding:0.25em 0.33em 0.33em; font-size:1.25em;"><span class="fn org country-name">French Republic</span>
<div style="padding-top:0.25em;">{{native name|fr|République française|icon=no}}</div>
</th>
</tr>
</table>
 
<p style="clear:both">&nbsp;</p>
 
===Note===
When the ''paren'' or ''icon'' and ''italics'' or ''italic'' parameters are set to "off" (or "no"), this template is equivalent to the {{tl|lang}} template.
 
== Annotated code ==
 
<pre style="overflow:auto;">
                              width 80 characters
--------------------------------------------------------------------------------
 
{{lang |{{{1}}}                                                       <!--[a]-->
|<!---->{{#switch:{{{italics|{{{italic|}}}}}}|off|no|''}}<!--
      -->{{{2}}}<!--                                                  <!--[b]-->
      -->{{#switch:{{{italics|{{{italic|}}}}}}|off|no|''}}
}}<!--
-->{{#switch:{{{paren|{{{icon|}}}}}}|off|no                          <!--[c]-->
    |&#38;nbsp;{{#switch:{{{italics|{{{italic|}}}}}}|off|no              <!--[d]-->
            |{{#ifeq:{{{nbsp|}}}|no |                                <!--[e]-->
              |&#38;nbsp;}}<!--
          -->}}<!--
  --><span class="languageicon"
          style="font-size:{{{fontsize|90%}}};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><!--
-->}}
 
 
--------------------------------------------------------------------------------
Legend
[a] {{{1}}} = ISO 639 language code.
[b] {{{2}}} = the foreign-language placename. Displayed in italics unless
                                                        italics or italic = no.
[c] If icon or paren=no, omit following linked language name (in brackets).
[d] If placename in italics,
[e] then, unless nbsp=no, add an extra space after it (to stop the italics
                                    leaning into the parenthesis that follows).
[f] If nolink set, display unlinked language name,
[g] else if a link for this language name exists, display it as
            "[[(name) language|(name)]]" (e.g. "([[French language|French]])"),
[h] else return the error query "(language?)".
</pre>
</pre>
|style="vertical-align:topmiddle;"|
{{Infobox country
| conventional_long_name = French Republic
| native_name = {{native name{{\sandbox}}|fr|République française|paren=omit}}
}}
|}


<includeonly>{{Sandbox other||
[[Category:Wikipedia formatting and function templates]]


<includeonly>
[[bn:টেমপ্লেট:Native name]]
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
[[mk:Шаблон:Изворно име]]
 
}}</includeonly>
</includeonly>

Latest revision as of 22:54, 3 September 2020

An inline formatting template, based on {{lang}}, 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 parentheses. For example:

Deutschland  (German)

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, however, still identifies the native name as a linguistic element, meaning that web browsers and screen readers can select a particular font, formatting, pronunciation, etc., for it.

Syntax

Common
{{native name|<IETF language tag>|<the native name>}}

The code for the example at the start of this documentation would, therefore, be:

{{native name|de|Deutschland}}

Parameters

Required parameters shown in bold italics.

Parameter name Description and example/s
[first unnamed] The IETF language tag code for the native language. French, for instance, is "fr"; Spanish is "es"; Arabic is "ar"; etc.
[second unnamed] The native name, in the native language (with accents, etc.).
italics
(or italic) 		Set to "off" or "no" to disable displaying the native name in italics.
|italics=off
paren
(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.
|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.
Generally works in tandem with the italics or italic and/or paren or icon switches, as the automatic addition of the second
space prevents the native name in italics from appearing to lean into the following bracket.
|nbsp=omit
parensize
(previously fontsize) 		Use to specify a font-size for the parenthesis. Per MOS:FONTSIZE, do not make this text smaller in infoboxes, since the text is already at 88% of normal.
|parensize=90%
nolink Set to anything (e.g. "on") to suppress the appearance of the native language's name as a link.
script (deprecated) when needed, include ISO 15924 in {{{1}}} IETF language tag; e.g. 'sr-Cyrl' Specifies the ISO 15924 script. E.g. "Cyrl", "Arab", "Hans"...
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%:

{{native name|de|Deutschland|italics=off|nbsp=omit|nolink=on|parensize=90%}}
Deutschland (German)

Retaining no italics but suppressing the parenthesis:

{{native name|de|Deutschland|italics=off|paren=omit}}
Deutschland

This result is the same as if the {{lang}} template had been used.

Other examples

Code Result 
{{Infobox settlement
| name = The Hague
| native_name = {{native name|nl|Den Haag}}
}}
Script error: No such module "Settlement short description".
The Hague

Den Haag  (Dutch)
{{Infobox country
| conventional_long_name = French Republic
| native_name = {{native name|fr|République française|paren=omit}}
}}
République française
French Republic


Retrieved from "https://zoophilia.wiki/index.php?title=Template:Native_name/doc&oldid=117092"