Module:Navseasoncats/doc

Related pages
Template (talk) Template sandbox Template testcases Template doc Template subpages Module (talk) Module sandbox Module testcases Module doc Module subpages

About

Recognized category types

Type	Example category	BC(E)?	Example output
Season		No	1998–99 1999–2000 2000–01 2001–02 2002–03 2003–04 2004–05
TV season		–	0 0 0 0 0 1 2 3 4 5 6
Office term		No	1989–1994 1994–1999 1999–2004 2004–2009 2009–2014 2014–2019 2019–2024
Numerical range		–	18–22 22–26 26–30 30–34 34–38 38–42 42–46
Decade		BC	1970s 1980s 1990s 2000s 2010s 2020s 2030s 2040s 2050s 2060s 2070s
Year		BC(E)	1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004
Year (auto-condensed)		–	1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005
skip-gaps=yes)		–	1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985
Ordinal (temporal)		BC(E)	4th BCE 3rd BCE 2nd BCE 1st BCE 1st 2nd 3rd 4th 5th 6th 7th
Ordinal (numeric)		–	5th 4th 3rd 2nd 1st 1st 2nd 3rd 4th 5th 6th
Ordinal (word)		–	0th 0th 0th 0th 0th 1st 2nd 3rd 4th 5th 6th
Roman numeral		–	V VI VII VIII IX X XI XII XIII XIV XV
Mixed decade		–	1710s 1720s 1730s 1740s 1750s 1760s 1770s 1780s 1790s 1800s 1810s
Mixed year	}	–	1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783

Searching behavior

Multi-year seasons/office terms/numerical ranges are acceptable as long as the duration/range size remains constant, and no years/numbers are irregularly skipped. The length of each duration/range 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. {{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 durations/ranges is also automatically determined, up to and including 5 years if a surrounding category is found, and defaults to 0 (e.g. 1995–96 → 1996–97).

Automatically condensed year display is 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 up to 10–15 years (position-dependent) in any year categories, use |skip-gaps=yes.

Limitations

• 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.
• Automatically condensed year display is supported for presidential categories only, due to their consistency. Use |skip-gaps=yes as desired elsewhere.
• Automatically condensed Olympics display is not supported due to peculiarities; use {{Winter Olympics by year category navigation}}, etc., instead.
• Ordinal words do not work above the ninety-ninth, because no higher working examples were found.
• General: for large, permanent gaps between successive categories, or when the base category name changes, use {{Category pair}} in addition to {{Navseasoncats}} on both sides of the gap/name change. Even if {{Navseasoncats}} is isolated, it has the benefit of confirming the absence of nearby categories to the reader or maintainer.

Usage

Typical usage

• {{Navseasoncats}}

Specify a minimum and/or maximum year to display

• {{Navseasoncats|min=-100}}
• {{Navseasoncats|min=100 BC}}
• {{Navseasoncats|min=1753|max=1810}}
• {{Navseasoncats|max=Template:NEXTYEAR}}

To skip gaps in year categories

• {{Navseasoncats|skip-gaps=yes}}

To not automatically follow {{Category redirect}}s

• {{Navseasoncats|follow-redirects=no}}

Exceptional cases

• {{Navseasoncats|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:

• {{Navseasoncats | testcase=Birds described in 1761 | min=1758}}

1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766

• {{Navseasoncats | testcase=2026 elections | max=Template:NEXTYEAR}}

2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031

• {{Navseasoncats | testcase=Nations at the 2013 World Athletics Championships | min=2008 | skip-gaps=yes | list-all-links=yes}}

1. Category:Nations at the 2008 World Athletics Championships (2008)
2. Category:Nations at the 2009 World Athletics Championships (2009)
3. Category:Nations at the 2010 World Athletics Championships (2010)
4. Category:Nations at the 2011 World Athletics Championships (2011)
5. Category:Nations at the 2012 World Athletics Championships (2012)
6. Category:Nations at the 2014 World Athletics Championships (2014)
7. Category:Nations at the 2015 World Athletics Championships (2015)
8. Category:Nations at the 2016 World Athletics Championships (2016)
9. Category:Nations at the 2017 World Athletics Championships (2017)
10. Category:Nations at the 2018 World Athletics Championships (2018)

• Which is technically an inappropriate category for {{Navseasoncats}} placement, but it best shows the |list-all-links=yes behavior for all element variants (blue, red/grey, hidden, and redirect), and would otherwise display as:

2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018

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:

Maintenance required

• Category:Navseasoncats failed to generate navbox (0)
• Category:Navseasoncats range abbreviated (0)
• Category:Navseasoncats range redirected (MOS) (0)
• Category:Navseasoncats range not using en dash (0)

Maintenance possible

• Category:Navseasoncats default season gap size (0)
• Category:Navseasoncats using cat parameter (0)
• Category:Navseasoncats using testcase parameter (0)
• Category:Navseasoncats isolated (0)

Tracking only

• Category:Navseasoncats range redirected (base change) (0)
• Category:Navseasoncats TV season redirected (0)
• Category:Navseasoncats decade redirected (0)
• Category:Navseasoncats year redirected (0)
• Category:Navseasoncats roman numeral redirected (0)
• Category:Navseasoncats nordinal redirected (0)
• Category:Navseasoncats wordinal redirected (0)
• Category:Navseasoncats using skip-gaps parameter (0)

See also

• {{Navseasoncats with centuries below decade}}
• {{Navseasoncats with decades below year}}
• {{Category in year}}
• {{Year by category}}
• {{R from category navigation}}