Purpose
[edit]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
[edit]Minimal form
[edit]{{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
[edit]{{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)
}}
produces the template seen at right for the Canada goose.
Changing the image
[edit]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
[edit]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