[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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

Andrey Rahmatullin <wrar@debian.org> writes:

> Package: debian-policy
> Version:
> 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.

Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>

Reply to: