When generating the HTML version of the manual, there are a lot of duplicate label warning messages. This makes identifying and addressing other warning messages more of a challenge.
This issue was raised on the GitLab issues queue: https://gitlab.com/koha-community/koha-manual/-/issues/18 Caroline Cyr La Rose has identified the cause of the issue[1] and a solution: - Caused by: 'sphinx.ext.autosectionlabel' setting in conf.py - Proposed solution: . update conf.py to remove setting: 'sphinx.ext.autosectionlabel', . change references to system preferences from: :ref:`SystemPreferenceName` . to: :ref:`SystemPreferenceName <systempreferencename-label>` [1] https://www.spinics.net/lists/linux-doc/msg77015.html
My suggested plan is to update these progressively - maybe a manual section/chapter at a time - as there are a lot of these to update! For each chapter/section being worked on, create a separate bug and link back in 'Depends on' to this omnibus bug - unless anyone else has a better idea. By the time it is finished this should have reduced the warning messages considerably - for me working locally, there currently there are 282 warning messages when the HTML output is produced.
Caroline, I've added you to the bug.
I am working on patches for this, hope to have something to show soon.
Thanks Katrin!
First patch up: https://gitlab.com/koha-community/koha-manual/-/merge_requests/591 It did seem to work ok when I created the html files locally.
A note to remember that we'll have to change the rst syntax cheatsheet on the wiki
I believe between Caroline's and my merge requests we should have taken care of all of them now. I suggest we remove the autosectionlabel after these are merged and then fix anything that remains.
(In reply to Caroline Cyr La Rose from comment #7) > A note to remember that we'll have to change the rst syntax cheatsheet on > the wiki This is done
Woot! Thanks Katrin and Caroline for all your speedy work on updating all the refs and fixing the casue of error messages! The manual is now generated without any warning or other error messages! David