Template:Infobox song/doc: Difference between revisions

Content deleted Content added
No edit summary
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 47:
Articles about [[wikipedia:song|song]]s often include an [[wikipedia:infobox|infobox]] that provides an overview or summary of the song. Generally, Infobox song is oriented more towards recorded music that has been commercially released. Other infoboxes, such as {{tl|Infobox musical composition}} and {{tl|Infobox anthem}} may be better suited to traditional or historical songs. The examples to the right are the infobox filled in with the most commonly used parameters.
 
An infobox provides [[wikipedia:WP:INFOBOXPURPOSE|key facts]] as discussed in the article—it should not be too detailed or take up too much of the article space. It should only contain items, such as genres or songwriters, that are discussed in the article (or have [[wikipedia:WP:CITE|citation]]s to [[wikipedia:WP:RS|reliable source]]s).
 
The code below can be copied and completed with information pertaining to particular song articles. The Parameters section provides guidance on using the fields.
Line 123:
== Parameters ==
===name===
The title of the song. If not provided, the template uses the {{tl|PAGENAMEBASE}} of the page. Since it is not linked, [[wikipedia:WP:DAB|disambiguation]] terms, such as {{nowrap|"(song)"}}, {{nowrap|"(Beyoncé song)"}}, etc., are not needed.
 
===cover===
Add an image of a sheet music cover, picture sleeve, or other image appropriate for the song. First, one must be uploaded (see [[wikipedia:Wikipedia:Uploading images|Uploading images]] for details). Then, enter the file name (without File:) into the field, such as <code>[Image Name].jpg</code>.
 
===alt===
Use this field to provide alternative text or a description of the cover image for visually impaired readers. See [[wikipedia:WP:ALT|WP:ALT]].
 
===caption===
If there is an image, a suitable caption may be added that follows [[wikipedia:MOS:CAPTION|MOS:CAPTION]] (begins with a capital letter, no period at end if it is a sentence fragment, etc.) Please note that if the image is ''unambiguously'' a picture sleeve or record label for the release that is described in the infobox, then it is "self-captioning", and no caption needs to be entered in this parameter.
 
===type===
Specify "single", "instrumental", "composition", "promo", etc., as shown in the code table below. The entry will be automatically linked to the corresponding article, so only the unlinked code is needed (the default is "song"). If an album track was later released as a single, '''use the most notable or best known'''. For example, "[[wikipedia:Stairway to Heaven|Stairway to Heaven]]" was released as a promo single in several markets and as a digital single in 2007, but became best known as a song from Led Zeppelin's fourth album. This field is used to generate the header and color; please note that it is not used for genre, which is described in the {{para|genre}} fields.
{{left|{{Infobox song/doc/type|color=Color|link=Link}}}}
{{clear}}
 
===artist===
If the article associates the original or primary rendition of the song with one artist, enter the name of the artist and link if they have a WP article. For band names that begin with "The", enter the lower case "the" ({{para|artist|the Beatles}}, rather than {{para|artist|The Beatles}}), consistent with [[wikipedia::MOS:THEMUSIC|:MOS:THEMUSIC]]. For traditional or historical songs, when the focus is not on a particular rendition, this should be left blank (alternatively, consider using [[Template:Infobox musical composition]]).
 
===album===
If the song was first released on an album, enter the name of the album and link. The template will italicize the album name and produce "from the album <var>Name</var>" in the header. If the song was originally released as a single '''well in advance''' of the album, {{para|album}} should not be used, since it is not ''from the album'', but later added to one. For example, "[[wikipedia:Beck's Bolero|Beck's Bolero]]" and "[[wikipedia:Back on the Chain Gang|Back on the Chain Gang]]" were released as singles about 16 months before they were added to albums and became well-known before the albums.
 
===EP===
If the song was first released on an EP or [[wikipedia:Extended play|Extended play]], add the EP name in this field. The name will be italicized, etc., and should be used as described in the album subsection above. Please note: only album ''or'' EP should be used and depends on which one was issued first.
 
===language===
Line 155:
 
===A-side===
If the article is about a song that was released as a [[wikipedia:A-side and B-side|B-side]] of a single, enter the name of the [[wikipedia:A-side and B-side|A-side]] and link as appropriate (do not use B-side). Quote marks will be added automatically.{{r|quotes}} For multiple entries, see Notes{{r|plainlist}} for details. For [[wikipedia:double A-side|double A-side]]d singles, refer to the [[wikipedia:#Chronology for double-A-side singles|Chronology for double-A-side singles]] section below.
 
===B-side===
Line 164:
 
===published===
The year the song was [[wikipedia:Music publisher (popular music)|published]] also may be included, if discussed in the article. This usually refers to [[wikipedia:Music publisher (sheet music)|sheet music published]] before the rise of music recording.
 
===released===
Line 176:
 
===studio===
If the song was recorded in a '''recording studio''', enter the name and location. Link the studio, but not well-known cities, states, or countries (see [[wikipedia:WP:OVERLINK|WP:OVERLINK]]). Remove "Studios" if it appears in the name – use <nowiki>[[wikipedia:Sound City Studios|Sound City]]</nowiki> rather than <nowiki>[[wikipedia:Sound City Studios|Sound City Studios]]</nowiki>. For multiple entries, see Notes{{r|flatlist}} for details. For "United States" and "United Kingdom", it is preferred that they be abbreviated "U.S." and "UK", but political subdivisions should never be (never "MA" for "Massachusetts", "ON" for "Ontario", etc.). See Notes{{r|location}} for details.
 
===venue===
Line 182:
 
===genre===
The field should include the music genre(s) that best describes the song. It should come from a [[wikipedia:WP:RS|reliable source]] and also '''be stated and referenced''' in the body of the article; personal opinions or [[wikipedia:WP:original research|original research]] must be not be included. Note that most genres are not proper nouns and should not be capitalized. However, the first word in a list of multiple genres should be capitalized. For multiple entries, see Notes{{r|flatlist}} for details.
 
===length===
Line 188:
 
===label===
The name of the '''record company''' that issued the release may be included here. Generally, add later releases, those from different countries, reissues, etc., in the body of article instead of the infobox. Remove "Records" if it appears in the name – use <nowiki>[[wikipedia:Universal Records|Universal]]</nowiki> instead of <nowiki>[[wikipedia:Universal Records|Universal Records]]</nowiki>. For multiple entries, see Notes{{r|flatlist}} for details.
 
===writer===
Use this field if the '''music''' ''and'' '''lyrics''' were written by one person or, in the case of multiple writers, where a separate lyricist and composer have not been clearly identified by a [[wikipedia:WP:RS|reliable source]]. Do not use this field if the {{para|composer}} and {{para|lyricist}} fields are used. For multiple entries, see Notes{{r|flatlist}} for details.
 
===composer===
Line 201:
===producer===
<!-- See RfC WT:ALBUMS 15 January 2020 -->
Enter the name of the person(s) credited as the actual [[wikipedia:record producer|record producer]](s). Do not include those listed as executive, co-, additional, vocal, etc., producers, unless a reliable source identifies their contribution as substantially the same as the main producers. These should be included in the article body or track listings rather than be listed here. For multiple entries, see Notes{{r|flatlist}} for details.
 
===chronology===
This field and the following {{para|prev_title}} and {{para|next_title}} display the artist's immediate singles chronology. By leaving it blank, "The Artist singles chronology" is automatically displayed if any of the following fields are used. An '''alternative header''' may be displayed before the automatically produced "chronology", for example, <code>The Artist American</code>, <code>The Artist UK singles</code>, etc., produces "The Artist American chronology", "The Artist UK singles chronology", etc. Please note: if this field is used and a track listing is also wanted, it must be added using {{tl|Extra track listing}}.
 
If {{para|chronology}} is blank, the first (English) letter of the artist name given in {{para|artist}} is automatically capitalized in the chronology header, so that band names starting with "The" appear as recommended in the [[wikipedia:MOS:THEMUSIC|Manual of Style]]. If the first letter of the artist's name is stylized in lower case, or if the first letter in the artist's name is not part of the English alphabet, enter the artist's name in {{para|chronology}} as you wish it to appear. For example:
* {{para|artist|[[wikipedia::letlive.|:letlive.]]}} should use {{para|chronology|[[wikipedia::letlive.|:letlive.]]}} for it to also appear there in lower case.
* {{para|artist|[[wikipedia:Édith Piaf|Édith Piaf]]}} should use {{para|chronology|[[wikipedia:Édith Piaf|Édith Piaf]]}} to prevent the letter "d" (the first English letter) from appearing in upper case.
 
===prev_title===
Enter the name of the artist's previous single. Quote marks will be added automatically;{{r|quotes}} link it if there is a WP article. Leave this blank if the artist has no previous single. For [[wikipedia:double A-side|double A-side]]d singles, refer to the [[wikipedia:#Chronology for double-A-side singles|Chronology for double-A-side singles]] section below.
 
===prev_year===
Enter only the year the previous single was released. Following the WP [[wikipedia:Wikipedia:Manual of Style (dates and numbers)#Date formatting|date style guidelines]], years should not be linked within the chronology section. Leave this field blank if there is no previous single.
 
===next_title===
Line 229:
 
==Track listing examples==
Not all infoboxes should include album track listings. Articles about traditional or historical songs might not focus on a particular recording, so details about a later rendition, including album releases, are inappropriate for an infobox. Additionally, there may already be an album track listing with links to other songs in a [[wikipedia:WP:NAV|navigation template]] or [[wikipedia:WP:NAVBOX|navbox]] at the end of the article. These include an album navbox (for example, {{tl|Thriller (album)}}), an artist song navbox ({{tl|Rihanna songs}}), or an artist navbox that includes songs ({{tl|Robert Johnson}}).
An album track listing may be added to infobox song as long as the following criteria are met: 1) <strong>the article does not have a navbox in which the song appears</strong>; and 2) a majority of the album's songs are linked to WP articles. Currently, three different approaches to listing album tracks are found in infobox song.
Line 243:
| released = {{Start date|{{#expr:{{#time:Y}}-1}}|04|01}}
| recorded = January 1–10, {{#expr:{{#time:Y}}-1}}
| studio = [[wikipedia:Record Plant|Record Plant]], New York City
| venue =
| genre = [[wikipedia:Contemporary R&B|Contemporary R&B]]
| length = 3:01
| label = [[wikipedia:Columbia Records|Columbia]]
| writer = The Artist
| producer = The Producer
Line 268:
| released = {{Start date|{{#expr:{{#time:Y}}-1}}|04|01}}
| recorded = January 1–10, {{#expr:{{#time:Y}}-1}}
| studio = [[wikipedia:Record Plant|Record Plant]], New York City
| venue =
| genre = [[wikipedia:Contemporary R&B|Contemporary R&B]]
| length = 3:01
| label = [[wikipedia:Columbia Records|Columbia]]
| writer = The Artist
| producer = The Producer
Line 279:
| text =
'''Side one'''
# "[[wikipedia:21st Century Schizoid Man|21st Century Schizoid Man]]"
# "[[wikipedia:I Talk to the Wind|I Talk to the Wind]]"
# "[[wikipedia:Epitaph (King Crimson song)|Epitaph]]"
'''Side two'''
# "[[wikipedia:Moonchild (King Crimson song)|Moonchild]]"
# "[[wikipedia:The Court of the Crimson King|The Court of the Crimson King]]"
}}
}}
Line 290:
A second option does not require a separate album track listing sub-template to be created. Instead, the {{tl|Hidden}} template is placed directly into the infobox in the {{para|tracks}} field, then the tracks are listed. This may be copied and added to other songs infoboxes from the same album.
 
The example to the right uses this approach. To see its use in actual infoboxes, click on the song titles. Also, please note that if a singles chronology is also used in the infobox ({{para|prev_title}}, etc.), {{tl|Extra track listing}} must be used in the {{para|misc}} field (refer to that [[wikipedia:Template:Extra track listing#Usage|Template:Extra track listing#Usage]] for the code and explanation).
 
'''Code'''
Line 309:
;text
:In this field, add the album tracks, using <code>#</code> to generate a sequential numbering. The song titles should be in "quotes", with the article track also in <strong>bold</strong>. Link any track that has its own WP article, except for when the song is the subject of the article.
:For multi-disc [[wikipedia:Compact Disc Digital Audio|CD]]s, subheadings for "Disc one", "Disc two", etc. may be included. Similarly, subheadings such as "Side one" or "Side A" may be added for [[wikipedia:LP record|LP record]]s and [[wikipedia:Extended play|EPs]]. To ensure that the track numbering continues sequentially after a subheading (rather than starting again at "1"), use <code><nowiki><li value="x"></nowiki></code> where "x"=the next track number.
 
'''Code'''
Line 338:
| artist = the Artist
| album = That Album
| A-side = "Other Side" ([[wikipedia:double A-side|double A-side]])
| released = {{Start date|{{#expr:{{#time:Y}}-1}}|04|01}}
| recorded = January 1–10, {{#expr:{{#time:Y}}-1}}
| studio = [[wikipedia:Record Plant|Record Plant]], New York City
| venue =
| genre = [[wikipedia:Contemporary R&B|Contemporary R&B]]
| length = 3:01
| label = [[wikipedia:Columbia Records|Columbia]]
| writer = The Artist
| producer = The Producer
Line 407:
|}
</ref>
<ref name="flatlist">For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists the use of the <code>class=hlist</code> is preferred as it offers a benefit to users of screen readers (see [[Wikipedia:Accessibility|Accessibility]] for more information on [[wikipedia:Web Content Accessibility Guidelines|Web Content Accessibility Guidelines]]). To use it, format the items as a normal bulleted list; don't use other list templates or <nowiki><br/></nowiki>. For example:<pre>
| genre =
*Item one
Line 421:
|}
</ref>
<ref name="location">As per RfC "Naming countries in infoboxes": When identifying a location, city or region in the United States or United Kingdom, the preferred approach is to use the country abbreviations allowed by [[wikipedia:MOS:ACRO|MOS:ACRO]], such as "Portsmouth, New Hampshire, U.S." and "Cardiff, Wales, UK", rather than spelling out the full country name. Avoid using abbreviations for states or provinces in all nations. {{xt|New Hampshire}} rather than {{!xt|NH}}, {{xt|New South Wales}} rather than {{!xt|NSW}}, or {{xt|British Columbia}} rather than {{!xt|BC}} (see [[wikipedia:MOS:POSTABBR|MOS:POSTABBR]]). Cities such as New York City and London may be rendered as "New York City, U.S." and "London, UK" or simply "New York City" and "London". Also, these should not be linked when the context makes it clear (see [[wikipedia:MOS:OVERLINK|MOS:OVERLINK]]). If only the country name is included, it may be written out in full.
</ref>
|}
Line 427:
 
{{When on basepage|
[[wikipedia:Category:Music infobox templates|Song]]
[[wikipedia:Category:WikiProject Songs templates|Category:WikiProject Songs templates]]
[[wikipedia:Category:Templates that add a tracking category|Category:Templates that add a tracking category]]
}}
 
Line 863:
 
== See also ==
* [[wikipedia:Wikipedia:WikiProject Songs|WikiProject Songs]]
* {{tl|Infobox album}}