Template:Infobox song/doc: Difference between revisions
Content deleted Content added
Johnrdorazio (talk | contribs) m 1 revision imported |
added parameter names example |
||
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 53 ⟶ 55:
== 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 62 ⟶ 66:
| name =
| cover = <!--just the file name-->
| alt =
| type =
| artist =
Line 135 ⟶ 140:
===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")
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 167 ⟶ 176:
===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
===recorded===
Line 176 ⟶ 185:
===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|
===venue===
Line 182 ⟶ 191:
===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
===length===
Line 250 ⟶ 259:
| writer = The Artist
| producer = The Producer
| tracks = {{
}}
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|
{{clear}}
Line 397 ⟶ 406:
<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,
| studio =
*First item
Line 407 ⟶ 416:
|}
</ref>
<ref name="flatlist">For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists
| genre =
*Item one
Line 431 ⟶ 440:
[[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 439 ⟶ 451:
"params": {
"name": {
"label": "Name",
"description": "The name or title of the song.",
Line 450 ⟶ 458:
},
"cover": {
"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": "
"aliases": [
"image"
]
},
"cover_size": {
"label": "Cover_size",
"type": "
"deprecated": "Cover_upright should be used if needed"
},
"alt": {
"label": "Alt",
"description": "Alternative text for the cover image, to describe it to visually impaired readers.",
"type": "
},
"border": {
"label": "Border",
"description": "Set to yes to put a 1 pixel border around the image.",
"type": "
"autovalue": "yes",
"suggestedvalues": [
"yes"
]
},
"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"
},
"type": {
"label": "Type",
"description": "Specify \"song\", \"single\", \"Instrumental\", \"Composition\", etc. This generates the header and color.",
"type": "
"suggested": true,
"suggestedvalues": [
"single",
"song",
"promo",
"demo",
"remix single",
"instrumental",
"composition",
"hymn",
"nursery"
]
},
"artist": {
"label": "Artist",
"description": "The name of the artist.",
Line 520 ⟶ 515:
},
"album": {
"label": "Album",
"description": "The name of the album on which the song originally appeared.",
Line 535 ⟶ 525:
},
"English_title": {
"label": "English title",
"description": "The English translation of the name of the song, if it is in another language.",
"type": "
},
"written": {
"
"description": "The date the song was written; this is usually used for songs created before music publishing or recording",
"type": "
},
"published": {
"
"description": "The date the song was published; this is usually used for songs created before the rise of music recording",
"type": "
},
"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": "
},
"A-side": {
"label": "A-side",
"description": "For singles: the name of A-side of the current or title single.",
Line 583 ⟶ 550:
},
"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 591 ⟶ 555:
},
"recorded": {
"
"description": "The date(s) the song was recorded.",
"type": "
},
"venue": {
"label": "Venue",
"description": "For live recordings, include the name of the venue (concert hall, stadium, etc.) and location.",
Line 607 ⟶ 565:
},
"studio": {
"label": "Studio",
"description": "If the song was recorded in a recording studio, enter the name and location.",
Line 615 ⟶ 570:
},
"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 624 ⟶ 576:
},
"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 632 ⟶ 581:
},
"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 640 ⟶ 586:
},
"writer": {
"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"
},
"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 659 ⟶ 596:
},
"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 \"
"type": "string"
},
"language": {
"label": "Language",
"description": "Only if the song is not in English, indicate the language.",
Line 675 ⟶ 606:
},
"producer": {
"label": "Producer",
"description": "The person(s) who is credited with the record production.",
Line 683 ⟶ 611:
},
"chronology": {
"label": "Chronology (artist)",
"description": "For singles: Replacement of artist's name for the chronology section.",
"type": "string"
},
"prev_title": {
Line 737 ⟶ 661:
},
"tracks": {
"label": "Tracks",
"description": "To add a full-album track listing.",
"type": "string"
},
"
"label": "
"description": "To add extra subtemplates, such as {{Extra chronology}}, {{Extra track listing}}, {{Extra album cover}}, {{Audio sample}}, etc.",
"
},
"
"label": "
"type": "number"
},
"
"
},
"
"
},
"
"
}
},
Line 798 ⟶ 689:
"cover",
"cover_size",
"cover_upright",
"alt",
"border",
Line 833 ⟶ 725:
"next_year",
"tracks",
"misc",
"
"
"
],
"format": "{{_\n| _____________ = _\n}}\n"
}
</templatedata>
Line 850 ⟶ 736:
== Tracking categories ==
* {{clc|Pages using infobox song with unknown parameters}}
* {{clc|Song articles with missing songwriters}}
* {{clc|Song articles with both composer and songwriter}}
| |||