Bản mẫu:IPA
{{{1}}}
 | Bản mẫu này sử dụng Lua: |
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.
Usage
[sửa]The behavior of this template changes drastically depending on whether more than one unnamed parameter is given.
Basic mode
[sửa]The basic usage of this template is just to pass an IPA transcription as the first argument, as in:
Which might not look different from just the transcription without the template (/ˌlɔːrəm ˈɪpsəm/), but it actually outputs:
<span title="Kí hiệu đại diện trong IPA" class="IPA">/ˌlɔːrəm ˈɪpsəm/</span>
That is, it adds
- the
IPAclass, allowing registered users to assign a typeface of their choice (see Bản mẫu:Section link for how); - an IETF language tag indicating IPA as the writing system (see Bản mẫu:Section link for more);
- a title attribute, which appears as a tooltip when the mouse hovers over the transcription;
- the
nowrapclass, preventing line wrapping at inappropriate places like after/orˌ; - the
wrapclass 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 Bản mẫu:Tlc. 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}}.
Issue with linking
[sửa]If the template is inside a wikilink, the link may not display correctly in certain namespaces (including the mainspace):
| Markup [[:Bản mẫu: | Renders asLỗi Lua: expandTemplate: template "format item" does not exist. |
|---|---|
This is because the template by default inserts a category. To prevent it, add
|cat=no, as in:
Optional parameters
[sửa]lang- IETF language tag (e.g.
ar,pt-BR) to be followed by-Latn-fonipa, replacingund(undetermined). tooltip- Replaces the default tooltip "Representation in the International Phonetic Alphabet (IPA)". Leaving it blank means no tooltip.
Guide-linking mode
[sửa]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 corrseponding one exists, or to Help:IPA if not, and preceded by a label with the name of the language, as in {{lang-xx}}. Unlike in the basic mode, brackets are automatically added so need not be included in the input.
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:Language by passing the language tag, unless overridden in Module:IPA/data.
The behavior in this mode mimics Bản mẫu:Tlc templates that were created for a number of languages. {{IPA}} consolidates those templates for better maintenance and consistency, and is now the recommended template.
Parameters
[sửa]- First unnamed parameter
- IETF language tag (e.g.
ar,pt-BR). See Template:Lang for more. - Second unnamed parameter
- Transcription, without brackets.
- Third unnamed parameter
- Label code. Leave it blank to have no label at all. The label "[language name] pronunciation:" is used if the input is not empty but none of the below.
lang: "[language name]:"ipa: "IPA:"pron: "pronounced"also: "also"alsolang: "also [language name]:"langalso: "[language name] also"local: "locally"localpron: "local pronunciation:"
- Fourth unnamed parameter
- Name of an audio file to accompany the transcription.
label- Text that precedes the transcription. Takes precedence over the third unnamed parameter.
link- If set to
yes, the language name in the label will be linked to the article about the language. small- If set to
no, the label appears in the same size as the surrounding text. Be sure to use this where the text is already smaller, per (references, infoboxes, and navboxes are excluded by default). generic- If set to
yes, the transcription is linked not to the language-specific key but to the generic Help:IPA. This is if the transcription does not adhere to the conventions laid out in the language-specific key.
List of keys
[sửa]These are defined in Module:IPA/data.
Lỗi kịch bản: Không tìm thấy mô đun “IPA/overview”.
Common parameters
[sửa]These parameters can be used in either mode.
audio- Name of an audio file to accompany the transcription. Takes precedence over the fourth unnamed parameter.
wrap- If set to
none, wrapping is prevented for the entire transcription (i.e. thewrapclass is not added to spaces). If set toall, no wrapping prevention takes place (i.e. thenowrapclass is not added to the transcription). class- HTML class(es) added to the span element containing the transcription.
cat- If set to
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).
Tracking categories
[sửa]- A subcategory of Category:Pages with IPA (if this is a red link, create it with the content {{IPA language category}})
- Category:IPA template errors – added if more than one parameter is given and the first is an invalid language tag
- Category:Pages including recorded pronunciations – added if the transcription has audio
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
[sửa]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.
| Tham số | Miêu tả | Kiểu | Trạng thái | |
|---|---|---|---|---|
| Transcription or language code | 1 | Transcription including brackets ([...] for a phonetic transcription and /.../ for a phonemic one) if this template is being used just for formatting. IETF language tag if used for linking the transcription to a language-specific key or introductory guide.
| Chuỗi dài | bắt buộc |
| Transcription | 2 | Without brackets.
| Chuỗi dài | tùy chọn |
| Label code | 3 | Replaces the default label "[language name] pronunciation:" with another canned one. Leave it blank to have no label.
| Chuỗi dài | tùy chọn |
| Audio file | audio 4 | Name of an audio file to accompany the transcription. | Tập tin | tùy chọn |
| Label | label | Text that precedes the transcription. Unlike "Label code", this displays any wikitext as entered. | Chuỗi ngắn | tùy chọn |
| link | link | "yes" links the language name in the label to the article about the language.
| Chuỗi dài | tùy chọn |
| small | small | "no" cancels the reduction of the label size.
| Chuỗi dài | tùy chọn |
| generic | generic | "yes" links the transcription to [[Help:IPA]] instead of a language-specific key. Required if the transcription does not adhere to the conventions of the language-specific key.
| Chuỗi dài | tùy chọn |
| wrap | wrap | "none" prevents wrapping anywhere in the transcription. "all" cancels the prevention of wrapping after non-space characters in the transcription.
| Chuỗi dài | tùy chọn |
| class | class | Additional HTML class(es) for the transcription. | Chuỗi dài | tùy chọn |
| Language code | lang | IETF language tag when the first parameter is a transcription.
| Chuỗi dài | tùy chọn |
| Tooltip | tooltip | Tooltip to replace the default one with. Leave it blank to have no tooltip. | Chuỗi dài | tùy chọn |
| cat | cat | "no" cancels the categorization of the page into "Pages with [language name] IPA".
| Chuỗi dài | tùy chọn |
Conversion templates
[sửa]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 | Bản mẫu:Tldep | {{IPAc-yue|h|ung|2|.|z|i|2}}
|
Bản mẫu:IPAc-yue |
| Hungarian | Bản mẫu:Tldep | {{IPAc-hu|'|m|a|gy|a|r}}
|
Bản mẫu:IPAc-hu |
| Mandarin | Bản mẫu:Tldep | {{IPAc-cmn|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}
|
Bản mẫu:IPAc-cmn |
| Polish | Bản mẫu:Tldep | {{IPAc-pl|'|sz|cz|e|ć|i|n}}
|
Bản mẫu:IPAc-pl |
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.