This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: Refentries in book TOC
- From: Bob Stayton <bobs at caldera dot com>
- To: "Bradford, Denis" <denisb at rational dot com>, docbook-apps at lists dot oasis-open dot org
- Date: Thu, 07 Mar 2002 01:51:49 -0800
- Subject: Re: DOCBOOK-APPS: Refentries in book TOC
- References: <3906C56A7BD1F54593344C05BD1374B1053EB517@SUS-MA1IT01>
On Wed, Mar 06, 2002 at 01:23:32PM -0500, Bradford, Denis wrote:
> Here's a problem generating HTML using docbook.xsl 1.49 (1.48 too): An
> <indexterm> in a <refname> seems to foul up generation of links in the book
> TOC. Is this a bug?
>
> ************* diff.xml fragment ***************
> <refentry id="diff_refentry_25973">
> <?dbhtml filename="diff.html"?>
> <refnamediv>
> <refname>
> <indexterm id="indexterm_14213523">
> <primary>versions</primary>
> <secondary>merging</secondary>
> </indexterm>Diff
> </refname>
> ...
>
> ************* HTML generated in book TOC ***************
> <dt>
> <a href="diff.html">
> <a class="indexterm" name="indexterm_14213523"></a>Diff
> </a> - Compares or merges text files
> </dt>
> ****************************
>
> The <a> here identifies the link target, but the text, Diff, is not
> underlined and not active. If I move the indexterm somewhere else (like,
> before the refnamediv), TOC links work.
>
> Clearly, fixing the XML is one workaround, but a stylesheet fix would be
> better. Anybody know what template to customize? - it's not real clear to
> me.
Yes, it is a bug. Other titles in the TOC use special
templates to strip out the index entries. But refentry
doesn't use <title> so it wasn't being processed with them.
I fixed it in CVS (in html/autotoc.xsl and common/titles.xsl
if you want to pick them up before the next release).
--
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: bobs@caldera.com