Template:Respell/doc

Description
This template formats pronunciation pronunciation of English words, and links to the key Reselling key pronunciation. It formats stressed syllables in bold, small-caps text. For example, the word machine is rewritten " "; using this template, the formatting is:

Formatting is: stressed syllables are in bold , unstressed syllables are in lowercase. All text is italicized, and is linked to the key pronunciation page.

No  separate each syllable with a pipe (|): join unstressed syllables with a hyphen, and only use a pipe to separate them from stressed syllables.

Como usar
Once you have available the spelling syllables, you can put them in the respell template. To start with, one syllable per parameter (without dashes) does it. But there are situations, regarding stressing, that require more attention.

1. The template accepts up to seven syllables (parameters), separated by a pipe ("|"). The pipes are automatically replaced by hyphens, and they alternate the stressing: &rarr;. If more parameters (syllables) are needed, just use two templates.

2. When unstressed syllables follow one another (– . . .), they need to be hyphenated together in a single parameter:
 * &rarr; (algorithm)

3. Stressed syllables are counted from the last syllable backwards: the second-last, fourth-last, and sixth-last parameters are formatted as stressed. The other parameters are unstressed (. – .– . – .):
 * &rarr; (arachnophobia)

4. When the final syllable is stressed (. –), one needs to add an extra apostrophe parameter:
 * &rarr; (machine)

5. Case in the input does not change the displayed result, but if the input case does not match the displayed case, the page will be added to Category:Articles with Respell issues in case this indicates an error:
 * &rarr;
 * &rarr;
 * &rarr; (correct, no issue categorisation)

Where to use
On, respelling is most commonly used to clarify the pronunciation of a name or topic in the lead section or introductory paragraph. Per the Manual of Style, respelling should follow the International Phonetic Alphabet, and never be used in place of it. The template provides a link to the key so that readers may easily look up how to pronounce the word. For example:
 * Worcestershire is a county located in central England.

The respelling key covers only English pronunciation, and should not be used for foreign names or words which have not been assimilated into English. If you need help transcribing the pronunciation into the IPA, please ask at Wikipedia talk:IPA for English.

How to use
Transcription can complement IPA in many cases, but it is not suitable for general use. For example, MOW and TOW are poor transcripts, because people tend to read them incorrectly as Moe, toe instead of Mao, Tao, which is what they actually transcribe. In such problematic cases, rhymes, sound alikes, or USdict transcription there may be better choices.

Examples
Here are some examples of how to use the templates for words with different numbers of syllables and different stress patterns: