模板:Langx/doc

本模板不應在引文模板（如引文格式1和引文格式2）中使用，因為本模板所含的標示語言會破壞引文模板產生的 COinS（英語：COinS）元數據，更多資訊請見「Wikipedia:COinS（英語：Wikipedia:COinS）」。

本模板不能替換參照嵌入。

此頁面是Template:Langx的模板文件。
此頁面可能包含了模板的使用說明、分類和其他內容。

此模板使用Lua語言：

Module:Lang（沙盒）

這個語言模板用於標識非中文文本。它與{{lang}}非常相似，不過會將語言名稱作為標籤插入其中。根據模板討論:Langx § 提議以langx模板取代lang-xx系列模板的決定，此模板{{langx}}正式引入到Module:Lang。

用法

語言模板用來標註特定內容的語言。IETF語言標籤和外文內容是必填參數。

此模板通常放在外文短語或術語之後用以標註原文。

參數|links=no可阻止語言名稱被設置為超連結。
參數|translit= 允許進行羅馬化。但對於已經使用拉丁字母書寫的語言，{{langx|<tag>|...}} 模板不支持此參數。
參數|lit=允許給出直譯。

參數

Langx支持的參數
參數	定義	受影響於	別名
`\|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=`	(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=`參數作用
`\|italic=`值	描述	範例代碼	結果	HTML標記
未設定或者無效的參數	樣式來源：模板設定，或者 `-latn`子標籤否則從外部標記繼承無效值視作default	`{{Langx\|ru\|тундра}}`	俄語：тундра	`俄語：<span lang="ru">тундра</span>`
		`{{Langx\|ru\|tûndra}}`	俄語：tûndra	`俄語：<span lang="ru">tûndra</span>` 標記有誤；需要script子標籤`-latn`。
		`{{Langx\|fr\|toundra}}`	法語：toundra	`法語：<span lang="fr">toundra</span>`
		`{{Langx\|ru-latn\|tûndra}}`	俄語：tûndra	`[[俄語]]：<span lang="ru-Latn">tûndra</span>`
`default`		`{{Langx\|ru\|тундра\|italic=default}}`	俄語：тундра	`俄語：<span lang="ru">тундра</span>`
		`{{Langx\|fr\|toundra\|italic=default}}`	法語：toundra	`法語：<span lang="fr">toundra</span>`
		`{{Langx\|ru-latn\|tûndra\|italic=default}}`	俄語：tûndra	`[[俄語]]：<span lang="ru-Latn">tûndra</span>`
`no`	upright樣式應用於：覆蓋`-latn`子標籤覆蓋外部標記	`{{Langx\|ru\|тундра\|italic=no}}`	俄語：тундра	`俄語：<span lang="ru" style="font-style: normal;">тундра</span>`
		`{{Langx\|fr\|toundra\|italic=no}}`	法語：toundra	`法語：<span lang="fr" style="font-style: normal;">toundra</span>`
		`{{Langx\|ru-latn\|tûndra\|italic=no}}`	俄語：tûndra	`[[俄語]]：<span lang="ru-Latn" style="font-style: normal;">tûndra</span>`
		`''{{Langx/sandbox\|ru-latn\|tûndra\|italic=no}}''`	俄語：tûndra	`''[[俄語]]：<span lang="ru-Latn" style="font-style: normal;">tûndra</span>''`
`yes`	italic樣式應用於：忽略`-latn`子標籤	`{{Langx\|ru\|тундра\|italic=yes}}`	俄語：тундра	`俄語：<i lang="ru">тундра</i>`
`yes`	italic樣式應用於：忽略`-latn`子標籤	`{{Langx\|ru-latn\|tûndra\|italic=yes}}`	俄語：tûndra	`[[俄語]]：<i lang="ru-Latn">tûndra</i>`
`unset`	no樣式應用於：從外部標籤繼承樣式；覆蓋`-latn`子標籤	`{{Langx\|ru\|тундра\|italic=unset}}`	俄語：тундра	`俄語：<span lang="ru">тундра</span>`
		`''{{Langx/sandbox\|ru\|тундра\|italic=unset}}''`	俄語：тундра	`''俄語：<span lang="ru">тундра</span>''`
		`{{Langx\|ru-latn\|tûndra\|italic=unset}}`	俄語：tûndra	`[[俄語]]：<span lang="ru-Latn">tûndra</span>`
		`''{{Langx/sandbox\|ru-latn\|tûndra\|italic=unset}}''`	俄語：tûndra	`''[[俄語]]：<span lang="ru-Latn">tûndra</span>''`
`invert`	no樣式應用於：翻轉內部標記中的樣式；^[a] 禁用自動斜體覆蓋`-latn`子標籤	`{{Langx\|ru\|тундра\|italic=invert}}`	俄語：тундра	`俄語：<span lang="ru">''тундра''</span>`
		`{{Langx\|ru\|''тундра''\|italic=invert}}`	俄語：тундра	`俄語：<span lang="ru">тундра</span>`
		`{{Langx\|ru-latn\|tûndra\|italic=invert}}`	俄語：tûndra	`[[俄語]]：<span lang="ru-Latn">''tûndra''</span>`
		`{{Langx\|ru-latn\|''tûndra''\|italic=invert}}`	俄語：tûndra	`[[俄語]]：<span lang="ru-Latn">tûndra</span>`

備註

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

模板資料

以下是該模板的模板資料，適用於視覺化編輯器等工具。

Langx模板資料

為讀者標註術語或短語的外語原文。

模板參數
參數		描述	類型	狀態
語言標籤	`1`	一個有效的IETF語言標籤，用於標識非現代標準漢語的文字語言。	字串	必填
文本	`2`	顯示的文本。	字串	必填
音譯	`3` `translit`	外語文本的音譯，適用於不使用拉丁字母的語言。對於使用拉丁字母的語言，此字段被忽略。	字串	非必填
直譯	`4` `lit` `translation`	外語文本的直譯。	字串	非必填
顯示連結	`links` `link`	設為'no'則禁用指向語言條目的連結。	布林值	非必填
語言標籤	`label`	設為'none'則隱藏語言連結和標籤。某些語言可能有其他選項值可用。範例 none	行	非必填
從右到左	`rtl`	切換外語文字是否從右到左顯示。預設 no 範例 yes	布林值	非必填
斜體	`italic` `italics` `i`	切換外語文字是否斜體顯示。預設 yes 範例 no	布林值	非必填
字體大小	`size`	設置外語文字的字體大小。範例 120%, 1.2em	不明	非必填

範例

The following examples show translations from German.

寫法

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.

呈現

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] 錯誤：{{Langx}}：參數 |links= 和 |link= 衝突（幫助）)
All Quiet on the Western Front (德語：Im Westen nichts Neues，直譯：「In the West Nothing New」) is a novel by Erich Maria Remarque.

追蹤分類

參見

[invertunset-1] re |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.

[a]

參數	定義	受影響於	別名
`\|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=`	(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`	—

語言模板
語言名稱（ISO 639）
{{ISO 639 name}}
維基詞典連結
{{Wikt-lang}} Module:Wikt-lang Module:Wikt-lang/data {{Interlanguage link}}
外語文本
{{Lang}} {{Langx}} Module:Lang {{Transliteration}} {{Title language}}
其他
{{IPA}}
閱論編