Re: [Docutils-users] reST->HTML: internal anchors: problem casting section names to IDs

[Tom R. <Tom...@po...>]

one more mistake to correct :-(

> Tom Roche[1]
> >> Small reST document[2] has sections with unique names. When I use docutils/restview to convert it to HTML, all but one section id is created by (speaking `sed`ishly) `s/ /-/g`. However *one* section id is "hashed" (i.e., created like a backref), which breaks an explicit internal anchor.

- Marc 'BlackJack' Rintsch[3]
+ Günter Milde[3]

> > Here is the problem: you define an external target with the URL "#long-term-bodywear" (which happens to point to the same document) therefore also: "reference-external".

> Doh! Thanks for clarifying. I had assumed all links were created in the same way.

> > The following works here as expected::
  
> >   .. howto style a link (e.g., make it italic): see http://docutils.sourcefor
> >   .. |long-term bodywear| replace:: *long-term bodywear*
> >   .. |short-term bodywear| replace:: *short-term bodywear*
  
> >   short-term bodywear
> >   -------------------
  
> >   *see also* |long-term bodywear|_
  
> >   long-term bodywear
> >   ------------------
  
> >   *see also* |short-term bodywear|_

> ... and that renders correctly locally via `restview` and remotely via Bitbucket[4].

> thanks again, Tom Roche <Tom...@po...>

> [1]: https://sourceforge.net/p/docutils/mailman/message/34982519/
> [2]: flawed version @ https://bitbucket.org/!api/2.0/snippets/tlroche/LR9oL/9277baf6d61904d1725c39dae4df8b7550192ebc/files/problematic_naming_of_internal_anchors.rst
> [3]: https://sourceforge.net/p/docutils/mailman/message/34984893/
> [4]: fixed version @ https://bitbucket.org/!api/2.0/snippets/tlroche/LR9oL/HEAD/files/problematic_naming_of_internal_anchors.rst