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

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

[footnotes follow .sig]

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]
> 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