Editing Template:Lang/doc (section)

=== Formatting ===
==== Automatic italics ====
{{tld|lang}} automatically applies italic styling <span style="font-weight: normal;">when the text in {{param|2}} is written entirely in the <code>Latn</code> script (the Latin alphabet and its extensions), either when that is the default encoding for the language or when it is triggered by a <code>{{var|xx}}-Latn</code> language code{{colon}}</span>
* <syntaxhighlight lang="wikitext" inline>{{lang|fr|Je suis française.}}</syntaxhighlight> → {{lang|fr|Je suis française.}}
* <syntaxhighlight lang="wikitext" inline>''{{lang|fr|Je suis française.}}''</syntaxhighlight> → ''{{lang|fr|Je suis française.}}'' – external markup is ignored
* <syntaxhighlight lang="wikitext" inline>{{lang|he-Latn|la'az}} ({{lang|he|לעז}})</syntaxhighlight> → {{lang|he-Latn|la'az}} ({{lang|he|לעז}})
* <code><nowiki>''{{lang|he-Latn|la'az}}''</nowiki> ({{!mxt|<nowiki>''{{lang|he|לעז}}''</nowiki>}})</code> → ''{{lang|he-Latn|la'az}}'' ({{!mxt|''{{lang|he|לעז}}''}}) – external markup is ignored around the <code>he-Latn</code> text, but will incorrectly italicize the Hebrew-character material.

When <code>Latn</code> script should not be italicized, there are multiple approaches{{colon}}
{{para|italic|no}} <span style="font-weight: normal;">– renders {{param|2}} in upright font; italic markup around the template is ignored; italic markup inside the template causes an error message{{colon}}</span>
* <syntaxhighlight lang="wikitext" inline>{{lang|fr|Je suis française.|italic=no}}</syntaxhighlight> → {{lang|fr|Je suis française.|italic=no}}
* <syntaxhighlight lang="wikitext" inline>''{{lang|fr|Je suis française.|italic=no}}''</syntaxhighlight> → ''{{lang|fr|Je suis française.|italic=no}}''
* <syntaxhighlight lang="wikitext" inline>''{{lang|fr|Je suis ''française''.|italic=no}}''</syntaxhighlight> → ''{{lang|fr|Je suis ''française''.|italic=no|cat=no}}'' – italic markup in conflict with {{para|italic|no}}

{{para|italic|unset}} <span style="font-weight: normal;">– disables template-provided styling; {{param|2}} is styled according to external or internal wiki markup{{colon}}</span>
* <syntaxhighlight lang="wikitext" inline>{{lang|fr|Je suis française.|italic=unset}}</syntaxhighlight> → {{lang|fr|Je suis française.|italic=unset}}
* <syntaxhighlight lang="wikitext" inline>''{{lang|fr|Je suis française.|italic=unset}}''</syntaxhighlight> → ''{{lang|fr|Je suis française.|italic=unset}}''
* <syntaxhighlight lang="wikitext" inline>{{lang|fr|''Je suis'' English.|italic=unset}}</syntaxhighlight> → {{lang|fr|''Je suis'' English.|italic=unset}}

{{tlx|noitalic}} <span style="font-weight: normal;">can also be used{{colon}}</span>
* <syntaxhighlight lang="wikitext" inline>{{lang|fr|Je suis {{noitalic|English}}.}}</syntaxhighlight> → {{lang|fr|Je suis {{noitalic|English}}.}}
{{hatnote|{{crossreference|See table "[[#italic parameter|lang {{!}}italic{{=}} parameter operation]]".}}}}

==== Prefixed language template ====
There is a version of this template, {{tl|langx}}, which is intended to be used the first time a language appears in an article. These templates will print the language's name and, when appropriate, italicize their content:

* <syntaxhighlight lang="wikitext" inline>A '''kremlin''' ({{langx|ru|кремль}}, 'castle') is a major fortified central complex ...</syntaxhighlight> → A '''kremlin''' ({{langx|ru|кремль}}, 'castle') is a major fortified central complex ...

While the {{tnull|langx}} template outputs text in italics for languages with Latin-based scripts, if plain text is required, such as for proper names, {{para|italic|no}} or {{tlx|noitalic}} may be used:

* <syntaxhighlight lang="wikitext" inline>the border town of Ventimiglia ({{langx|fr|Vintimille}})</syntaxhighlight> → the border town of Ventimiglia ({{langx|fr|Vintimille}})
* <syntaxhighlight lang="wikitext" inline>the border town of Ventimiglia ({{langx|fr|italic=no|Vintimille}})</syntaxhighlight> → the border town of Ventimiglia ({{langx|fr|italic=no|Vintimille}})
* <syntaxhighlight lang="wikitext" inline>the border town of Ventimiglia ({{langx|fr|{{noitalic|Vintimille}}}})</syntaxhighlight> → the border town of Ventimiglia ({{langx|fr|{{noitalic|Vintimille}}}})

When formatting foreign-language text to match style guidelines, it is best to exclude the styling markup from the template, so that any extraneous markup which is not from the foreign language does not receive incorrect metadata for that language. This includes: English-language quotation marks around titles of works in languages that use other quotation character glyphs; italicization of titles in languages which do not use that convention; and emphasis that is not found (in one style or another) in the original foreign text; among other cases. If in doubt, put such markup outside the template when possible.

{{See also|Wikipedia:Manual of Style/Text formatting#Foreign terms}}

==== Proto-languages ====
* {{tlx|lang|cel-x-proto|kal-|_show_result=yes}}
* {{tlx|lang|cel-x-proto|kal-|proto{{=}}no|_show_result=yes}}
* {{tlx|langx|cel-x-proto|kal-|_show_result=yes}}
* {{tlx|langx|cel-x-proto|kal-|proto{{=}}no|_show_result=yes}}
* {{tlx|lang|en|accidently|_show_result=yes}}
* {{tlx|lang|en|accidently|proto{{=}}yes|_show_result=yes}}