قالب:Langx/doc

This template is used on many pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page قبل تنفيذهم.

This template should not be used in citation templates such as Citation Style 1 and Citation Style 2، لأنها تضم markup that will pollute the COinS metadata they produce؛ انظر COinS في المعرفة.

This template should not be substituted.

هذه صفحة توثيق فرعية لـ قالب:Langx.
تتضمن معلومات الاستعمال، التصنيفات وأي محتوى آخر ليس من محتويات الأصل لصفحة القالب.

Uses Lua:

Module:Lang

Usage

This language template identifies non-English text. Both an IETF language tag and the non-English term or phrase are the only required parameters. The text is formatted according to recommendations in Wikipedia:Manual of Style/Text formatting#Foreign terms § Notes; italics for languages that use the Latin alphabet, normal for others.

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 to be identified. This parameter is not supported by {{langx|<<var style="padding-right: 1px;" >tag</var>>|...}} 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: `ISO`, `DIN`, `IAST`, `ALA`, `ALA-LC`	–
`\|translit-script=`	The transliteration standard's script identifier	–
`\|translation=`	The literal English translation or gloss of the content in `\|text=`	–	`\|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=`	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 "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 `\|script=latn`; else inherits from external markup; invalid values treated as default	`{{Langx\|ru\|тундра}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`{{Langx\|ru\|tûndra}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">tûndra</span>` Incorrect markup; this requires `\|script=latn`.
		`{{Langx\|fr\|toundra}}`	فرنسية: toundra	`[[فرنسية language\|فرنسية]]: <i lang="fr" dir="ltr">toundra</i>`
		`{{Langx\|ru\|script=latn\|tûndra}}`	روسية: tûndra	`[[روسية language\|روسية]]: <i lang="ru-Latn" dir="ltr">tûndra</i>`
`default`		`{{Langx\|ru\|тундра\|italic=default}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`{{Langx\|fr\|toundra\|italic=default}}`	فرنسية: toundra	`[[فرنسية language\|فرنسية]]: <i lang="fr" dir="ltr">toundra</i>`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=default}}`	روسية: tûndra	`[[روسية language\|روسية]]: <i lang="ru-Latn" dir="ltr">tûndra</i>`
`no`	module applies upright style; overrides `\|script=latn`; overrides external markup	`{{Langx\|ru\|тундра\|italic=no}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr" style="font-style: normal;">тундра</span>`
		`{{Langx\|fr\|toundra\|italic=no}}`	فرنسية: toundra	`[[فرنسية language\|فرنسية]]: <span lang="fr" dir="ltr" style="font-style: normal;">toundra</span>`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=no}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr" style="font-style: normal;">tûndra</span>`
		`''{{Langx\|ru\|script=latn\|tûndra\|italic=no}}''`	روسية: tûndra	`''[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr" style="font-style: normal;">tûndra</span>''`
`yes`	module applies italic style; ignores `\|script=latn`	`{{Langx\|ru\|тундра\|italic=yes}}`	روسية: тундра	`[[روسية language\|روسية]]: <i lang="ru" dir="ltr">тундра</i>`
`yes`	module applies italic style; ignores `\|script=latn`	`{{Langx\|ru\|script=latn\|tûndra\|italic=yes}}`	روسية: tûndra	`[[روسية language\|روسية]]: <i lang="ru-Latn" dir="ltr">tûndra</i>`
`unset`	module applies no style; inherits style from external markup; overrides `\|script=latn`	`{{Langx\|ru\|тундра\|italic=unset}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`''{{Langx\|ru\|тундра\|italic=unset}}''`	روسية: тундра	`''[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>''`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=unset}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">tûndra</span>`
		`''{{Langx\|ru\|script=latn\|tûndra\|italic=unset}}''`	روسية: tûndra	`''[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">tûndra</span>''`
`invert`	module applies no style; inverts style in internal markup^[أ]; disables auto-italics overrides script subtag `latn`;	`{{Langx\|ru\|тундра\|italic=invert}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">''тундра''</span>`
		`{{Langx\|ru\|''тундра''\|italic=}invert}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=invert}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">''tûndra''</span>`
		`{{Langx\|ru\|script=latn\|''tûndra''\|italic=invert}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">tûndra</span>`

Notes

^ compare |italic=invert to |italic=unset:
{{Langx|de|... ein neues Opernprojekt in Angriff: ''Das Käthchen von Heilbronn'', nach Heinrich von Kleists gleichnamigem Drama.|italic=invert}}
ألمانية: ... ein neues Opernprojekt in Angriff: Das Käthchen von Heilbronn, nach Heinrich von Kleists gleichnamigem Drama.

{{Langx|de|''... ein neues Opernprojekt in Angriff: ''Das Käthchen von Heilbronn'', nach Heinrich von Kleists gleichnamigem Drama.''|italic=unset}}
ألمانية: ... ein neues Opernprojekt in Angriff: Das Käthchen von Heilbronn, nach Heinrich von Kleists gleichnamigem Drama.

TemplateData

This is the بيانات القالب documentation for this template used by المحرر المرئي وأدوات أخرى.

See 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.

وسائط القالب
وسيط		وصف	نوع	حالة
Language tag	`1`	A valid IETF language tag identifying the language of the non-English text.	نص	مطلوب
Text	`2`	The non-English text to display.	نص	مطلوب
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.	نص	اختياري
Literal translation	`4` `lit` `translation`	The literal translation of the foreign text.	نص	اختياري
Display link	`links` `link`	Set to 'no' to disable the link to the article's language.	بولياني	اختياري
Language label	`label`	If 'none', suppresses language link and label. Other options may be available depending on the language. مثال none	سطر	اختياري
Right-to-left	`rtl`	Toggle right-to-left view for the foreign text. غيابي no مثال yes	بولياني	اختياري
Italicize	`italic` `italics` `i`	Toggle italicization for the foreign text. غيابي yes مثال no	بولياني	اختياري
Font-size	`size`	Sets font-size for the foreign text. مثال 120%, 1.2em	غير معروف	اختياري

Examples

The following examples show translations from German.

Edit

Weimar is located in the federal state of Thuringia ({{Langx|de|Thüringen}}).
The Seafarers of Catan ({{Langx|de|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}})
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.

Resulting text

Weimar is located in the federal state of Thuringia (ألمانية: Thüringen).
The Seafarers of Catan (ألمانية: Die Seefahrer von Catan) is an expansion of the board game The Settlers of Catan.
Albert the Bear (ألمانية: Albrecht der Bär)
All Quiet on the Western Front (ألمانية: Im Westen nichts Neues, lit. 'In the West Nothing New') is a novel by Erich Maria Remarque.

Tracking categories

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

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: `ISO`, `DIN`, `IAST`, `ALA`, `ALA-LC`	–
`\|translit-script=`	The transliteration standard's script identifier	–
`\|translation=`	The literal English translation or gloss of the content in `\|text=`	–	`\|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=`	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 "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`	–

\|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	`{{Langx\|ru\|тундра}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`{{Langx\|ru\|tûndra}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">tûndra</span>` Incorrect markup; this requires `\|script=latn`.
		`{{Langx\|fr\|toundra}}`	فرنسية: toundra	`[[فرنسية language\|فرنسية]]: <i lang="fr" dir="ltr">toundra</i>`
		`{{Langx\|ru\|script=latn\|tûndra}}`	روسية: tûndra	`[[روسية language\|روسية]]: <i lang="ru-Latn" dir="ltr">tûndra</i>`
`default`		`{{Langx\|ru\|тундра\|italic=default}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`{{Langx\|fr\|toundra\|italic=default}}`	فرنسية: toundra	`[[فرنسية language\|فرنسية]]: <i lang="fr" dir="ltr">toundra</i>`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=default}}`	روسية: tûndra	`[[روسية language\|روسية]]: <i lang="ru-Latn" dir="ltr">tûndra</i>`
`no`	module applies upright style; overrides `\|script=latn`; overrides external markup	`{{Langx\|ru\|тундра\|italic=no}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr" style="font-style: normal;">тундра</span>`
		`{{Langx\|fr\|toundra\|italic=no}}`	فرنسية: toundra	`[[فرنسية language\|فرنسية]]: <span lang="fr" dir="ltr" style="font-style: normal;">toundra</span>`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=no}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr" style="font-style: normal;">tûndra</span>`
		`''{{Langx\|ru\|script=latn\|tûndra\|italic=no}}''`	روسية: tûndra	`''[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr" style="font-style: normal;">tûndra</span>''`
`yes`	module applies italic style; ignores `\|script=latn`	`{{Langx\|ru\|тундра\|italic=yes}}`	روسية: тундра	`[[روسية language\|روسية]]: <i lang="ru" dir="ltr">тундра</i>`
`yes`	module applies italic style; ignores `\|script=latn`	`{{Langx\|ru\|script=latn\|tûndra\|italic=yes}}`	روسية: tûndra	`[[روسية language\|روسية]]: <i lang="ru-Latn" dir="ltr">tûndra</i>`
`unset`	module applies no style; inherits style from external markup; overrides `\|script=latn`	`{{Langx\|ru\|тундра\|italic=unset}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`''{{Langx\|ru\|тундра\|italic=unset}}''`	روسية: тундра	`''[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>''`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=unset}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">tûndra</span>`
		`''{{Langx\|ru\|script=latn\|tûndra\|italic=unset}}''`	روسية: tûndra	`''[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">tûndra</span>''`
`invert`	module applies no style; inverts style in internal markup^[أ]; disables auto-italics overrides script subtag `latn`;	`{{Langx\|ru\|тундра\|italic=invert}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">''тундра''</span>`
		`{{Langx\|ru\|''тундра''\|italic=}invert}}`	روسية: тундра	`[[روسية language\|روسية]]: <span lang="ru" dir="ltr">тундра</span>`
		`{{Langx\|ru\|script=latn\|tûndra\|italic=invert}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">''tûndra''</span>`
		`{{Langx\|ru\|script=latn\|''tûndra''\|italic=invert}}`	روسية: tûndra	`[[روسية language\|روسية]]: <span lang="ru-Latn" dir="ltr">tûndra</span>`