模板:Category series navigation

此模板被引用于许多页面。
为了避免造成大规模的影响，所有对此模板的编辑应先于沙盒、测试样例或您的沙盒上测试。
测试后无误的版本可以一次性地加入此模板中，但是修改前请务必于讨论页发起讨论。

模板引用数量会自动更新。

此模板使用Lua语言：

说明

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

适用情形
类型	分类名称（范例）	BC(E)?	显示结果（范例）
体育赛季	2019–20年欧洲足协足球	No	2010–11年 2011–12年 2012–13年 2018–19年 2019–20年 2020–21年 2021–22年 2022–23年 2023–24年
电视分季	X档案第一季分集	–
政治人物任期（定期）	MEPs 2004–2009	No
政治人物任期（不定期）	Wales AMs 2003–2007	No
Numerical range	Taxonbars with 30–34 taxon IDs	–	15–19 20–24 25–29 30–34 35–39 40–44 45–49
世纪	21世纪作品	BC	16世纪 17世纪 18世纪 19世纪 20世纪 21世纪 22世纪 23世纪 24世纪 25世纪 26世纪
年代	1990年代瑞士	BC	1940年代 1950年代 1960年代 1970年代 1980年代 1990年代 2000年代 2010年代 2020年代 2030年代 2040年代
年份	2010年西班牙	BC(E)	2005年 2006年 2007年 2008年 2009年 2010年 2011年 2012年 2013年 2014年 2015年
跨年份（`\|skip-gaps=yes`）	2006年国际足联世界杯	–	1986年 1990年 1994年 1998年 2002年 2006年 2010年 2014年 2018年 2022年 2026年

Ordinal (temporal)	2nd-century rabbis	BC(E)
Ordinal (numeric)	9th Lok Sabha	–
Ordinal (word)	First Dynasty of Egypt	–
Roman numeral	Deputies of Legislature X of the Kingdom of Italy	–
Mixed decade	1760s in the Province of Quebec (1763–1791)	–
Mixed year	1778 establishments in the Province of Quebec (1763–1791)	–

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)}} →

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

If |list-all-links=yes is used on a hyphenated category, then all tested categories will also be shown:

{{Category series navigation|cat=2018–19 NHL season|list-all-links=yes}} →

延伸内容

追踪分类

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 possible

Module maintenance possible

仅追踪

参见

{{Irregular category series navigation}}—for use on categories
{{Irregular series navigation}}—for use outside categories
{{R from category navigation}}
{{Category TOC custom}}

上述文档嵌入自Template:Category series navigation/doc。
编者可以在本模板的沙盒和测试样例页面进行实验。
请在/doc子页面中添加分类。本模板的子页面。