வார்ப்புரு:Navseasoncats/doc
{{Documentation subpage}}
 {{High-use}}
 {{Lua|Module:Navseasoncats|Module:ConvertNumeric|Module:Roman|Module:Check for unknown parameters}}
 {{Lua sidebar}}
 
 ==About==
 {{tl|Navseasoncats}} is intended to be a minimal-input, near-universal template for navigating ''most'' sequential categories.
 {{Clear}}
 {| class=&quot;wikitable&quot;
 |+'''Recognized category types'''
 !style=&quot;background:#CCCCCC;&quot;|Type
 !style=&quot;background:#CCCCCC; width: 25%;&quot;|Example category
 !style=&quot;background:#CCCCCC;&quot;|BC(E)?
 !style=&quot;background:#CCCCCC;&quot;|Example output
 |-
 | Decade || {{c|2010கள்}} || கிமு || {{Navseasoncats|testcase=2010கள்}}
 |-
 | Ordinal (Decade) || {{c|1970கள் படைப்புகள்}} || கிமு || {{Navseasoncats|testcase=1970கள் படைப்புகள்}}
 |-
 | Decade || {{c|1530களில் இந்தியா}} || கிமு || {{Navseasoncats|testcase=1530களில் இந்தியா}}
 |-
 | Year ({{para|skip-gaps|yes}}) || {{c|1880|skip-gaps=yes}} || – || {{Navseasoncats|testcase=1880|skip-gaps=yes}}
 |-
 | Ordinal (Year) || {{c|2019 இல் இந்தியா}} || கிமு || {{Navseasoncats|testcase=2019 இல் இந்தியா}}
 |-
 | Ordinal (நூற்றாண்டு) || {{c|பதினான்காம் நூற்றாண்டு}} || கிமு || {{Navseasoncats|testcase=பதினான்காம் நூற்றாண்டு}}
 |-
 | Ordinal (temporal) || {{c|12-ஆம் நூற்றாண்டு நபர்கள்}} || கிமு || {{Navseasoncats|testcase=12-ஆம் நூற்றாண்டு நபர்கள்}}
 |-
 | Ordinal (temporal) || {{c|16 ஆம் நூற்றாண்டு நபர்கள்}} || கிமு || {{Navseasoncats|testcase=16 ஆம் நூற்றாண்டு நபர்கள்}}
 |-
 | Ordinal (numeric) || {{c|9வது மக்களவை உறுப்பினர்கள்}} || – || {{Navseasoncats|testcase=9வது மக்களவை உறுப்பினர்கள்}}
 |}
 
 ===Searching behavior===
 Most multi-year seasons/office terms/numerical ranges are acceptable, as long as the season duration/term length/range size is &lt;= 10, ''and'' the gap between seasons is &lt;= 6. For series exceeding either of these criteria, see/use {{tl|Irregular navseasoncats}}.
 
 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 [[:Category:Navseasoncats range abbreviated (MOS)|tracked]] for regular series with seasons &gt; 1 year long. {{tl|Category redirect}}s are followed, and tracked for either [[:Category:Navseasoncats range redirected (MOS)|MOS contravention]] (to be corrected) or for [[:Category:Navseasoncats range redirected (base change)|navigational aid]] (no error). The gap size between successive seasons is ''also'' automatically determined, up to and including 5 years, and defaults to 0 (e.g. {{nowrap|1995–96}} → {{nowrap|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 25 years in any ''year'' categories, use {{para|skip-gaps|yes}}.
 
 ===Limitations===
 ;Numerical limitations &amp; 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 &amp; numeral words do not work above the ninety-ninth &amp; ninety-nine, because no working examples were found.
 ;Condensation
 * Automatically condensed ''Olympics'' display is not supported due to peculiarities; use {{tl|Winter Olympics by year category navigation}}, etc., instead.
 * Automatically condensed ''years'' ''are'' supported for ''presidential'' categories only, due to their consistency; use {{para|skip-gaps|yes}} as desired elsewhere.
 ;Work-arounds
 * '''Base-name changes:''' create at least 2 logically numbered {{tl|R from category navigation}} (1 [[Special:Permalink/1040102736|forward]] &amp; 1 [[Special:Permalink/1040103249|backward]]), to join both related series.
 * '''Unaccounted-for name+number conventions:''' where a fixed number is part of the prefix text, e.g. ''Chapter 11 bankruptcies'', a non-breaking space may force the template to work. See [[Special:Diff/948223374|this fix]], where {{tl|title year}} skipped over ''11'' as part of a word rather than a discrete number. (This has been accounted for and is no longer required in this example.)
 * '''General:''' for large, permanent gaps&lt;sup&gt;†&lt;/sup&gt; between successive categories, use {{tl|Succeeding category}}, {{tl|Preceding category}}, {{tl|Category pair}}, as needed, in addition to {{tl|Navseasoncats}} on both sides, or in the middle, of the gap. Even if {{tl|Navseasoncats}} is [[:Category:Navseasoncats isolated|isolated]], it has the benefit of confirming the absence of nearby categories to the reader or maintainer.&lt;br/&gt;&lt;sup&gt;†&lt;/sup&gt;''Permanent gaps'', where there is confirmed to be an absence of data, and not just a current, yet to be filled, gap on Wikipedia.
 
 ===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
 * {{tlx|Navseasoncats}}
 
 ;Specify a minimum and/or maximum year to display
 * {{tlx|Navseasoncats|min{{=}}-100}}
 * {{tlx|Navseasoncats|min{{=}}100 BC}}
 * {{tlx|Navseasoncats|min{{=}}1753|max{{=}}1810}}
 * {{tlx|Navseasoncats|max{{=}}{{NEXTYEAR}}}}
 
 ;To skip gaps in year categories
 * {{tlx|Navseasoncats|skip-gaps{{=}}yes}}
 
 ;To ''not'' automatically follow {{tl|Category redirect}}s
 * {{tlx|Navseasoncats|follow-redirects{{=}}no}}
 
 ;Exceptional cases
 * {{tlx|Navseasoncats|cat{{=}}2010s albums}} &amp;mdash; to behave as if placed on {{para|cat}}; consider using {{tl|Category pair}} instead of {{para|cat}}
 
 ==Testing &amp; debugging==
 To test the output of the template on a particular category name, use the {{para|testcase}} parameter, and {{para|testcasegap}} if necessary:
 * {{tlx|Navseasoncats&amp;nbsp;| testcase{{=}}[[:Category:1770s in the Province of Quebec (1763–1791)|1770s in the Province of Quebec (1763–1791)]]&amp;nbsp;| min{{=}}1760}} →
 {{Navseasoncats | testcase=1770s in the Province of Quebec (1763–1791) | min=1760}}
 &lt;br/&gt;
 * {{tlx|Navseasoncats&amp;nbsp;| testcase{{=}}[[:Category:1770s in the Province of Quebec (1763–1791)|1770s in the Province of Quebec (1763–1791)]]&amp;nbsp;| max{{=}}1970s}} →
 {{Navseasoncats | testcase=1770s in the Province of Quebec (1763–1791) | max=1790s}}
 &lt;br/&gt;
 To see all links produced and/or tested, and what effect each has on their display, use {{para|list-all-links|yes}}:
 * {{tlx|Navseasoncats&amp;nbsp;| testcase{{=}}[[:Category:Nations at the 2013 World Athletics Championships|Nations at the 2013 World Athletics Championships]]&amp;nbsp;| min{{=}}2008&amp;nbsp;| skip-gaps{{=}}yes&amp;nbsp;| list-all-links{{=}}yes}} →
 # [[:Category:Nations at the 2006 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2006&lt;/span&gt;) (&lt;span style=&quot;visibility:hidden&quot;&gt;2006&lt;/span&gt;)
 # [[:Category:Nations at the 2007 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2007&lt;/span&gt;) (&lt;span style=&quot;visibility:hidden&quot;&gt;2007&lt;/span&gt;)
 # [[:Category:Nations at the 2008 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2008&lt;/span&gt;)
 # [[:Category:Nations at the 2008–2009 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2008–2009&lt;/span&gt;) (tried; not displayed)
 # [[:Category:Nations at the 2008–09 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2008–09&lt;/span&gt;) (tried; not displayed)
 # [[:Category:Nations at the 2009 World Athletics Championships]] → [[:Category:Nations at the 2009 World Championships in Athletics]] ([[: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]] ([[: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]] ([[: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]] ([[:Category:Nations at the 2017 World Championships in Athletics|2017]])
 # [[:Category:Nations at the 2019 World Athletics Championships]] ([[:Category:Nations at the 2019 World Athletics Championships|2019]])
 # [[:Category:Nations at the 2020 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2020&lt;/span&gt;)
 # [[:Category:Nations at the 2020–2021 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2020–2021&lt;/span&gt;) (tried; not displayed)
 # [[:Category:Nations at the 2020–21 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2020–21&lt;/span&gt;) (tried; not displayed)
 # [[:Category:Nations at the 2021 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2021&lt;/span&gt;)
 # [[:Category:Nations at the 2021–2022 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2021–2022&lt;/span&gt;) (tried; not displayed)
 # [[:Category:Nations at the 2021–22 World Athletics Championships]] (&lt;span style=&quot;color:#888&quot;&gt;2021–22&lt;/span&gt;) (tried; not displayed)
 * All possible element types are shown above (blue, red/grey, hidden, and redirect), and would otherwise display as:
 {| class=&quot;toccolours hlist&quot; style=&quot;text-align: center; margin: auto;&quot;
 |
 *&lt;span style=&quot;visibility:hidden&quot;&gt;2006&lt;/span&gt;
 *&lt;span style=&quot;visibility:hidden&quot;&gt;2007&lt;/span&gt;
 *&lt;span style=&quot;color:#888&quot;&gt;2008&lt;/span&gt;
 *[[:Category:Nations at the 2009 World Championships in Athletics|2009]]
 *[[:Category:Nations at the 2011 World Championships in Athletics|2011]]
 *&lt;b&gt;2013&lt;/b&gt;
 *[[:Category:Nations at the 2015 World Championships in Athletics|2015]]
 *[[:Category:Nations at the 2017 World Championships in Athletics|2017]]
 *[[:Category:Nations at the 2019 World Athletics Championships|2019]]
 *&lt;span style=&quot;color:#888&quot;&gt;2020&lt;/span&gt;
 *&lt;span style=&quot;color:#888&quot;&gt;2021&lt;/span&gt;
 |}
 
 ==Tracking categories==
 :&lt;small&gt;''{{Purge|Purge this page to update the totals}}''&lt;/small&gt;
 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:
 
 {{Columns-start}}
 
 ===Maintenance required===
 * {{Category link with count|Navseasoncats failed to generate navbox}}
 * {{Category link with count|Navseasoncats redirection error}}
 * {{Category link with count|Navseasoncats range abbreviated (MOS)}}
 * {{Category link with count|Navseasoncats range redirected (MOS)}}
 * {{Category link with count|Navseasoncats range ends (blank, MOS)}}
 * {{Category link with count|Navseasoncats range not using en dash}}
 * {{Category link with count|Navseasoncats in mainspace}}
 
 ===Maintenance possible===
 * {{Category link with count|Navseasoncats isolated}}
 * {{Category link with count|Navseasoncats default season gap size}}
 * {{Category link with count|Navseasoncats using cat parameter}}
 * {{Category link with count|Navseasoncats using testcase parameter}}
 * {{Category link with count|Navseasoncats using unknown parameter}}
 
 ===Module maintenance possible===
 * {{Category link with count|Navseasoncats year redirected (other)}}
 * {{Category link with count|Navseasoncats range redirected (other)}}
 
 {{Column}}
 
 ===Tracking only===
 * {{Category link with count|Navseasoncats range redirected (base change)}}
 * {{Category link with count|Navseasoncats range redirected (var change)}}
 * {{Category link with count|Navseasoncats range redirected (end)}}
 * {{Category link with count|Navseasoncats range gaps}}
 * {{Category link with count|Navseasoncats range irregular}}
 * {{Category link with count|Navseasoncats range irregular, 0-length}}
 * {{Category link with count|Navseasoncats range ends (present)}}
 * {{Category link with count|Navseasoncats TV season redirected}}
 * {{Category link with count|Navseasoncats decade redirected}}
 * {{Category link with count|Navseasoncats year redirected (base change)}}
 * {{Category link with count|Navseasoncats year redirected (var change)}}
 * {{Category link with count|Navseasoncats roman numeral redirected}}
 * {{Category link with count|Navseasoncats nordinal redirected}}
 * {{Category link with count|Navseasoncats wordinal redirected}}
 * {{Category link with count|Navseasoncats using skip-gaps parameter}}
 * {{Category link with count|Navseasoncats year and range}}
 * {{Category link with count|Navseasoncats year and decade}}
 * {{Category link with count|Navseasoncats decade and century}}
 
 {{Columns-end}}
 
 ==See also==
 * {{tl|Irregular navseasoncats}}
 * {{tl|Year by category}}
 * {{tl|R from category navigation}}
 
 &lt;includeonly&gt;{{sandbox other||
 [[Category:Chronology category templates]]