Template:Track listing/doc: Difference between revisions

Content deleted Content added
m 1 revision imported
m →‎See also: remove redirect
Line 1:
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{#ifeq:{{SUBPAGENAME}}|sandbox||{{High-use}}}}
{{lua|Module:Track listing}}
This template is an optional way to organize track listings in articles about albums and singles. Please refer to [[MOS:VAR]] and [[WP:ALBUMSTYLE#Style and form]] for maintaining existing styles on pages that do nonot currently use this template. Total lengths can be calculated and added automatically, using the [[WP:USERSCRIPT|custom userscript]] at [[User:JPxG/TrackSum.js]].
 
===Usage===
Line 8 ⟶ 9:
{{Track listing
| headline =
| extra_column =
| total_length =
 
| all_writing =
Line 29:
| length1 =
 
| total_length =
...
 
Line 38 ⟶ 39:
{{Track listing
| headline =
| extra_column =
| total_length =
 
| all_writing =
Line 211:
| length20 =
 
| total_length =
...
 
}}
</pre>
{{Collapse bottom}}
 
{{Collapse top|title=Shortened empty template with 20 tracks for copy-pasting}}
<pre style="overflow:auto;">
{{Track listing
| headline =
| extra_column =
 
| all_writing =
| all_lyrics =
| all_music =
 
| title1 =
| length1 =
 
| title2 =
| length2 =
 
| title3 =
| length3 =
 
| title4 =
| length4 =
 
| title5 =
| length5 =
 
| title6 =
| length6 =
 
| title7 =
| length7 =
 
| title8 =
| length8 =
 
| title9 =
| length9 =
 
| title10 =
| length10 =
 
| title11 =
| length11 =
 
| title12 =
| length12 =
 
| title13 =
| length13 =
 
| title14 =
| length14 =
 
| title15 =
| length15 =
 
| title16 =
| length16 =
 
| title17 =
| length17 =
 
| title18 =
| length18 =
 
| title19 =
| length19 =
 
| title20 =
| length20 =
 
| total_length =
}}
</pre>
Line 228 ⟶ 304:
| {{para|extra_column}}
| Used to both enable and set the header for an additional column to hold per-track information. If this option is not used, no extra column will be shown. Use sparingly, in order to keep the overall column count to a minimum and if the respective type of data is not available for most tracks consider using the <code>note</code> fields instead. Some suggested headers: {{kbd|Artist}} ([[Compilation album|compilation]]s), {{kbd|Original artist}} ([[Cover version|cover]] albums), {{kbd|Producer(s)}}, {{kbd|Remixer(s)}} ([[remix album]]s).
|-
| {{para|total_length}}
| Used to display the total length of the record at the bottom of the list. It should be specified in minutes and seconds, even if it is longer than one hour, for example 74:23.
|-
| {{para|all_writing}}<br />{{para|all_lyrics}}<br />{{para|all_music}}
Line 258 ⟶ 331:
| {{para|collapsed}}
| {{strongbad|Deprecated}}. Including this parameter with the value {{var|yes}} ({{para|collapsed|yes}}) will cause the track listing table to start out collapsed. This was intended for very long lists or pages with several lists. {{strong|Do not use this in mainspace}} (articles), per [[MOS:DONTHIDE]] and [[MOS:ACCESSIBILITY]]. Doing so breaks all of the following: 1) in-page searching, 2) screen readers, 3) mobile accessibility to the content, 4) browsers without Javascript (or with it temporarily disabled), 5) various [[WP:REUSE|reuse]] of Wikipedia content. Use of this category will added the article to [[:Category:Track listings that use the collapsed parameter]]. [[Template talk:Track listing/Archive 13|Consensus was to remove this feature in 2014]].
|-
| {{para|total_length}}
| Used to display the total length of the record at the bottom of the list. It should be specified in minutes and seconds, even if it is longer than one hour, for example 74:23. This can be calculated manually, or inserted automatically with one click if you install the [[WP:USERSCRIPT|custom userscript]] at [[User:JPxG/TrackSum.js]].
|}
 
===Examples===
====''[[The Beatles (album)|The Beatles]]'' ("the White Album") by [[the Beatles]]====
The ''headline'' option, general songwriting credits:
 
{{Track listing
| headline = Side one
| extra_column = Lead vocals
 
| title1 = [[Back in the U.S.S.R.]]
| all_writing = [[Lennon–McCartney]], except where noted
| extra1 = McCartney
 
| length1 = 2:43
| title1 = [[Back in the U.S.S.R.]]
| title2 = [[Dear Prudence]]
| length1 = 2:43
| extra2 = Lennon
 
| length2 = 3:56
| title2 = [[Dear Prudence]]
| title3 = [[Glass Onion]]
| length2 = 3:56
| extra3 = Lennon
 
| length3 = 2:18
| title3 = [[Glass Onion]]
| title4 = [[Ob-La-Di, Ob-La-Da]]
| length3 = 2:17
| extra4 = McCartney
 
| length4 = 3:08
| title4 = [[Ob-La-Di, Ob-La-Da]]
| title5 = [[Wild Honey Pie]]
| length4 = 3:08
| extra5 = McCartney
 
| length5 = 0:52
| title5 = [[Wild Honey Pie]]
| title6 = [[The Continuing Story of Bungalow Bill]]
| length5 = 0:52
| extra6 = Lennon, with [[Yoko Ono]]
 
| length6 = 3:14
| title6 = [[The Continuing Story of Bungalow Bill]]
| title7 = [[While My Guitar Gently Weeps]]
| length6 = 3:13
| note7 = [[George Harrison]]
 
| extra7 = Harrison
| title7 = [[While My Guitar Gently Weeps]]
| length7 = 4:45
| note7 = [[George Harrison]]
| title8 = [[Happiness Is a Warm Gun]]
| length7 = 4:45
| extra8 = Lennon
 
| length8 = 2:47
| title8 = [[Happiness Is a Warm Gun]]
| length8 total_length = 223:43
}}
{{Track listing
| headline = Side two
| extra_column = Lead vocals
 
| title9 title1 = [[Martha My Dear]]
| extra1 = McCartney
| length9 = 2:28
| length1 = 2:28
 
| title10 title2 = [[I'm So Tired]]
| extra2 = Lennon
| length10 = 2:03
| length2 = 2:03
 
| title11 title3 = [[Blackbird (Beatles song)|Blackbird]]
| extra3 = McCartney
| length11 = 2:18
| length3 = 2:18
 
| title12 title4 = [[Piggies]]
| note12 note4 = Harrison
| extra4 = Harrison
| length12 = 2:04
| length4 = 2:04
 
| title13 title5 = [[Rocky Raccoon]]
| extra5 = McCartney
| length13 = 3:32
| length5 = 3:33
 
| title14 title6 = [[Don't Pass Me By]]
| note14 note6 = [[Ringo Starr|Richard Starkey]]
| extra6 = Starr
| length14 = 3:50
| length6 = 3:51
 
| title15 title7 = [[Why Don't We Do It in the Road?]]
| extra7 = McCartney
| length15 = 1:40
| length7 = 1:41
 
| title16 title8 = [[I Will]]
| extra8 = McCartney
| length16 = 1:45
| length8 = 1:46
 
| title17 title9 = [[Julia (Beatles song)|Julia]]
| extra9 = Lennon
| length17 = 2:54
| length9 = 2:57
| total_length = 22:41
}}
{{Track listing
| headline = Side three
| extra_column = Lead vocals
 
| title1 = [[Birthday (Beatles song)|Birthday]]
| extra1 = McCartney with Lennon
| length1 = 2:42
| length1 = 2:42
 
| title2 = [[Yer Blues]]
| extra2 = Lennon
| length2 = 4:00
| length2 = 4:01
 
| title3 = [[Mother Nature's Son]]
| extra3 = McCartney
| length3 = 2:47
| length3 = 2:48
 
| title4 = [[Everybody's Got Something to Hide Except Me and My Monkey]]
| extra4 = Lennon
| length4 = 2:24
| length4 = 2:24
 
| title5 = [[Sexy Sadie]]
| extra5 = Lennon
| length5 = 3:15
| length5 = 3:15
 
| title6 = [[Helter Skelter (song)|Helter Skelter]]
| extra6 = McCartney
| length6 = 4:29
| length6 = 4:30
 
| title7 = [[Long, Long, Long]]
| note7 = Harrison
| extra7 = Harrison
| length7 = 3:03
| length7 = 3:08
| total_length = 22:48
}}
{{Track listing
| headline = Side four
| extra_column = Lead vocals
 
| title8 title1 = [[Revolution (Beatles song)#Revolution 1|Revolution 1]]
| extra1 = Lennon
| length8 = 4:15
| length1 = 4:15
 
| title9 title2 = [[Honey Pie]]
| extra2 = McCartney
| length9 = 2:40
| length2 = 2:41
 
| title10 title3 = [[Savoy Truffle]]
| note10 note3 = Harrison
| extra3 = Harrison
| length10 = 2:54
| length3 = 2:54
 
| title11 title4 = [[Cry Baby Cry]]
| extra4 = Lennon, with McCartney
| length11 = 3:02
| length4 = 3:02
 
| title12 title5 = [[Revolution 9]]
| extra5 = Speaking from Lennon, Harrison, Ono and George Martin
| length12 = 8:13
| length5 = 8:15
 
| title13 title6 = [[Good Night (Beatles song)|Good Night]]
| extra6 = Starr
| length13 = 3:11
| length6 = 3:14
| total_length = 24:21
}}
 
Line 477 ⟶ 559:
| length1 = 4:25
 
| title2 = [[Ready Steady Go (L'Arc-en-Ciel song)|Ready Steady Go]]
| lyrics2 = Hyde
| music2 = [[Tetsuya (musician)|Tetsu]]
Line 617 ⟶ 699:
 
===Tracking categories===
* {{clc|Pages using track listing with unknown parameters}}
* {{clc|Track listings that use the collapsed parameter}}
* {{clc|Track listings with deprecated parameters}}
* {{clc|Track listings with input errors}}
 
Previously this template used the parameters <code>writing_credits</code>, <code>lyrics_credits</code> and <code>music_credits</code> to determine which of the Writer(s), Lyrics, and Music columns to display. These parameters are now deprecated, and pages using them are categorized in [[:Category:Track listings with deprecated parameters]].
Line 624 ⟶ 708:
===See also===
* {{tl|Infobox album}}
* {{tl|Infobox single}}
* {{tl|Infobox song}}
 
===TemplateData===
 
{{TemplateData header}}
 
{{collapse top|Show TemplateData}}
<templatedata>
{{Format TemplateData|header=0|JSON=
{
"params": {
Line 740 ⟶ 821:
"label": "Title 2",
"description": "Title of track 2.",
"type": "line",
"suggested": true
},
"note2": {
Line 751 ⟶ 831:
"label": "Length 2",
"description": "Length of track 2. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics2": {
Line 777 ⟶ 856:
"label": "Title 3",
"description": "Title of track 3.",
"type": "line",
"suggested": true
},
"note3": {
Line 788 ⟶ 866:
"label": "Length 3",
"description": "Length of track 3. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics3": {
Line 814 ⟶ 891:
"label": "Title 4",
"description": "Title of track 4.",
"type": "line",
"suggested": true
},
"note4": {
Line 825 ⟶ 901:
"label": "Length 4",
"description": "Length of track 4. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics4": {
Line 851 ⟶ 926:
"label": "Title 5",
"description": "Title of track 5.",
"type": "line",
"suggested": true
},
"note5": {
Line 862 ⟶ 936:
"label": "Length 5",
"description": "Length of track 5. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics5": {
Line 888 ⟶ 961:
"label": "Title 6",
"description": "Title of track 6.",
"type": "line",
"suggested": true
},
"note6": {
Line 899 ⟶ 971:
"label": "Length 6",
"description": "Length of track 6. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics6": {
Line 925 ⟶ 996:
"label": "Title 7",
"description": "Title of track 7.",
"type": "line",
"suggested": true
},
"note7": {
Line 936 ⟶ 1,006:
"label": "Length 7",
"description": "Length of track 7. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics7": {
Line 962 ⟶ 1,031:
"label": "Title 8",
"description": "Title of track 8.",
"type": "line",
"suggested": true
},
"note8": {
Line 973 ⟶ 1,041:
"label": "Length 8",
"description": "Length of track 8. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics8": {
Line 999 ⟶ 1,066:
"label": "Title 9",
"description": "Title of track 9.",
"type": "line",
"suggested": true
},
"note9": {
Line 1,010 ⟶ 1,076:
"label": "Length 9",
"description": "Length of track 9. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics9": {
Line 1,036 ⟶ 1,101:
"label": "Title 10",
"description": "Title of track 10.",
"type": "line",
"suggested": true
},
"note10": {
Line 1,047 ⟶ 1,111:
"label": "Length 10",
"description": "Length of track 10. Format is m:ss. (mm:ss or even h:mm:ss is fine for long tracks.)",
"type": "line",
"suggested": true
},
"lyrics10": {
Line 1,425 ⟶ 1,488:
"suggested": true
},
"title_width": {
"label": "Column width (Title)",
"description": "Include these parameters to override the default column widths. Note: If the width of a column is overridden, the width of all other columns used in the table must be also overridden for it to appear correctly.",
"example": "30%"
},
},
"writing_width": {
"label": "Column width (Writing)",
"description": "Include these parameters to override the default column widths. Note: If the width of a column is overridden, the width of all other columns used in the table must be also overridden for it to appear correctly.",
"example": "30%"
},
},
"music_width": {
"label": "Column width (Music)",
"description": "Include these parameters to override the default column widths. Note: If the width of a column is overridden, the width of all other columns used in the table must be also overridden for it to appear correctly.",
"example": "30%"
},
},
"lyrics_width": {
"label": "Column width (Lyrics)",
"description": "Include these parameters to override the default column widths. Note: If the width of a column is overridden, the width of all other columns used in the table must be also overridden for it to appear correctly.",
"example": "30%"
},
},
"extra_width": {
"label": "Column width (Extra)",
"description": "Include these parameters to override the default column widths. Note: If the width of a column is overridden, the width of all other columns used in the table must be also overridden for it to appear correctly.",
"example": "30%"
}
}
},
"format": "block",
"description": "Generates a track listing for an album or other music recording.",
"paramOrder": [
"all_writing",
"all_lyrics",
"all_music",
"collapsed",
"headline",
"extra_column",
"title0",
"note0",
"length0",
"lyrics0",
"music0",
"writer0",
"extra0",
"title1",
"note1",
"length1",
"lyrics1",
"music1",
"writer1",
"extra1",
"title2",
"note2",
"length2",
"lyrics2",
"music2",
"writer2",
"extra2",
"title3",
"note3",
"length3",
"lyrics3",
"music3",
"writer3",
"extra3",
"title4",
"note4",
"length4",
"lyrics4",
"music4",
"writer4",
"extra4",
"title5",
"note5",
"length5",
"lyrics5",
"music5",
"writer5",
"extra5",
"title6",
"note6",
"length6",
"lyrics6",
"music6",
"writer6",
"extra6",
"title7",
"note7",
"length7",
"lyrics7",
"music7",
"writer7",
"extra7",
"title8",
"note8",
"length8",
"lyrics8",
"music8",
"writer8",
"extra8",
"title9",
"note9",
"length9",
"lyrics9",
"music9",
"writer9",
"extra9",
"title10",
"note10",
"length10",
"lyrics10",
"music10",
"writer10",
"extra10",
"title11",
"note11",
"length11",
"lyrics11",
"music11",
"writer11",
"extra11",
"title12",
"note12",
"length12",
"lyrics12",
"music12",
"writer12",
"extra12",
"title13",
"note13",
"length13",
"lyrics13",
"music13",
"writer13",
"extra13",
"title14",
"note14",
"length14",
"lyrics14",
"music14",
"writer14",
"extra14",
"title15",
"note15",
"length15",
"lyrics15",
"music15",
"writer15",
"extra15",
"title16",
"note16",
"length16",
"lyrics16",
"music16",
"writer16",
"extra16",
"title17",
"note17",
"length17",
"lyrics17",
"music17",
"writer17",
"extra17",
"title18",
"note18",
"length18",
"lyrics18",
"music18",
"writer18",
"extra18",
"title19",
"note19",
"length19",
"lyrics19",
"music19",
"writer19",
"extra19",
"title20",
"note20",
"length20",
"lyrics20",
"music20",
"writer20",
"extra20",
"total_length",
"title_width",
"writing_width",
"music_width",
"lyrics_width",
"extra_width"
]
}
</templatedata>
}}
{{collapse bottom}}