Difference between revisions of "Template:Discography list/doc"

From blackwiki
Jump to navigation Jump to search
imported>Downstream
imported>WOSlinker
(revert back to previous docs)
 
(63 intermediate revisions by 29 users not shown)
Line 1: Line 1:
<includeonly>
+
{{Documentation subpage}}
:''This template documentation is [[Wikipedia:Template doc page pattern|transcluded]] from [[Template:Infobox Discography/doc]]'' <small>[<span class="plainlinks">[{{fullurl:Template:Infobox Discography/doc|action=edit}} edit]</span>]</small></includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
+
{{Intricate template}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
+
<!-------------------------------------------------------------------
 +
    Place categories where indicated at the bottom of this page,
 +
    please; interwikis to Wikidata (see [[Wikipedia:Wikidata]]).
 +
-------------------------------------------------------------------->
 +
==Usage==
 +
* '''{{tl|Discography list}}''' should be used for the [[discography]] section of a band's article '''only when most or all of their albums lack their own article'''. It will then be a useful repository of all known album information that is currently not available elsewhere.
 +
* On the other hand, '''for a band article that has most or all of their albums described in a separate article, the standard shorter list should be used instead''' (album year, album title, studio/live/compilation qualifier) in a bulleted list or a table. All the extra information is then provided at each album's own article.
 +
* The template can also be used for adding a description to the <CODE>==Summary==</CODE> section of an uploaded image. See an example at [[:File:Kingspadeselftitled.jpg#Summary]].
  
This template is adapted from the [[Wikipedia:Infobox|infobox]] for albums, the '''{{tl|Infobox Album}}''' template. Please see that template's documentation for details as indicated below.
+
This template is adapted from the [[Wikipedia:Infobox|infobox]] for albums, the '''{{tl|Infobox album}}''' template. Please see that template's documentation for details as indicated below.
  
The standard infobox for discographies is the '''{{tl|Infobox Discography}}''' template. The table below is an example. You can click on "edit this page" and copy-and-paste the markup to a different article, replacing its information with info on the discography you choose to write about.
+
The table below is an example. You can click on "edit this page" and copy-and-paste the markup to a different article, replacing its information with info on the discography you choose to write about.
  
The template may be used anywhere in an article.
+
The template is preferably used within a <CODE>==Discography==</CODE> section.
  
== Studio releases ==
+
==Example==
{{Infobox Discography
+
{{Discography list
| Type          = Album
+
| Type          = Album
| Name          = [[Mommy's Little Monster]]
+
| Name          = [[Mommy's Little Monster (album)|Mommy's Little Monster]]
| Cover        = Nocover.png|120px
+
| Released      = 1983
| Released      = 1983
+
| Label        = 13th Floor Records (1983), [[Triple X Records|Triple X]] (1989), [[Time Bomb Recordings|Time Bomb]] (1995)
| Label        = 13th Floor Records (1983), [[Triple-X]] (1989), [[Time Bomb Recordings]] (1995)
+
| Producer      = [[Social Distortion]], Chaz Ramirez, Thom Wilson
| Producer      = [[Social Distortion]], Chaz Ramirez, Thom Wilson
+
| Format        = CD
| Format        = CD
+
| Chart position=  
| Chart position=  
+
| Certification =  
| Certification =  
+
| Sales        =  
| Sales        =  
+
| Singles      = “Another State of Mind”, “Mommy's Little Monster”
| Singles      = “Another State of Mind”, “Mommy's Little Monster”
+
| from Album    = <!-- For use with Singles --->
| from Album    = <!-- For use with Singles --->
+
| Writer        = <!-- For use with Singles --->
| Writer        = <!-- For use with Singles --->
+
| Tracks        = <!-- For use with Singles --->
| Tracks        = <!-- For use with Singles --->
+
| Other info    =  
| Other info    =  
 
 
}}
 
}}
{{Infobox Discography
+
{{Discography list
| Type          = Album
+
| Type          = Album
| Name          = [[Somewhere Between Heaven and Hell]]
+
| Name          = [[Somewhere Between Heaven and Hell]]
| Cover        = Nocover.png|120px
+
| Released      = February 11, 1992
| Released      = [[February 11]], [[1992]]
+
| Label        = [[Epic Records|Epic]]
| Label        = [[Epic Records|Epic]]
+
| Producer      = [[Social Distortion]]
| Producer      = [[Social Distortion]]
+
| Format        = CD
| Format        = CD
+
| Chart position= No. 76 U.S.
| Chart position= #76 U.S.
+
| Certification = Gold
| Certification = Gold
+
| Sales        =  
| Sales        =  
+
| Singles      = “Ball and Chain”, “Let It Be Me”, “Ring of Fire”
| Singles      = “Ball And Chain”, “Let It Be Me”, “Ring Of Fire”
+
| from Album    = <!-- For use with Singles --->
| from Album    = <!-- For use with Singles --->
+
| Writer        = <!-- For use with Singles --->
| Writer        = <!-- For use with Singles --->
+
| Tracks        = <!-- For use with Singles --->
| Tracks        = <!-- For use with Singles --->
+
| Other info    =  
| Other info    =  
 
 
}}
 
}}
  
{{Main|Social Distortion discography}}
+
==Code==
 +
This self-documented code base can be copy-pasted and filled directly in your article:
  
===Code===
+
<pre style="overflow:auto;">
 +
{{Discography list
 +
| Type          = <!-- "Studio/EP/Live/Compilation/...", see codes below -->
 +
| Name          = <!-- "Name" or "[[Name]]" (album or EP/single) -->
 +
| Other info    = <!-- added between parentheses after Name (album or EP) -->
 +
| from Album    = <!-- ONLY FOR EP/SINGLE: added after Name -->
 +
| Released      = <!-- "1992" or "11 February 1992 -->
 +
| Format        = <!-- "LP/CD/..." -->
 +
| Label          = <!-- "Name" or "[[Name Records|Name]]", comma if many -->
 +
| Writer        = <!-- "Songwriter name" or "[[Songwriter name]]" -->
 +
| Writers        = <!-- Use if there are multiple writers, comma if many -->
 +
| Producer      = <!-- "Producer name" or "[[Producer name]]", comma if many -->
 +
| Director      = <!-- "Director name" or "[[Director name]]" for music videos -->
 +
| Chart position = <!-- "No. 1 U.S." or "No. 12 UK" or such -->
 +
| Sales          = <!-- "3 million sold as of 2005" or such -->
 +
| Certification  = <!-- "Gold" or such -->
 +
| Tracks        = <!-- " "One", "Two", "Three" ", etc. -->
 +
| Bonus tracks  = <!-- "Four" (Japan edition) -->
 +
| Singles        = <!-- " "Single", "Other Single" ", etc. -->
 +
}}
 +
</pre>
 +
 
 +
* If you document a full album, delete the "from Album" field, fill the rest, and you will get this heading (depending on whether you also filled "Other info" or not):
 +
<DIV STYLE="margin-left:2em; width:50%;">
 +
{{Discography list
 +
| Type          = Studio
 +
| Name          = NAME
 +
}}
 +
{{Discography list
 +
| Type          = Studio
 +
| Name          = NAME
 +
| Other info    = OTHER INFO
 +
}}
 +
</DIV>
 +
: In this case, the fields "Writer", "Tracks", "Bonus tracks" are very optional (they are usually used for EPs and single, where there are fewer songs).
  
Most albums should not need the "from Album", "Writer", "Tracks" fields which are included for EPs and Singles where there are traditionally fewer songs on the album. Do not remove unnecessary parameters; they may be used later on and should be left blank instead.  Please note that the field names are case-sensitive:
+
* If you document an EP or a single, fill the "from Album" field, fill the rest, and you will get this heading (depending on whether you also filled "Other info" or not):
<pre>
+
<DIV STYLE="margin-left:2em; width:50%;">
{{Infobox Discography
+
{{Discography list
| Type          =  
+
| Type          = Studio
| Name          =  
+
| Name          = NAME
| Cover        =  
+
| from Album    = FROM ALBUM
| Released      =
+
}}
| Label        =
+
{{Discography list
| Producer      =  
+
| Type          = Studio
| Format        =
+
| Name          = NAME
| Chart position=
+
| from Album    = FROM ALBUM
| Certification =
+
| Other info    = OTHER INFO
| Sales        =
 
| Singles      =  
 
| from Album    = <!-- For use with Singles --->
 
| Writer        = <!-- For use with Singles --->
 
| Tracks        = <!-- For use with Singles --->
 
| Other info    =
 
 
}}
 
}}
</pre>
+
</DIV>
 +
: In this case, the fields "Writer", "Tracks", "Bonus tracks" become more interesting to fill.
 +
 
 +
Preferably, do not delete unused lines (except "from Album") if there is a chance they could be used or filled later (just keep them blank with the helper commentary). Also note that the name of the fields are case-sensitive, and they all start with a cap except "from Album" (sic).
 +
 
 +
Note: if you do not fill the Type field with one of the predefined keywords (or if you make a typo), the article will be automatically added to [[:Category:Non-standard discography infoboxes]] so as to be able to track and fix errors.
  
===Type and color===
+
==Type and color==
 
The '''type''' refers to the general type of album. Enter a code from the following chart. The type will appear with the appropriate color. If the type is unknown, leave the field blank. The small amount of color does not stand out on its own but when grouped together as shown in the example above, it gives a subtle indication of the type of the albums as a group.
 
The '''type''' refers to the general type of album. Enter a code from the following chart. The type will appear with the appropriate color. If the type is unknown, leave the field blank. The small amount of color does not stand out on its own but when grouped together as shown in the example above, it gives a subtle indication of the type of the albums as a group.
  
{| class="toccolours"
+
{| CLASS="wikitable"
!Display!!Code
+
! Code
 +
|-
 +
|STYLE="border-top:3px solid {{Infobox Album/color|studio}};"    |studio
 +
|-
 +
|STYLE="border-top:3px solid {{Infobox Album/color|demo}};"      |demo
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|ep}};" |''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|ep}};"         |ep
!style="border-top: 1px solid {{Infobox Album/color|ep}};"|ep
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|studio}};" |''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|live}};"       |live
!style="border-top: 1px solid {{Infobox Album/color|studio}};"|studio
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|live}};" |''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|greatest}};"   |greatest
!style="border-top: 1px solid {{Infobox Album/color|live}};"|live
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|greatest}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|remix}};"     |remix
!style="border-top: 1px solid {{Infobox Album/color|greatest}};"|greatest
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|remix}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|box}};"       |box
!style="border-top: 1px solid {{Infobox Album/color|remix}};"|remix
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|box}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|compilation}};"|compilation
!style="border-top: 1px solid {{Infobox Album/color|box}};"|box
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|compilation}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|cover}};"     |cover
!style="border-top: 1px solid {{Infobox Album/color|compilation}};"|compilation
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|cover}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|tribute}};"   |tribute
!style="border-top: 1px solid {{Infobox Album/color|cover}};"|cover
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|tribute}};" |''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|soundtrack}};" |soundtrack
!style="border-top: 1px solid {{Infobox Album/color|tribute}};"|tribute
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|soundtrack}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|television}};" |television
!style="border-top: 1px solid {{Infobox Album/color|soundtrack}};"|soundtrack
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|television}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|film}};"       |film
!style="border-top: 1px solid {{Infobox Album/color|television}};"|television
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|film}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|video}};"     |video
!style="border-top: 1px solid {{Infobox Album/color|film}};"|film
 
 
|-
 
|-
!style="border-top: 1px solid {{Infobox Album/color|unknown}};"|''Name''
+
|STYLE="border-top:3px solid {{Infobox Album/color|unknown}};"   |''(unknown or typo)''
!style="border-top: 1px solid {{Infobox Album/color|unknown}};"|&nbsp;
 
 
|}
 
|}
  
===Album cover, Details===
+
==Details==
{{Main|Template:Infobox Album}}
+
{{Main|Template:Infobox album}}
 +
 
 +
== Tracking category ==
 +
* {{clc|Non-standard discography infoboxes}}
 +
 
 +
<includeonly>{{Sandbox other||
 +
 
 +
<!-------------------------------------------------------------------
 +
      Categories below here, please; interwikis to Wikidata.
 +
-------------------------------------------------------------------->
 +
[[Category:Music infobox templates|Discography List]]
 +
[[Category:Templates that add a tracking category]]
 +
 
 +
}}</includeonly>

Latest revision as of 13:34, 25 October 2020

Usage

  • {{Discography list}} should be used for the discography section of a band's article only when most or all of their albums lack their own article. It will then be a useful repository of all known album information that is currently not available elsewhere.
  • On the other hand, for a band article that has most or all of their albums described in a separate article, the standard shorter list should be used instead (album year, album title, studio/live/compilation qualifier) in a bulleted list or a table. All the extra information is then provided at each album's own article.
  • The template can also be used for adding a description to the ==Summary== section of an uploaded image. See an example at File:Kingspadeselftitled.jpg#Summary.

This template is adapted from the infobox for albums, the {{Infobox album}} template. Please see that template's documentation for details as indicated below.

The table below is an example. You can click on "edit this page" and copy-and-paste the markup to a different article, replacing its information with info on the discography you choose to write about.

The template is preferably used within a ==Discography== section.

Example

Mommy's Little Monster

  • Released: 1983
  • Format: CD
  • Label: 13th Floor Records (1983), Triple X (1989), Time Bomb (1995)
  • Producer: Social Distortion, Chaz Ramirez, Thom Wilson
  • Singles: “Another State of Mind”, “Mommy's Little Monster”

Somewhere Between Heaven and Hell

  • Released: February 11, 1992
  • Format: CD
  • Label: Epic
  • Producer: Social Distortion
  • Chart position: No. 76 U.S.
  • Certification: Gold
  • Singles: “Ball and Chain”, “Let It Be Me”, “Ring of Fire”

Code

This self-documented code base can be copy-pasted and filled directly in your article:

{{Discography list
 | Type           = <!-- "Studio/EP/Live/Compilation/...", see codes below -->
 | Name           = <!-- "Name" or "[[Name]]" (album or EP/single) -->
 | Other info     = <!-- added between parentheses after Name (album or EP) -->
 | from Album     = <!-- ONLY FOR EP/SINGLE: added after Name -->
 | Released       = <!-- "1992" or "11 February 1992 -->
 | Format         = <!-- "LP/CD/..." -->
 | Label          = <!-- "Name" or "[[Name Records|Name]]", comma if many -->
 | Writer         = <!-- "Songwriter name" or "[[Songwriter name]]" -->
 | Writers        = <!-- Use if there are multiple writers, comma if many -->
 | Producer       = <!-- "Producer name" or "[[Producer name]]", comma if many -->
 | Director       = <!-- "Director name" or "[[Director name]]" for music videos -->
 | Chart position = <!-- "No. 1 U.S." or "No. 12 UK" or such -->
 | Sales          = <!-- "3 million sold as of 2005" or such -->
 | Certification  = <!-- "Gold" or such -->
 | Tracks         = <!-- " "One", "Two", "Three" ", etc. -->
 | Bonus tracks   = <!-- "Four" (Japan edition) -->
 | Singles        = <!-- " "Single", "Other Single" ", etc. -->
}}
  • If you document a full album, delete the "from Album" field, fill the rest, and you will get this heading (depending on whether you also filled "Other info" or not):

NAME

NAME (OTHER INFO)

In this case, the fields "Writer", "Tracks", "Bonus tracks" are very optional (they are usually used for EPs and single, where there are fewer songs).
  • If you document an EP or a single, fill the "from Album" field, fill the rest, and you will get this heading (depending on whether you also filled "Other info" or not):

"NAME" from the album FROM ALBUM

"NAME" (OTHER INFO) from the album FROM ALBUM

In this case, the fields "Writer", "Tracks", "Bonus tracks" become more interesting to fill.

Preferably, do not delete unused lines (except "from Album") if there is a chance they could be used or filled later (just keep them blank with the helper commentary). Also note that the name of the fields are case-sensitive, and they all start with a cap except "from Album" (sic).

Note: if you do not fill the Type field with one of the predefined keywords (or if you make a typo), the article will be automatically added to Category:Non-standard discography infoboxes so as to be able to track and fix errors.

Type and color

The type refers to the general type of album. Enter a code from the following chart. The type will appear with the appropriate color. If the type is unknown, leave the field blank. The small amount of color does not stand out on its own but when grouped together as shown in the example above, it gives a subtle indication of the type of the albums as a group.

Code
studio
demo
ep
live
greatest
remix
box
compilation
cover
tribute
soundtrack
television
film
video
(unknown or typo)

Details

Tracking category