My book is describing the actual behavior of the stylesheets, not the
processing expectations. I would say that the stylesheet does not meet the
processing expectations as documented in TDG. Norm Walsh once described why
he implemented index references that way for HTML output, but I don't recall
the explanation now. Perhaps he can fill us in.
Norm?
Regardless, it seems that there should be an option such that index
references take you to the point of origin of the entry, rather than the top
of the section containing the entry.
Bob Stayton
Sagehill Enterprises
[EMAIL PROTECTED]
----- Original Message -----
From: "Stefan Seefeld" <[EMAIL PROTECTED]>
To: "DocBook Apps Mailing List" <[email protected]>; "Norman
Walsh" <[EMAIL PROTECTED]>
Sent: Tuesday, March 11, 2008 9:39 AM
Subject: [docbook-apps] Request For Clarification: Indexterm processing in
auto-index generation.
Hi there,
earlier this year I asked about the expected and 'correct' behavior for
index generation in HTML and pdf, as I found (find) the current behavior
surprising.
Bob Stayton pointed me to this explanation:
http://www.sagehill.net/docbookxsl/IndexOutput.html
"Instead of page numbers (which do not exist in HTML), each link shows the
title of the section that contained the indexterm. That gives the reader
some context for the link.
...
The links go to the top of the section rather than to the anchor point
within the section. That's done to permit multiple identical indexterms in
the same section to collapse to a single entry. That's done to avoid
having to repeat the section title."
while I had read in "DocBook: The Definitive Guide":
http://docbook.org/tdg/en/html/indexterm.html
"IndexTerms identify text that is to be placed in the index. In the
simplest case, the placement of the IndexTerm in the document identifies
the location of the term in the text. In other words, the IndexTerm is
placed in the flow of the document at the point where the IndexEntry in
the Index should point. In other cases, attributes on IndexTerm are used
to identify the location of the term in the text."
I still find these two texts to contradict each other. I do find the
suggested processing expectation from TDG much more intuitive than the one
explained in "DocBook XSL: The Complete Guide".
At least, I'd appreciate if those two texts could be made to agree on what
the expected processing should be like. :-)
Thanks a lot,
Stefan
--
...ich hab' noch einen Koffer in Berlin...
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
