Template:Category series navigation/sandbox

This is the template sandbox page for Template:Category series navigation (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 524,000 pages, or roughly 1% of all pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

About

{{Category series navigation}} is intended to be a minimal-input, near-universal template for automatically navigating most numerically adjacent categories.

Recognized category types
Type	Example category	BC(E)?	Example output
Season	2001–02 FA Cup	No	1997–98 1998–99 1999–2000 2000–01 2001–02 2002–03 2003–04 2004–05 2005–06
TV season	Futurama season 1 episodes	–	• 0 • 0 • 0 • 0 • 01 2 3 4 5 6
Office term (regular)	MEPs 2004–2009	No	1989–1994 1994–1999 1999–2004 2004–2009 2009–2014 2014–2019 2019–2024
Office term (irregular)	Wales AMs 2003–2007	No	1991–1995 1995–1999 1999–2003 2003–2007 2007–2011 2011–2016 2016–2021
Numerical range	Taxonbars with 30–34 taxon IDs	–	15–19 20–24 25–29 30–34 35–39 40–44 45–49
Decade	1990s in Scotland	BC	1940s 1950s 1960s 1970s 1980s 1990s 2000s 2010s 2020s 2030s 2040s 15th 16th 17th 18th 19th 20th 21st 22nd 23rd 24th 25th
Year	1999 in Scotland	BC(E)	1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 1940s 1950s 1960s 1970s 1980s 1990s 2000s 2010s 2020s 2030s 2040s
Year (auto-condensed)	Candidates in the 2000 US presidential election	–	1980 1984 1988 1992 1996 2000 2004 2008 2012 2016 2020
Year (`\|skip-gaps=yes`)	Amusement parks opened in 1877	–	1836 1843 1846 1847 1870 1877 1879 1880 1883 1885 1888 1820s 1830s 1840s 1850s 1860s 1870s 1880s 1890s 1900s 1910s 1920s
Ordinal (temporal)	2nd-century rabbis	BC(E)	4th BCE 3rd BCE 2nd BCE 1st BCE 1st 2nd 3rd 4th 5th 6th 7th
Ordinal (numeric)	9th Lok Sabha	–	4th 5th 6th 7th 8th 9th 10th 11th 12th 13th 14th
Ordinal (word)	First Dynasty of Egypt	–	• 0th • 0th • 0th • 0th • 0th1st 2nd 3rd 4th 5th 6th
Roman numeral	Deputies of Legislature X of the Kingdom of Italy	–	V VI VII VIII IX X XI XII XIII XIV XV

Mixed decade	1760s in the Province of Quebec (1763–1791)	–	1710s 1720s 1730s 1740s 1750s 1760s 1770s 1780s 1790s 1800s 1810s
Mixed year	1778 establishments in the Province of Quebec (1763–1791)	–	1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1720s 1730s 1740s 1750s 1760s 1770s 1780s 1790s 1800s 1810s 1820s

Searching behavior

Most multi-year seasons/office terms/numerical ranges are acceptable, as long as the season duration/term length/range size is <= 10, and the gap between seasons is <= 6. For series exceeding either of these criteria, see/use {{Irregular category series navigation}}.

The length of each season is automatically determined from the originating category name, up to and including 10 years. MOS:DATERANGE compliance is preferred, but some deviation is allowed and tracked for regular series with seasons > 1 year long. {{Category redirect}}s are followed, and tracked for either MOS contravention (to be corrected) or for navigational aid (no error). The gap size between successive seasons is also automatically determined, up to and including 6 years, and defaults to 0 (e.g. 1995–96 → 1996–97).

Automatically condensed years are supported for presidential categories only (but can be easily expanded as needed), for gaps up to and including 5 years, and defaults to 1. To skip gaps of up to 50 years in any year categories, use |skip-gaps=yes.

Limitations

Numerical limitations and AD/BC/E

Season/office term categories do not work for any years BC, which will be hidden, because no working examples were found.
Decade categories recognize BC, but not BCE, because no working examples were found.
Ordinal & numeral words do not work above the ninety-ninth & ninety-nine, because no working examples were found.

Condensation

Automatically condensed Olympics display is not supported due to peculiarities; use {{Winter Olympics by year category navigation}}, etc., instead.
Automatically condensed years are supported for US presidential categories only, due to their consistency; use |skip-gaps=yes as desired on other year categories.
|skip-gaps=yes currently only works when starting on a year category, and is not intended to find all hyphenated ranges, which allows it to span much larger gaps.

Work-arounds

Base-name changes: create at least 2 logically numbered {{R from category navigation}} (1 backward & 1 forward), to join both related series.
Unaccounted-for name+number conventions: where a fixed number is part of the prefix or suffix text, e.g. Chapter 11 bankruptcies, a non-breaking space may force the template to work. See this fix, where {{title year}} skipped over 11 as part of a word rather than a discrete number. (This case has been accounted for and is no longer required in this example.)
General: for large, permanent gaps^† between successive categories, use {{Preceding category}}, {{Category pair}}, {{Succeeding category}}, as needed, in addition to {{Category series navigation}} on both sides, or in the middle, of the gap. Even if {{Category series navigation}} is isolated, it has the benefit of confirming the absence of nearby categories to the reader or maintainer.
^†Permanent gaps, where there is a confirmed permanent absence of data, and not just a temporary, yet to be filled, gap on Wikipedia.
|skip-gaps=: create {{R from category navigation}} from an appropriate year to the hyphenated category that was not found.

Related CfDs

Usage

Typical usage

{{Category series navigation}}

Specify a minimum and/or maximum year to display

{{Category series navigation|min=-100}}
{{Category series navigation|min=100 BC}}
{{Category series navigation|min=1753|max=1810}}
{{Category series navigation|max=2030}}

To skip gaps in year categories

{{Category series navigation|skip-gaps=yes}}

To not automatically follow {{Category redirect}}s

{{Category series navigation|follow-redirects=no}}

Exceptional cases

{{Category series navigation|cat=2010s albums}} — to behave as if placed on |cat=; consider using {{Category pair}} instead of |cat=

Testing & debugging

To test the output of the template on a particular category name, use the |testcase= parameter, and |testcasegap= if necessary:

{{Category series navigation|testcase=1770s in the Province of Quebec (1763–1791)|min=1760}} →

{{Category series navigation|testcase=1770s in the Province of Quebec (1763–1791)|max=1790s}} →

To see all links produced and/or tested, and what effect each has on their display, use |list-all-links=yes:

{{Category series navigation|testcase=Nations at the 2013 World Athletics Championships|min=2008|skip-gaps=yes|list-all-links=yes}} →

Category:Nations at the 2006 World Athletics Championships (2006) (2006)
Category:Nations at the 2007 World Athletics Championships (2007) (2007)
Category:Nations at the 2008 World Athletics Championships (2008)
Category:Nations at the 2008–2009 World Athletics Championships (2008–2009) (tried; not displayed)²
Category:Nations at the 2008–09 World Athletics Championships (2008–09) (tried; not displayed)⁴
Category:Nations at the 2009 World Athletics Championships → Category:Nations at the 2009 World Championships in Athletics (2009)
Category:Nations at the 2011 World Athletics Championships → Category:Nations at the 2011 World Championships in Athletics (2011)
Category:Nations at the 2015 World Athletics Championships → Category:Nations at the 2015 World Championships in Athletics (2015)
Category:Nations at the 2017 World Athletics Championships → Category:Nations at the 2017 World Championships in Athletics (2017)
Category:Nations at the 2019 World Athletics Championships (2019)
Category:Nations at the 2020 World Athletics Championships (2020)
Category:Nations at the 2020–2021 World Athletics Championships (2020–2021) (tried; not displayed)²
Category:Nations at the 2020–21 World Athletics Championships (2020–21) (tried; not displayed)⁴
Category:Nations at the 2021 World Athletics Championships (2021)
Category:Nations at the 2021–2022 World Athletics Championships (2021–2022) (tried; not displayed)²
Category:Nations at the 2021–22 World Athletics Championships (2021–22) (tried; not displayed)⁴

All possible element types are shown above (blue, red/grey, hidden, and redirect), and would otherwise display as:

2006
2007
2008
2009
2011
2013
2015
2017
2019
2020
2021

Tracking categories

Purge this page to update the totals

If the template encounters an issue, it displays an error message and/or places the category into one or more of the following tracking categories:

Template:Category series navigation/sandbox

About

Searching behavior

Limitations

Numerical limitations and AD/BC/E

Condensation

Work-arounds

Related CfDs

Usage

Testing & debugging

Tracking categories

Maintenance required

Maintenance possible

Module maintenance possible

Tracking only

See also