Usage Bản_mẫu:IPA

The behavior of this template changes drastically depending on whether more than one unnamed parameter is given.

Cú phápKết quả 
{{IPA|/ˌlɔːrəm ˈɪpsəm/}}

/ˌlɔːrəm ˈɪpsəm/

{{IPA|la|ˌloːrɛm ˈɪpsʊm}}

la

Basic mode

The basic usage of this template is just to pass an IPA transcription as the first argument, as in:

Cú phápKết quả 
{{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 title="Kí hiệu đại diện trong IPA" class="IPA">/ˌlɔːrəm ˈɪpsəm/</span>

That is, it adds

  • the IPA class, allowing registered users to assign a typeface of their choice (see Help:IPA § Rendering issues for how);
  • an IETF language tag indicating IPA as the writing system (see Template:Lang § Rationale for more);
  • a title attribute, which appears as a tooltip when the mouse hovers over the transcription;
  • the nowrap class, preventing line wrapping at inappropriate places like after / or ˌ;
  • the 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}}.

Issue with linking

If the template is inside a wikilink, the link may not display correctly in certain namespaces (including the mainspace):

Cú phápKết quả 
[[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:

Cú phápKết quả 
[[Lorem ipsum|{{IPA|/ˌlɔːrəm ˈɪpsəm/|cat=no}}]]

Optional parameters

langIETF language tag (e.g. ar, pt-BR) to be followed by -Latn-fonipa, replacing und (undetermined).tooltipReplaces 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 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.

Cú phápKết quả 
{{IPA|la|ˌloːrɛm ˈɪpsʊm}}

la

{{IPA|pt-BR|sɐ̃w̃ ˈpawlu|lang|Br-SaoPaulo.ogg}}

pt-BR

{{IPA|ki|ɣēkōjó|link=yes}}

ki

{{IPA|und|ʔ|}}

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:Language 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.

Parameters

First unnamed parameterIETF language tag (e.g. ar, pt-BR). See Template:Lang for more.Second unnamed parameterTranscription, without brackets.Third unnamed parameterLabel 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 parameterName of an audio file to accompany the transcription.labelText that precedes the transcription. Takes precedence over the third unnamed parameter.linkIf set to yes, the language name in the label will be linked to the article about the language.smallIf 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 MOS:SMALLTEXT (references, infoboxes, and navboxes are excluded by default).genericIf set to 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.

List of keys

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

These parameters can be used in either mode.

audioName of an audio file to accompany the transcription. Takes precedence over the fourth unnamed parameter.wrapIf set to 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).classHTML class(es) added to the span element containing the transcription.catIf 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).

Liên quan