Template:Singles discography/doc
Appearance
![]() | This is a documentation subpage for Template:Singles discography. It may contain usage information, categories and other content that is not part of the original template page. |
![]() | This template employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. You can conduct experiments, and should test all major changes, in either this template's sandbox, the general template sandbox, or your user space before changing anything here. |
Usage
[edit]This template is for rendering tables of single releases in artist discographies (both as separate articles and sections of another article).
Parameters
[edit]- titlen (title1, title2, ...) – The title of the nth single in the table. Required for every single. Automatically placed in quotes. A current maximum of twenty-one singles is in effect.
- noten (note1, note2, ...) – An optional note to be displayed in brackets after the title. Useful for denoting alternative versions of songs.
- refn (ref1, ref2, ...) – Adds a reference for the nth single, taking this parameter as both name and label. Either single letters or numbers are recommended. Useful for longer notes such as release information. See the {{Ref}} template documentation for more information.
- title_width – The width of the title column in pixels. Defaults to 200.
- yearn (year1, year2, ...) – The release year of the nth single in the table. Required for every single (see below).
- yearspann – Sets the rowspan of yearn. Repeated year parameters should be removed accordingly.
- all_albums – Adds the column titled "Album" when set to the value yes.
- albumn (album1, album2, ...) – The album from which the nth single in the table was taken. Required, and only rendered, for every single if all_albums is set (see below). Automatically placed in italics. In the absence of an album, set to
</i>Non-album single<i>
to bypass the italics. - albumspann – Sets the rowspan of albumn. Repeated album parameters should be removed accordingly.
- album_width – The width of the album column in pixels. Defaults to 150.
- albumn (album1, album2, ...) – The album from which the nth single in the table was taken. Required, and only rendered, for every single if all_albums is set (see below). Automatically placed in italics. In the absence of an album, set to
- all_certs – Adds the column titled "Certifications" when set to the value yes.
- certn (cert1, cert2, ...) – Any certifications received by the nth single in the table. Only rendered if all_certs is set. Include any references, and line breaks between certifications.
- cert_width – The width of the certifications column in pixels. Defaults to 150.
- charts – The number of charts to be rendered in the table. Charts are rendered in order and surplus charts are ignored, even if rendered charts contain no data. If unspecified no charts are included in the table. A current maximum of ten charts is in effect.
- chartx (chartA, chartB, ...) – Details for each chart in the table. Include the country code, a link to the relevant chart, and any references for the chart. Only rendered for the number of charts specified by charts.
- chartx_width – The width of the chartx column. Defaults to 3em, a value of 4.5em is recommended for component charts.
- peaknx (peak1A, peak2B, ...) – The peak chart position of the nth single in the table in chartx. Only rendered for the number of charts specified by charts. If left blank or not included, this parameter defaults to an em dash (—).
- include_footnote – Adds a footnote to the table containing the text: "—" denotes releases that did not chart or were not released in that country. Advised if there are any singles which did not appear in one of the rendered charts.
Examples
[edit]Code
[edit]{{ Singles discography | all_albums=yes | all_certs=yes | charts=7 | include_footnote = yes
| chartA = [[UK singles chart|UK]]<br /><ref>18</ref>
| chartB = [[ARIA Charts|AUS]]<br /><ref>20</ref>
| chartC = [[Irish Singles Chart|IRL]]<br /><ref>19</ref>
| chartD = [[Finland|FIN]]<br /><ref>22</ref>
| chartE = [[Media Control Charts|GER]]<br /><ref>248</ref>
| chartF = [[Norway|NOR]]<br /><ref>21</ref>
| chartG = [[Billboard Hot 100|US]]<br /><ref>23</ref>
| title1 = [[One Love (The Prodigy song)|One Love]] | album1 = [[Music for the Jilted Generation]] | albumspan1 = 4 | year1 = 1993 | peak1A = 8 | peak1C = 3
| title2 = [[No Good (Start the Dance)]] | year2 = 1994 | yearspan2 = 2 | peak2A = 4 | peak2B = 45 | peak2C = 3 | peak2E = 4 | peak2F = 7
| title3 = [[Voodoo People (song)|Voodoo People]] | peak3A = 13 | peak3B = 24 | peak3C = 7
| title4 = [[Poison (The Prodigy song)|Poison]] | year4 = 1995 | peak4A = 15 | peak4C = 3 | peak4F = 5
| title5 = [[Firestarter (The Prodigy song)|Firestarter]] | album5 = [[The Fat of the Land]] | cert5 = UK: Gold<ref>25</ref><br />US: Gold<ref>26</ref> | year5 = 1996 | peak5A = 1 }}
Output
[edit]Year | Title | Peak chart positions | Certifications (sales thresholds) | Album | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
UK [1] |
AUS [2] |
IRL [3] |
FIN [4] |
GER [5] |
NOR [6] |
US [7] | ||||||||
1993 | "One Love" | 8 | — | 3 | — | — | — | — | Music for the Jilted Generation | |||||
1994 | "No Good (Start the Dance)" | 4 | 45 | 3 | — | 4 | 7 | — | ||||||
"Voodoo People" | 13 | 24 | 7 | — | — | — | — | |||||||
1995 | "Poison" | 15 | — | 3 | — | — | 5 | — | ||||||
1996 | "Firestarter" | 1 | — | — | — | — | — | — | UK: Gold[8] US: Gold[9] | The Fat of the Land | ||||
"—" denotes a recording that did not chart or was not released in that territory. |
Code
[edit]{{ Singles discography | all_albums=yes
| title1 = [[One Love (The Prodigy song)|One Love]] | album1 = [[Music for the Jilted Generation]] | albumspan1 = 4 | year1 = 1993
| title2 = [[No Good (Start the Dance)]] | year2 = 1994 | yearspan2 = 2
| title3 = [[Voodoo People (song)|Voodoo People]]
| title4 = [[Poison (The Prodigy song)|Poison]] | year4 = 1995
| title5 = [[Firestarter (The Prodigy song)|Firestarter]] | album5 = [[The Fat of the Land]] | albumspan5 = 2 | year5 = 1996 | yearspan5 = 2}}
Output
[edit]Year | Title | Album |
---|---|---|
1993 | "One Love" | Music for the Jilted Generation |
1994 | "No Good (Start the Dance)" | |
"Voodoo People" | ||
1995 | "Poison" | |
1996 | "Firestarter" | The Fat of the Land |