Seeds of the Word

Template:Infobox song/doc: Difference between revisions

Browse history interactively
← Older editNewer edit →
Content deleted Content added
VisualWikitext
added parameter names example
No edit summary
Line 1:
{{documentation subpage}}
{{#ifeq:{{SUBPAGENAME}}|sandbox||{{High-use}}}}
{{Music infobox header}}
{{Auto short description}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:String|Module:Check for unknown parameters}}
 
Line 16 ⟶ 14:
| 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 39 ⟶ 37:
| recorded = January 1–10, {{#expr:{{#time:Y}}-1}}
| studio =
| venue = [[wikipedia:Madison Square Garden|Madison Square Garden]]
| genre = [[wikipedia:Contemporary R&B|Contemporary R&B]]
| length = 3:01
| label = [[wikipedia:Columbia Records|Columbia]]
| composer = Another Artist
| lyricist = The Artist
| producer = The Producer
}}
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 [[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 [[WP:CITE|citation]]s to [[WP:RS|reliable source]]s).
Line 55 ⟶ 53:
 
== Code ==
{{Parameter names example |name | cover | cover_size | cover_upright | alt | border | caption | type | artist | album | EP | language | English_title | A-side | B-side | written | published | released | recorded | studio | venue | genre | length | label | writer | composer | lyricist | producer | chronology | prev_title | prev_title2 | prev_year | title | title2 | year | next_title | next_title2 | next_year | tracks | misc | original_artist | from_album | __µ}}
 
The first template code below includes the most commonly used infobox parameters. If there is no information in the article to support the field, leave it blank. Remove the <code><nowiki><!--</nowiki></code> and <code><nowiki>--></nowiki></code> to use the {{tl|Start date}} and {{tl|Duration}} subtemplates.
 
Line 66 ⟶ 62:
| name =
| cover = <!--just the file name-->
| alt =
| type =
| artist =
Line 140 ⟶ 135:
 
===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, "[[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.
 
A song that is called a "single" by sources, even if the song was not released as part of a single, may be classified as a "single".
 
If an album track was later released as a single, '''use the most notable or best known'''. For example, "[[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.
{{left|{{Infobox song/doc/type|color=Color|link=Link}}}}
{{clear}}
Line 176 ⟶ 167:
 
===released===
Indicate the commercial release date, whether it is a single, album, or other. Usually, this is the date that it became widely available to the public, such as in retail. Dates for leaked copies, advance or limited promo releases to radio stations, etc., generally are not used, but may be included in an appropriate section of the main body if noteworthy. For example, album tracks that receive airplay should use the album release date, rather than when they were added to radio. If the same song is later released as an actual single and that becomes the best known (and {{para|type|single}} is used), indicate the date the single was released. Enter the date using {{tl|Start date}}. For example, use <code><nowiki>{{Start date|YYYY|MM|DD}}</nowiki></code> for the complete date, <code><nowiki>{{Start date|YYYY|MM}}</nowiki></code> if only year and month are known, or <code><nowiki>{{Start date|YYYY}}</nowiki></code> for just a year. For multiple entries, see Notes{{r|plainlist}} for details. Generally, later releases or in secondary markets, reissues, on compilations, etc., should only be included in the body of the article.
 
===<del>format</del>===
The format parameter has been removed as a result of [[Templatethe talk:InfoboxJuly–August song/Archive2020 8#Formattalk section|a 2020page discussion]]. Any information entered in {{para|format}} will not be displayed.
 
===recorded===
Line 185 ⟶ 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 [[WP:OVERLINK]]). Remove "Studios" if it appears in the name – use <nowiki>[[Sound City Studios|Sound City]]</nowiki> rather than <nowiki>[[Sound City Studios]]</nowiki>. For multiple entries, see Notes{{r|plainlistflatlist}} 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 191 ⟶ 182:
 
===genre===
The field should include the music genre(s) that best describes the song. It should come from a [[WP:RS|reliable source]] and also '''be stated and referenced''' in the body of the article; personal opinions or [[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 259 ⟶ 250:
| writer = The Artist
| producer = The Producer
| tracks = {{AstralRumours Weeks track listingtracks}}
}}
 
If a separate album track listing sub-template has been created, it may be added to the {{para|tracks}} of the infobox. Using such a template may be more convenient for multi-disc albums or those with many tracks. A header with the album name will be automatically generated, along with the number of tracks. The song title will not be linked, but will appear in <strong>bold</strong>.
 
The example to the right uses {{tl|AstralRumours Weeks track listingtracks}} to demonstrate. To see its use in actual song infobox, click on the song links. Please note, 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 [[Template:Extra track listing#Usage]] for the code and explanation).
{{clear}}
 
Line 406 ⟶ 397:
<ref name="quotes">If any details besides the actual song title (country, etc.) are added, quote marks need to be added manually to the song title. Additionally, for {{para|A-side}} and {{para|B-side}}, quote marks need to be added for each title if there is more than one.
</ref>
<ref name="plainlist"> For multiple entries, formatthis parameter uses <code>class=plainlist</code>. Format the items as a normal bulleted list; don't use other list templates or <nowiki><br/></nowiki>. For example:<pre>
| studio =
*First item
Line 416 ⟶ 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]] for more information on [[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 440 ⟶ 431:
[[Category:Templates that add a tracking category]]
}}
 
==Short description==
This template generates an automatic short description of the form {{tq|YYYY [type] by [artist]}} under certain conditions, when it appears once in an article in the lead, {{para|artist}} is defined, and {{property|P577}} is defined on Wikidata. A manually entered short description will override the automatic one. If an article can generate a satisfactory automatic description, any preexisting manual description may be deleted.
 
==TemplateData==
Line 451 ⟶ 439:
"params": {
"name": {
"aliases": [
"Name",
"title"
],
"label": "Name",
"description": "The name or title of the song.",
Line 458 ⟶ 450:
},
"cover": {
"aliases": [
"Cover",
"image"
],
"label": "Cover",
"description": "An appropriate image, such as a sheet music or single picture sleeve cover.",
"example": "A file name, without the File: <NAME.jpg>",
"type": "wiki-file-namestring",
"aliases": [
"image"
]
},
"cover_size": {
"aliases": [
"Cover size",
"cover size"
],
"label": "Cover_size",
"type": "numberstring",
"deprecated": "Cover_upright should be used if needed"
},
"alt": {
"aliases": [
"Alt"
],
"label": "Alt",
"description": "Alternative text for the cover image, to describe it to visually impaired readers.",
"type": "linestring"
},
"border": {
"aliases": [
"Border"
],
"label": "Border",
"description": "Set to yes to put a 1 pixel border around the image.",
"type": "linestring",
"autovalue": "yes",
"suggestedvalues": [
"yes"
]
},
"caption": {
"aliases": [
"Caption"
],
"label": "Caption",
"description": "Caption for the image; this will overwrite automatically generated <\"Song\" cover> when a file is added to the \"caption\" field",
"example": "Sheet music cover, 1920.",
"type": "string"
},
"comment": {
"aliases": [
"Comment"
],
"label": "Comment",
"type": "string",
"deprecated": "This parameter is no longer used."
},
"type": {
"aliases": [
"Type"
],
"label": "Type",
"description": "Specify \"song\", \"single\", \"Instrumental\", \"Composition\", etc. This generates the header and color.",
"type": "linestring",
"suggested": true,
"suggestedvalues": [
"single",
"song",
"promo",
"demo",
"remix single",
"instrumental",
"composition",
"hymn",
"nursery"
]
},
"artist": {
"aliases": [
"Artist",
"original_artist"
],
"label": "Artist",
"description": "The name of the artist.",
Line 515 ⟶ 520:
},
"album": {
"aliases": [
"Album",
"from_album",
"from Album"
],
"label": "Album",
"description": "The name of the album on which the song originally appeared.",
Line 525 ⟶ 535:
},
"English_title": {
"aliases": [
"english_title"
],
"label": "English title",
"description": "The English translation of the name of the song, if it is in another language.",
"type": "linestring"
},
"written": {
"labelaliases": "Written (date)",[
"Written"
],
"label": "Written",
"description": "The date the song was written; this is usually used for songs created before music publishing or recording",
"type": "datestring"
},
"published": {
"labelaliases": "Published (date)",[
"Published"
],
"label": "Published",
"description": "The date the song was published; this is usually used for songs created before the rise of music recording",
"type": "datestring"
},
"released": {
"labelaliases": "Released (date)",[
"Released"
],
"label": "Released",
"description": "For recorded music: The earliest known date of commercial release, using a single occurrence, using {{Start date}}. For April 1, 2015, enter {{Start date|2015|04|01}}.",
"type": "datestring"
},
"format": {
"aliases": [
"Format"
],
"label": "Format",
"type": "string",
"deprecated": "No longer used."
},
"A-side": {
"aliases": [
"a-side"
],
"label": "A-side",
"description": "For singles: the name of A-side of the current or title single.",
Line 550 ⟶ 583:
},
"B-side": {
"aliases": [
"b-side"
],
"label": "B-side",
"description": "For singles: the name of the B-side of the current or title single. Only one of the fields 'A-side' or 'B-side' should be used.",
Line 555 ⟶ 591:
},
"recorded": {
"labelaliases": "Recorded (date)",[
"Recorded"
],
"label": "Recorded",
"description": "The date(s) the song was recorded.",
"type": "datestring"
},
"venue": {
"aliases": [
"Venue"
],
"label": "Venue",
"description": "For live recordings, include the name of the venue (concert hall, stadium, etc.) and location.",
Line 565 ⟶ 607:
},
"studio": {
"aliases": [
"Studio"
],
"label": "Studio",
"description": "If the song was recorded in a recording studio, enter the name and location.",
Line 570 ⟶ 615:
},
"genre": {
"aliases": [
"Genre"
],
"label": "Genre",
"description": "The genre(s) that best describes the song. This must not be original research, and should be stated and referenced in the article.",
Line 576 ⟶ 624:
},
"length": {
"aliases": [
"Length"
],
"label": "Length",
"description": "The length of the song, using {{Duration}}. To display 3 minutes 45 seconds as 3:45, enter {{Duration|m=3|s=45}}.",
Line 581 ⟶ 632:
},
"label": {
"aliases": [
"Label"
],
"label": "Label",
"description": "The record company label which originally released the recording. Releases in other territories, different formats, reissues, etc., should be included in the body of the article, not in this field.",
Line 586 ⟶ 640:
},
"writer": {
"aliases": [
"Writer",
"songwriter",
"Songwriter"
],
"label": "Songwriter/Writer",
"description": "The name of the person(s) credited with writing both the music and lyrics for the song. Where a separate lyricist and composer have been clearly identified by a reliable source, use the \"composer\" and \"lyricist\" fields instead.",
"type": "string",
"suggested": true
},
"composer": {
"aliases": [
"Composer"
],
"label": "Composer",
"description": "The name of the person(s) who composed the song's music, if different than the lyricist. If not differentiated in the article, use the \"songwriter/writer\" field instead.",
Line 596 ⟶ 659:
},
"lyricist": {
"aliases": [
"Lyricist"
],
"label": "Lyricist",
"description": "The person(s) who wrote the lyrics, if different than the song's composer. If not differentiated in the article, use the \"songwritersongwiter/writer\" field instead.",
"type": "string"
},
"language": {
"aliases": [
"Language"
],
"label": "Language",
"description": "Only if the song is not in English, indicate the language.",
Line 606 ⟶ 675:
},
"producer": {
"aliases": [
"Producer"
],
"label": "Producer",
"description": "The person(s) who is credited with the record production.",
Line 611 ⟶ 683:
},
"chronology": {
"aliases": [
"label": "Chronology (artist)",
"Chronology"
"description": "For singles: Replacement of artist's name for the chronology section.",
],
"type": "string"
"label": "Chronology",
"description": "For singles: Header for the chronology section.",
"type": "string",
"default": "(Artist name) singles chronology"
},
"prev_title": {
Line 661 ⟶ 737:
},
"tracks": {
"aliases": [
"Tracks"
],
"label": "Tracks",
"description": "To add a full-album track listing.",
"type": "string"
},
"miscprev_track": {
"label": "MiscPrev_track",
"type": "string",
"description": "To add extra subtemplates, such as {{Extra chronology}}, {{Extra track listing}}, {{Extra album cover}}, {{Audio sample}}, etc.",
"typedeprecated": "stringNo longer used."
},
"cover_uprighttrack_no": {
"label": "Cover_uprightTrack_no",
"type": "number",
"deprecated": "No longer used."
},
"original_artistnext_track": {
"deprecatedlabel": true"Next_track",
"type": "string",
"deprecated": "No longer used."
},
"from_albumISWC": {
"deprecatedlabel": true"ISWC",
"type": "string",
"deprecated": "No longer used."
},
"__µprev": {
"deprecatedlabel": true"Prev",
"type": "string",
"deprecated": "No longer used."
},
"prev_no": {
"label": "Prev_no",
"type": "number",
"deprecated": "No longer used."
},
"next": {
"label": "Next",
"type": "string",
"deprecated": "No longer used."
},
"next_no": {
"label": "Next_no",
"type": "number",
"deprecated": "No longer used."
},
"misc": {
"aliases": [
"Misc"
],
"label": "Misc",
"description": "To add extra subtemplates, such as {{Extra chronology}}, {{Extra track listing}}, {{Extra album cover}}, {{Audio sample}}, etc.",
"type": "string"
}
},
Line 689 ⟶ 798:
"cover",
"cover_size",
"cover_upright",
"alt",
"border",
Line 725 ⟶ 833:
"next_year",
"tracks",
"prev_track",
"track_no",
"next_track",
"misc",
"original_artistISWC",
"from_albumcomment",
"__µprev",
"prev_no",
],
"next",
"format": "{{_\n| _____________ = _\n}}\n"
"next_no",
"format"
]
}
</templatedata>
Line 736 ⟶ 850:
 
== Tracking categories ==
* {{clc|Pages using infobox song with deprecated parameters}}
* {{clc|Pages using infobox song with unknown parameters}}
* {{clc|Infobox song with A-side or B-side quote formatting fix needed}}
* {{clc|Song articles with missing songwriters}}
* {{clc|Song articles with both composer and songwriter}}
Retrieved from "https://en.seminaverbi.bibleget.io/wiki/Template:Infobox_song/doc"