ᱪᱷᱟᱸᱪ:Langx

Template documentation[view] [edit] [history] [purge]

This language template identifies non-English text. It is very similar to {{lang}} but inserts the name of the language as a label. The text is formatted according to recommendations in Wikipedia:Manual of Style/Text formatting § Foreign terms: italics for languages that use the Latin alphabet, normal for others.

Usage

An IETF language tag and the non-English term or phrase are the only required parameters.

The template should generally be placed after the English translation of the foreign term or phrase.

• The parameter |links=no prevents the language name from being linked.
• The parameter |translit= allows for a romanization. This parameter is not supported by {{langx|<tag>|...}} templates for languages that are already written in Latin script.
• The parameter |lit= enables a literal translation (in English) to be given.

Parameters

Langx supported parameters

Parameter	Definition	Yields to	Alias
|1=	The IETF language tag for the content in |text=	—	|code=
|text=	The non-English text	—	|2=
|translit=	The Latin script transliteration of the content in |text=	—	|3=
|translit-std=	The standard used for the transliteration of the value of |translit=; accepted values are: Abkai, ahl, ALA, ALA-LC, batr, bgn/pcgn, DIN, eae, hepburn, hu, hunterian, IAST, ISO, jyutping, mdorff, mlcts, mr, nihon-shiki, no_std, pinyin, rr, rtgs, satts, scientific, ukrainian, ungegn, wadegile, wehr, yaleko	—
|translit-script=	The transliteration standard's script identifier	—
|translation=	The literal English translation or gloss of the content in |text=. Will be surrounded in single-quotes. The text will be tagged with CSS class gloss-text and the quotes with gloss-quot, like how {{gloss}} does it, enabling customization in user stylesheets.	—	|lit=, |4=
|label=	The 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=	Links language name and static text associated with |translit= and |translation=. Defaults to yes. Accepted values are: no, yes; |link=no does not unlink wikilinked labels set by |label=	—	|links=
|proto=	Accepted values are: no (default) or yes (default for private-use language tags with the -x-proto subtags); when yes (default or explicit), prefixes rendered text with an asterisk indicating 'unattested'	—
|script=	(Deprecated – include script subtag in |1=) 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=	(Deprecated – include region subtag in |1=) IETF language region subtag	—
|variant=	(Deprecated – include variant subtag in |1=) 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 "Langx |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.	—
|engvar=	Selects English variant spelling of 'romanised' or 'romanized' (default) according to the country specified; accepted values are: au (Australia), ca (Canada), gb (Great Britain), ie (Ireland), in (India), nz (New Zealand), us (United States), za (South Africa)	—
|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	—

Langx |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   -latn script subtag; else inherits from external markup; invalid values treated as default	{{Langx|ru|тундра}}	Russian: тундра	[[Russian language|Russian]]: <span lang="ru">тундра</span>
		{{Langx|ru|tûndra}}	Russian: tûndra	[[Russian language|Russian]]: <span lang="ru">tûndra</span> Incorrect markup; this requires script subtag -latn.
		{{Langx|fr|toundra}}	French: toundra	[[French language|French]]: <i><span lang="fr">toundra</span></i>
		{{Langx|ru-latn|tûndra}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]
default		{{Langx|ru|тундра|italic=default}}	Russian: тундра	[[Russian language|Russian]]: <span lang="ru">тундра</span>
		{{Langx|fr|toundra|italic=default}}	French: toundra	[[French language|French]]: <i><span lang="fr">toundra</span></i>
		{{Langx|ru-latn|tûndra|italic=default}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]
no	module applies upright style; overrides -latn script subtag; overrides external markup	{{Langx|ru|тундра|italic=no}}	Russian: тундра	[[Russian language|Russian]]: <span lang="ru">тундра</span>
		{{Langx|fr|toundra|italic=no}}	French: toundra	[[French language|French]]: <i><span lang="fr">toundra</span></i>
		{{Langx|ru-latn|tûndra|italic=no}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]
		''{{Langx|ru-latn|tûndra|italic=no}}''	ᱪᱷᱟᱸᱪ:Lang-ru-latn	''[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]''
yes	module applies italic style; ignores -latn script subtag	{{Langx|ru|тундра|italic=yes}}	Russian: тундра	[[Russian language|Russian]]: <span lang="ru">тундра</span>
		{{Langx|ru-latn|tûndra|italic=yes}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]
unset	module applies no style; inherits style from external markup; overrides -latn script subtag	{{Langx|ru|тундра|italic=unset}}	Russian: тундра	[[Russian language|Russian]]: <span lang="ru">тундра</span>
		''{{Langx|ru|тундра|italic=unset}}''	Russian: тундра	''[[Russian language|Russian]]: <span lang="ru">тундра</span>''
		{{Langx|ru-latn|tûndra|italic=unset}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]
		''{{Langx|ru-latn|tûndra|italic=unset}}''	ᱪᱷᱟᱸᱪ:Lang-ru-latn	''[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]''
invert	module applies no style; inverts style in internal markup; disables auto-italics; overrides -latn script subtag	{{Langx|ru|тундра|italic=invert}}	Russian: тундра	[[Russian language|Russian]]: <span lang="ru">тундра</span>
		{{Langx|ru|''тундра''|italic=invert}}	[тундра]	&#x5B;''тундра''&#x5D; <span style="font-size:100%; font-style:normal;" class="error">error: {{lang-xx}}: text has italic markup ([[:Category:lang and lang-xx template errors|help]])</span>
		{{Langx|ru-latn|tûndra|italic=invert}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]
		{{Langx|ru-latn|''tûndra''|italic=invert}}	ᱪᱷᱟᱸᱪ:Lang-ru-latn	[[:ᱪᱷᱟᱸᱪ:Lang-ru-latn]]

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; Italic textsee the monthly error report for this template.

TemplateData for Langx

Indicates to readers the original form of a term or phrase in a foreign language.

Template parameters[Edit template data]

Parameter		Description	Type	Status
Language tag	1	A valid IETF language tag identifying the language of the non-English text. E.g. "ja" for Japanese. Example ja	String	required
Text	2	The non-English text to display. E.g. "東京都" means "Tokyo" in Japanese. Example 東京都	String	required
Transliteration	3 translit	The transliteration of the foreign text, for languages that do not use the Latin alphabet. This field is ignored for languages that do use the Latin alphabet. E.g. "Tōkyō" is the standardized romanization of "Tokyo". Example Tōkyō	String	optional
Literal translation	4 lit translation	The literal translation of the foreign text. E.g. "Tokyo" means "eastern capital". Example eastern capital	String	optional
Display link	links link	Set to 'no' to disable the link to the article's language. Default yes Auto value no	Boolean	optional
Language label	label	If 'none', suppresses language link and label. Other options may be available depending on the language. Example none	Line	optional
Right-to-left	rtl	Toggle right-to-left view for the foreign text. Default no Example yes	Boolean	optional
Italicize	italic italics i	Toggle italicization for the foreign text. Default yes Example no	Boolean	optional
Font-size	size	Sets font-size for the foreign text. Example 120%, 1.2em	Unknown	optional
English variant	engvar	Spelling of 'romanized/romanised'. Suggested values au ca gb ie in nz us za	String	optional

Examples

The following examples show translations from German or French.

• Weimar is located in the federal state of Thuringia ({{Langx|de|Thüringen}}).

  
  Weimar is located in the federal state of Thuringia (German: Thüringen).

• The ''Seafarers of Catan'' ({{Langx|de|Die Seefahrer von Catan}}) is an expansion of the board game ''[[The Settlers of Catan]]''.

  
  The Seafarers of Catan (German: Die Seefahrer von Catan) is an expansion of the board game The Settlers of Catan.

• Albert the Bear ({{Langx|de|Albrecht der Bär|links=no}})

  
  Albert the Bear (German: Albrecht der Bär)

• ''All Quiet on the Western Front'' ({{Langx|de|Im Westen nichts Neues|lit=In the West Nothing New}}) is a novel by [[Erich Maria Remarque]].

  
  All Quiet on the Western Front (German: Im Westen nichts Neues) is a novel by Erich Maria Remarque.

• '''Paris Cité University''' ({{langx|fr|links=no|'''Université Paris Cité'''}}) is a public research university

  
  Paris Cité University (French: Université Paris Cité) is a public research university

Comparison with the Lang template

This template differs from the {{lang}} template in that this one labels the text with the name of the language. For that reason, to avoid unnecessary clutter, this template should be used sparingly, in cases where the name of the language should be made explicit, such as the first place in an article that the translation of a word or phrase in English is given, or when renderings in multiple languages are being given and confusion is possible in the absence of such labeling.

Comparison:

• {{Lang|ru|тундра}} produces тундра
• {{Langx|ru|тундра}} produces Russian: тундра
• {{Langx|ru|тундра|label=none}} produces Russian: тундра

Tracking categories

• Category:Lang and lang-xx template errors (᱔)
• Category:Lang and lang-xx code promoted to ISO 639-1 (᱑)
• Category:Lang and lang-xx using deprecated ISO 639 codes (᱐)

TODO: (2024-09-22) rename these categories

See also

• {{crh}} – Supports Latin, Cyrillic, and Arabic Crimean Tatar text
• {{Lang}}
• {{Language with name/for}}
• List of ISO 639 language codes (language codes)
• {{IPA}}

The above documentation is transcluded from ᱪᱷᱟᱸᱪ:Langx/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.

This is the TemplateData documentation for this template used by VisualEditor and other tools; Italic textsee the monthly error report for this template.

TemplateData for Langx

ᱯᱟᱲᱦᱟᱣᱤᱭᱟᱹ ᱠᱚ ᱢᱤᱫᱴᱟᱝ ᱵᱟᱦᱨᱮ ᱯᱟᱹᱨᱥᱤ ᱨᱮᱱᱟᱜ ᱟᱹᱲᱟᱹ ᱥᱮ ᱟᱹᱭᱟᱹᱛ ᱨᱮᱱᱟᱜ ᱟᱥᱚᱞ ᱨᱩᱯ ᱩᱫᱩᱜ ᱞᱟᱹᱜᱤᱫ ᱵᱮᱵᱷᱟᱨᱚᱜ ᱠᱟᱱ ᱴᱮᱢᱯᱞᱮᱴ ᱾

Template parameters[Edit template data]

Parameter		Description	Type	Status
ᱯᱟᱹᱨᱥᱤ ᱧᱩᱛᱩᱢ	1	ᱢᱤᱫᱴᱟᱝ ᱵᱟᱛᱟᱣᱟᱜ IETF ᱯᱟᱹᱨᱥᱤ ᱠᱳᱰ ᱡᱟᱦᱟᱸ ᱫᱚ ᱵᱟᱝ-ᱥᱟᱱᱛᱟᱲᱤ ᱚᱞ ᱠᱚ ᱞᱟᱹᱭ ᱥᱚᱫᱚᱨᱟ ᱾ Example en	String	required
ᱚᱞ (Text)	2	ᱩᱫᱩᱜ ᱞᱟᱹᱜᱤᱫ ᱵᱟᱝ-ᱥᱟᱱᱛᱟᱲᱤ ᱚᱞ ᱾	String	required
ᱞᱤᱯᱤ ᱵᱚᱫᱚᱞ (Transliteration)	3 translit	ᱚᱞ ᱪᱤᱠᱤ ᱵᱟᱝ ᱵᱮᱵᱷᱟᱨᱚᱜ ᱠᱟᱱ ᱯᱟᱹᱨᱥᱤ ᱠᱚ ᱞᱟᱹᱜᱤᱫ ᱵᱟᱦᱨᱮ ᱯᱟᱹᱨᱥᱤ ᱚᱞ ᱨᱮᱱᱟᱜ ᱩᱪᱟᱹᱲ ᱾	String	optional
ᱛᱚᱨᱡᱚᱢᱟ	4 lit translation	ᱵᱟᱦᱨᱮ ᱯᱟᱹᱨᱥᱤ ᱚᱞ ᱨᱮᱱᱟᱜ ᱥᱟᱹᱨᱤ ᱛަރުᱡᱚᱢᱟ ᱾	String	optional
ᱡᱚᱱᱚᱲ ᱩᱫᱩᱜ (Links)	links link	ᱥᱟᱛᱟᱢ ᱨᱮᱱᱟᱜ ᱯᱟᱹᱨᱥᱤ ᱡᱚᱱᱚᱲ ᱵᱚᱸᱫᱚ ᱞᱟᱹᱜᱤᱫ 'no' ᱥᱮ 'ᱵᱟᱝ' ᱚᱞ ᱢᱮ ᱾	Boolean	optional
ᱯᱟᱹᱨᱥᱤ ᱞᱮᱵᱮᱞ	label	'none' ᱠᱷᱟᱱ, ᱯᱟᱹᱨᱥᱤ ᱡᱚᱱᱚᱲ ᱟᱨ ᱞᱮᱵᱮᱞ ᱵᱟᱭ ᱩᱫᱩᱜᱟ ᱾ Example none	Line	optional
ᱡᱚᱡᱚᱢ-ᱠᱷᱚᱱ-ᱞᱮᱸᱜᱟ (RTL)	rtl	ᱵᱟᱦᱨᱮ ᱯᱟᱹᱨᱥᱤ ᱚᱞ ᱞᱟᱹᱜᱤᱫ ᱡᱚᱡᱚᱢ-ᱠᱷᱚᱱ-ᱞᱮᱸᱜᱟ ᱧᱮᱱᱮᱞ ᱪાલુ ᱢᱮ ᱾ Default no Example yes	Boolean	optional
ᱛᱮᱨᱪᱷᱟ ᱚᱞ (Italic)	italic italics i	ᱵᱟᱦᱨᱮ ᱯᱟᱹᱨᱥᱤ ᱚᱞ ᱠᱚᱬᱟ ᱜᱮ ᱩᱫᱩᱜ ᱢᱮ ᱾ Default yes Example no	Boolean	optional
ᱪᱤᱠᱤ ᱟᱠᱟᱨ (Font size)	size	ᱵᱟᱦᱨᱮ ᱯᱟᱹᱨᱥᱤ ᱚᱞ ᱞᱟᱹᱜᱤᱫ ᱪᱤᱠᱤ ᱨᱮᱱᱟᱜ ᱟᱠᱟᱨ ᱴᱷᱟᱹᱣᱠᱟᱹ ᱢᱮ ᱾ Example 120%, 1.2em	Unknown	optional