imported>Tom.Reding: /* Testing & debugging */ Partial update

2022-11-06T20:34:23Z

Testing & debugging: Partial update

New page

{{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="wikitable"
|+'''Recognized category types'''
!style="background:#CCCCCC;"|Type
!style="background:#CCCCCC; width: 25%;"|Example category
!style="background:#CCCCCC;"|BC(E)?
!style="background:#CCCCCC;"|Example output
|-
| Season || {{c|2001–02 FA Cup}} || No || {{Navseasoncats|testcase=2001–02 FA Cup}}
|-
| TV season || {{c|Futurama (season 1) episodes}} || – || {{Navseasoncats|testcase=Futurama (season 1) episodes}}
|-
| Office term (regular) || {{c|MEPs 2004–2009}} || No || {{Navseasoncats|testcase=MEPs 2004–2009}}
|-
| Office term (irregular) || {{c|Wales AMs 2003–2007}} || No || {{Navseasoncats|testcase=Wales AMs 2003–2007}}
|-
| Numerical range || {{c|Taxonbars with 30–34 taxon IDs}} || – || 
{| class="toccolours hlist" style="text-align: center; margin: auto;"
|
*15–19
*[[:Category:Taxonbars with 20–24 taxon IDs|20–24]]
*[[:Category:Taxonbars with 25–29 taxon IDs|25–29]]
*30–34
*[[:Category:Taxonbars with 35–39 taxon IDs|35–39]]
*[[:Category:Taxonbars with 40+ taxon IDs|40–44]]
*45–49
|}
|-
| Decade || {{c|1990s in Scotland}} || BC || {{Navseasoncats|testcase=1990s in Scotland}}
|-
| Year || {{c|1999 in Scotland}} || BC(E) || {{Navseasoncats|testcase=1999 in Scotland}}
|-
| Year (auto-condensed) || {{c|Candidates in the 2000 United States presidential election|Candidates in the 2000 US presidential election}} || – || {{Navseasoncats|testcase=Candidates in the 2000 United States presidential election}}
|-
| Year ({{para|skip-gaps|yes}}) || {{c|Amusement parks opened in 1880|skip-gaps=yes}} || – || {{Navseasoncats|testcase=Amusement parks opened in 1880|skip-gaps=yes}}
|-
| Ordinal (temporal) || {{c|2nd-century rabbis}} || BC(E) || {{Navseasoncats|testcase=2nd-century rabbis}}
|-
| Ordinal (numeric) || {{c|9th Lok Sabha}} || – || {{Navseasoncats|testcase=9th Lok Sabha}}
|-
| Ordinal (word) || {{c|First Dynasty of Egypt}} || – || {{Navseasoncats|testcase=First Dynasty of Egypt}}
|-
| Roman numeral || {{c|Deputies of Legislature X of the Kingdom of Italy}} || – || {{Navseasoncats|testcase=Deputies of Legislature X of the Kingdom of Italy}}
|-
|colspan="4" style="background:#CCCCCC"|
|-
| Mixed decade || {{c|1760s in the Province of Quebec (1763–1791)}} || – || {{Navseasoncats|testcase=1760s in the Province of Quebec (1763–1791)}}
|-
| Mixed year || {{c|1778 establishments in the Province of Quebec (1763–1791)}} || – || {{Navseasoncats|testcase=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 {{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 > 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 & 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 {{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]] & 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† 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. †''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}} — to behave as if placed on {{para|cat}}; consider using {{tl|Category pair}} instead of {{para|cat}}

==Testing & 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 | testcase{{=}}[[:Category:1770s in the Province of Quebec (1763–1791)|1770s in the Province of Quebec (1763–1791)]] | min{{=}}1760}} →
{{Navseasoncats | testcase=1770s in the Province of Quebec (1763–1791) | min=1760}}
 
* {{tlx|Navseasoncats | testcase{{=}}[[:Category:1770s in the Province of Quebec (1763–1791)|1770s in the Province of Quebec (1763–1791)]] | max{{=}}1970s}} →
{{Navseasoncats | 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 {{para|list-all-links|yes}}:
* {{tlx|Navseasoncats | testcase{{=}}[[:Category:Nations at the 2013 World Athletics Championships|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)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]] ([[: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]] (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:
{| class="toccolours hlist" style="text-align: center; margin: auto;"
|
*2006
*2007
*2008
*[[:Category:Nations at the 2009 World Championships in Athletics|2009]]
*[[:Category:Nations at the 2011 World Championships in Athletics|2011]]
*2013
*[[: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]]
*2020
*2021
|}

==Tracking categories==
:''{{Purge|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:

{{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}}

<includeonly>{{sandbox other||
[[Category:Chronology category templates]]
}}</includeonly>

Template:Navseasoncats/doc - Revision history

imported>Tom.Reding: /* Testing & debugging */ Partial update