Re: [docbook-apps] Linkable index in The Complete Guide

["Bob Stayton" <bobs@sagehill.net>]

Hi Dave,

Yes, it was done entirely by embedding indexterms and running the stylesheet machinery to generate the index.

 

I wrote a short macro at the time in the XML editor I was using to generate the elements (one macro for just primary entries, and one for primary plus secondary),  so all I had to do was position the cursor, execute the macro, and type in the text. While there, I usually tried to come up additional indexterms with synonyms and reversals of primary and secondary too.  After generating the first index with the stylesheet, I read it and settled on my indexing vocabulary, that is, which words would make the best primary entries, and which would be "See" entries, or "See also" entries. Then I  went back and edited the indexterms in place to align them with my vocabulary.  After two more passes like that, you see the result.

 

It is a tedious process, but I'm convinced that only a human (usually a  single human at that) can create a truly useful index.

 

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

 

 

----- Original Message -----

From: Xmplar

To: docbook-apps@lists.oasis-open.org

Sent: Saturday, October 08, 2011 1:42 AM

Subject: [docbook-apps] Linkable index in The Complete Guide

How was the hyperlinking index created for DocBook XSL: TCG? I'd like to try this for my FO output. Was it generated entirely from embedded indexterms?
Thanks

--
Dave Gardiner
Xmplar
info@xmplar.biz
http://xmplar.biz
Mob. 0416 833 993