Template:Infobox single/doc
<templatestyles src="Module:Message box/ombox.css"></templatestyles>
40px | This is a documentation subpage for Template:Infobox single. It contains usage information, categories and other content that is not part of the original template page. |
<templatestyles src="Module:Message box/ombox.css"></templatestyles>
40x40px | The design and content of all music-related infoboxes should follow Wikipedia's verifiability policy, infobox style guideline and music style guideline. While this document may clarify details of their specific application to the infobox, it is primarily concerned with explaining usage and not with matters of Wikipedia policy and style. |
<templatestyles src="Module:Message box/ombox.css"></templatestyles>
30px | Uses Lua: |
Contents
Usage
This is the template for a single (A- or B-side), not a song.
Code
"Country House" | ||||
---|---|---|---|---|
Single by Blur | ||||
from the album The Great Escape | ||||
Released | August 14, 1995 | (UK)|||
Format | ||||
Recorded | 1995 | |||
Genre | Britpop | |||
Length | 3:57 | |||
Label | ||||
Producer(s) | Stephen Street | |||
Blur singles chronology | ||||
|
{{Infobox single <!-- See Wikipedia:WikiProject_Songs --> | Name = | Cover = <!-- just the file name --> | Border = | Alt = | Caption = | Artist = | Album = | A-side = | B-side = | Released = <!-- {{Start date|YYYY|MM|DD}} --> | Format = | Recorded = | Studio = | Venue = | Genre = | Length = <!-- {{Duration|m=MM|s=SS}} --> | Label = | Writer = | Producer = | ISWC = | Chronology = | Last single = | This single = | Next single = | Misc = }}
Parameters
- Name
- This field should contain the name of the single. This field is mandatory.
- Cover
- Upload a copy of the single cover (under fair use—use the tag "{{Non-free album cover}}"). Enter the file name only into the field:
<Image Name>.jpg
. - Border
- Type "yes" in this field to place a 1px border around the single's cover.
- Alt
- Alt text for the cover image, to describe it to visually impaired readers. See WP:ALT.
- Artist
- This field should contain the name of the artist. This field is mandatory.
- Album
- If the single was also released on an album, enter the name of the album. If the album has a Wikipedia article, link the article name as usual. The template will italicize the album name. For guidelines on whether a single should be described as being from a particular album, see template:infobox album#Template:Singles.
- A-side
- Use this field to display the A-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link.
- B-side
- Use this field to display the B-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link. Only one of the fields "A-side" or "B-side" should be used.
- Released
- This field should refer to the earliest known commercial release date, using a single occurrence of {{Start date}} as {{Start date|YYYY|MM|DD}}, for example "{{Start date|2007|7|31}}". (Use "{{Start date|YYYY|MM}}" if only year and month are known, or "{{Start date|YYYY}}" for just a year).
- Recorded
- This field should include the date(s) the single was recorded. The location of the recording is now included in the
Studio
orVenue
field. - Venue
- For live recordings, include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate.
- Studio
- If the single was recorded in a recording studio, enter the name and location here. Link the studio, but not well-known cities (see WP:OVERLINK). Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1]
- Format
- The way that the single was originally released; i.e. 7-inch single, 12-inch single, CD single, cassette single, digital download (note the piped download link). Do not use
"
or″
(double quote) for inches (use 7-inch instead of 7"; if necessary to abbreviate, use 7 in). See WP:Units. Numbers should be expressed in figures rather than spelled out (use 10-inch instead of ten-inch). The format type should also be specified (single, record, etc.), rather than using the measurement alone. Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1] - Genre
- The music genre(s) that the single is from. These must not be original research, and should be stated and referenced in a 'Composition' section of the article. Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1].
- Length
- The length should use {{Duration}} thus:
{{Duration|m=3|s=45}}
, renders as 3:45, for 3 minutes 45 seconds - Label
- This field should refer to the label on which the single/album was originally released. Where significantly different versions have been released (featuring alternate track listings) e.g. U.S. vs. UK, the later release date and/or record label should be mentioned in the article. Drop words like "Records" from the end of the label's name (e.g. use [[Universal Records|Universal]] rather than [[Universal Records]]).
- Producer
- This field allows display of the song's producer(s). Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1]
- ISWC
- International Standard Musical Work Code
- Writer
- This field allows display of the song's writer(s). Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1].
- Misc
- This field allows you to provide more infobox data such as additional chronologies using {{Extra chronology}}, a track listing using {{Extra track listing}}, extra covers using {{Extra album cover}}, or a sample of the music using {{Audiosample}}. Set
|Type=single
on those templates so the section titles use the same background color as the rest of the infobox.
Chronology
The chronology section should link to the previous single on the left and the next single on the right. Songs should be ordered based on the first release dates of their official singles.
- For first singles the left box (the "{{{1}}}" field) should be left blank.
- For latest singles, the right box (the "{{{1}}}" field) should be left blank.
By default, the chronology section begins with an "artist Chronology" header. If you specify the optional "{{{1}}}" field, the text you supply will replace the "artist" portion of that header. This is useful when a single is released by two or more artists and you want to supply a chronology for each using the built-in chronology for one artist and the {{Extra chronology}} template for the other(s).
Wikipedia's date style guidelines recommend that years should not be linked within the chronology section.
- Note: album cover images should NOT be used in this section as they do not meet Wikipedia fair use requirements.
Examples
Here are some examples of articles using the infoboxes:
Notes
- ↑ 1.0 1.1 1.2 1.3 1.4 For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists the use of {{flatlist}} or {{hlist}} is preferred as they offer a benefit to users of screen readers. Vertical lists should always be implemented by {{plainlist}} or {{ubl}} and never by
<br />
tags for reasons of accessibility.
Microformat
The HTML mark-up produced by this template includes an hCalendar microformat that makes event 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.
- Classes used
The HTML classes this microformat uses include:
- attendee
- contact
- description
- dtend
- dtstart
- location
- organiser
- summary
- url
- vevent
nor collapse nested elements which use them.
TemplateData
See the monthly error report for this template.
TemplateData for Infobox single
An Infobox for singles
Parameter | Description | Type | Status | |
---|---|---|---|---|
Name | Name | The name of the single.
| String | optional |
Cover | Cover image cover | An image of the single cover, a file name, e.g. 'Relax_single.jpg'. The image should be uploaded with the fair use tag {{Non-free album cover}}. | String | suggested |
Border | Border border | Set to yes to put a 1 pixel border around the cover image. | String | optional |
Alt | Alt alt | Alt text for the cover image, to describe it to visually impaired readers. | String | suggested |
Caption | Caption caption | Caption for the cover image. | String | optional |
Artist | Artist | The name of the artist. | String | required |
Album | Album from Album | If the single was also released on an album, enter the name of the album. If the album has a Wikipedia article, link the article name as usual. The template will italicize the album name. For guidelines on whether a single should be described as being from a particular album, see [[Template:infobox album#Template:Singles]]. | String | suggested |
A-side | A-side | The A-side song title if different from the name. If it has a Wikipedia article use a link. Only one of the fields 'A-side' or 'B-side' should be used. | String | optional |
B-side | B-side | Use this field to display the B-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link. Only one of the fields 'A-side' or 'B-side' should be used. | String | optional |
Released | Released | The earliest known date of commercial release, using a single occurrence of {{Start date}} as {{Start date|YYYY|MM|DD}}, for example {{Start date|2007|7|31}}. (Use {{Start date|YYYY|MM}} if only year and month are known, or {{Start date|YYYY}} for just a year). | String | suggested |
Recorded | Recorded | This field should include details on when and where the song was recorded. Separate multiple values using {{Plainlist}}. | String | optional |
Venue | Venue | For live recordings, include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate. | String | optional |
Studio | Studio | If the single was recorded in a recording studio, enter the name and location here. Link the studio, but not well-known cities (see WP:OVERLINK). Separate multiple values using commas, {{flatlist}} or {{hlist}}. | String | optional |
Format | Format | The way that the single was released; i.e. 7-inch single, 12-inch single, CD single, cassette single, digital download (note the piped download link). Separate multiple values using {{Flatlist}}. | String | optional |
Genre | Genre | The music genres that the single is from. These must not be original research, and should be stated and referenced in a 'Composition' section of the article. Separate multiple values using {{Flatlist}}. | String | suggested |
Length | Length | The length should use {{Duration}} thus: {{Duration|m=3|s=45}}, renders as 3:45, for 3 minutes 45 seconds | String | suggested |
Label | Label | This field should refer to the label on which the single/album was originally released. Where significantly different versions have been released (featuring alternate track listings) e.g. U.S. vs. UK, the later release date and/or record label should be mentioned in the article. Drop words like 'Records' from the end of the label's name (e.g. use [[Universal Records|Universal]] rather than [[Universal Records]]). Separate multiple values using {{Flatlist}}. | String | suggested |
Producer | Producer | The song's producer(s). Separate multiple values using {{Flatlist}}. | String | optional |
ISWC | ISWC | International Standard Musical Work Code
| String | optional |
Writer | Writer | The song's writer(s). Separate multiple values using {{Flatlist}}. | String | optional |
Chronology | Chronology | Header for chronology section
| String | optional |
Last single title | Last single title | Title of the previous single in the artist's chronology. Link when appropriate.
| String | optional |
Last single year | Last single year | Year of the previous single in the artist's chronology.
| Unknown | optional |
Previous single | Last single | Previous single in the artist's chronology (in quotation marks), above its year of release (in brackets). Link when appropriate.
| String | optional |
This single | This single | Name (in bold and in quotation marks) and year of this single for the chronology.
| String | optional |
Next single title | Next single title | Title of the next single in the artist's chronology. Link when appropriate.
| String | optional |
Next single year | Next single year | Year of the next single in the artist's chronology.
| String | optional |
Next single | Next single | Next single in the artist's chronology (in quotation marks), above its year of release (in brackets). Link when appropriate. Don't use this parameter with «Next single title» or «Next single year».
| String | optional |
Misc | Misc | This field allows you to provide more infobox data such as additional chronologies using {{Extra chronology}}, a track listing using {{Extra track listing}}, extra covers using {{Extra album cover}}, or a sample of the music using {{Audiosample}}. Set 'Type=single' on those templates so the section titles use the same background color as the rest of the infobox. | String | optional |
Tracking category
- Category:Pages using infobox single with unknown parameters (0)
- Category:Pages using Infobox single with deprecated certification parameter (0)
See also