Template:it-pr/documentation

Introduction
This template generates the ==Pronunciation== section of an Italian term, including the phonemic pronunciation, rhymes and hyphenation, as well as (if manually specified) audio files and homophones.

This template is intended to replace the use of along with, ,  and similar templates specifying auxiliary pronunciation information. It uses the same respelling conventions as, but automatically generates the rhyme info as well as (if the respelling is similar to the page name) the hyphenation info.

Basic usage
This template normally takes a single parameter, which in the most basic usage is simply the respelling of the term, as with. For example, for, use the following on a line by itself:

which produces

Note how the pronunciation, rhyme and hyphenation are all auto-generated.

If there is more than one possible pronunciation, separate the respellings with a comma, as with :

which produces

If the respelling is the same as the page name, it can be omitted, as with :

which produces

You can also explicitly request the page name using :

which produces

In simple cases like this, explicitly using  is unnecessary, but it is required when there is more than one respelling or a modifier is attached to a respelling (see below).

Qualifiers
All of the special symbols documented for can be used with  as well. An example is  to indicate a traditional pronunciation, as with :

which produces

Note how the qualifier is echoed on the rhyme and hyphenation lines.

The template is smart about the handling of qualifiers, and will not include the qualifier where it does not make sense to do so. For example, has a traditional pronunciation with  instead of :

which produces

Here, the hyphenations of the normal and traditional pronunciations are the same, so the traditional qualifier is not included with the hyphenation.

You can attach an arbitrary qualifier to a term using modifier syntax, which is of the form. For example, to note the rare pronunciation ananàs of :

which produces

You can add qualifiers separately to each term, as with :

which produces

Footnotes and references
To add a footnote (reference) to a term, use the modifier syntax. For example, to reference the pronunciation of to Olivetti's Dizionario Italiano, use a syntax like the following:

Parameters
The allowed parameters are as follows:


 * 1, 2, ...
 * Specify a line of pronunciation; see above.


 * pagename
 * Explicitly specify the pagename, for testing purposes and for use on documentation pages.