This template is used on approximately 158,000 pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. Preview message: Transclusion count updated automatically (see documentation). |
This template uses Lua: |
Language templates |
---|
Language names (ISO 639) |
|
Interwiki links |
Foreign-language text |
|
Other |
|
This template ensures proper display of a transcription in the International Phonetic Alphabet (IPA). It can also automatically provide a label indicating the language being transcribed and link to an explanatory guide. Its behavior changes drastically depending on whether more than one unnamed parameter is given. For broad transcriptions of English, use {{IPAc-en}} instead.
The behavior of this template changes significantly depending on whether more than one unnamed parameter is given.
Markup | Renders as |
---|---|
{{IPA|/ˌlɔːrəm ˈɪpsəm/}} |
/ˌlɔːrəm ˈɪpsəm/ |
{{IPA|la|ˌloːrɛm ˈɪpsʊm}} |
Latin pronunciation: [ˌloːrɛm ˈɪpsʊm] |
The basic usage of this template is just to pass an IPA transcription as the first argument, as in:
Markup | Renders as |
---|---|
{{IPA|/ˌlɔːrəm ˈɪpsəm/}} |
/ˌlɔːrəm ˈɪpsəm/ |
Which might not look different from just the transcription without the template (/ˌlɔːrəm ˈɪpsəm/), but it actually outputs:
<span class="IPA nowrap" lang="und-Latn-fonipa" title="Representation in the International Phonetic Alphabet (IPA)">/ˌlɔːrəm<span class="wrap"> </span>ˈɪpsəm/</span>
That is, it adds
IPA
class, allowing registered users to assign a typeface of their choice (see Help:IPA § Rendering issues for how);nowrap
class, preventing line wrapping at inappropriate places like after /
or ˌ
;wrap
class to whitespace characters, allowing wrapping to occur at appropriate places.All IPA text should be placed in the template, even if it consists entirely of ASCII characters, as in {{IPA|/mi/}}
. This allows users to format all examples of IPA text consistently, and software like screen readers to interpret them accurately. If a substantial portion of a page uses IPA, post notice of that fact with {{IPA notice}}.
If the template is inside a wikilink, the link may not display correctly in certain namespaces (including the mainspace):
Markup | Renders as |
---|---|
[[Lorem ipsum|{{IPA|/ˌlɔːrəm ˈɪpsəm/}}]] |
[[Lorem ipsum|/ˌlɔːrəm ˈɪpsəm/]] |
This is because the template by default inserts a category. To prevent it, add |cat=no
, as in:
Markup | Renders as |
---|---|
[[Lorem ipsum|{{IPA|/ˌlɔːrəm ˈɪpsəm/|cat=no}}]] |
|
lang
ar
, pt-BR
) to be followed by -Latn-fonipa
, replacing und
(undetermined).tooltip
If more than one unnamed parameter is given, the first one is recognized as a language code and the second as the transcription. The transcription is automatically linked to one of the language-specific keys if a corresponding one exists, or to Help:IPA if not, and preceded by a label with the name of the language, as in {{langx}}. Unlike in the basic mode, brackets are automatically added so need not be included in the input.
Markup | Renders as |
---|---|
{{IPA|la|ˌloːrɛm ˈɪpsʊm}} |
Latin pronunciation: [ˌloːrɛm ˈɪpsʊm] |
{{IPA|pt-BR|sɐ̃w̃ ˈpawlu|lang|Br-SaoPaulo.ogg}} |
Brazilian Portuguese: [sɐ̃w̃ ˈpawlu] |
{{IPA|ki|ɣēkōjó|link=yes}} |
|
{{IPA|und|ʔ|}} |
|
Notice the transcriptions are linked to language-specific keys in the first two examples, and to the generic guide in the rest. The language name and article link are automatically taken from Module:Lang by passing the language tag, unless overridden in Module:IPA/data.
The behavior in this mode mimics {{IPA-xx}}
templates that were created for a number of languages. {{IPA}} consolidates those templates for better maintenance and consistency, and is now the recommended template.
ar
, pt-BR
). See Template:Lang for more.lang
: "[language name]:"ipa
: "IPA:"pron
: "pronounced"also
: "also"alsolang
: "also [language name]:"langalso
: "[language name] also"local
: "locally"localpron
: "local pronunciation:"label
link
yes
, the language name in the label will be linked to the article about the language.small
no
, the label appears in the same size as the surrounding text. Be sure to use this where the text is already smaller, per MOS:SMALLTEXT (references, infoboxes, and navboxes are excluded by default).generic
yes
, the transcription is linked not to the language-specific key but to the generic Help:IPA. This is required if the transcription does not adhere to the conventions laid out in the language-specific key.These are defined in Module:IPA/data.
These parameters can be used in either mode.
audio
wrap
none
, wrapping is prevented for the entire transcription (i.e. the wrap
class is not added to spaces). If set to all
, no wrapping prevention takes place (i.e. the nowrap
class is not added to the transcription).class
cat
no
, the page will not be categorized under Category:Pages with plain IPA (basic mode) or a language-specific subcategory of Category:Pages with IPA (guide-linking mode).{{IPA language category}}
)These are added only in Module:Category handler's default namespaces. If |debug=yes
is given, the categories that would be added are shown as links, no matter the namespace. This is for testcases only.
TemplateData
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
This template ensures proper display of transcriptions using the International Phonetic Alphabet (IPA). Its behavior changes drastically depending on whether more than one unnamed parameter is given. For dialect-neutral transcriptions of English, use IPAc-en instead.
|
Some language-specific templates allow you to enter ordinary letters (or conventional ASCII equivalents) in place of IPA characters, and convert them to the phonetic symbols used to transcribe the language.
Language | Template | Code example | Result |
---|---|---|---|
Cantonese | {{IPAc-yue}} (uses) | {{IPAc-yue|h|ung|2|.|z|i|2}}
|
[hʊŋ˧˥.tsi˧˥] |
Hungarian | {{IPAc-hu}} (uses) | {{IPAc-hu|'|m|a|gy|a|r}}
|
[ˈmɒɟɒr] |
Mandarin | {{IPAc-cmn}} (uses) | {{IPAc-cmn|zh|ong|1|h|ua|2}}
|
[ʈʂʊ́ŋxwǎ] |
Polish | {{IPAc-pl}} (uses) | {{IPAc-pl|'|sz|cz|e|ć|i|n}}
|
[ˈʂt͡ʂɛt͡ɕin] |
Some other conversion templates have also been created, but they haven't been vetted by the community and may not produce output complying with the respective keys.