On 8/18/08, John Lapeyre <pdl at johnlapeyre.com> wrote:
> I am making html links into the maxima manual from
> another document. they look like this:
>
> manual_path/maxima_5.html#IDX97
>
> But if the manual changes (say adding a chapter or function)
> then a lot of links can break.
Yes. My advice is to avoid hyperlinks entirely.
> There is a file called index.hhk in the maxima html manual
> directory. It looks like xml or something, but it consists
> of a simple map between index entries and html links.
How about generating a TeX macro for each index item
from index.hhk, which maps each item's name to the appropriate
hyperlink? If you decide to use hyperlinks after all, that is.
The current documentation system is a mash-up of various
document processing schemes, held together with the proverbial
duct tape & bailing wire. It is certainly not guaranteed to stay the
same for any length of time, although it has a certain
institutional stability about it.
FWIW
Robert Dodier