Template:Audio/doc

Purpose

This template links to an audio file for quick listening. It is meant to be used inline with text, for pronunciations and the like. Please note that this just creates a link to the file and does not actually embed the file. If the file is Non-Free and only referenced via this template it is not in compliance with Wikipedia:Non-free content criteria § Policy #7.

Usage

Basic

{{Audio|name of sound file|text to use as link to soundfile|help=}}

Simple

'''Alabama''' ({{Audio|en-us-Alabama.ogg|pronunciation}}) is a state located in...

→ Alabama (pronunciation Template:main other) is a state located in...

Help links

Setting |help=no disables the "help/info" links. If this is done the template Template:tlx must be shown on the page.

'''Alabama''' ({{Audio|en-us-Alabama.ogg|pronunciation of "Alabama"|help=no}})

→ Alabama (pronunciation of "Alabama"Template:main other)

Todo: add Template:tlx to this page.

Microformat

The HTML mark-up produced by this template includes an hAudio microformat that makes an audio recording's details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

Template:big

Date-of-publication ("published") information will only be included in the microformat if Template:tl (or, where appropriate, Template:tl) is used in a parent infobox/template. Do not, however, use Template:tlf or Template:tlf if a date before 1583 CE is involved.

Use Template:tl to specify the duration/length of a recording. For instance, if the recording's duration is 3 minutes 45 seconds, use Template:tlc (which appears as: Template:duration). If needed, |h= may be included to specify a number of hours.

Please do not remove instances of these subtemplates.

Template:big

The HTML classes of this microformat include:

Template:hlist

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. click here to see a monthly parameter usage report for this template.

TemplateData for Audio

Use this template to add an inline link to an audio file, preceded by a speaker icon.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Audio file	1	Audio file to link to Example En-uk-London.ogg	File	required
Label	2	Text to replace the filename in the link Example English pronunciation	String	optional
Show "(help·info)" links?	help	Enter "no" here to remove the "(help·info)" links. Example no Auto value no	Line	optional

See also

• Template:tl – sets an audio clip off from the main text
  • Template:tl – sets an audio clip and an associated image off from the main text
• Template:tl – for inline sounds like pronunciations (with a help link)
  • Template:tl – a variant of this template to be used with IPA notation
  • Template:tl – a shortcut for {{small|{{Audio|soundfile.ogg|pronunciation}}}}
  • Template:tl – without a help link
• Template:tl – for linking spoken Wikipedia article versions
• Template:tl, Template:tl, and Template:tl – used to list multiple audio files in the same box
• Template:tl – adds only the small icon with no links
• Template:tl – adds a notice with link to Wikipedia:Media help