This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Refentries in book TOC


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]