Re: [docbook-apps] Indexing.

Hi, 

some technical/formatting things we ran into while using indexes:

1. Indexterms within listitems add a line break in the generated HTML (if they come first). Review the entire documentation, and either reposition them to come after a para (workaround), or use zones:

<listitem>
<indexterm zone="para1">
<primary>term1</primary>
<secondary>term2</secondary>
</indexterm>
<para xml:id="para1">loremipsum</para>
</listitem>

(Zones documented at: http://docbook.org/tdg/en/html/indexterm.html)

2. When adding indexterms directly after  a <section> or similar tag, we got validation errors, so now we place them after the title tag. However, this causes the browsers scroll through the title, which is a bit confusing, because the title of the section/procedure/whatever is not always visible

HTH, 

Robert

On Wed, Jun 22, 2016 at 8:27 AM, Dave Pawson <> wrote:
I agree, the more I've used it the more I'm impressed with the coding,

for which many thanks to the docbook team.

regards

On 21 June 2016 at 23:06, Pc Thoms <> wrote:

> Hi Dave and Docbook-apps Company:

>

> In working with a legacy text, 1875, and it's index I entered five secondary

> entries, expecting an error, using the following:

>

> <index><title>Index</title>

> <indexentry><primaryie>Admission to Seats in Synod</primaryie>

> <secondaryie>Ven. Archdeacon McMurray</secondaryie>

> <secondaryie>Rev. Dr. Sullivan</secondaryie>

> <secondaryie>Rev. Dr. Stocking</secondaryie>

> <secondaryie>Wm. J. Harris</secondaryie>

> <secondaryie>W. B. Curran</secondaryie></indexentry>

> </index>

>

> And to my surprise and delight this validated and produced the desired

> entry.

> All I have to say is that the xslt stylesheets for DocBook are awesome!

> If this should not work - don't change anything.

>

> Grateful - Paul

>

>

> On Sat, May 5, 2012 at 4:40 AM, davep <> wrote:

>>

>> I'm about to start indexing a db5 book.

>> Reading up on the subject(Nancy C. Mulvany) and wondered if anyone has

>> been there and done that, got the tee-shirt and found the pitfalls in

>> docbook? Any advice from those with lots of experience of using

>> db indexes please?

>>

>>

>>

>> regards

>>

>> --

>> Dave Pawson

>> XSLT XSL-FO FAQ.

>> http://www.dpawson.co.uk

>>

>> ---------------------------------------------------------------------

>> To unsubscribe, e-mail: 

>> For additional commands, e-mail: 

>>

>

---------------------------------------------------------------------

To unsubscribe, e-mail: 

For additional commands, e-mail: