Template:Birdsong/doc

Purpose

Allows a clean link in articles on bird species to recordings of songs, calls, etc. for that species' listing at xeno-canto.org. Up to four audio recordings at the Wikimedia Commons can be added, and the default image seen can be changed to any one you specify.

Usage

Minimal form

{{Birdsong
 | url = url at xeno-canto.org (required)
 | species = the name of the species (required). If not using the scientific name, you may need to add a definite article ["the"; "a"] depending on the context.
 }}

Scientific name example:
{{Birdsong|species = ''Sitta przewalskii''|url = http://www.xeno-canto.org/species/Sitta-przewalskii}}
produces the template seen at the right for Przevalski's nuthatch.

Common name Example, with definite article needed:
{{Birdsong|species = the Canada goose|url = http://www.xeno-canto.org/species/Branta-canadensis}}
produces the template seen at the right for the Canada goose.

Adding Wikimedia Commons audio files

{{Birdsong
 | url = url at xeno-canto.org (required)
 | species = the name of the species (required)
 | song1 = name of the first audio file (optional)
 | caption song1 = caption for the first audio file (optional)
 | song2 = name of the second audio file (optional)
 | caption song2 = caption for the second audio file (optional)
 | song3 = name of the third audio file (optional)
 | caption song3 = caption for the third audio file (optional)
 | song4 = name of the fourth audio file (optional)
 | caption song4 = caption for the fourth audio file (optional)
 }}

Thus: {{Birdsong|url = http://www.xeno-canto.org/species/Branta-canadensis|species = Canada goose|song1 = Branta canadensis.ogg|caption song1 = Call of the Canada goose}}
produces the template seen at right for the Canada goose.

Changing the image

If you want to change the default image seen in the examples, simply add:

|image=name of image; do NOT prefix "File:"

Example:
{{Birdsong|species = the Canada goose|url = http://www.xeno-canto.org/species/Branta-canadensis|image=Canada Goose -Branta canadensis.JPG}}
produces the template seen at the right.

Additional topography syntax

You can add the following additional, optional, parameters to force a moult of the template's display from its definitive plumage:

 | Align = left / center (right by default)
 | length = Number (250 by default); do NOT use "px"; just enter a number, e.g., length=300
 | height = Number (50 by default); do NOT use "px"; just enter a number, e.g., height=75

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Birdsong in articles based on its TemplateData.

TemplateData for Birdsong

No description.

Template parameters

Parameter		Description	Type	Status
align	align alignment	float location Suggested values left center Default right Example left / center (right by default)	String	optional
length	length	Number (250 by default); do NOT use "px"; just enter a number, e.g., length=300 Default 250 Example 300	Number	optional
song1	song1	name of the first audio file	String	optional
height	height	Number (50 by default); do NOT use "px"; just enter a number, e.g., height=75 Default 50 Example 75	Number	optional
image	image	name of image; do NOT prefix "File:"	File	optional
caption song1	caption song1	caption for the first audio file	String	optional
song2	song2	name of the second audio file	String	optional
caption song2	caption song2	caption for the second audio file	String	optional
song3	song3	name of the third audio file	String	optional
caption song3	caption song3	caption for the third audio file	String	optional
song4	song4	name of the fourth audio file	String	optional
caption song4	caption song4	caption for the third audio file	String	optional
url	url	url at xeno-canto.org	URL	required
species	species	the name of the species. If not using the scientific name, you may need to add a definite article ["the"; "a"] depending on the context.	String	required