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

From blackwiki
Jump to navigation Jump to search
imported>Jc86035
imported>Steel1943
(#REDIRECT Template:Infobox song/doc {{R with history}})
 
(8 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Merging|Infobox song}}
+
#REDIRECT [[Template:Infobox song/doc]]
{{Documentation subpage}}
+
{{R with history}}
{{Music infobox header}}
 
{{High-use| 53000 }}
 
{{Lua|Module:Infobox|Module:InfoboxImage|Module:String|Module:Check for unknown parameters}}
 
 
 
==Usage==
 
{{#ifeq:{{FULLPAGENAME}}|Wikipedia:WikiProject Songs||{{for|non-single songs|Template:Infobox song}}}}
 
 
 
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==
 
{{UF-hcal}}
 
}}
 
==TemplateData==
 
{{TemplateDataHeader}}
 
<templatedata>
 
{
 
"description": {
 
"en": "An Infobox for singles",
 
"de": "Vorlage:Infobox Single"
 
},
 
"params": {
 
"ISWC": {
 
"label": "ISWC",
 
"description": "International Standard Musical Work Code",
 
"example": "T-000.000.001-0",
 
"type": "string",
 
"aliases": [
 
"iswc"
 
]
 
},
 
"name": {
 
"aliases": [
 
"Name"
 
],
 
"label": "Name",
 
"description": "The name of the single.",
 
"type": "string",
 
"default": "(PAGENAME)"
 
},
 
"cover": {
 
"aliases": [
 
"image",
 
"Cover"
 
],
 
"label": "Cover",
 
"description": "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}}.",
 
"type": "string",
 
"suggested": true
 
},
 
"border": {
 
"aliases": [
 
"Border"
 
],
 
"label": "Border",
 
"description": "Set to yes to put a 1 pixel border around the cover image.",
 
"type": "string"
 
},
 
"alt": {
 
"aliases": [
 
"Alt"
 
],
 
"label": "Alt text",
 
"description": "Alt text for the cover image, to describe it to visually impaired readers.",
 
"type": "string",
 
"suggested": true
 
},
 
"caption": {
 
"aliases": [
 
"Caption"
 
],
 
"label": "Caption",
 
"description": "Caption for the cover image.",
 
"type": "string"
 
},
 
"artist": {
 
"aliases": [
 
"Artist"
 
],
 
"label": "Artist",
 
"description": "The name of the artist.",
 
"type": "string",
 
"required": true,
 
"suggested": true
 
},
 
"album": {
 
"aliases": [
 
"from Album",
 
"from_album",
 
"Album"
 
],
 
"label": "Album",
 
"description": "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]].",
 
"type": "string",
 
"suggested": true
 
},
 
"a-side": {
 
"aliases": [
 
"A-side"
 
],
 
"label": "A-side",
 
"description": "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.",
 
"type": "string"
 
},
 
"b-side": {
 
"aliases": [
 
"B-side"
 
],
 
"label": "B-side",
 
"description": "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.",
 
"type": "string"
 
},
 
"released": {
 
"aliases": [
 
"Released"
 
],
 
"label": "Released",
 
"description": "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).",
 
"type": "string",
 
"suggested": true
 
},
 
"recorded": {
 
"aliases": [
 
"Recorded"
 
],
 
"label": "Recorded",
 
"description": "This field should include details on when and where the song was recorded. Separate multiple values using {{Plainlist}}.",
 
"type": "string"
 
},
 
"venue": {
 
"aliases": [
 
"Venue"
 
],
 
"label": "Venue",
 
"description": "For live recordings, include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate.",
 
"type": "string"
 
},
 
"studio": {
 
"aliases": [
 
"Studio"
 
],
 
"label": "Studio",
 
"description": "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}}.",
 
"type": "string"
 
},
 
"format": {
 
"aliases": [
 
"Format"
 
],
 
"label": "Format",
 
"description": "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}}.",
 
"type": "string"
 
},
 
"genre": {
 
"aliases": [
 
"Genre"
 
],
 
"label": "Genre",
 
"description": "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}}.",
 
"type": "string",
 
"suggested": true
 
},
 
"length": {
 
"aliases": [
 
"Length"
 
],
 
"label": "Length",
 
"description": "The length should use {{Duration}} thus: {{Duration|m=3|s=45}}, renders as 3:45, for 3 minutes 45 seconds",
 
"type": "string",
 
"suggested": true
 
},
 
"label": {
 
"aliases": [
 
"Label"
 
],
 
"label": "Label",
 
"description": "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}}.",
 
"type": "string",
 
"suggested": true
 
},
 
"producer": {
 
"aliases": [
 
"Producer"
 
],
 
"label": "Producer",
 
"description": "The song's producer(s). Separate multiple values using {{Flatlist}}.",
 
"type": "string"
 
},
 
"writer": {
 
"aliases": [
 
"Writer"
 
],
 
"label": "Writer",
 
"description": "The song's writer(s). Separate multiple values using {{Flatlist}}.",
 
"type": "string"
 
},
 
"chronology": {
 
"aliases": [
 
"Chronology"
 
],
 
"label": "Chronology",
 
"description": "Header for chronology section",
 
"type": "string",
 
"default": "(Artist name)"
 
},
 
"last_single": {
 
"aliases": [
 
"Last single"
 
],
 
"label": "Previous single",
 
"description": "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)",
 
"type": "string"
 
},
 
"last_single_title": {
 
"aliases": [
 
"Last single title"
 
],
 
"label": "Last single title",
 
"description": "Title of the previous single in the artist's chronology. Link when appropriate.",
 
"example": "[[Relax (song)|Relax]]",
 
"type": "string"
 
},
 
"last_single_year": {
 
"aliases": [
 
"Last single year"
 
],
 
"label": "Last single year",
 
"description": "Year of the previous single in the artist's chronology.",
 
"example": "1983"
 
},
 
"this_single": {
 
"aliases": [
 
"This single"
 
],
 
"label": "This single",
 
"description": "Name (in bold and in quotation marks) and year of this single for the chronology.",
 
"example": "\"'''Two Tribes'''\"<br />(1984)",
 
"type": "string"
 
},
 
"next_single_title": {
 
"aliases": [
 
"Next single title"
 
],
 
"label": "Next single title",
 
"description": "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]]",
 
"type": "string"
 
},
 
"next_single_year": {
 
"aliases": [
 
"Next single year"
 
],
 
"label": "Next single year",
 
"description": "Year of the next single in the artist's chronology.",
 
"example": "1984",
 
"type": "string"
 
},
 
"next_single": {
 
"aliases": [
 
"Next single"
 
],
 
"label": "Next single",
 
"description": "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)",
 
"type": "string"
 
},
 
"misc": {
 
"aliases": [
 
"Misc"
 
],
 
"label": "Miscellaneous data",
 
"description": "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.",
 
"type": "string"
 
}
 
},
 
"format": "block",
 
"paramOrder": [
 
"name",
 
"cover",
 
"border",
 
"alt",
 
"caption",
 
"artist",
 
"album",
 
"a-side",
 
"b-side",
 
"released",
 
"recorded",
 
"venue",
 
"studio",
 
"format",
 
"genre",
 
"length",
 
"label",
 
"producer",
 
"ISWC",
 
"writer",
 
"chronology",
 
"last_single_title",
 
"last_single_year",
 
"last_single",
 
"this_single",
 
"next_single_title",
 
"next_single_year",
 
"next_single",
 
"misc"
 
]
 
}
 
</templatedata>
 
 
 
== Tracking category ==
 
* {{clc|Pages using infobox single with unknown parameters}}
 
* {{clc|Pages using Infobox single with deprecated certification parameter}}
 
 
 
== See also ==
 
* [[Wikipedia:WikiProject Songs]]
 
* {{tl|Infobox song}}
 
 
 
{{basepage subpage|
 
<!-- categories links -->
 
[[Category:Music infobox templates|Single]]
 
[[Category:WikiProject Songs templates]]
 
[[Category:Templates that add a tracking category]]
 
}}
 

Latest revision as of 22:21, 14 December 2018

  • With history: This is a redirect from a page containing substantive page history. This page is kept as a redirect to preserve its former content and attributions. Please do not remove the tag that generates this text (unless the need to recreate content on this page has been demonstrated), nor delete this page.
    • This template should not be used for redirects having some edit history but no meaningful content in their previous versions, nor for redirects created as a result of a page merge (use {{R from merge}} instead), nor for redirects from a title that forms a historic part of Wikipedia (use {{R with old history}} instead).