View source for Template:Wikt-lang/doc

{{Documentation subpage}}
{{High-use}}
{{tsh|wktl}}
{{Lua|Module:Wikt-lang}}
{{Language templates}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

{{tlb|Wikt-lang}} generates a link to the correct section of the corresponding [[Wiktionary]] entry by automatically determining the correct English Wiktionary entry by removing italics or bolding, and removing or replacing [[Diacritic|diacritical]] marks and letters that are not used in entry names on English Wiktionary.

It also adds italics for languages that use the Latin alphabet (see [[MOS:FOREIGNITALIC]]). Italics cannot be turned {{em|on}} for languages that use a non-Latin script, but they can be turned {{em|off}} by using the parameter {{para|i|-}}. This is useful in tables, where italics are often unnecessary.

The template will also link to the Wiktionary [[Wikt:Wiktionary:Reconstructed terms|''Reconstruction:'' namespace]], where entries on reconstructed languages are placed, or to the [[Wikt:Help:Appendices|''Appendix:'' namespace]], where some constructed languages have their entries (such as [[Lojban]]), if there is data for them in the module, [[Module:Wikt-lang]], at [[Module:Wikt-lang/data]].

== Usage ==
This template takes a language code and one or two words, and generates a link to the correct section of the corresponding Wiktionary entry. If two words are provided, it is like a [[Wikipedia:Piped link|piped link]]: the first word is the entry name, while the second serves as link text.

* {{Tlx|Wikt-lang|<lang code>|<Wiktionary entry>|<Text displayed>|i}}

The text will be italicized if the text consists of Latin letters or the language code includes the script code <code>Latn</code>, unless italics are turned off with {{para|italics|-}} or {{para|i|-}}.

== Parameters ==
{| class="wikitable"
|+ Template parameters
|-
! scope="col" | Parameter
! scope="col" | Description
|-
! scope="row" | 1
| A code identifying the language of the text, in one of the following forms:
* an [[ISO 639]] [[List of ISO 639-2 codes|language code]] (2 or 3 letters),
* an ISO 639 language code and 4-letter [[ISO 15924]] script code, separated by a hyphen,
* a [[wikt:Wiktionary:Languages#Language codes|Wiktionary exceptional code]], or
* a Wikipedia code, consisting of an ISO 639 language code, an <code>x</code> and one or more private-use subtags, separated by hyphens, representing a language that hasn't been assigned a standard language subtag, such as <code>cel-x-proto</code> ([[Proto-Celtic]]).
Region and variant subtags are not supported, as it is difficult to support both them and Wiktionary language tags that contain hyphens (such as <code>ine-pro</code>).
|-
! scope="row" | 2
| Entry to link to on Wiktionary.
|-
! scope="row" | 3
| Optional. Text displayed, if different from the term being linked to.
|-
! scope="row" | italic
| Optional. Use {{para|italic|no}} or {{para|italic|-}} to disable italicization of the text.
|}

===TemplateData===
{{Collapse top|title=[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Language code",
			"type": "line",
			"required": true,
			"description": "ISO 639 language code (2 or 3 letters) representing which language the text is in",
			"example": "'en', 'zh', 'fr', 'enm', 'la', 'sco', 'es'"
		},
		"2": {
			"label": "Wiktionary entry",
			"type": "string",
			"required": true,
			"description": "Entry to link to on Wiktionary",
			"example": "an apple a day keeps the doctor away"
		},
		"3": {
			"label": "Text displayed",
			"type": "string",
			"description": "Text displayed, if different from the term being linked to",
			"example": "an apple a day"
		},
		"italic": {
			"aliases": [
				"italics",
				"i"
			],
			"label": "Disable italics",
			"type": "string",
			"description": "Whether to not italicize the text",
			"example": "no"
		}
	},
	"format": "inline"
}
</templatedata>
{{Collapse bottom}}

== Examples ==
* {{Tlx|Wikt-lang|en|language|languages}} → {{Wikt-lang|en|language|languages}}
* {{Tlx|Wikt-lang|ru|язы́к}} → {{Wikt-lang|ru|язы́к}}
* {{Tlx|Wikt-lang|la|Latīnus|italic{{=}}no}} → {{Wikt-lang|la|Latīnus|italic=no}}
* {{Tlx|Wikt-lang|la|Latīnus|i{{=}}-}} → {{Wikt-lang|la|Latīnus|i=-}}

==Help==
If you try to use this template and get an error message, but can't figure out how to fix it, please go to [[Module talk:Wikt-lang]] and post a message about it.

==See also==
* {{tl|Lang}}
* {{tl|Linktext}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Wiktionary link templates]]
[[Category:Wikipedia multilingual support templates]]
}}</includeonly>