Mô đun:Category series navigation/doc
Đây là một trang con tài liệu dành cho Mô đun:Category series navigation. Nó gồm có các thông tin hướng dẫn sử dụng, thể loại và các nội dung khác không thuộc về phần trang mô đun gốc. |
Mô đun Lua này được sử dụng ở rất nhiều trang, vì thế những thay đổi đến nó sẽ hiện ra rõ ràng. Vui lòng thử nghiệm các thay đổi ở trang con /sandbox, /testcases của mô đun, hoặc ở chỗ thử mô đun. Cân nhắc thảo luận các thay đổi tại trang thảo luận trước khi áp dụng sửa đổi. |
Mô đun này phụ thuộc vào các mô đun sau: |
Liên kết liên quan |
---|
Thông tin
sửa{{Category series navigation}} is intended to be a minimal-input, near-universal template for automatically navigating most numerically adjacent categories.
Hành vi tìm kiếm
sửaMost 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. CNBS: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
.
Hạn chế
sửaNumerical limitations and AD/BC/E
sửa- 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
sửa- 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
sửa- 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.
Sử dụng
sửa- 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=
Kiểm thử & gỡ lỗi
sửaTo 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}}
→
- Thể loại:Nations at the 2006 World Athletics Championships (2006) ( )
- Thể loại:Nations at the 2007 World Athletics Championships (2007) ( )
- Thể loại:Nations at the 2008 World Athletics Championships (2008)
- Thể loại:Nations at the 2008–2009 World Athletics Championships (2008–2009) (tried; not displayed)2
- Thể loại:Nations at the 2008–09 World Athletics Championships (2008–09) (tried; not displayed)4
- Thể loại:Nations at the 2009 World Athletics Championships → Thể loại:Nations at the 2009 World Championships in Athletics (2009)
- Thể loại:Nations at the 2011 World Athletics Championships → Thể loại:Nations at the 2011 World Championships in Athletics (2011)
- Thể loại:Nations at the 2015 World Athletics Championships → Thể loại:Nations at the 2015 World Championships in Athletics (2015)
- Thể loại:Nations at the 2017 World Athletics Championships → Thể loại:Nations at the 2017 World Championships in Athletics (2017)
- Thể loại:Nations at the 2019 World Athletics Championships (2019)
- Thể loại:Nations at the 2020 World Athletics Championships (2020)
- Thể loại:Nations at the 2020–2021 World Athletics Championships (2020–2021) (tried; not displayed)2
- Thể loại:Nations at the 2020–21 World Athletics Championships (2020–21) (tried; not displayed)4
- Thể loại:Nations at the 2021 World Athletics Championships (2021)
- Thể loại:Nations at the 2021–2022 World Athletics Championships (2021–2022) (tried; not displayed)2
- Thể loại: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:
Thể loại theo dõi
sửaIf the template encounters an issue, it displays an error message and/or places the category into one or more of the following tracking categories:
Cần bảo trì
sửa- Thể loại:Category series navigation failed to generate navbox (0)
- Thể loại:Category series navigation redirection error (0)
- Thể loại:Category series navigation range abbreviated (MOS) (0)
- Thể loại:Category series navigation range redirected (MOS) (0)
- Thể loại:Category series navigation range ends (blank, MOS) (0)
- Thể loại:Category series navigation range not using en dash (0)
- Thể loại:Category series navigation in mainspace (0)
Có thể cần bảo trì
sửa- Thể loại:Category series navigation isolated (0)
- Thể loại:Category series navigation default season gap size (0)
- Thể loại:Category series navigation using cat parameter (0)
- Thể loại:Category series navigation using testcase parameter (0)
- Thể loại:Category series navigation using unknown parameter (0)
Có thể cần bảo trì module
sửaChỉ để theo dõi
sửa- Thể loại:Category series navigation range redirected (base change) (0)
- Thể loại:Category series navigation range redirected (var change) (0)
- Thể loại:Category series navigation range redirected (end) (0)
- Thể loại:Category series navigation range gaps (0)
- Thể loại:Category series navigation range irregular (0)
- Thể loại:Category series navigation range irregular, 0-length (0)
- Thể loại:Category series navigation range ends (present) (0)
- Thể loại:Category series navigation TV season redirected (0)
- Thể loại:Category series navigation decade redirected (0)
- Thể loại:Category series navigation year redirected (base change) (0)
- Thể loại:Category series navigation year redirected (var change) (0)
- Thể loại:Category series navigation roman numeral redirected (0)
- Thể loại:Category series navigation nordinal redirected (0)
- Thể loại:Category series navigation wordinal redirected (0)
- Thể loại:Category series navigation using skip-gaps parameter (0)
- Thể loại:Category series navigation year and range (0)
- Thể loại:Category series navigation year and decade (0)
- Thể loại:Category series navigation decade and century (0)
Xem thêm
sửa- {{Irregular category series navigation}}—for use on categories
- {{Irregular series navigation}}—for use outside categories
- {{R from category navigation}}
- {{Category TOC custom}}