RE: [docbook-apps] HTML links not being created in my indexes

["Mauritz Jeanson" <mj@johanneberg.com>]

> -----Original Message-----
> From: Hendrik Schreiber 
 
> Unfortunately none of the index entries in the generated index are  
> actual functional links to the referenced sections. Blaine Simpson  
> seemed to have had the same problem, but it wasn't solved (http:// 
> sourceware.org/ml/docbook/2004-04/msg00027.html).
> 
> Here's an example:
> 
> <?xml version="1.0" encoding="UTF-8"?>
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http:// 
> www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ ]>
> <book>
>      <chapter>
>          <title>Title</title>
>          <para>First Para
>              <indexterm>
>                  <primary>IndexTerm in first para</primary>
>              </indexterm>
>          </para>
>          <sect1>
>              <title>
>                  <indexterm>
>                      <primary>IndexTerm in sect1 title</primary>
>                  </indexterm>
>              </title>
>              <para>Sect1 para
>                  <indexterm>
>                      <primary>IndexTerm in sect1 para</primary>
>                      <secondary>IndexTerm in sect1 para</secondary>
>                  </indexterm>
>              </para>
>          </sect1>
>      </chapter>
>      <index/>
> </book>


When I tested this document with Saxon 6.5.4, I did get one working index
link (to the chapter title), but the others were missing. 

Missing index links is a known issue[1] with at least one version of Xalan
(you say that you use Java 1.4.2, and it might actually be Xalan behind the
scenes; I forget the details).

There is another problem: the title element in the sect1 contains only
whitespace + an indexterm. Although this is valid markup, the processing
expectations[2] imply that indexterms are not supposed to be rendered in the
primary flow of the document. An index link points to a title, but in this
case the title is empty. It works better with some text in there.

[1] http://lists.oasis-open.org/archives/docbook-apps/200406/msg00238.html.
[2] http://docbook.org/tdg/en/html/indexterm.html


/MJ