[singlehtml] add docname to section anchor to make them unique

[gastmaier]

Purpose

Follow up to #13717, inverting the logic, instead of patching the toctree to yield "#id1" instead of "#document-path/to#id1", have the section id to be docname preffixed, solving non-unique ids in singlehtml.
Allows to remove post Sphinx transforms like in here

Top level overview of current behavior

• ID collision is resolved per doc (#already-used -> #id1, #already-used -> #id2).
• There is no ID collision resolution on singlehtml step.

Approach taken

Based on the LaTeX builder solution.
sphinx/writers/latex.py#hypertarget[withdoc=True] method suffixes docutils id with the docname.
In my implementation I edit ids['0'] directly to not have to overwrite the whole visit_section method, but I understand if requested to not modify the tree and instead overwrite.

On the format #document-test/extra#id1

It is compatible with HTML anchoring, CSS and JavaScript selectors, but require escaping:

#document-test\/extra\#test {color: #f00;}

document.querySelector('#document-test\\/extra\\#test')

Tests

The following tests are relevant:

• tests/test_builders/test_build_html_tocdepth.py
• test_build_html_numfig.py

References

• [singlehtml] toctree no filename with anchor #13717 (replaces)
• 🐛 Fix singlehtml target uris to be same-document references #11970,
• singlehtml: Use same-document hyperlinks for internal project references #12551
• singlehtml: deprecate the 'fix_refuris' helper function #13037

[jayaddison]

Hi @gastmaier - I'm a former semi-regular volunteer contributor here, although I have been less active recently. Thanks for the pull request; and sorry that I did not notice the toctree constructor problem, as you mention in #13717.

I am reading both #13717 and this PR #13739 to try to understand the different approaches and reasons for them.

Also: do you have a test case that we could add under tests/roots that demonstrates the problem? I suppose it would need to include a table of contents of some kind and have a corresponding singlehtml test case.

[gastmaier]

Hi @jayaddison maybe extending tests/test_builders/test_build_html_tocdepth.py
to check for duplicated ids?
as is, it already checks if ids are as expected (e.g., the pr changes things in 3 location to keep passing the test)., but not for duplicated ids, so I guess I can add that assertion

[jayaddison]

@gastmaier that sounds perfect, yep! (I'd forgotten about those tests)

[akhilsmokie7-cloud]

Align with purpose