Template:IPA/doc

From Wikipedia, the free encyclopedia
Jump to: navigation, search

Usage

Template:IPA is most useful when there are multiple instances of the International Phonetic Alphabet (IPA) on a page. It contains

<span title="Representation in the International Phonetic Alphabet (IPA)" class="IPA">{{{1}}}</span>

This means, it simply specifies a class called “IPA” as a hook for CSS styling and DOM scripting.

This allows fixing broken display of IPA characters in MS Internet Explorer 6 for Windows, and choice of style in any browser.

The font declaration is in MediaWiki:Common.js and targets only Windows XP. Registered Wikipedia users can specify their own style for IPA text by editing, for each project, their user style sheet, e.g. monobook.css. Users can also specify the style locally in their browser, which works across projects.

MediaWiki:Common.css also ensures that links inside IPA transcriptions marked up with this template do not use underlines since these carry special semantics there.

TemplateData

This is the TemplateData documentation for the template used by the new VisualEditor.

IPA

This template ensures proper display of transcriptions using the International Phonetic Alphabet (IPA), especially in older operating systems and browsers. There are related specialized templates that also semi-automatically generate the transcription itself.

Template parameters
Parameter Description Type Default Status
transcription 1 including square brackets [...] for phonetic transcriptions or enclosing forward slashes /.../ for phonemic ones string empty required

Examples

Placing a phonemic rendering of the word characters in Template:IPA:

{{IPA|/ˈkærəktɚz/}}
{{IPA|/[[character|ˈkærəktɚz]]/}}

The result will be a span with a class attribute, like this:

<span title="Representation in the International Phonetic Alphabet (IPA)" class="IPA">/ˈkærəktɚz/</span>

Which appear in your browser as:

/ˈkærəktɚz/
/ˈkærəktɚz/

Without template:IPA:

/ˈkærəktɚz/
/ˈkærəktɚz/

[These sets should only look different if you are using Internet Explorer 6 or lower on Windows, or if you have a custom style defined for IPA text.]

Please place all IPA text into Template:IPA, even if it doesn't have any special IPA characters, like this: /mi/. This will allow users to format all examples of IPA text consistently, with their choice of fonts, colours, etc.

List of fonts

The following is a list of fonts that are used using this template.

Usage of IPA pronunciation templates

Wikipedia offers several templates for proper display of IPA transcriptions.

IPA font

In general, IPA symbols on a page should be enclosed in the {{IPA}} template, which formats the text in an IPA-producing font. If a substantial portion of a page uses IPA, it is customary to post notice of that fact with {{IPA notice|lang=en}}, though each token still requires the {{IPA}} template for proper formatting.

If there are not enough occurrences to warrant a notice, then consider a template that links to an IPA key for the first instance of the IPA on a page or section.

English words

For English words, in a broad, non-regional transcription, as when giving the pronunciation of a key word in an article, use templates linking to Help:IPA for English, a chart of the subset of the IPA that is relevant to English:

  • {{IPA-en}}, appearing as: English pronunciation: /word/ (also /word/, English: /word/, pronounced /word/, as hereafter).
  • {{IPAc-en}}, which automates the conversion to IPA, so that {{IPAc-en|'|w|3r|d}} appears as /ˈwɜrd/. This provides mouse-over links to the symbols, and is now the preferred template.

Foreign words

For foreign words that are not assimilated into English, regional pronunciations of English words, and non-standard English dialects, use templates linking to the more general Help:IPA chart, containing all major IPA symbols:

    • {{IPA-all}}, appearing as: IPA: [word]. Or:
    • For specific languages, there may be dedicated IPA keys for standardized transcription. There are several options for their display. The first cell includes the ISO code of the language; the second is the transcription; the third keys an introductory phrase; and the fourth is space for a sound file. Using the French word eau [o] as an example, we have the default format:
  • {{IPA-fr|o}}French pronunciation: ​[o]
Or the word "pronounced" can be used as the introduction:
  • {{IPA-fr|o|pron}}pronounced: [o]
Language name only:
  • {{IPA-fr|o|lang}}French: [o]
"IPA" only:
  • {{IPA-fr|o|IPA}}IPA: [o]
Link only:
  • {{IPA-fr|o|}}[o]
Any of these may be combined with a sound file:
  • {{IPA-fr|o|lang|Fr-eau.ogg}}French: [o] ( )
For the default introductory phrase, however, a placeholder such as “-” is required:
  • {{IPA-fr|o|-|Fr-eau.ogg}}French pronunciation: [o] ( )

IPA-all for not-supported languages

Redirects have been created for languages which do not yet have dedicated templates. Transcriptions which use these redirects will link to {{IPA-all}} for the time being; when a language-specific template is created the articles will be linked correctly. For example, you can use {{IPA-jv|word}} for Javanese, but for the moment it will be redirected to {{IPA-all}}, producing IPA: [word].

Conversion to IPA

Another type of language-specific template allows you to enter ordinary letters (or conventional ASCII equivalents) from a given language for automatic conversion to phonetic symbols. Languages currently available, and examples of use, are:

Arabic, {{IPAc-ar}} {{IPAc-ar|2|a|l|l|u|gh|a|t_|a|l|3|a|r|a|b|i|y|y|a}}[ʔalluɣat‿alʕarabijja]
Mandarin, {{IPAc-cmn}} {{IPAc-cmn|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}[tʂʊ́ŋxwǎ ʐə̌nmǐn kʊ̂ŋxɤ̌kwɔ̌]
English, {{IPAc-en}} {{IPAc-en|'|s|&|n|d|k|a:|s|@l}}/ˈsændkɑːsəl/
French, {{IPAc-fr}} {{IPAc-fr|j|@|-|s|U|i|s_|a|m|é|r|i|c|ain}}[jə sɥi.z‿ameʁikɛ̃]
Irish, {{IPAc-ga}} {{IPAc-ga|'|b|ai|l'|@|-|'|á|th|@|-|'|c'|l'|ia|th}}[ˈbˠalʲə ˈaːhə ˈclʲiəh]
Italian, {{IPAc-it}} {{IPAc-it|ˈ|i|.|o|_|ˈ|s|ɔ|ː|.|n|o|_|a|.|m|e|.|r|i|ˈ|k|a|.|n|o}}/ˈi.o ˈsɔː.no a.me.riˈka.no/
Japanese, {{IPAc-ja}} {{IPAc-ja|ku|ro|si|o}}[ku͍ɽoɕio]
Hungarian, {{IPAc-hu}} {{IPAc-hu|'|m|a|gy|á|r}}[ˈmɒɟaːr]
Polish, {{IPAc-pl}} {{IPAc-pl|'|sz|cz|e|ć|i|n}}[ˈʂt͡ʂɛt͡ɕin]

See also










Creative Commons License