[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Texi2html-bug] Setting $element->{id} if manual is not split (i.e.
From: |
Patrice Dumas |
Subject: |
Re: [Texi2html-bug] Setting $element->{id} if manual is not split (i.e. element_file_name is not called)? |
Date: |
Tue, 2 Sep 2008 14:20:07 +0200 |
User-agent: |
Mutt/1.5.18 (2008-05-17) |
On Sat, Aug 30, 2008 at 12:02:11AM +0200, Reinhold Kainhofer wrote:
>
> For us the issue is not so much to absolutely guarantee uniqueness, but
> rather
> to provide anchor names, which don't change over time. In particular, we
> often answer user requests by simply posting a link to the documentation. Of
> course, those links should always work. SECxx is bad in that regard, because
> whenever a subsection is added somewhere, everything after that will change
> anchors and the posted links will point to the wrong section (the docs on the
> homepage are updated quite frequently to the latest version...).
> That's why I base the anchor names on the node names (which need to be unique
> in the document, anyway). And for those sections without a node attached:
> Well, that's our problem then to guarantee that the section names are unique
> (at least unique within each section due to our file splitting).
I have implemented human readable anchors for sections. However to
disambiguate these from nodes, they may have a number starting at 1
appended, like
section-1
In fact, each time the node and the section have the same name, theere
will by such a character appended.
--
Pat