Difference between revisions of "Template:Infobox single/doc"

From blackwiki
Jump to navigation Jump to search
imported>Jc86035
m (+ notice)
imported>Ojorojo
(moved notice to Usage, removed outdated material)
Line 1: Line 1:
{{notice|Please use [[Template:Infobox song]] in new articles.}}
 
 
{{Merging|Infobox song}}
 
{{Merging|Infobox song}}
{{Documentation subpage}}
 
{{Music infobox header}}
 
{{High-use| 53000 }}
 
 
{{Lua|Module:Infobox|Module:InfoboxImage|Module:String|Module:Check for unknown parameters}}
 
{{Lua|Module:Infobox|Module:InfoboxImage|Module:String|Module:Check for unknown parameters}}
  
 
==Usage==
 
==Usage==
{{#ifeq:{{FULLPAGENAME}}|Wikipedia:WikiProject Songs||{{for|non-single songs|Template:Infobox song}}}}
+
{{notice|Please use [[Template:Infobox song]] in new articles.}}
 
 
This is the template for a [[wikt:single|single]] (A- or B-side), '''not''' a [[wikt:song|song]].
 
 
 
==Code==
 
{{Infobox single <!-- See Wikipedia:WikiProject_Songs -->
 
| name          = Country House
 
| artist        = [[Blur (band)|Blur]]
 
| album          = [[The Great Escape (Blur album)|The Great Escape]]
 
| released      = {{start date|1995|08|14}} (UK)
 
| format        = {{flatlist|
 
* [[CD single|CD]]
 
* [[Gramophone record|7-inch 45{{nbsp}}rpm]]
 
* [[cassette single|cassette]]
 
  }}
 
| recorded      = 1995
 
| genre          = [[Britpop]]
 
| length        = {{duration|m=3|s=57}}
 
| label          = {{flatlist|
 
* [[Food Records|Food]]
 
* [[EMI]]
 
}}
 
| producer      = [[Stephen Street]]
 
| last_single    = "[[To the End (Blur song)|To the End]]"<br />(1994)
 
| this_single    = "'''Country House'''"<br />(1995)
 
| next_single    = "[[The Universal (song)|The Universal]]"<br />(1995)
 
}}
 
 
 
<pre style="overflow:auto;">
 
{{Infobox single
 
| 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          =
 
}}
 
</pre>
 
 
 
==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 "<nowiki>{{Non-free album cover}}</nowiki>"). Enter the file name only into the field: <code><nowiki><Image Name>.jpg</nowiki></code>.
 
;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 and B-side|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 [[A-side and B-side|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 {{tl|Start date}} as <nowiki>{{Start date|YYYY|MM|DD}}</nowiki>, for example "<nowiki>{{Start date|2007|7|31}}</nowiki>". (Use "<nowiki>{{Start date|YYYY|MM}}</nowiki>" if only year and month are known, or "<nowiki>{{Start date|YYYY}}</nowiki>" 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 <code>Studio</code> or <code>Venue</code> 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, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}
 
;Format: The way that the single was originally released; i.e. [[7-inch single]], [[12-inch single]], [[CD single]], [[cassette single]], [[Music download|digital download]] (note the piped download link). Do not use <code>{{!xt|"}}</code> or <code>{{!xt|″}}</code> (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, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}
 
;Genre: The music genre(s) that the single is from. These must not be [[WP:original research|original research]], and should be stated and referenced in a 'Composition' section of the article. Separate multiple values using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}.
 
;Length : The length should use {{Tl|Duration}} thus: <code><nowiki>{{Duration|m=3|s=45}}</nowiki></code>, renders as {{Duration|m=3|s=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 <nowiki>[[Universal Records|Universal]]</nowiki> rather than <nowiki>[[Universal Records]]</nowiki>).
 
;Producer : This field allows display of the song's producer(s). Separate multiple values using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}
 
;ISWC : [[International Standard Musical Work Code]]
 
;Writer : This field allows display of the song's writer(s). Separate multiple values using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}.
 
;Misc : This field allows you to provide more infobox data such as additional chronologies using {{tl|Extra chronology}}, a track listing using {{tl|Extra track listing}}, extra covers using {{tl|Extra album cover}}, or a sample of the music using {{tl|Audiosample}}. Set {{para|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 "{{para|last_single}}" field) should be left blank.
 
* For ''latest'' singles, the right box (the "{{para|next_single}}" field) should be left blank.
 
 
 
By default, the chronology section begins with an "'''''artist'' Chronology'''" header. If you specify the optional "{{mono|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 {{tl|Extra chronology}} template for the other(s).
 
 
 
Wikipedia's [[Wikipedia:Manual of Style (dates and numbers)#Date formatting|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:
 
* "[[Country House]]"
 
* "[[I Want to Hold Your Hand]]"
 
* "[[Smells Like Teen Spirit]]"
 
 
 
{{#ifeq:{{FULLPAGENAME}}|Wikipedia:WikiProject Songs||
 
 
 
== Notes ==
 
{{reflist |refs=
 
<ref name="lists">For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists the use of {{tl|flatlist}} or {{tl|hlist}} is preferred as they offer a benefit to users of screen readers. Vertical lists should always be implemented by {{tl|plainlist}} or {{tl|ubl}} and never by {{tag|br|s}} tags for reasons of [[Wikipedia:Manual of Style/Accessibility#Vertical lists|accessibility]].</ref>
 
}}
 
  
 
==Microformat==
 
==Microformat==
 
{{UF-hcal}}
 
{{UF-hcal}}
}}
+
 
 
==TemplateData==
 
==TemplateData==
 
{{TemplateDataHeader}}
 
{{TemplateDataHeader}}

Revision as of 14:31, 15 June 2017

Template:Merging

Usage

Microformat

Template:UF-hcal

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Infobox single

An Infobox for singles

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
Namename Name

The name of the single.

Default
(PAGENAME)
Stringoptional
Covercover 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}}.

Stringsuggested
Borderborder Border

Set to yes to put a 1 pixel border around the cover image.

Stringoptional
Alt textalt Alt

Alt text for the cover image, to describe it to visually impaired readers.

Stringsuggested
Captioncaption Caption

Caption for the cover image.

Stringoptional
Artistartist Artist

The name of the artist.

Stringrequired
Albumalbum from Album from_album 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]].

Stringsuggested
A-sideA-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.

Stringoptional
B-sideB-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.

Stringoptional
Releasedreleased 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).

Stringsuggested
Recordedrecorded Recorded

This field should include details on when and where the song was recorded. Separate multiple values using {{Plainlist}}.

Stringoptional
Venuevenue Venue

For live recordings, include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate.

Stringoptional
Studiostudio 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}}.

Stringoptional
Formatformat 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}}.

Stringoptional
Genregenre 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}}.

Stringsuggested
Lengthlength Length

The length should use {{Duration}} thus: {{Duration|m=3|s=45}}, renders as 3:45, for 3 minutes 45 seconds

Stringsuggested
Labellabel 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}}.

Stringsuggested
Producerproducer Producer

The song's producer(s). Separate multiple values using {{Flatlist}}.

Stringoptional
ISWCISWC iswc

International Standard Musical Work Code

Example
T-000.000.001-0
Stringoptional
Writerwriter Writer

The song's writer(s). Separate multiple values using {{Flatlist}}.

Stringoptional
Chronologychronology Chronology

Header for chronology section

Default
(Artist name)
Stringoptional
Last single titlelast_single_title Last single title

Title of the previous single in the artist's chronology. Link when appropriate.

Example
[[Relax (song)|Relax]]
Stringoptional
Last single yearlast_single_year Last single year

Year of the previous single in the artist's chronology.

Example
1983
Unknownoptional
Previous singlelast_single Last single

Previous single in the artist's chronology (in quotation marks), above its year of release (in brackets). Link when appropriate.

Example
"[[Relax (song)|Relax]]"<br />(1983)
Stringoptional
This singlethis_single This single

Name (in bold and in quotation marks) and year of this single for the chronology.

Example
"'''Two Tribes'''"<br />(1984)
Stringoptional
Next single titlenext_single_title Next single title

Title of the next single in the artist's chronology. Link when appropriate.

Example
[[The Power of Love (Frankie Goes to Hollywood song)|The Power Of Love]]
Stringoptional
Next single yearnext_single_year Next single year

Year of the next single in the artist's chronology.

Example
1984
Stringoptional
Next singlenext_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».

Example
"[[The Power of Love (Frankie Goes to Hollywood song)|The Power Of Love]]"<br />(1984)
Stringoptional
Miscellaneous datamisc 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.

Stringoptional

Tracking category

See also