View source for Template:Timeline of release years/doc

{{Documentation subpage}}
{{Lua sidebar}}
{{Uses Lua|Module:Timeline of release years}}

The '''timeline of release years''' template displays a timeline of release years.

== Usage ==
<pre>{{Timeline of release years
| title =
| subtitle =
| align =
| compressempty =
| rangeN =
| rangeN_color =
| first =
| <year1> =
| <year1>_color =
| <year2> =
| <year2>_color =
...
| <yearN-1>a =
| <yearN-1>b =
...
| <yearN-1>j =
| <yearN> =
| TBA =
| TBAb =
| TBAc =
| last =
}}
</pre>

=== Parameters ===
; {{para|title}}
: Optional title for the table. Defaults to "Release timeline"
; {{para|subtitle}}
: Optional subtitle.
; {{para|align}}
: Optional value of "left" floats the table left.
; {{para|compressempty}}
: Compresses series of empty rows with any value to the year range of those empty rows. Use only where there are multiple long stretches of time where no title is released.
; {{para|rangeN}}
: Identifies a range for range coloring. Takes two years, separated by any non-digit characters. Up to 10 ranges are supported.
; {{para|rangeN_color}}
: Identifies two colors for a range where the second color is optional. The colors must be separated by any whitespace character(s). When one color is given, all years in the range will take that color. Where two colors are given, the first color will be assigned to years with a title and the second color will be assigned to years without. The default colors for a range are {{color|#0BDA51|2=&#x02588;}} #0BDA51 for years with a title and {{color|1=#228B22|2=&#x02588;}} #228B22 for years without.
; {{para|first}}
: Optional beginning of the timeline (unless before 1940).
; {{para|<yearN><letter>}}
: The year of release. For example, {{para|1997|<nowiki>''[[Angels Fall First]]''</nowiki>}} will render a row with the year and album title. Letters can be used to add multiple titles for a single year e.g. {{para|1988a|<nowiki>[[Ninja Gaiden (arcade game)|''Ninja Gaiden'' (arcade)]]</nowiki>}} and {{para|1988b|<nowiki>[[Ninja Gaiden (Nintendo Entertainment System)|''Ninja Gaiden'' (NES)]]</nowiki>}} will display a row with the year and both titles.
; {{para|<yearN>_color}}
: Color for a specific year.
; {{para|TBA}}
: An announced but unreleased title. Can take letters like {{para|<year>}}.
; {{para|last}}
: Optional end end of the timeline. [[Help:Magic words|magic word]] can be used to set an automatic end year. For example: <code><nowiki>{{CURRENTYEAR}}</nowiki></code> (this year), <code><nowiki>{{#time:Y|-1 year}}</nowiki></code> (last year).
; {{para|<yearN><letter>_to}}
: Specifies an end year for a given item, which will cause it to appear as a range, such as 1943-1945.
; {{para|<yearN>_to_<yearEnd>_color}}
: Specifies a color for a given item that matches the specified range. Only works in conjunction with <yearN><letter>_to, such that an item with the year range 1943-1945 will appear as this color.

=== Examples ===
{{columns-start}}
<pre>{{Timeline of release years
| title = Studio album releases timeline
| 1997 = ''[[Angels Fall First]]''
| 1998 = ''[[Oceanborn]]''
| 2000 = ''[[Wishmaster (album)|Wishmaster]]''
| 2002 = ''[[Century Child]]''
| 2004 = ''[[Once (Nightwish album)|Once]]''
| 2007 = ''[[Dark Passion Play]]''
| 2011 = ''[[Imaginaerum]]''
| 2015 = ''[[Endless Forms Most Beautiful (album)|Endless Forms Most Beautiful]]'' 
| TBA = Upcoming album
}}</pre>
{{column}}
{{Timeline of release years
| title = Studio album releases timeline
| 1997 = ''[[Angels Fall First]]''
| 1998 = ''[[Oceanborn]]''
| 2000 = ''[[Wishmaster (album)|Wishmaster]]''
| 2002 = ''[[Century Child]]''
| 2004 = ''[[Once (Nightwish album)|Once]]''
| 2007 = ''[[Dark Passion Play]]''
| 2011 = ''[[Imaginaerum]]''
| 2015 = ''[[Endless Forms Most Beautiful (album)|Endless Forms Most Beautiful]]''
| TBA = Upcoming album
}}
{{columns-end}}
{{columns-start}}
<pre>{{Timeline of release years
| subtitle = Original series in green<br />Modern series in yellow

| range1 = 1988 – 1995
| range1_color = #0BDA51 #228B22
| range2 = 1996 – 2003
| range2_color = Black
| range3 = 2004 –
| range3_color = Gold Goldenrod

| 1988a = [[Ninja Gaiden (arcade game)|''Ninja Gaiden'' (arcade)]]
| 1988b = [[Ninja Gaiden (Nintendo Entertainment System)|''Ninja Gaiden'' (NES)]]
| 1990 = ''[[Ninja Gaiden II: The Dark Sword of Chaos]]''
| 1991a = ''[[Ninja Gaiden III: The Ancient Ship of Doom]]''
| 1991b = [[Ninja Gaiden (Game Gear video game)|''Ninja Gaiden'' (Game Gear)]]
| 1991c = ''[[Ninja Gaiden Shadow]]'' 
| 1992 = [[Ninja Gaiden (Master System video game)|''Ninja Gaiden'' (Master System)]]
| 1995 = ''Ninja Gaiden Trilogy''
| 2004 = ''[[Ninja Gaiden (2004 video game)|Ninja Gaiden]]''
| 2005 = ''[[Ninja Gaiden (2004 video game)#Ninja Gaiden Black|Ninja Gaiden Black]]''
| 2007 = ''[[Ninja Gaiden Sigma]]''
| 2008a = ''[[Ninja Gaiden: Dragon Sword]]''
| 2008b = ''[[Ninja Gaiden II]]''
| 2009 = ''[[Ninja Gaiden Sigma 2]]''
| 2012a = ''[[Ninja Gaiden 3]]''
| 2012b = ''[[Ninja Gaiden 3: Razor's Edge]]''
| 2014 = ''[[Yaiba: Ninja Gaiden Z]]''
}}</pre>
{{column}}
{{Timeline of release years
| subtitle = Original series in green<br />Modern series in yellow

| range1 = 1988 – 1995
| range1_color = #0BDA51 #228B22
| range2 = 1996 – 2003
| range2_color = Black
| range3 = 2004 –
| range3_color = Gold Goldenrod

| 1988a = [[Ninja Gaiden (arcade game)|''Ninja Gaiden'' (arcade)]]
| 1988b = [[Ninja Gaiden (Nintendo Entertainment System)|''Ninja Gaiden'' (NES)]]
| 1990 = ''[[Ninja Gaiden II: The Dark Sword of Chaos]]''
| 1991a = ''[[Ninja Gaiden III: The Ancient Ship of Doom]]''
| 1991b = [[Ninja Gaiden (Game Gear video game)|''Ninja Gaiden'' (Game Gear)]]
| 1991c = ''[[Ninja Gaiden Shadow]]'' 
| 1992 = [[Ninja Gaiden (Master System video game)|''Ninja Gaiden'' (Master System)]]
| 1995 = ''Ninja Gaiden Trilogy''
| 2004 = ''[[Ninja Gaiden (2004 video game)|Ninja Gaiden]]''
| 2005 = ''[[Ninja Gaiden (2004 video game)#Ninja Gaiden Black|Ninja Gaiden Black]]''
| 2007 = ''[[Ninja Gaiden Sigma]]''
| 2008a = ''[[Ninja Gaiden: Dragon Sword]]''
| 2008b = ''[[Ninja Gaiden II]]''
| 2009 = ''[[Ninja Gaiden Sigma 2]]''
| 2012a = ''[[Ninja Gaiden 3]]''
| 2012b = ''[[Ninja Gaiden 3: Razor's Edge]]''
| 2014 = ''[[Yaiba: Ninja Gaiden Z]]''
}}
{{columns-end}}
{{columns-start}}
<pre>{{Timeline of release years
| title = 
| subtitle = ''Microsoft'' omitted from the titles
| compressempty = yes
| 1982 = ''[[Microsoft Flight Simulator 1.0|Flight Simulator 1.0]]''
| 1984 = ''[[Microsoft Flight Simulator 2.0|Flight Simulator 2.0]]''
| 1986 = ''[[Microsoft Flight Simulator (1986 video game)|Flight Simulator]]'' (for Macintosh)
| 1988 = ''[[Microsoft Flight Simulator 3.0|Flight Simulator 3.0]]''
| 1989 = ''[[Microsoft Flight Simulator 4.0|Flight Simulator 4.0]]''
| 1993 = ''[[Microsoft Flight Simulator 5.0|Flight Simulator 5.0]]''
| 1995 = ''[[History of Microsoft Flight Simulator#Flight Simulator 5.1|Flight Simulator 5.1]]''
| 1996 = ''[[Microsoft Flight Simulator '95|Flight Simulator for Windows 95]]''
| 1997 = ''[[Flight Simulator 98]]''
| 1999 = ''[[Microsoft Flight Simulator 2000|Flight Simulator 2000]]''
| 2001 = ''[[Microsoft Flight Simulator 2002|Flight Simulator 2002]]''
| 2003 = ''[[Microsoft Flight Simulator 2004: A Century of Flight|Flight Simulator 2004: A Century of Flight]]''
| 2006 = ''[[Microsoft Flight Simulator X|Flight Simulator X]]''
<!-- 2012 Microsoft Flight is a separate product, please do not include it in the timeline -->
| 2014 = ''[[Microsoft Flight Simulator X#Steam Edition|Flight Simulator X: Steam Edition]]''
| 2020 = ''[[Microsoft Flight Simulator (2020 video game)|Flight Simulator]]''
}}</pre>
{{column}}
{{Timeline of release years
| title = 
| subtitle = ''Microsoft'' omitted from the titles
| compressempty = yes
| 1982 = ''[[Microsoft Flight Simulator 1.0|Flight Simulator 1.0]]''
| 1984 = ''[[Microsoft Flight Simulator 2.0|Flight Simulator 2.0]]''
| 1986 = ''[[Microsoft Flight Simulator (1986 video game)|Flight Simulator]]'' (for Macintosh)
| 1988 = ''[[Microsoft Flight Simulator 3.0|Flight Simulator 3.0]]''
| 1989 = ''[[Microsoft Flight Simulator 4.0|Flight Simulator 4.0]]''
| 1993 = ''[[Microsoft Flight Simulator 5.0|Flight Simulator 5.0]]''
| 1995 = ''[[History of Microsoft Flight Simulator#Flight Simulator 5.1|Flight Simulator 5.1]]''
| 1996 = ''[[Microsoft Flight Simulator '95|Flight Simulator for Windows 95]]''
| 1997 = ''[[Flight Simulator 98]]''
| 1999 = ''[[Microsoft Flight Simulator 2000|Flight Simulator 2000]]''
| 2001 = ''[[Microsoft Flight Simulator 2002|Flight Simulator 2002]]''
| 2003 = ''[[Microsoft Flight Simulator 2004: A Century of Flight|Flight Simulator 2004: A Century of Flight]]''
| 2006 = ''[[Microsoft Flight Simulator X|Flight Simulator X]]''
<!-- 2012 Microsoft Flight is a separate product, please do not include it in the timeline -->
| 2014 = ''[[Microsoft Flight Simulator X#Steam Edition|Flight Simulator X: Steam Edition]]''
| 2020 = ''[[Microsoft Flight Simulator (2020 video game)|Flight Simulator]]''
}}
{{columns-end}}

<includeonly>{{Sandbox other||
[[Category:Generic timeline templates]]

}}</includeonly>