Template:IPA soundbox/doc

This template produces a standard box to start a sound file. It has some extra features to help linking to a phonetic sound file. Also, there are options to format possible error messages and to alter the layout of the box. Basic examples:
 * &rarr;
 * &rarr;

Usage
The box is created in three steps: Step 1. Determine the soundfile name
 * - By using input IPA symbol, looked up in a list: &rarr;
 * - Use input soundfile:

&rarr;

Step 2. Check if the soundfile exists This check may prevent red links and (undesired) repeated checks

Step 3. Create the standard browser soundbox on the page, using Here the information is put together, optional settings such as size are used, and the result is soundbox.
 * &rarr;

Input options

 * a. skip (expensive) check on file existance:
 * b. return soundfile name, not soundbox:
 * c. layout of the soundbox:
 * - showicon (noicon in basic documentation)
 * - location (left, center, right)
 * - size (px: dflt =150px, min is ~40px)
 * d. change error report:
 * - default: show red error
 * - option show any text
 * - blank, no output at all (no showbox)

Example of check file once:
 * See infobox IPA. First the file is checked, and returns filename if exists. Then if there is a filename, the infobox row is composed, including the soundbox set with.


 * Bare input parameters:


 * Possible errors:
 * 1. IPA symbol unknow in IPAsym list
 * 2. File does not exist
 * Any error: no soundbox (possible)