OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Request For Clarification: Indexterm processing in auto-index generation.

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.


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

----- Original Message ----- 
From: "Stefan Seefeld" <seefeld@sympatico.ca>
To: "DocBook Apps Mailing List" <docbook-apps@lists.oasis-open.org>; "Norman 
Walsh" <ndw@nwalsh.com>
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: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]