模組:Category series navigation/doc
这是Module:Category series navigation的文档页面
![]() | 此頁面是Module: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)? | 顯示結果(範例) |
---|---|---|---|
Season | 2019–20年歐洲足協足球 | No | |
TV season | Futurama season 1 episodes | – | Error! Function find_var can't find the variable text in category "Futurama season 1 episodes".***Navseasoncats failed to generate navbox*** |
Office term (regular) | MEPs 2004–2009 | No | Error! Function find_var can't find the variable text in category "MEPs 2004–2009".***Navseasoncats failed to generate navbox*** |
Office term (irregular) | Wales AMs 2003–2007 | No | Error! Function find_var can't find the variable text in category "Wales AMs 2003–2007".***Navseasoncats failed to generate navbox*** |
Numerical range | Taxonbars with 30–34 taxon IDs | – | |
Decade | 1990年代瑞士 | BC | |
Year | 2010年西班牙 | BC(E) | |
Year (auto-condensed) | Candidates in the 2000 US presidential election | – | Error! Function find_var can't find the variable text in category "Candidates in the 2000 United States presidential election".***Navseasoncats failed to generate navbox*** |
Year (|skip-gaps=yes ) |
2006年國際足協世界盃 | – | |
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
[编辑]- Wikipedia:Categories for discussion/Log/2019 June 8#Category:Northern Ireland MLAs 2016–17
- Wikipedia:Categories for discussion/Log/2019 May 29#Category:MEPs 1952–58
- Wikipedia:Categories for discussion/Log/2019 April 19#Category:Aircraft piston engines 1900–1909
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) ( )
- Category:Nations at the 2007 World Athletics Championships (2007) ( )
- Category:Nations at the 2008 World Athletics Championships (2008)
- Category:Nations at the 2008–2009 World Athletics Championships (2008–2009) (tried; not displayed)2
- Category:Nations at the 2008–09 World Athletics Championships (2008–09) (tried; not displayed)4
- 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)2
- Category:Nations at the 2020–21 World Athletics Championships (2020–21) (tried; not displayed)4
- Category:Nations at the 2021 World Athletics Championships (2021)
- Category:Nations at the 2021–2022 World Athletics Championships (2021–2022) (tried; not displayed)2
- Category:Nations at the 2021–22 World Athletics Championships (2021–22) (tried; not displayed)4
- All possible element types are shown above (blue, red/grey, hidden, and redirect), and would otherwise display as:
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}}
→
延伸內容
|
---|
追蹤分類
[编辑]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:
需要儘快解決
[编辑]- Category:Navseasoncats failed to generate navbox(5)
- Category:Navseasoncats redirection error(0)
- Category:Navseasoncats range abbreviated (MOS)(0)
- Category:Navseasoncats range redirected (MOS)(0)
- Category:Navseasoncats range ends (blank, MOS)(0)
- Category:Navseasoncats range not using en dash(0)
- Category:Navseasoncats in mainspace(0)
Maintenance possible
[编辑]- Category:Navseasoncats isolated(113)
- Category:Navseasoncats default season gap size(1)
- Category:Navseasoncats using cat parameter(0)
- Category:Navseasoncats using testcase parameter(0)
- Category:Navseasoncats using unknown parameter(0)
Module maintenance possible
[编辑]- Category:Navseasoncats year redirected (other)(0)
- Category:Navseasoncats range redirected (other)(0)
僅追蹤
[编辑]- Category:Navseasoncats range redirected (base change)(0)
- Category:Navseasoncats range redirected (var change)(0)
- Category:Navseasoncats range redirected (end)(0)
- Category:Navseasoncats range gaps(0)
- Category:Navseasoncats range irregular(0)
- Category:Navseasoncats range irregular, 0-length(0)
- Category:Navseasoncats range ends (present)(0)
- Category:Navseasoncats TV season redirected(0)
- Category:Navseasoncats decade redirected(0)
- Category:Navseasoncats year redirected (base change)(0)
- Category:Navseasoncats year redirected (var change)(0)
- Category:Navseasoncats roman numeral redirected(0)
- Category:Navseasoncats nordinal redirected(0)
- Category:Navseasoncats wordinal redirected(0)
- Category:Navseasoncats using skip-gaps parameter(0)
- Category:Navseasoncats year and range(0)
- Category:Navseasoncats year and decade(0)
- Category:Navseasoncats decade and century(0)
參見
[编辑]- {{Irregular navseasoncats}}—for use on categories
- {{Irregular series navigation}}—for use outside categories
- {{R from category navigation}}
- {{Category TOC custom}}