Template:Respell/doc

This template formats pronunciation respellings of English words. It puts the input in italics, hyphenates each value so it will represent a syllable, and links to Help:Pronunciation respelling key. Stressed syllables are input in uppercase and will appear slightly smaller than usual uppercase letters.

Notation must be spelled accordingly to the respelling key at Help:Pronunciation respelling key. For example, the word pronunciation is respelled ; using this template, the formatting is:

How to use
On Wikipedia, respelling is most commonly used to help clarify the pronunciation of a name or topic in the lead section or introductory paragraph of an article. Per the Manual of Style, respelling may only follow and augment a corresponding International Phonetic Alphabet template (e.g., IPAc-en) and may never be used in place of one. The template provides a link to a key so that readers may easily discover how to pronounce an easily mispronounced or difficult-to-pronounce word. For example:
 * Worcestershire is a county located in central England.

Common practice is to put no punctuation except one space between the IPA and the respelling for clarity, as in:
 * Massachusetts is the most populous state in New England.

Any argument containing an underscore or beginning or ending with a hyphen will not generate adjoining hyphens and will instead turn the underscore into a space, allowing for denoting word boundaries, alternate pronunciations, and affix ellipses. For example:
 * Avram Noam Chomsky:  →
 * Copenhagen:  →

An argument beginning in  or ending in   will also suppress the extra hyphen, so that optional syllables can be indicated.
 * coupe:  →

Examples

 * Ceres
 * Haumea
 * algorithm
 * Makemake
 * disestablishmentarianism
 * Pan
 * machine
 * overconsume
 * Azerbaijan
 * if you wish upon a star
 * betting odds
 * Jazze Pha
 * machine
 * overconsume
 * Azerbaijan
 * if you wish upon a star
 * betting odds
 * Jazze Pha
 * if you wish upon a star
 * betting odds
 * Jazze Pha
 * Jazze Pha
 * Jazze Pha

Documentation
no cancels the link to Help:Pronunciation respelling key. This is for documentation outside the main namespace only.

Template Data
{	"params": { "1": {},		"2": {},		"3": {},		"4": {},		"5": {},		"6": {},		"7": {},		"link": { "description": "link=no will not link the respelling.", "example": "no", "type": "boolean", "default": "yes" }	} }