Template:IPA link

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

This template uses Lua:

Module:IPA symbol

The template {{IPA link}} takes an IPA symbol and turns it into a link to the respective article which discusses the sound the symbol represents.

Versions with defined brackets are also available:

For phonetic representations, {{IPAblink}} encloses the link in square brackets: [a]
For phonemic representations, {{IPAslink}} encloses the link in slashes: /a/
For orthographic representations, {{IPAalink}} encloses the link in angle brackets: ⟨a⟩

Another version is {{IPAplink}}, which encloses the link in neither brackets nor ‎...‎, which is useful if the link is already inside {{IPA}}, avoiding superfluous nesting of the same class.

Usage

First parameter (required): any IPA symbol.

{{IPA link|m}} → m
{{IPA link|ɡb}} → ɡb

Second parameter: changes the label of the wikilink.

{{IPA link|m|Any text}} → Any text

Audio link

|audio=yes adds a link to the corresponding audio file:

{{IPA link|ɽ|audio=yes}} → ɽ Audio file "Retroflex flap.ogg" not found

If the value in |audio= is not "yes", "y", "true", etc., it is treated as the name of an audio file:

{{IPA link|ɽ|audio=Retroflex flaps.ogg}} → ɽ Audio file "Retroflex flaps.ogg" not found

If the audio file is not specified at Module:IPA symbol/data, the link will not appear:

{{IPA link|s̬|audio=yes}} → s̬

Errors

If the IPA symbol is not defined at Module:IPA symbol/data, then an error message is returned and the page will be categorized into Category:International Phonetic Alphabet pages needing attention.

{{IPA link|xyz}} → Error using {{IPA symbol}}: "xyz" not found in list

The error message can be customized in |errortext=. This cancels the addition of the error category. If set to blank, the message will not appear at all.

{{IPA link|xyz|errortext=Custom error message}} → Custom error message
{{IPA link|xyz|errortext=blank}} →

IPA templates

Inline

Formatting

{{IPA}}
{{IPA link}}
{{IPAblink}} [a]
{{IPAslink}} /a/
{{IPAalink}} ⟨a⟩
{{IPAplink}}
{{angbr IPA}}
{{Chinese tone letter}}
{{Audio-IPA}}

Conversion

{{IPAc-en}}
{{IPAc-cmn}}
{{IPAc-hu}}
{{IPAc-pl}}
{{IPAc-yue}}

This template is used on approximately 3,500 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Shortcut

{{x2i}}

This template uses Lua:

Module:Template link general

This template, often abbreviated as {{}}, is used to provide stylized formatting to template displays without actually using the template itself. The code generated will be displayed inline. For a multi-line output, see {{tj}}.

Parameters

With the exception of alttext, the named parameters are toggles that are either omitted (default in most cases) or activated (by being assigned a value such as "on", "yes", "true", "include", etc.). They may be included in any order (see Examples below). Certain templates have the parameter "on" by default; see the main table for all alternate options.

Parameter	Action	Use with {{example}}	Default active
	Default (without accessory parameters)	{{example}}
brace	Include braces as part of the template link	{{example}}	{{tlw}}/{{tn}}
braceinside	Include innermost braces as part of the template link	{{example}}
bold	Renders the template link/name in bold	{{example}}	{{tlb}}, {{tlxb}}
code	Display output using HTML `‎<code>...‎</code>` tags (monospaced font)	`{{example}}`	{{tlc}}, {{Template link expanded}}, etc.
italic	Display any parameters accompanying the template link/name in italics	{{example\|param}}	{{tlxi}}
kbd	Display output using HTML `‎<kbd>...‎</kbd>` tags (monospaced font)	`{{example}}`
nolink	Don't render the template name as a link	{{example}}	{{tlf}}, {{tnull}}
nowrap	Prevent the insertion of line breaks (word wrap) in the output	{{example}}
nowrapname	Prevent word wrapping in the output of template name/link (parameters will wrap if needed)	{{example}}
plaincode	Uses `‎<code style="border:none; background:transparent;">...‎</code>`	`{{example}}`	{{tltss}}
subst	Include a subst: prefix before the template link/name	{{subst:example}}	{{tls}}, {{tlxs}}, etc
alttext=`[text]`	Replace `[text]` with the actual label to be displayed for the template link	{{Other}}	{{tla}}
_show_result	Will also display the result of the template	`{{Min\|7\|-5}}` → -5
_expand	Will add a link to the expanded template page	`{{Min\|7\|-5}}` [1]

Unnamed (Positional)

This template can take any number of unnamed parameters as parameters accompanying the template link (or name); see Examples below.

Examples

Code	Output	Remarks
{{x2i\|Banner}}	βanner	Template:Banner does not exist. (Non-existent template is redlinked.)
{{x2i\|Abc}}	ɑbc	Template:Abc exists.
{{x2i\|abC}}	abç	Template names are case-sensitive
{{x2i\|abc}}	abc	(but the first letter is case-insensitive).
{{x2i\|x0}}	x◌	no parameters
{{x2i\|x1\|one}}	xɨ	one parameter
{{x2i\|x2\|one\|two}}	xø	two parameters
{{x2i\|x3\|1\|2\|3\|4\|5\|6\|7\|8\|9\|10}}	xɜ	ten parameters
`{{tlg\|convert\|<nowiki>14\|m\|ftin\|abbr=out\|sp=us</nowiki>}}`	convert	Unlimited parameters, as one `‎<nowiki>...‎</nowiki>` string.
{{x2i\|x2\|\|two\|\|}}	xø	Empty parameters are discarded.
{{x2i\|x0\|code=on}}	x◌	<code> style
{{x2i\|x0\|plaincode=on}}	x◌	plaincode style
{{x2i\|x0\|kbd=on}}	x◌	<kbd> style
{{x2i\|x0\|bold=on}}	x◌	bold link/name
{{x2i\|x1\|one\|italic=on}}	xɨ	parameter(s) in italics
{{x2i\|x0\|nolink=on}}	x◌
{{x2i\|x0\|subst=on}}	x◌
{{x2i\|x0\|brace=on}}	x◌	all braces in link
{{x2i\|x0\|braceinside=on}}	x◌	inside braces in link
{{x2i\|x0\|alttext=x0 link}}	x◌
{{x2i\|x0\|bold=on\|code=on\|brace=on}}	x◌	Combine multiple parameter settings.
`{{tlg\|x1\|{{spaces}}one{{spaces}}}}`	abc	Using {{spaces}} before and after a parameter.
{{x2i\|x2\|bold=on\|code=on\|one\|two}}	xø	Can combine named and anonymous parameters ...
{{x2i\|x2\|one\|two\|bold=on\|code=on}}	xø	... in any order ...
{{x2i\|x2\|one\|code=on\|two\|bold=on\|three}}	xø	... even intermixed ...
{{x2i\|x2\|one\|code=on\|two\|bold=on\|three\|italic=on}}	xø	... with many configurations.
`{{tlg\|x1\|x=u}}`	xɨ	= won't work
`{{tlg\|x1\|x=u}}`	xɨ	`=` is okay
`{{tlg\|x1\|x{{=}}u}}`	xɨ	`{{=}}` is okay (see Template:=)
`{{tlg\|x1\|x<nowiki>=</nowiki>u}}`	xɨ	Sticky nowiki is okay.
{{x2i\|x2\|3=two\|2=one}}	xø	Right-to-left is okay
{{x2i}}	x2i	With no arguments, it emits the current page name without braces.
{{x2i\|x2\|3=one\|4=two}}	xø	Null parameter stops parsing.

Wrapping of long names (default)
Code	Output
{{x2i\|long template name that would wrap to new line\|this is a long value for the 1st parameter that would wrap}}	lonɡ template name that would wrap to new line

Wrapping of long names (`nowrap=on`)
Code	Output
{{x2i\|nowrap=on\|long template name that would wrap to new line\|long value for the 1st parameter that would wrap}}	lonɡ template name that would wrap to new line

Wrapping of long names (`nowrapname=on`)
Code	Output
{{x2i\|nowrapname=on\|long template name that would wrap to new line\|long value for the 1st parameter that would wrap}}	lonɡ template name that would wrap to new line

Comparison of template-linking templates according to the styles of generated text and link produced
Text style ↓	`{{tlg}}` options^{[note 1]} to achieve text style	Link style
Text style ↓	`{{tlg}}` options^{[note 1]} to achieve text style	Linked	Unlinked	Linked with subst	Unlinked with subst	Linked including braces	Linked with alternative text
`{{tlg}}` options^{[note 1]} to achieve link style	—	DEFAULT	`nolink=yes`	`subst=yes`	`nolink=yes\|subst=yes`	`braceinside=yes`	`alttext=Foo` `2=Foo`
normal	DEFAULT	{{tlg}}^{[note 1]} {{tl}} {{tlp\|1\|2\|...}}^{[note 2]} {{Template:tlu}}^{[note 3]}	{{tlf}}^{[note 2]} ^{<template link>}	Template loop detected: Template:Tls {{subst:Template:tlsu}}^{[note 3]}	{{subst:tlsf}}^{[note 2]} ^{<template link>}	{{tn}}	{{tla}}
`code`	`code=yes`	`{{tl2}}` `{{tlx}}` `{{Template:tlxu}}`^{[note 3]}	`{{tlc}}`^{[note 2]} ^{<template link>} `{{tnull}}`^{<template link>}	`{{subst:tlxs}}`	`{{subst:tlsc}}`^{[note 2]} ^{<template link>}	—
monospace	`plaincode=yes`^{[note 4]}	—		{{subst:tltss}}^{[note 5]}	—
`kbd`	`kbd=yes`^{[note 5]}	—		{{subst:tltss}}^{[note 5]}	—
bold	`bold=yes`	{{tlb}}	—
`bold+code`	`bold=yes\|code=yes`	`{{tlxb}}`
`italic+code`	`italic=yes\|code=yes`	`{{tlxi}}`

↑ ^1.0 ^1.1 ^1.2 {{tlg}} is the most general template, allowing any combination of text style and/or link style options.
↑ ^2.0 ^2.1 ^2.2 ^2.3 ^2.4 Prevents wrapping of text by placing it inside ‎...‎ tags.
↑ ^3.0 ^3.1 ^3.2 Allows links to templates in any namespace.
↑ {{tlg|plaincode=yes}} uses ‎<code style="border:none; background-color:transparent;">...‎</code>.
↑ ^5.0 ^5.1 Displays monospaced font using ‎...‎.

Other formatting templates

Templates producing specialised formatting effects for given templates, modules or parameters
Code example	Effect	Notes
`{{Tj\|Hatnote\|Some text\|selfref: yes\|category: no\|lang: fr}}`	{{Hatnote \| Some text \| selfref = yes \| category = no \| lang = fr }}	Supports colors, placeholder texts, named and unnamed parameters
<syntaxhighlight lang="wikitext"> {{Hatnote \| Some text \| selfref = yes \| category = no \| lang = fr }} </syntaxhighlight>	{{Hatnote \| Some text \| selfref = yes \| category = no \| lang = fr }}	Same as above
`{{Tji\|Hatnote\|Some text\|selfref: yes\|category: no\|lang: fr}}`	{{Hatnote\|Some text\|selfref=yes\|category=no\|lang=fr}}	Supports colors, placeholder texts, named and unnamed parameters
`<syntaxhighlight lang="wikitext" inline>{{Hatnote\|Some text\|selfref=yes\|category=no\|lang=fr}}</syntaxhighlight>`	`{{Hatnote\|Some text\|selfref=yes\|category=no\|lang=fr}}`	Same as above
`{{tl2\|Hatnote\|lang=fr}}`	`{{hatnote}}`	Supports linking to sister projects (e.g., fr:Hatnote)
`{{demo\|<nowiki>{{Hatnote\|lang=fr\|Some text}}</nowiki>}}`	{{hatnote\|lang=fr\|Some text}} Some text	Shows code and example
`{{tln\|Hatnote}}`	Template:Hatnote	Produces a normal link to the template
`{{elc\|Template:Hatnote}}` `{{elc\|Template:Hatnote\|Hatnote}}`	`[[Template:Hatnote]]` `[[Template:Hatnote\|Hatnote]]`	Formats wikilink, with optional piped link text and blended suffix
`{{ml\|Example\|hello}}`	{{#invoke:Example\|hello}}	Counterpart to {{tl}} for linking to Lua modules
`{{mfl\|Example\|hello}}`	{{#invoke:Example\|hello}}	Similar to {{ml}}, but expects the function to be documented and creates a link to the corresponding section
`{{mlx\|Example\|hello}}`	`{{#invoke:Example\|hello}}`	Counterpart to {{tlx}} for linking to Lua modules
`{{ml-lua\|Module:Example\|hello}}`	`require('Module:Example')`	Link to Lua modules and built-in libraries, showing Lua code.
`{{para\|title\|<var>book title</var>}}`	`\|title=book title`	Formats template parameters for display, with or without values
`{{sclx\|LASTING}}`	`[[WP:LASTING]]`	Takes a shortcut suffix in project namespace and displays it with brackets and the WP: alias in a `‎<code>...‎</code>` tag.
`{{tag\|ref}}` `{{xtag\|templatedata}}`	`‎<ref>...‎</ref>` `<templatedata>`	Formats [X]HTML tags; can add content, choose opening, closing, or self-closing
`{{dtl\|Ping project}}`	{{d:Ping project}}	Wikidata counterpart to {{tl}}
`{{pf\|if}}` `{{pf\|if\|{{{1}}}\|true\|false}}`	{{#if}} {{#if:{{{1}}}\|true\|false}}	Parser function equivalent to {{tl}}
`{{magic word\|uc:}}`	{{uc:}}	Magic word links

With utility links

Templates producing utility links for a given template (Hatnote used here as example)
Code example	Effect
`{{lt\|Hatnote}}`	[[Template:]]
`{{lts\|Hatnote}}`	Template:Hatnote(edit talk links history)
`{{t links\|Hatnote}}`	{{Hatnote}} (edit talk history links # /subpages /doc /doc edit /sbox /sbox diff /test)
`{{tfd links\|Hatnote}}`	Template:Hatnote (talk · history · transclusions · logs · subpages)
`{{tetl\|Hatnote}}`	{{Hatnote}} links talk edit
`{{tsetl\|Hatnote}}`	{{subst:Hatnote}} links talk edit
`{{ti\|Hatnote}}`	{{Hatnote}}
`{{tic\|Hatnote}}`	Template:Hatnote (talk links edit)
`{{tim\|Hatnote}}`	m:Template:Hatnote (backlinks edit)
`{{tiw\|Hatnote}}`	Template:Hatnote (backlinks edit)
`{{tlt\|Hatnote}}`	{{Hatnote}} (talk)
`{{ttl\|Hatnote}}`	{{Hatnote}} (t/l)
`{{twlh\|Hatnote}}`	Template:Hatnote (links, talk)

Semantic markup templates

Template	Example output	Use
{{strong}}	Important!	To indicate <strong> importance, seriousness, or urgency instead of just simple typographical boldfacing
{{strongbad}}	"Never use ..."	Same as {{strong}} but in red
{{stronggood}}	"Only use ..."	Same as {{strong}} but in green
{{em}}	"An emphatic phrase"	To indicate <em> stress emphasis (not just purely typographical italicization like for book titles or foreign terms)
{{var}}	`strPrefix`	To indicate text is a variable name. Use for any variable names except those including "I" (uppercase i) and/or "l" (lowercase L); for these, {{var serif}} should be used to ensure a noticeable distinction
{{var serif}}	`strIllustratePrefix`	(see {{var}} above)
{{tld}}	`{{DEFAULTSORT:Y, X}}`	To display wikicode variables and magic words as they would appear in code
{{para}}	`\|year=2008`	To display template parameters with or without values
{{param}}	`{{{title\|alt}}}`	To display parameters as used in code (i.e. with triple braces), especially to indicate relationships between them. May be combined with {{para}} above
{{tjp}}	\|selfref=yes	To display template parameters with colors (as they would appear in the {{tj}} and {{tji}} templates)
{{param value}}	`··2·blanks·fore·and·aft··`	To display parameter values lightly bordered; replaces <code>...</code>, especially when value contains embedded or leading/trailing blanks; visualized here with middot (·) but can use ␠, ▯, or any character.
{{tlx}} etc.	`{{Template\|1\|2\|...\|10}}`	To display a template call (with or without parameters and values) as code
{{tji}}	{{hatnote\|Hello\|selfref=yes\|category=no}}	To showcase with colors in horizontal format the syntax of any template, while providing an easy way to display placeholder texts using colons as separators
{{tag}}	"The `‎<img>...‎</img>` tags ..."	To render HTML elements ("tags") in prose
{{code}}/{{codett}}	"Ensure the `alt=` parameter ..."	To indicate text is source code. To nest other templates within {{code}}, use `‎<code>...‎</code>`. {{codett}} differs only in styling: `someMethod` becomes `someMethod`
Template loop detected: Template:Tls	`{{small\|small text}}`	To wrap example code in `<code><nowiki>...</nowiki></code>`
Template loop detected: Template:Tls	`{{large\|large text}}`	To wrap example code in `<kbd><nowiki>...</nowiki></kbd>`
{{syntaxhighlight}}	_{[this is a block template]}	( or `{{sxhl}}` ) Wrapper for `‎<syntaxhighlight>...‎</syntaxhighlight>`, but will wrap overflowing text
{{deprecated code}}	"Do not use `‎<blink>`."	( or `{{dc}}` ) To indicate deprecated source code in template documentation, articles on HTML specs, etc. The `{{dc2}}` variant uses strike-through (`‎<blink>`) while `{{dcr}}` uses red (`‎<blink>`).
{{pre}}	_{[this is a block template]}	For larger blocks of source code and other pre-formatted text
{{tj}}	_{[this is a block template]}	To showcase with colors and multiple lines (vertical format) the syntax of any template, while providing an easy way to display placeholder texts using colons as separators
{{quote}}	_{[this is a block template]}	For block quotations (only – never for non-quotations)
{{block indent}}	_{[this is a block template]}	For indented blocks of material; visually identical to `{{quote}}` but without quote markup
{{kbd}}	`user input`	To indicate user input
{{key press}}	`Ctrl`+`x`	To indicate specific-keystroke input, including combinations
{{key top}}	`Left shift`	Similar; includes more symbols, but does not directly support combinations
{{button}}	`Don't save`	To indicate a button in a user interface
{{samp}}	`example output`	To indicate sample or example output

Maintenance

{{Needs IPA}}
{{Pronunciation needed}}

Charts

Guidance

Meta templates

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for IPA link

TemplateData

No description.

Template parameters
Parameter		Description	Type	Status
IPA symbol	`1`	IPA symbol whose article to link to Example ʉː	String	required
Display text	`2`	Text to show instead of the IPA symbol	String	optional
Audio	`audio`	Adds a link to sound if available Example yes	String	optional
Error text	`errortext`	no description Example blank	String	optional

The above documentation is transcluded from Template:IPA link/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.