Template:listen/documentation

allows audio files to be embedded in entries. It should be used for audio files that are set off from the text, like music clips or sound recordings.

For audio files containing pronunciations or spoken language, audio should be used instead.

Simple usage
or:


 * filename (Required): the pagename of the media file, without the File: prefix
 * description: a caption to be displayed beneath the audio file

Multiple files
Additional files can be embedded in an article with one template by appending a number to each parameter. Up to ten files can be included.




 * filename (Required): the pagename of the media file, without the File: (formerly Image:) prefix
 * alt: alt text for the image displayed for the file, for visually impaired readers. This is needed for files that include video as well as sound. The alt text should describe just the initial static image, not the entire video or its sound.
 * description: a description of the audio file

Style parameters
The template also takes a number of style parameters to control its appearance:


 * type: can be used to alter the image displayed at the left depending on the type of audio content being embedded. Acceptable values are:
 * (default)
 * style: can be used to pass specific style instructions to the box. Setting this to float:none will anchor the box when this is convenient. Setting this to float:none; clear:none will enable the anchored box to co-exist gracefully beside another floating box.
 * play#: some media files cannot be displayed inline; if this is the case set no to prevent the broken inline link from displaying.
 * style: can be used to pass specific style instructions to the box. Setting this to float:none will anchor the box when this is convenient. Setting this to float:none; clear:none will enable the anchored box to co-exist gracefully beside another floating box.
 * play#: some media files cannot be displayed inline; if this is the case set no to prevent the broken inline link from displaying.

Examples

 * Basic example:




 * Example with video:




 * Example with header:




 * Multiple files:

