Module talk:Category series navigation Source: en.wikipedia.org/wiki/Module_talk:Category_series_navigation

Template:Category series navigation is permanently protected from editing because it is a heavily used or highly visible template. Substantial changes should first be proposed and discussed here on this page. If the proposal is uncontroversial or has been discussed and is supported by consensus, editors may use {{edit template-protected}} to notify an administrator or template editor to make the requested edit. Usually, any contributor may edit the template's documentation to add usage notes or categories. Any contributor may edit the template's sandbox. Functionality of the template can be checked using test cases.

This template does not require a rating on Wikipedia's content assessment scale. It is of interest to the following WikiProjects:

Categories This template is within the scope of WikiProject Categories, a collaborative effort to improve the coverage of categories on Wikipedia. If you would like to participate, please visit the project page, where you can join the discussion and see a list of open tasks.CategoriesWikipedia:WikiProject CategoriesTemplate:WikiProject CategoriesCategories Years This template is within the scope of WikiProject Years, a collaborative effort to improve the coverage of Years on Wikipedia. If you would like to participate, please visit the project page, where you can join the discussion and see a list of open tasks.YearsWikipedia:WikiProject YearsTemplate:WikiProject YearsYears

On 22 October 2023, it was proposed that this page be moved to Template:Sequential chronology category navigation. The result of the discussion was moved to Template:Category series navigation.

Archives

Archive 1 Archive 2 Archive 3

This page has archives. Sections older than 180 days may be automatically archived by Lowercase sigmabot III when more than 3 sections are present.

@Tom.Reding: the template currently displays 5 years/decades forward & back, but only 3 seasons. Please would you extend the number of seasons also to 5? Then this template can be used in e.g. {{NHL seasons CatNav}} without loss. – Fayenatic London 08:33, 11 July 2024 (UTC)[reply]

@Fayenatic london: if I can restrict it to YYYY–YY cases where the seasons increment by 1, then ok.

The current maximum-width case is:

Proposed is:

YYYY–YYYY x5 per side produces:

to abide by MOS:DATERANGE, which is 56% wider than the current widest nav, which I think is too wide.

Also, technically, {{NHL seasons CatNav}} violates MOS:DATERANGE at the year 2000 by displaying "1999–00" instead of "1999–2000". Admittedly, "1999–00" looks much better since it keeps all nav elements the same width, so maybe WP:IAR just for 2000?   ~ Tom.Reding (talk ⋅dgaf)  09:52, 11 July 2024 (UTC)[reply]

I take your point about YYYY–YYYY x5 being too wide.

Moving between pages in a mixed series (years and seasons), it looks weird when the table width jumps between x5 and x3 links. How about x4 for seasons? Or perhaps x4 for YYYY–YY and x3 for YYYY–YYYY?

As for 1999–2000, IMHO the guideline should be altered to only rule out 1999–00 in article text, as it's perfectly clear when presented as part of a list of links. – Fayenatic London 13:57, 11 July 2024 (UTC)[reply]

Current again for reference:

YYYY–YY x4 per side:

YYYY–YYYY x3 per side:

Definitely looks good.   ~ Tom.Reding (talk ⋅dgaf)  12:32, 17 July 2024 (UTC)[reply]

clock Ready in the sandbox ~ YYYY–YYYY & YYYY–YY used as example cats.

I made it so up to 2 YYYY–YYYY are allowed for the entire x4-per-side nav before reverting back to x3-per-side, to smooth out any navigational irregularities (e.g. COVID, 2000, etc.).   ~ Tom.Reding (talk ⋅dgaf)  19:43, 9 August 2024 (UTC)[reply]

Thanks, Tom. Trying the sandbox template in Category:1996–97 in IndyCar, it extends the range one more than the current limit 2000, but instead of linking to 2001, it returns 2001–02 in grey. – Fayenatic London 20:46, 9 August 2024 (UTC)[reply]

 Fixed   ~ Tom.Reding (talk ⋅dgaf)  14:14, 10 August 2024 (UTC)[reply]

I found a similar thing with the current version at Category:American soccer clubs 1960–61 season where it skips a gap and finds the next category 1967, but after that returns grey 1968–69 instead of linking to 1968. – Fayenatic London 21:07, 9 August 2024 (UTC)[reply]

 Fixed! This was literally an edge case, where a cat was found at the edge of the search limit, so I decided to just keep moving the goalpost...   ~ Tom.Reding (talk ⋅dgaf)  14:14, 10 August 2024 (UTC)[reply]

Thanks, Tom.Reding – I suggest you implement the sandbox! – Fayenatic London 21:25, 10 August 2024 (UTC)[reply]

 Live! After a few followup bug fixes, all the testcases now look correct.   ~ Tom.Reding (talk ⋅dgaf)  18:15, 12 August 2024 (UTC)[reply]

I might even go 1 step further (later) & display 5 elements on each side IF the majority of the elements are only single years (e.g. surrounding Category:2019–20 FIA World Endurance Championship season), now that a lot of relevant code is in place. This will actually go a long way towards effectively (visually) merging nav_hyphen() & nav_year(), which has been in the back of my mind for a long time. Little did I know when starting this that it would be a step in that direction :)   ~ Tom.Reding (talk ⋅dgaf)  19:25, 12 August 2024 (UTC)[reply]

That would be nice, if it's doable – thanks, Tom.

In that series I notice that the 2018–19 and 2019–20 pages show only valid links, whereas 2017 and 2021 have a grey link for 2020 – but that's understandable, so no need to spend time on it unless there's an easy way to skip that gap. I tried using the skip-gaps parameter on the 2017 or 2021 page, but then it wrongly omits 2018–19 and 2019–20 altogether. – Fayenatic London 19:55, 13 August 2024 (UTC)[reply]

I added a 3rd bullet under Template:Category series navigation/doc#Condensation to explain that |skip-gaps= only works on and for year categories, and is not intended to find hyphenated ranges. Perhaps the parameter name is a bit misleading by being overly broad, but my planned improvements above will get it a step closer to earning its name - not by finding hyphenated ranges, but by at least skipping years when starting on a hyphenated range. |skip-gaps= can easily be made to work on TV seasons, ordinals (temporal, numeric, and word), and roman numerals, but I just haven't seen the need for it (i.e. those types of cats don't contain any gaps that I know of. And if they did, and the gaps were small, the gaps themselves would probably be important enough to be shown, and not skipped over.).   ~ Tom.Reding (talk ⋅dgaf)  13:05, 15 August 2024 (UTC)[reply]

Can someone please give an example of this template being used to "staple" two lists together. the Australian/New Zealand version of RuPaul's Drag race changed names, so I am trying to make Category:RuPaul's Drag Race Down Under season 3 contestants be followed by Category:Drag Race Down Under season 4 contestants. (RuPaul's name was dropped since he wasn't primary host any more.) Season 5 and later will stay like Season 4. Naraht (talk) 15:36, 27 December 2024 (UTC)[reply]

@Naraht: see Template:Category series navigation#Work-arounds 1st bullet.   ~ Tom.Reding (talk ⋅dgaf)  22:14, 4 February 2025 (UTC)[reply]

Tom.Reding that one I figured out. Sorry for not closing this.Naraht (talk) 22:17, 4 February 2025 (UTC)[reply]

I've used the template for a number of countries in the Drag Race Franchise but Category:Canada's Drag Race Season 1 contestants and the rest of Canada's act differently. For some reason, it is showing all numbers rather than just the ones that have categories, so instead of just 1-5, it is showing -4 -3 -2 -1 0 1 2 3 4 5 6.Naraht (talk) 15:39, 27 December 2024 (UTC)[reply]

@Naraht: "Season" should be lowercase for the entire series, and then only seasons 1-5 will be shown.   ~ Tom.Reding (talk ⋅dgaf)  22:12, 4 February 2025 (UTC)[reply]

Interesting effect. I'll put in to make the change.Naraht (talk) 22:15, 4 February 2025 (UTC)[reply]

It looks like Category:Category series navigation redirection error is full of categories encountering {{category redirect}}s which take advantage of the new functionality allowing templates in category targets. As an example, Category:1950 establishments in Slovenia barfs when it encounters Category:1900s establishments in Slovenia. Tom.Reding, would you be able to investigate this? Thanks, HouseBlaster (talk • he/they) 19:28, 4 February 2025 (UTC)[reply]

 Fixed - I forgot I had that update ready & waiting in the sandbox...   ~ Tom.Reding (talk ⋅dgaf)  22:05, 4 February 2025 (UTC)[reply]

Thank you!! HouseBlaster (talk • he/they) 22:06, 4 February 2025 (UTC)[reply]

I made some sandbox updates to add functionality for month year categories such as Category:February 2021, Category:July 1934 in sports, etc. It appears to be working as expected except when adding the nav_year below, it will bold the year category with the same year as the month year category, undesirably. Any ideas how to resolve this without breaking nav_year? –Aidan721 (talk) 00:55, 7 March 2025 (UTC)[reply]

I think I've got a fix. –Aidan721 (talk) 13:14, 7 March 2025 (UTC)[reply]

I am using {{Category series navigation|min=1}} on Category:WikiProject Women in Red meetup 3 articles but there are extra dots between the omitted links, i.e.  •  •  • 1 • 2 • 3 • 4 • 5 Am I doing something wrong? — Martin (MSGJ · talk) 04:40, 28 April 2025 (UTC)[reply]

I don't see you manually using Category Series Navigation at all. Looks like everything is flowing from Module:Women_in_Red_event with the category argument.

Secondly, is that Module building the list itself?Naraht (talk) 12:45, 28 April 2025 (UTC)[reply]

Yes, the module is calling the template. The same happens if you apply the template directly (link) so it does look like a bug in this template — Martin (MSGJ · talk) 13:01, 28 April 2025 (UTC)[reply]

You can also see the error on the test cases: Template:Category series navigation/testcases#Nordinals. Pinging Tom.Reding — Martin (MSGJ · talk) 13:47, 28 April 2025 (UTC)[reply]

 Done! (Also this was a feature request and not a bug)   ~ Tom.Reding (talk ⋅dgaf)  11:54, 4 May 2025 (UTC)[reply]

Thanks — Martin (MSGJ · talk) 07:40, 6 May 2025 (UTC)[reply]