View source for Template:Extra chronology/doc

{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{High-use}}
{{Lua|Module:Check for unknown parameters}}

==Usage==
{{Main|Template:Infobox album#Template:Extra chronology}}

Extra chronologies may be added to {{tl|Infobox album}} and {{tl|Infobox song}}, depending on which version of this template is used.  Both add the proper header, color, and formatting (depending on the {{para|type}} designation) and are added to the infoboxes in the {{para|misc}} field.

If this template is substituted, it will return a cleaned-up copy of itself (see [[Wikipedia:Substitution trick]]) with unnecessary parameters removed and deprecated parameters replaced. Parameter indentation will also automatically be fixed.

===Infobox album version===
{{infobox|title=Albums and EPs|data1={{parameter names example|artist|type=studio|prev_title|prev_year|title|year|next_title|next_year}}}}
The album version provides the previous, current, and next albums and the years of their release. The titles appear in italics, with the current title also in bold. Extra formatting does not usually need to be added.

;Code :
<syntaxhighlight lang="wikitext">{{Infobox album
...
| misc        = {{subst:Extra chronology
 | artist     = 
 | type       = 
 | prev_title = 
 | prev_year  = 
 | title      = 
 | year       = 
 | next_title = 
 | next_year  = 
 }}
}}</syntaxhighlight>

;artist : The name of the artist, with <code>live album</code>, <code>EP</code>, etc., appended to produce either "Artist live album chronology", "Artist EP chronology", etc.  If just the artist's name is used, the header will display "Artist chronology".
;type : Specify <code>studio</code>, <code>live</code>, <code>compilation</code>, etc., as detailed in {{tl|Infobox album/doc/type}} – this triggers the header color and formatting.
;prev_title : Enter the name of the previous album. If it has a WP article, add a link.
;prev_year : The year the previous album was released.
;title : Enter the name of the current or article title. This should not be wikilinked, since it should be the subject of the article.
;year : The year the current album was released. 
;next_title : Enter the name of the next album and link as appropriate.
;next_year : The year the next album was released.
;Notes : All parameters are optional except {{para|title}} and {{para|type}}. Horizontal lines replace the header row if you omit {{para|artist}}.

===Infobox song version===
{{infobox|title=Singles|data1={{parameter names example|artist|type=single|prev_title|prev_year|title|year|next_title|next_year}}}}
In addition to providing the previous, current, and next singles and the years of their release, the single version allows two song titles to be entered.  This is useful for [[double A-side]] singles, such as "[[Ruby Tuesday (song)|Ruby Tuesday]]"/"[[Let's Spend the Night Together]]". The titles appear in quotes, with the current title also in bold. Extra formatting does not usually need to be added.

;Code :
<syntaxhighlight lang="wikitext">{{Infobox song
...
| misc         = {{subst:Extra chronology
 | artist      = 
 | type        = single
 | prev_title  = 
 | prev_title2 = 
 | prev_year   = 
 | title       = 
 | title2      = 
 | year        = 
 | next_title  = 
 | next_title2 = 
 | next_year   = 
 }}
}}
</syntaxhighlight>

;artist : Enter the name of the artist to produce "Artist singles chronology". (The word "singles" is automatically added for singles chronologies.) Adding <code>American</code>, <code>UK</code>, etc. after "Artist" will display "Artist American singles chronology", "Artist UK singles chronology", etc.
;type : Specify <code>single</code>. (In the event that another {{para|type}} is used in Infobox song, specify <code>song</code> so that a light blue color will be produced).
;prev_title : Enter the name of the previous single. If it has a WP article, add a link.
;prev_title2 : Leave blank, unless the previous is a double A-side single. Then enter the name of the previous single second or flip side and link as appropriate.
;prev_year : The year the previous single was released.
;title : Enter the name of the current or article title. This should not be wikilinked, since it should be the subject of the article.
;title2 : Leave blank, unless it is a double A-side single. Then enter the name of the second or flip side of current or article title.
;year : The year the current single was released.
;next_title : Enter the name of the next single. If it has a article, add a link.
;next_title2 : Enter the name of the second or flip side of next single, if it is a double-A. Link as appropriate.
;next_year : The year the next single was released.
;Notes : All parameters are optional except {{para|title}} and {{para|type}}. Horizontal lines replace the header row if you omit {{para|artist}}.

== Tracking categories ==
* {{clc|Music infoboxes with malformed table placement}}
* {{clc|Pages using extra chronology with unknown parameters}}

{{clear}}

==TemplateData==
{{TemplateDataHeader}}

<templatedata>
{
	"description": "For use with {{Infobox album}} or {{Infobox single}} – adds an extra chronology range. If there are deprecated parameters, substitute the template and it will clean itself up.",
	"params": {
		"type": {
			"label": "Type",
			"description": "To specify single or a type of album. Valid values are: single, studio, demo, ep, live, greatest, remix, box, compilation, mixtape, soundtrack, film, cast, video, other",
			"type": "string",
			"required": true,
			"suggested": true
		},
		"artist": {
			"label": "Artist",
			"description": "The name of the recording artist",
			"type": "string",
			"required": false,
			"suggested": true
		},
		"prev_title": {
			"label": "Previous title",
			"description": "The title of the artist's previous release. Add a link if an article exists",
			"type": "string",
			"required": false,
			"example": "[[Help! (song)|Help!]]",
			"suggested": true
		},
		"prev_title2": {
			"label": "Previous title (2)",
			"description": "The second title of the artist's previous release, for double A-sides only. Add a link if an article exists",
			"type": "string",
			"required": false,
			"example": "[[Day Tripper]]"
		},
		"prev_year": {
			"label": "Previous year",
			"description": "The year that the previous work was released",
			"type": "date",
			"required": false,
			"example": "1965",
			"suggested": true
		},
		"title": {
			"label": "Title",
			"description": "The title of the current release. No formatting required. For double A-sides only, if this is the other side add a wikilink if an article exists",
			"type": "string",
			"required": true,
			"example": "All Star",
			"suggested": true
		},
		"title2": {
			"label": "Title (2)",
			"description": "The second title of the current release, for double A-sides only. If this is the other side then add a link if an article exists",
			"type": "string",
			"required": false,
			"example": "[[Strawberry Fields Forever]]"
		},
		"year": {
			"label": "Year",
			"description": "The year that the current work was released",
			"type": "date",
			"required": true,
			"example": "2001",
			"suggested": true
		},
		"next_title": {
			"label": "Next title",
			"description": "The title of the artist's following release. Add a link if an article exists",
			"type": "string",
			"required": false,
			"example": "[[My Neck, My Back (Lick It)]]",
			"suggested": true
		},
		"next_title2": {
			"label": "Next title (2)",
			"description": "The second title of the artist's following release, for double A-sides only. Add a link if an article exists",
			"type": "string",
			"required": false,
			"example": "[[Kids with Guns]]"
		},
		"next_year": {
			"label": "Next year",
			"description": "The year the following work was released",
			"type": "date",
			"required": false,
			"example": "2002",
			"suggested": true
		}
	},
	"format": "block"
}
</templatedata>

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Music infobox templates]]
[[Category:Embeddable templates]]
[[Category:Templates that add a tracking category]]

}}</includeonly>