Re: [docbook-apps] Generating e-pub and html indexes

From
Pc Thoms <>
Date
2013-07-23T12:58:01+00:00
ID
CAHZ81Os5pbQYu-wgG6L=
Thread
Re: [docbook-apps] Generating e-pub and html indexes
Hi Paul
You are right about my desire to change the appearance of the locator in the generated index. I would prefer a locator like a page number.

I understand that the locators generated in html, etc., give the context of the <indexterm/>. However, I would prefer a locator such as

c1s3p7 (chapter one, section 3, paragraph 7), or c4t3 (chapter four, table 3), if not the exact locator given in an equivalent pdf file. Or, each locator might be given a sequential number. I am looking for a simply link in an index than the chapter title.

With thanks

On Tue, Jul 23, 2013 at 4:12 AM, Bob Stayton <> wrote:

Hi Paul,

I misunderstood what you meant by locator.  As you said 
in your earlier mail, setting the stylesheet parameter 'index.links.to.section' 
to a value of  zero creates an href that sends the link directly to the 
point in the text where the indexterm was located.  I don't think you can 
get any more specific than that.  So I think your last paragraph is 
satisfied.

 

The hot link text displayed in the index is still the section 
title, even though the link lands at the specific point.  I thought you wanted to change the hot text, from the section title to 
something like a page number, so I was asking about an example of what you want 
the hot text to say instead of the section title, given that page numbers don't 
exist in HTML output.  

 

Bob Stayton
Sagehill Enterprises


From: Pc Thoms 

Sent: Monday, July 22, 2013 5:02 PM

To: Bob Stayton 

Cc: Jirka 
Kosek ;  

Subject: Re: [docbook-apps] Generating e-pub and html 
indexes

A specific example I should not provide, as it is beyond my expertise, but 
I have expectations and hopes for such. I am fairly competent in xml, but not 
with xslt.

If the locators in a DocBook formatted xml file can point to the 
<chapter/>, <section>, <para/>, <table/>, etc., within 
the document, the more specific the reference between the locator and the 
origination of the <indexterm/> so much the better. Preferably the 
generated locator will point directly to the originating <indexterm/> 
placed in the document, or the lowest hierarchical block element. Rather than 
linking to the <chapter/>, which may contain hundreds, to thousands, of 
words it would be better to link to the lowest hierarchical block element that 
contains the <indexterm/>, such as a <para/> or <line/> 
(DocBook-Publisher).

This should make the an <index/> locator link directly to specific 
place in the text, that one would presumably be interested in once they click a 
link.

Locators that link to the beginning of a <chapter/> or 
<section/> that may contain 500+ words is not very useful. But a locator 
that links one directly to the <section>, <para/>, <table/>, 
or <line/>, would serve its’ readers well.

What I’m looking for is an index locator that has an “href” attribute that 
links directly to an anchored point in an XHTML and E-Pub document.

Any assistance, and direction, is appreciated.

Paul