Template:IPA-en/doc
This is a documentation subpage for Template:IPA-en. It contains usage information, categories and other content that is not part of the original template page. |
Note: Per WP:LEAD, do not use this template in the lead section for common English words (like pub, rose, pencil, bus, Monday, Earth, etc.).
Usage[edit source]
This template formats IPA transcriptions and links them to Help:IPA/English. The transcription should match the conventions of that key; for narrower dialect transcriptions, use {{IPA-endia}} or {{IPA-all}}, which links to a more complete IPA key.
The first parameter in the template is for the transcription, and a second optional parameter is a switch that controls the wording introducing the transcription. With no second value, the introduction English pronunciation: appears:
{{IPA-en|n}}
→ English pronunciation: /n/{{IPA-en|n|pron}}
→ pronounced /n/{{IPA-en|n|lang}}
→ English: /n/{{IPA-en|n|local}}
→ locally /n/{{IPA-en|n|IPA}}
→ IPA: /n/{{IPA-en|n|UK}}
→ UK: /n/{{IPA-en|n|US}}
→ US: /n/{{IPA-en|n|}}
→ /n/
Any of these may be combined with a sound file in an optional third parameter:
To use the default introductory wording when a third parameter is used, a placeholder such as ‹-› (something that does not match any of the above switches) is required in the second parameter:
or the third parameter must be explicitly numbered:
Usage of IPA pronunciation templates[edit source]
Wikipedia offers several templates for proper display of IPA transcriptions.
IPA font[edit source]
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}}
, 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[edit source]
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/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.
For a specific transcription in a regional variety, use {{IPA-endia}} or {{IPA-all}}.
Non-English words[edit source]
For 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: Template:IPA-all. 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}}
→ Template:IPA-fr
- Or the word "pronounced" can be used as the introduction:
{{IPA-fr|o|pron}}
→ Template:IPA-fr
- Language name only:
{{IPA-fr|o|lang}}
→ Template:IPA-fr
- "IPA" only:
{{IPA-fr|o|IPA}}
→ Template:IPA-fr
- Link only:
{{IPA-fr|o|}}
→ Template:IPA-fr
- Any of these may be combined with a sound file:
{{IPA-fr|o|lang|Fr-eau.ogg}}
→ Template:IPA-fr
- For the default introductory phrase, however, a placeholder such as “-” is required:
{{IPA-fr|o|-|Fr-eau.ogg}}
→ Template:IPA-fr
Languages without dedicated keys[edit source]
Templates have been created for languages which do not yet have dedicated key pages. Transcriptions which use these templates will link to Help:IPA for the time being; when a language-specific key is created the templates will be linked accordingly. For example, you can use {{IPA-jv|word}}
for Javanese, but for the moment it will link to Help:IPA, producing Template:IPA-jv.
Languages and language extensions (IPA-iso) with links to Help:IPA |
---|
|
Conversion to IPA[edit source]
The template {{x2i}} takes X-SAMPA symbols (ASCII equivalents of IPA symbols) and converts them to IPA.
Other language-specific templates allow you to enter ordinary letters (or conventional ASCII equivalents) in place of IPA characters, and they will be automatically converted to the phonetic symbols that are used to transcribe the language. The templates that are currently available are shown below, with examples:
Arabic, {{IPAc-ar}} | {{IPAc-ar|2|a|l|l|u|gh|a|t_|a|l|3|a|r|a|b|i|y|y|a}} → Template:IPAc-ar
|
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}} → Template:IPAc-cmn
|
English, {{IPAc-en}} | {{IPAc-en|,|{|l|@|'|b|{|m|@}} → /ˌæləˈbæmə/
|
Spanish, {{IPAc-es}} | {{IPAc-es|m|i|'|gu|e|l|_|d|e|_|c|e|r|'|v|a|n|t|e|s|_|s|aa|'|v|e|d|r|a}} → Template:IPAc-es
|
French, {{IPAc-fr}} | {{IPAc-fr|j|@|-|s|U|i|s_|a|m|é|r|i|c|ain}} → Template:IPAc-fr
|
Irish, {{IPAc-ga}} | {{IPAc-ga|'|b|ai|l'|@|-|'|á|th|@|-|'|c'|l'|ia|th}} → Template:IPAc-ga
|
Hebrew, {{IPAc-he}} | {{IPAc-he|y|a|ʿ|a|k|o|v}} → Template:IPAc-he
|
Hungarian, {{IPAc-hu}} | {{IPAc-hu|'|m|a|gy|a|r}} → Template:IPAc-hu
|
Italian, {{IPAc-it}} | {{IPAc-it|'|ì|o|_|'|s|o|:|n|o|_|a|m|e|r|i|'|c|a|:|n|o}} → Template:IPAc-it
|
Japanese, {{IPAc-ja}} | {{IPAc-ja|ku|ro|si|o}} → Template:IPAc-ja
|
Georgian {{IPAc-ka}} | {{IPAc-ka|dz|a|l|a|_|e|r|t|o|b|a|sh|i|a}} → Template:IPAc-ka
|
Korean, {{IPAc-ko}} | {{IPAc-ko|h|a|ng|eo}} → Template:IPAc-ko
|
Marshallese, {{IPAc2-mh}} | {{IPAc-mh|m|yay|J|^yeh|r|how|ow}} → Template:IPAc-mh
|
Māori, {{IPAc-mi}} | {{IPAc-mi|ng|ā|r|u|a|'|w|ā|h|i|a}} → Template:IPAc-mi
|
Polish, {{IPAc-pl}} | {{IPAc-pl|'|sz|cz|e|ć|i|n}} → Template:IPAc-pl
|
Portuguese, {{IPAc-pt}} | {{IPAc-pt|p|o|<|r|t|u|'|g|a|l|lang=pt}} and {{IPAc-pt|b|r|a|'|S|i|l|lang=br}} → Template:IPAc-pt and Template:IPAc-pt
|
Romanian, {{IPAc-ro}} | {{IPAc-ro|ˈ|m|U|n|ț|ii|_|f|ă|G|ă|ˈ|r|a|ș|U|l|U|i}} → Template:IPAc-ro
|
Cantonese, {{IPAc-yue}} | {{IPAc-yue|h|ung|2|.|z|i|2}} → Template:IPAc-yue
|
Broken templates[edit source]
The following templates need amendment:
See also[edit source]
- {{Respell}}, for pronunciation respellings, which may be used for English words in addition to the IPA
- {{Lang-nci-IPA}}, for dual Nahuatl-IPA transcription
External links[edit source]
- Template:IPA-en/doc at Wikipedia, the free Terran encyclopedia that anyone can edit.
External links[edit source]
- Template:IPA-en/doc at Wikipedia, the free Terran encyclopedia that anyone can edit.