View source for Template:IPAc-en/doc

{| align="right"
| __TOC__
|}

This template is used to display [[International Phonetic Alphabet]] (IPA) transcriptions.  If the phonemes are broken into individual variables it generates mouseover pronunciation guides. It is also capable of translating phonetic representations into IPA.

If the code <code><nowiki>/[[Wikipedia:IPA_for_English#Key|??]]/</nowiki></code> is displayed, it means that an unsupported input was used, or that you included a non-existent sound file. Such instances are tallied at [[:Category:Ill-formatted IPAc-en transclusions]], where they can be reviewed and fixed. 

There are a maximum of 50 variables, including the first three. 

The first three variables can be used to indicate a prescript (eg, <small>English pronunciation:</small>). The named parameter {{para|audio}} may be used to link to an audio file.

*<code><nowiki>{{IPAc-en|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}
*<code><nowiki>{{IPAc-en|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}
*<code><nowiki>{{IPAc-en|US|pron|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|US|pron|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}

The pronunciation is broken into individual phonemes so that they will have mouseovers to indicate pronunciation. All phonemes from [[Wikipedia:IPA_for_English#Key|IPA for English]] are available. For anything outside that set, a different template should be used. 

Individual phonemes can be translated from [[SAMPA Chart|SAMPA]] spelling:

*<code><nowiki>{{IPAc-en|,|&|l|@|'|b|&|m|@}}</nowiki></code> → {{IPAc-en|,|&|l|@|'|b|&|m|@}}
*<code><nowiki>{{IPAc-en|lang|pron|audio=en-us-Alabama.ogg|,|&|l|@|'|b|&|m|@}}</nowiki></code> → {{IPAc-en|lang|pron|audio=en-us-Alabama.ogg|,|&|l|@|'|b|&|m|@}}

For a space between words, use a keyboard underscore. See [[Template:H:IPA]] for the full list of recognized phonemes and [[Template:IPAc-en/pronunciation]] for the list of recognized prefix flags.

==== Behaviour changes from current templates ====
{{tl|IPAc-en}} combines the features of {{tl|IPA-en}} and the original {{tl|IPAc-en}}.  It is also intended to replace incidences of {{tl|Audio-IPA}}.  To facilitate this a [[Greasemonkey]] [http://userscripts.org/scripts/show/62994 script is available] that will automatically convert any incidents of these templates to {{tl|IPAc-en}} with properly separated phonemes. 

Behavioural differences follow.

===== {{tl|IPA-en}} =====
The default behaviour has changed to no prescript.
*<code><nowiki>{{IPA-en|ˌæləˈbæmə}}</nowiki></code> → {{IPA-en|ˌæləˈbæmə}}
*<code><nowiki>{{IPAc-en|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}
It can be simulated using the flags lang & pron.
*<code><nowiki>{{IPAc-en|lang|pron|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|lang|pron|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}

Audio files are specifically called:
*<code><nowiki>{{IPA-en|ˌæləˈbæmə|-|en-us-Alabama.ogg}}</nowiki></code> → {{IPA-en|ˌæləˈbæmə|-|en-us-Alabama.ogg}}
*<code><nowiki>{{IPAc-en|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}} or {{IPAc-en|ˌ|æ|l|ə|ˈ|b|æ|m|ə|audio=en-us-Alabama.ogg}}</nowiki></code> → {{IPAc-en|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}, {{IPAc-en|ˌ|æ|l|ə|ˈ|b|æ|m|ə|audio=en-us-Alabama.ogg}}

===== {{tl|IPAc-en}} =====
The original template had three flags ( /- , -- and -/ ) that allowed multiple templates to be strung together in case there wasn't enough characters.  The maximum character count has increased from 33 to 50 and this feature has been dropped.

<includeonly>
[[Category:IPA language templates|c]]

[[ar:قالب:IPAc-en]]
[[bn:টেমপ্লেট:IPAc-en]] 
[[ko:틀:IPAc-en]]
[[pt:Predefinição:IPAc-en]]
</includeonly>