imported>内存溢出的猫：翻译

2026-02-09T20:12:56Z

翻译

新页面

{{documentation subpage}}

{{#ifeq:{{SUBPAGENAME}}|sandbox||{{High-use}}}}
{{Lua|Module:IPA}}
{{Language templates}}
这个模板用于确保[[国际音标]]（IPA）转写的正确显示。它还可以自动提供语言标签，并链接到解释指南。根据是否提供多个未命名参数，其行为会发生显著变化。对于英语的宽式转写，请改用 {{tl|IPAc-en}}。

==用法==
该模板的行为会根据是否提供多个未命名参数而发生显著变化。


{{automarkup
|{{IPA{{!}}/ˌlɔːrəm ˈɪpsəm/}}
|{{IPA{{!}}la{{!}}ˌloːrɛm ˈɪpsʊm}}
}}

===基本模式===
该模板的基本用法是将国际音标（IPA）转写作为第一个参数，例如：

{{automarkup|{{IPA{{!}}/ˌlɔːrəm ˈɪpsəm/}}}}

这看起来可能和没有模板的转写（/ˌlɔːrəm ˈɪpsəm/）没什么区别，但实际上会输出：

{{#tag:syntaxhighlight|{{IPA|/ˌlɔːrəm ˈɪpsəm/}}|lang=mediawiki}}

即，会添加
* the <code>IPA</code> class, allowing registered users to assign a typeface of their choice (see {{section link|Help:IPA|Rendering issues}} for how);
* an [[IETF language tag]] indicating IPA as the writing system (see {{section link|Template:Lang|Rationale}} for more);
* a title attribute, which appears as a tooltip when the mouse hovers over the transcription;
* the <code>nowrap</code> class, preventing [[自动换行|line wrapping]] at inappropriate places like after <code>/</code> or <code>ˌ</code>;
* the <code>wrap</code> 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 {{tlc|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 {{tl|IPA notice}}.

====可选参数====
{{see also|#Common parameters}}

; <code>lang</code>
: [[IETF語言標籤]] (e.g. <code>ar</code>, <code>pt-BR</code>) to be followed by <code>-Latn-fonipa</code>, replacing <code>und</code> (undetermined).
; <code>tooltip</code>
: Replaces the default tooltip "Representation in the International Phonetic Alphabet (IPA)". Leaving it blank means no tooltip.

===Guide-linking mode===
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 [[#List of keys|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 {{tl|langx}}. Unlike in the basic mode, brackets are automatically added so need not be included in the input.

{{automarkup
|{{IPA{{!}}la{{!}}ˌloːrɛm ˈɪpsʊm}}
|{{IPA{{!}}pt-BR{{!}}sɐ̃w̃ ˈpawlu{{!}}lang{{!}}Br-SaoPaulo.ogg}}
|{{IPA{{!}}ki{{!}}ɣēkōjó{{!}}link{{=}}yes}}
}}

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 {{tlc|IPA-xx}} templates that were created for a number of languages. {{tlf|IPA}} consolidates and replaces those templates for better maintenance and consistency.

====参数====
{{see also|#Common parameters}}

; First unnamed parameter
: [[IETF語言標籤]] (e.g. <code>ar</code>, <code>pt-BR</code>). 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.
:* <code>lang</code>: "[language name]："
:* <code>ipa</code>: "IPA："
:* <code>pron</code>: "發音："
:* <code>also</code>: "又作："
:* <code>alsolang</code>: "[language name]又作："
:* <code>langalso</code>: "[language name]又作："
:* <code>local</code>: "本地發音："
:* <code>localpron</code>: "本地發音："
; Fourth unnamed parameter
: Name of an audio file to accompany the transcription. Ignored if {{para|audio}} is given.
; <code>label</code>
: Text that precedes the transcription. Takes precedence over the third unnamed parameter.
; <code>link</code>
: If set to <code>yes</code>, the language name in the label will be linked to the article about the language.
; <code>small</code>
: If set to <code>no</code>, the label appears in the same size as the surrounding text. Be sure to use this where the text is already smaller, per [[MOS:SMALL]] (references, infoboxes, and navboxes are excluded by default).
; <code>generic</code>
: If set to <code>yes</code>, the transcription is linked not to the language-specific key but to the generic [[Help:IPA]]. This is [[MOS:PRON|required]] if the transcription does not adhere to the conventions laid out in the language-specific key, such as with non-standard dialects.

====List of keys====
These are defined in [[Module:IPA/data{{#ifeq:{{SUBPAGENAME}}|sandbox|/sandbox}}]].

{{#invoke:IPA/overview|keys}}

===Common parameters===
These parameters can be used in either mode.

; <code>audio</code>
: Name of an audio file to accompany the transcription. Takes precedence over the fourth unnamed parameter.
; <code>wrap</code>
: If set to <code>none</code>, wrapping is prevented for the entire transcription (i.e. the <code>wrap</code> class is not added to spaces). If set to <code>all</code>, no wrapping prevention takes place (i.e. the <code>nowrap</code> class is not added to the transcription).
; <code>class</code>
: HTML class(es) added to the span element containing the transcription.
; <code>cat</code>
: If set to <code>no</code>, the page will not be categorized under [[:Category:含有純國際音標的頁面]] (basic mode) or a language-specific subcategory of [[:Category:含有国际音标的页面]] (guide-linking mode).

==追踪分类==
* A subcategory of [[:Category:含有国际音标的页面]] (if this is a red link, create it with the content {{tlx|IPA language category}})
* [[:Category:IPA template errors]] – added if more than one parameter is given and the first is an invalid language tag
* [[:Category:含有錄音發音的頁面]] – added if the transcription has audio

These are added only in [[Module:Category handler]]'s default namespaces. If {{para|debug|yes}} is given, the categories that would be added are shown as links, no matter the namespace. This is for testcases only.

== 模板数据 ==
{{collapse top|TemplateData}}
<templatedata>{
"description": "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.",
"params": {
"1": {
"label": "Transcription or language code",
"description": "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.",
"type": "string",
"required": true,
"example": "[ɛɡzɑ̃pl], en"
},
"2": {
"label": "Transcription",
"description": "Without brackets.",
"example": "ɛɡzɑ̃pl",
"type": "string"
},
"3": {
"label": "Label code",
"description": "Replaces the default label \"[language name] pronunciation:\" with another canned one. Leave it blank to have no label.",
"type": "string",
"suggestedvalues": [
"lang",
"ipa",
"pron",
"also",
"alsolang",
"langalso",
"local",
"localpron"
]
},
"audio": {
"aliases": [
"4"
],
"label": "Audio file",
"description": "Name of an audio file to accompany the transcription.",
"type": "wiki-file-name"
},
"label": {
"label": "Label",
"description": "Text that precedes the transcription. Unlike \"Label code\", this displays any wikitext as entered.",
"type": "line"
},
"link": {
"description": "\"yes\" links the language name in the label to the article about the language.",
"type": "string",
"suggestedvalues": [
"yes"
]
},
"small": {
"description": "\"no\" cancels the reduction of the label size.",
"type": "string",
"suggestedvalues": [
"no"
]
},
"generic": {
"description": "\"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.",
"type": "string",
"suggestedvalues": [
"yes"
]
},
"wrap": {
"description": "\"none\" prevents wrapping anywhere in the transcription. \"all\" cancels the prevention of wrapping after non-space characters in the transcription.",
"type": "string",
"suggestedvalues": [
"none",
"all"
]
},
"class": {
"description": "Additional HTML class(es) for the transcription.",
"type": "string"
},
"lang": {
"label": "Language code",
"description": "IETF language tag when the first parameter is a transcription.",
"example": "en",
"type": "string"
},
"tooltip": {
"label": "Tooltip",
"description": "Tooltip to replace the default one with. Leave it blank to have no tooltip.",
"type": "string"
},
"cat": {
"description": "\"no\" cancels the categorization of the page into \"Pages with [language name] IPA\".",
"type": "string",
"suggestedvalues": [
"no"
]
}
},
"paramOrder": [
"1",
"2",
"3",
"audio",
"label",
"link",
"small",
"generic",
"wrap",
"class",
"lang",
"tooltip",
"cat"
],
"format": "inline"
}</templatedata>
{{collapse bottom}}

== Conversion templates ==
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.

{| class="wikitable sortable"
! Language
! Template
! class="unsortable" | Code example
! class="unsortable" | Result
|-
| Cantonese
| class="nowrap" | {{tlx|IPAc-yue}}
| <code><nowiki>{{IPAc-yue|h|ung|2|.|z|i|2}}</nowiki></code>
| {{IPAc-yue|h|ung|2|.|z|i|2}}
|-
| Hungarian
| class="nowrap" | {{tlx|IPAc-hu}}
| <code><nowiki>{{IPAc-hu|'|m|a|gy|a|r}}</nowiki></code>
| {{IPAc-hu|'|m|a|gy|a|r}}
|-
| Mandarin
| class="nowrap" | {{tlx|IPAc-cmn}}
| <code><nowiki>{{IPAc-cmn|zh|ong|1|h|ua|2}}</nowiki></code>
| {{IPAc-cmn|zh|ong|1|h|ua|2}}
|-
| Polish
| class="nowrap" | {{tlx|IPAc-pl}}
| <code><nowiki>{{IPAc-pl|'|sz|cz|e|ć|i|n}}</nowiki></code>
| {{IPAc-pl|'|sz|cz|e|ć|i|n}}
|}

Some other conversion templates have also been created (see list at [[Special:PrefixIndex/Template:IPAc-]]), but they haven't been vetted by the community and may not produce output complying with the respective keys.

== 参见 ==
* [[國際音標]]
* [[Help:國際音標]]
{{IPA templates}}

<includeonly>

[[Category:语言模板|I]]
[[Category:IPA模板]]
</includeonly>

Template:IPA/doc - 版本历史

imported>内存溢出的猫：​翻译

imported>内存溢出的猫：翻译