MapServer
link bahaviour on subsections
I noticed at various locations in docs this convention:
.. index::
pair: Apache; ReWriteRule
Apache ReWrite rules (using Apache mod_rewrite)
-----------------------------------------------
With current setup this is encoded in html as:
<h3>
<a class="toc-backref" href="#table-of-contents" role="doc-backlink">Apache ReWrite rules (using Apache mod_rewrite)</a>
<a class="headerlink" href="#apache-rewrite-rules-using-apache-mod-rewrite" title="Link to this heading">¶</a>
</h3>
It is a convention i'm not familiar with, even unexpected. In stead I would expect a single link to the current item (to be able copy/paste it) and if desirable an extra to-top link which brings the user back to the TOC.
@pvgenuchten I'm not quite understanding. Sphinx's index directive is used to define the terms in the index, nothing to do with a TOC.
From what I remember, previously none of these indexed items could be linked to at all. I added in a new option to Sphinx with the help of the developers there at https://github.com/sphinx-doc/sphinx/pull/7087 and then added to the MapServer docs in https://github.com/MapServer/MapServer-documentation/pull/324 to get fixed URLs for all indexed items. The first link I think is default behaviour in Sphinx when using a TOC.
