Re: Bug#876075: Anchors are non-unique in the single-HTML version

Russ Allbery <[email protected]>
Newsgroups gmane.linux.debian.devel.www
Organization The Eyrie
Message-ID <[email protected]>
Andrey Rahmatullin <[email protected]> writes:

> Package: debian-policy
> Version: 4.1.0.0
> Severity: normal

> https://www.debian.org/doc/debian-policy/#version
> https://www.debian.org/doc/debian-policy/index.html#introduction

> etc.

> This breaks the ToC.

More troublingly, this also breaks all the footnotes.  We can fix the
headings by explicitly setting an anchor, but I don't think the footnotes
are fixable without fixing things in Sphinx.

I'm not sure where we landed with this, but it feels like the single-HTML
output from Sphnix is kind of broken, and publishing that on the web site
has caused various problems.  I'm not sure how to get to the multi-page
version on www.debian.org, and indeed the anchors and table of contents in
Policy are not working right now on the web site because of this problem.

I feel like the single-page HTML version may have been a failed
experiment, at least pending further work on Sphinx, and we should just
publish the multi-page version.  What do other people think?  (Adding
debian-www for their opinion as well.)

Not having working footnotes feels to me like kind of a showstopper.
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.