Template:Lang-en/doc

From MOASSpedia
Jump to navigation Jump to search

Usage

settings
code en
link no
style: inherit

Because this is English Wikipedia, the facts that a) the content is in English by default, and that b) the word "English" refers to the English language, are generally taken to be understood. Unlike many multilingual support templates, this template does not link the language name by default. To activate the link, add the |link=yes parameter.

In most cases, there is no reason to use this template, unless you have a specific technical need for it. This template exists principally as a placeholder for interwiki purposes.

Legitimate use almost always involves automation. The vast majority of needed uses of this template are cases where {{lang-xx}} has values, possibly including en, inserted for xx automatically by software tools such as templates and bots.

Some editors would also include using it in lists and tables that are using other such templates (e.g. {{lang-es}} for Spanish) to provide multiple translations of something, where consistency of output is desirable. However even in these cases it is better to use plain text, because  {{lang-en|foo}}  is three characters longer than simply  English: foo  and wastes performance on template parsing. That said, the form {{lang-en|foo}} could be useful in such a table in a linguistics or language usage article, where a link to English language could be genuinely relevant in the context.

It is rarely ever useful in ordinary article prose. Simply use:

  • {{lang-es|casa}}, 'house'

giving

rather than:

  • {{lang-es|casa}}, {{lang-en|'house'}}

giving

which is pointless on en.wikipedia.org.

Parameters

lang-xx supported parameters
parameter definition yields to alias
text non-English text {{{1}}}
translit Latin script transliteration of the content in text {{{2}}}
translit-std standard used for the transliteration of the value of translit; accepted values are: ISO, DIN, IAST, ALA, ALA-LC
translit-script transliteration standard's script identifier
translation literal English translation or gloss of the content in text lit, {{{3}}}
label label to be used instead of template-provided language label; may be wikilinked; special keyword none causes the template to render without any labels (including transliteration and translation labels)
link yes (default) links language name and static text associated with translit and translation; accepted values are: no, yes; |link=no does not unlink wikilinked labels set by |label= links
code IETF language tag for the content in text; set by the template, overriding the template setting is discouraged
script IETF language script subtag; sometimes set by the template when the language of the content in text uses more than one writing system; always four alpha characters; a value of Latn (not "Latin"!) forces italic rendering unless overridden by italic; overrides rtl italic
region IETF language region subtag
variant IETF language variant subtag
rtl yes indicates that the writing system used for the content in text is right-to-left; accepted values are: no (default), yes script
italic see table "lang-xx |italic= parameter operation"; accepted values are: yes, no, unset, invert, default italics,i
size specifies font size of the content in text; use a value suitable for use with the CSS font-size property; this should almost always be a relative value supplied in % or em units, not a fixed px value.
cat inhibits automatic categorization; mirror version of nocat; accepted values are: no, n, false, f, off, 0
nocat inhibits automatic categorization; mirror version of cat; accepted values are: yes, y, true, t, on, 1
lang-xx |italic= parameter operation
|italic= value description example code result html markup
  • parameter not present;
  • parameter present, not set;
  • invalid value
  • module applies style from:
  •   template setting, or
  •   |script=latn;
  • else inherits from external markup;
  • invalid values treated as default
{{lang-ru|тундра}} Russian: тундра [[Russian language|Russian]]: <span lang="ru">тундра</span>
{{lang-ru|tûndra}} Russian: tûndra [[Russian language|Russian]]: <span lang="ru">tûndra</span>
Incorrect markup; this requires |script=latn.
{{lang-fr|toundra}} French: toundra [[French language|French]]: <i lang="fr">toundra</i>
{{lang-ru|script=latn|tûndra}} Russian: tûndra [[Russian language|Russian]]: <i lang="ru-Latn">tûndra</i>
default {{lang-ru|тундра|italic=default}} Russian: тундра [[Russian language|Russian]]: <span lang="ru">тундра</span>
{{lang-fr|toundra|italic=default}} French: toundra [[French language|French]]: <i lang="fr">toundra</i>
{{lang-ru|script=latn|tûndra|italic=default}} Russian: tûndra [[Russian language|Russian]]: <i lang="ru-Latn">tûndra</i>
no
  • module applies upright style;
  • overrides |script=latn;
  • overrides external markup
{{lang-ru|тундра|italic=no}} Russian: тундра [[Russian language|Russian]]: <span lang="ru" style="font-style: normal;">тундра</span>
{{lang-fr|toundra|italic=no}} French: toundra [[French language|French]]: <span lang="fr" style="font-style: normal;">toundra</span>
{{lang-ru|script=latn|tûndra|italic=no}} Russian: tûndra [[Russian language|Russian]]: <span lang="ru-Latn" style="font-style: normal;">tûndra</span>
''{{lang-ru|script=latn|tûndra|italic=no}}'' Russian: tûndra ''[[Russian language|Russian]]: <span lang="ru-Latn" style="font-style: normal;">tûndra</span>''
yes
  • module applies italic style;
  • ignores |script=latn
{{lang-ru|тундра|italic=yes}} Russian: тундра [[Russian language|Russian]]: <i lang="ru">тундра</i>
{{lang-ru|script=latn|tûndra|italic=yes}} Russian: tûndra [[Russian language|Russian]]: <i lang="ru-Latn">tûndra</i>
unset
  • module applies no style;
  • inherits style from external markup;
  • overrides |script=latn
{{lang-ru|тундра|italic=unset}} Russian: тундра [[Russian language|Russian]]: <span lang="ru">тундра</span>
''{{lang-ru|тундра|italic=unset}}'' Russian: тундра ''[[Russian language|Russian]]: <span lang="ru">тундра</span>''
{{lang-ru|script=latn|tûndra|italic=unset}} Russian: tûndra [[Russian language|Russian]]: <span lang="ru-Latn">tûndra</span>
''{{lang-ru|script=latn|tûndra|italic=unset}}'' Russian: tûndra ''[[Russian language|Russian]]: <span lang="ru-Latn">tûndra</span>''
invert
  • module applies no style;
  • inverts style in internal markupdagger;
  • disables auto-italics
  • overrides script subtag latn;
{{lang-ru|тундра|italic=invert}} Russian: тундра [[Russian language|Russian]]: <span lang="ru">''тундра''</span>
{{lang-ru|''тундра''|italic=invert}} Russian: тундра [[Russian language|Russian]]: <span lang="ru">тундра</span>
{{lang-ru|script=latn|tûndra|italic=invert}} Russian: tûndra [[Russian language|Russian]]: <span lang="ru-Latn">''tûndra''</span>
{{lang-ru|script=latn|''tûndra''|italic=invert}} Russian: tûndra [[Russian language|Russian]]: <span lang="ru-Latn">tûndra</span>

dagger compare |italic=invert to |italic=unset:

{{Lang-de|... ein neues Opernprojekt in Angriff: ''Das Käthchen von Heilbronn'', nach Heinrich von Kleists gleichnamigem Drama.|italic=invert}}
German: ... ein neues Opernprojekt in Angriff: Das Käthchen von Heilbronn, nach Heinrich von Kleists gleichnamigem Drama.
{{Lang-de|''... ein neues Opernprojekt in Angriff: ''Das Käthchen von Heilbronn'', nach Heinrich von Kleists gleichnamigem Drama.''|italic=unset}}
German: ... ein neues Opernprojekt in Angriff: Das Käthchen von Heilbronn, nach Heinrich von Kleists gleichnamigem Drama.


See also