ទំព័រគំរូ:Extra music sample/doc

This is a documentation subpage for ទំព័រគំរូ:Extra music sample.
It may contain usage information, categories and other content that is not part of the original ទំព័រគំរូ page.

This template is used on many pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template is for adding a music sample within {{Infobox song}} or {{Infobox single}}.

Usage

{{Extra music sample
| type           = 
| filename       = 
| title          = 
| description    = 
}}

type should be "song" for songs and "single" for singles (without the quotes).
filename is the name of the audio file.
title is the name of the song.
description should probably be left blank in this context; otherwise, provide a brief description specific to the sample such as the duration.

{{Extra music sample
| Type           = single
| Filename       = The_Beatles_-_Ticket_to_Ride.ogg
| Title          = "Ticket to Ride"
| Description    = 
}}

Note: This template must be wrapped in an infobox; it does not provide the outer table markup and relies on a table being open when used. See "Ticket to Ride" for an example.

Microformat

The HTML mark up produced by this template includes an hAudio microformat, which makes the recording's details parsable by computers, either acting automatically to catalogue articles across Wikipedia, or via a browser tool operated by a person, to (for example) add the subject to a playlist or database. For more information about the use of microformats on Wikipedia, please see the microformat project.

Sub-templates

Date-of-publication ("published") information will only be included in the microformat if {{Start date}} (or {{Start date and age}} where appropriate) is used in a parent template or infobox (but do not use these if the date is before 1583 CE).

For the length or duration of a recording, say 3 minutes 45 seconds, use {{Duration}} thus: {{Duration|m=3|s=45}}, which renders as 3:45. An optional h parameter can be used for hours.

Please do not remove instances of these sub-templates.

Classes

hAudio uses HTML classes including:

haudio
fn
album
description
category
contributor
duration
h
item
min
photo
position
price
published
s

Please do not rename or remove these classes; nor collapse nested elements which use them.