Lihimi Tɛmplet:IPAc-en/doc ni yi shɛli na

{{documentation subpage}}
{{High-use|demo={{ROOTPAGENAME}}}}
{{lua|Module:IPAc-en}}
'''Note: Per [[WP:LEAD]], do not use this template in the lead section for common English words (e.g., ''[[pub]]'', ''[[rose]]'', ''[[pencil]]'', ''[[bus]]'', ''[[Monday]]'', ''[[Earth]]'', etc.).'''

This template is used to display English [[International Phonetic Alphabet]] (IPA). The pronunciation is broken into individual [[diaphoneme]]s so that they will have tooltips (mouse-over text) to indicate pronunciation. All diaphonemes from [[Help:IPA/English]] are available.

The transcription system of [[Help:IPA/English]], upon which this template relies, is diaphonemic, i.e. meant to cover multiple major varieties of English at once. If you wish to give a narrow transcription of a pronunciation in a certain variety of English, use {{tl|IPA-endia}} or {{tl|IPA-all}} instead.

The initial argument (entry after |) can be used to indicate a pronunciation prescript; link to IPA. The codes are:
{| class="wikitable mw-collapsible mw-collapsed"
|+ class="nowrap" | Pronunciation & IPA link codes
! Code !! Output
|-
| <code>lang</code> || English:
|-
| <code>local</code> || locally
|-
| <code>ipa</code> || [[International Phonetic Alphabet|IPA]]:
|-
| <code>also</code> || also
|-
| <code>uk</code> || [[British English|UK]]:
|-
| <code>us</code> || [[American English|US]]:
|-
| <code>uklang</code> || [[British English]]:
|-
| <code>uslang</code> || [[American English]]:
|-
| <code>ukalso</code> || [[British English|UK]] also
|-
| <code>usalso</code> || [[American English|US]] also
|-
| <code>alsouk</code> || also [[British English|UK]]:
|-
| <code>alsous</code> || also [[American English|US]]:
|}

The first argument that is not a code above will be treated as a diaphoneme. All diaphonemes listed at [[Help:IPA/English]] are available (except the ones that span two syllables such as {{IPA|/iə/}}, which need to be input as <code>i|ə</code>). Also available are {{IPA|/ɪəˈr/}}, {{IPA|/ɛəˈr/}}, {{IPA|/ʊəˈr/}}, {{IPA|/ɪəˌr/}}, {{IPA|/ɛəˌr/}}, and {{IPA|/ʊəˌr/}}, preserved for when a centering diphthong precedes a stress.

;Separator codes
:Use an underscore <code>_</code> to separate words. When multiple pronunciations for the same word(s) are possible, use a comma and an underscore <code>,_</code> to separate the variants which will appear as a comma. As necessary, use a hyphen <code>-</code> to indicate omitted syllables. Diaphonemes are underlined, but separators are not, and separators do not have any tooltip text.

See the table below for a full list of diaphoneme codes.

{{collapse top|Diaphoneme codes|expand=yes}}
Note that the aliases include ones that are kept merely for compatibility reasons and therefore not recommended for further use, as they might not accurately represent the sound represented by the output.
{{#invoke:IPAc-en/documentation|phonemes}}
{{collapse bottom}}

The named parameter {{para|audio}} may be used to link to an audio file. By default, two links are created: one to the audio file itself and one to the File page. If the audio file is licensed as CC0 or public domain, you can use {{para|attribution|no}} to make it only link to the audio file.

== Examples ==
* <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|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|US|audio=en-us-Alabama.ogg|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}
* <code><nowiki>{{IPAc-en|US|audio=en-us-Alabama.ogg|attribution=no|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}</nowiki></code> → {{IPAc-en|US|audio=en-us-Alabama.ogg|attribution=no|ˌ|æ|l|ə|ˈ|b|æ|m|ə}}

Examples using [[SAMPA chart|SAMPA]] spelling for individual diaphonemes:
* <code><nowiki>{{IPAc-en|,|{|l|@|'|b|{|m|@}}</nowiki></code> → {{IPAc-en|,|{|l|@|'|b|{|m|@}}
* <code><nowiki>{{IPAc-en|lang|audio=en-us-Alabama.ogg|,|{|l|@|'|b|{|m|@}}</nowiki></code> → {{IPAc-en|lang|audio=en-us-Alabama.ogg|,|{|l|@|'|b|{|m|@}}

If "[invalid input]" is displayed, it means that an unsupported input was used. Such instances are tallied at [[:Category:Ill-formatted IPAc-en transclusions]], where they can be reviewed and fixed.

Notations with audio links will appear under [[:Category:Pages including recorded pronunciations]].

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"format": "inline",
	"params": {
		"audio": {
			"label": "Audio file",
			"description": "The audio file without the \"File:\" prefix",
			"example": "En-us-Foobar.ogg"
		},
		"attribution": {
			"label": "Attribution link",
			"description": "Set attribution to \"no\" to only display a speaker icon that links directly to the audio file (with no link to the File page).",
			"example": "no"
		},
		"1": {
			"label": "First input",
			"type": "string",
			"required": true
		},
		"2": {
			"label": "Second input",
			"type": "string",
			"required": false
		},
		"3": {
			"label": "Third input",
			"type": "string",
			"required": false
		},
		"4": {
			"label": "Fourth input",
			"type": "string",
			"required": false
		},
		"5": {
			"label": "Fifth input",
			"type": "string",
			"required": false
		},
		"6": {
			"label": "Sixth input",
			"type": "string",
			"required": false
		},
		"7": {
			"label": "Seventh input",
			"type": "string",
			"required": false
		},
		"8": {
			"label": "Eighth input",
			"type": "string",
			"required": false
		},
		"9": {
			"label": "Ninth input",
			"type": "string",
			"required": false
		},
		"10": {
			"label": "Tenth input",
			"type": "string",
			"required": false
		},
		"11": {
			"label": "Eleventh input",
			"type": "string",
			"required": false
		},
		"12": {
			"label": "Twelfth input",
			"type": "string",
			"required": false
		},
		"13": {
			"label": "Thirteenth input",
			"type": "string",
			"required": false
		},
		"14": {
			"label": "Fourteenth input",
			"type": "string",
			"required": false
		},
		"15": {
			"label": "Fifteenth input",
			"type": "string",
			"required": false
		},
		"16": {
			"label": "Sixteenth input",
			"type": "string",
			"required": false
		},
		"17": {
			"label": "Seventeenth input",
			"type": "string",
			"required": false
		},
		"18": {
			"label": "Eighteenth input",
			"type": "string",
			"required": false
		},
		"19": {
			"label": "Nineteenth input",
			"type": "string",
			"required": false
		},
		"20": {
			"label": "Twentieth input",
			"type": "string",
			"required": false
		},
		"21": {
			"label": "Twenty-first input",
			"type": "string",
			"required": false
		},
		"22": {
			"label": "Twenty-second input",
			"type": "string",
			"required": false
		},
		"23": {
			"label": "Twenty-third input",
			"type": "string",
			"required": false
		},
		"24": {
			"label": "Twenty-fourth input",
			"type": "string",
			"required": false
		},
		"25": {
			"label": "Twenty-fifth input",
			"type": "string",
			"required": false
		},
		"26": {
			"label": "Twenty-sixth input",
			"type": "string",
			"required": false
		},
		"27": {
			"label": "Twenty-seventh input",
			"type": "string",
			"required": false
		},
		"28": {
			"label": "Twenty-eighth input",
			"type": "string",
			"required": false
		},
		"29": {
			"label": "Twenty-ninth input",
			"type": "string",
			"required": false
		},
		"30": {
			"label": "Thirtieth input",
			"type": "string",
			"required": false
		},
		"31": {
			"label": "Thirty-first input",
			"type": "string",
			"required": false
		},
		"32": {
			"label": "Thirty-second input",
			"type": "string",
			"required": false
		},
		"33": {
			"label": "Thirty-third input",
			"type": "string",
			"required": false
		},
		"34": {
			"label": "Thirty-fourth input",
			"type": "string",
			"required": false
		},
		"35": {
			"label": "Thirty-fifth input",
			"type": "string",
			"required": false
		},
		"36": {
			"label": "Thirty-sixth input",
			"type": "string",
			"required": false
		},
		"37": {
			"label": "Thirty-seventh input",
			"type": "string",
			"required": false
		},
		"38": {
			"label": "Thirty-eighth input",
			"type": "string",
			"required": false
		},
		"39": {
			"label": "Thirty-ninth input",
			"type": "string",
			"required": false
		},
		"40": {
			"label": "Fortieth input",
			"type": "string",
			"required": false
		},
		"41": {
			"label": "Forty-first input",
			"type": "string",
			"required": false
		},
		"42": {
			"label": "Forty-second input",
			"type": "string",
			"required": false
		},
		"43": {
			"label": "Forty-third input",
			"type": "string",
			"required": false
		},
		"44": {
			"label": "Forty-fourth input",
			"type": "string",
			"required": false
		},
		"45": {
			"label": "Forty-fifth input",
			"type": "string",
			"required": false
		},
		"46": {
			"label": "Forty-sixth input",
			"type": "string",
			"required": false
		},
		"47": {
			"label": "Forty-seventh input",
			"type": "string",
			"required": false
		},
		"48": {
			"label": "Forty-eighth input",
			"type": "string",
			"required": false
		},
		"49": {
			"label": "Forty-ninth input",
			"type": "string",
			"required": false
		},
		"50": {
			"label": "Fiftieth input",
			"type": "string",
			"required": false
		},
		"51": {
			"label": "Fifty-first input",
			"type": "string",
			"required": false
		},
		"52": {
			"label": "Fifty-second input",
			"type": "string",
			"required": false
		},
		"53": {
			"label": "Fifty-third input",
			"type": "string",
			"required": false
		},
		"54": {
			"label": "Fifty-fourth input",
			"type": "string",
			"required": false
		},
		"55": {
			"label": "Fifty-fifth input",
			"type": "string",
			"required": false
		},
		"56": {
			"label": "Fifty-sixth input",
			"type": "string",
			"required": false
		},
		"57": {
			"label": "Fifty-seventh input",
			"type": "string",
			"required": false
		},
		"58": {
			"label": "Fifty-eighth input",
			"type": "string",
			"required": false
		},
		"59": {
			"label": "Fifty-ninth input",
			"type": "string",
			"required": false
		},
		"60": {
			"label": "Sixtieth input",
			"type": "string",
			"required": false
		},
		"61": {
			"label": "Sixty-first input",
			"type": "string",
			"required": false
		},
		"62": {
			"label": "Sixty-second input",
			"type": "string",
			"required": false
		},
		"63": {
			"label": "Sixty-third input",
			"type": "string",
			"required": false
		},
		"64": {
			"label": "Sixty-fourth input",
			"type": "string",
			"required": false
		},
		"65": {
			"label": "Sixty-fifth input",
			"type": "string",
			"required": false
		},
		"66": {
			"label": "Sixty-sixth input",
			"type": "string",
			"required": false
		},
		"67": {
			"label": "Sixty-seventh input",
			"type": "string",
			"required": false
		},
		"68": {
			"label": "Sixty-eighth input",
			"type": "string",
			"required": false
		},
		"69": {
			"label": "Sixty-ninth input",
			"type": "string",
			"required": false
		},
		"70": {
			"label": "Seventieth input",
			"type": "string",
			"required": false
		},
		"71": {
			"label": "Seventy-first input",
			"type": "string",
			"required": false
		},
		"72": {
			"label": "Seventy-second input",
			"type": "string",
			"required": false
		},
		"73": {
			"label": "Seventy-third input",
			"type": "string",
			"required": false
		},
		"74": {
			"label": "Seventy-fourth input",
			"type": "string",
			"required": false
		},
		"75": {
			"label": "Seventy-fifth input",
			"type": "string",
			"required": false
		},
		"76": {
			"label": "Seventy-sixth input",
			"type": "string",
			"required": false
		},
		"77": {
			"label": "Seventy-seventh input",
			"type": "string",
			"required": false
		},
		"78": {
			"label": "Seventy-eighth input",
			"type": "string",
			"required": false
		},
		"79": {
			"label": "Seventy-ninth input",
			"type": "string",
			"required": false
		},
		"80": {
			"label": "Eightieth input",
			"type": "string",
			"required": false
		},
		"81": {
			"label": "Eighty-first input",
			"type": "string",
			"required": false
		},
		"82": {
			"label": "Eighty-second input",
			"type": "string",
			"required": false
		},
		"83": {
			"label": "Eighty-third input",
			"type": "string",
			"required": false
		},
		"84": {
			"label": "Eighty-fourth input",
			"type": "string",
			"required": false
		},
		"85": {
			"label": "Eighty-fifth input",
			"type": "string",
			"required": false
		},
		"86": {
			"label": "Eighty-sixth input",
			"type": "string",
			"required": false
		},
		"87": {
			"label": "Eighty-seventh input",
			"type": "string",
			"required": false
		},
		"88": {
			"label": "Eighty-eighth input",
			"type": "string",
			"required": false
		},
		"89": {
			"label": "Eighty-ninth input",
			"type": "string",
			"required": false
		},
		"90": {
			"label": "Ninetieth input",
			"type": "string",
			"required": false
		},
		"91": {
			"label": "Ninety-first input",
			"type": "string",
			"required": false
		},
		"92": {
			"label": "Ninety-second input",
			"type": "string",
			"required": false
		},
		"93": {
			"label": "Ninety-third input",
			"type": "string",
			"required": false
		},
		"94": {
			"label": "Ninety-fourth input",
			"type": "string",
			"required": false
		},
		"95": {
			"label": "Ninety-fifth input",
			"type": "string",
			"required": false
		},
		"96": {
			"label": "Ninety-sixth input",
			"type": "string",
			"required": false
		},
		"97": {
			"label": "Ninety-seventh input",
			"type": "string",
			"required": false
		},
		"98": {
			"label": "Ninety-eighth input",
			"type": "string",
			"required": false
		},
		"99": {
			"label": "Ninety-ninth input",
			"type": "string",
			"required": false
		},
		"100": {
			"label": "One hundredth input",
			"type": "string",
			"required": false
		}
	}
}
</templatedata>

== See also ==
* {{tl|Respell}}, for [[Help:Pronunciation respelling key|pronunciation respelling]]s, which may be used for English words in addition to the IPA

{{IPA templates}}

<includeonly>{{Sandbox other||
[[Category:IPA language templates|c]]
[[Category:Templates that add a tracking category]]
}}</includeonly>