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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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: [email protected]
> >> For additional commands, e-mail: [email protected]
> >>
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [email protected]
> For additional commands, e-mail: [email protected]
>
>

Reply via email to