[Python-Dev] Questions/comments on documentation formatting

Ben Finney ben+python at benfinney.id.au
Tue Jan 20 05:06:51 CET 2009


"Raymond Hettinger" <python at rcn.com> writes:

> What controls whether section headers get urls with a custom named
> jump target instead of a default name like "id1"?
> 
> In particular, look at the urls for:
>    http://docs.python.org/dev/library/collections.html#id1 versus

Hmm. Immediately preceding the <h2> element, there is also an empty
<span> element with a meaningful ID, "counter-objects", that can be
used to get to the same position in the document:

    http://docs.python.org/dev/library/collections.html#counter-objects

However, the problem is that URL isn't used for the “Permalink to this
headline” link.

Perhaps a bug report to the Docutils folks is in order.

-- 
 \     “Nature is trying very hard to make us succeed, but nature does |
  `\       not depend on us. We are not the only experiment.” —Richard |
_o__)                                   Buckminster Fuller, 1978-04-30 |
Ben Finney



More information about the Python-Dev mailing list