Template:Infobox single/doc
 | This is a documentation subpage for Template:Terminate sentence It may contain usage information, categories and other content that is not part of the original template page. |
 | 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. |
Usage
[edit]This is the template for a single (A- or B-side), not a song.
Code
[edit]| "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 =
| Genre =
| Length = <!-- {{Duration|m=MM|s=SS}} -->
| Label =
| Writer =
| Producer =
| Certification =
| Chronology =
| Last single =
| This single =
| Next single =
| Misc =
}}
Parameters
[edit]- 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}}"). Ideally the image should be 200px wide. 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 details on when and where the song was recorded. Separate multiple values using {{Plainlist}}.
- 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}}.
- 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 {{Flatlist}}.
- 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]]). Separate multiple values using {{Flatlist}}.
- Producer
- This field allows display of the song's producer(s). Separate multiple values using {{Flatlist}}.
- Writer
- This field allows display of the song's writer(s). Separate multiple values using {{Flatlist}}.
- 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=singleon those templates so the section titles use the same background color as the rest of the infobox.
Chronology
[edit]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 "Last single=" field) should be left blank.
- For latest singles, the right box (the "Next single=" field) should be left blank.
By default, the chronology section begins with an "artist Chronology" header. If you specify the optional "Chronology=" 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
[edit]Here are some examples of articles using the infoboxes:
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:
- Page Template:Flatlist/styles.css has no content.
- attendee
- contact
- description
- dtend
- dtstart
- location
- organiser
- summary
- url
- vevent
TemplateData
[edit]This is the TemplateData documentation for the template used by the new VisualEditor.
Infobox single
An Infobox for singles
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Name | Name | The name of the single.
| String | optional |
| Artist | Artist | This field should contain the name of the artist. | String | required |
| Cover | Cover | An image of the single cover, a file name, e.g. 'Relax_single.jpg'. The image should be uploaded under fair—use tag {{Non-free album cover}}. | String | optional |
| Alt | Alt | Alt text for the cover image, to describe it to visually impaired readers. | String | optional |
| Caption | Caption | Caption for the cover image. | String | optional |
| Border | Border | Set to yes to put a 1 pixel border around the cover image. | String | optional |
| 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 | optional |
| 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 | optional |
| Recorded | Recorded | This field should include details on when and where the song was recorded. Separate multiple values using {{Plainlist}}. | 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 | optional |
| Length | Length | The length should use {{Duration}} thus: {{Duration|m=3|s=45}}, renders as 3:45, for 3 minutes 45 seconds | String | optional |
| 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 | optional |
| Writer | Writer | The song's writer(s). Separate multiple values using {{Flatlist}}. | String | optional |
| Producer | Producer | The song's producer(s). Separate multiple values using {{Flatlist}}. | String | optional |
| Certification | Certification | Music recording sales certification. Example :Platinum <small>([[Recording Industry Association of America|RIAA]])</small> | String | optional |
| Chronology | Chronology | Header for chronology section
| String | optional |
| Previous single | Last single | Previous single in the artists chronology. Use wiki-link when appropriate. Example: "[[Relax (song)|Relax]]"<br />(1983) | String | optional |
| Next single | Next single | Next single in the artists chronology. Use wiki-link when appropriate. Example: "[[The Power of Love (Frankie Goes to Hollywood song)|The Power Of Love]]"<br />(1984) | String | optional |
| This single | This single | Name and year of this single for the chronology. Example: "Two Tribes"<br />(1984) | 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 {{tl|Extra album cover}}, or a sample of the music using {{tl|Audiosample}}. Set 'Type=single' on those templates so the section titles use the same background color as the rest of the infobox. | String | optional |
| Clip requested? | Clip requested? | Set to 'yes' to add article to [[Category:Song articles missing an audio sample]] | String | optional |