I'm working on existing documentation with heavy indexing. The way that <indexterm> is coded will very often lead to unwanted whitespace (blank lines).
I've read a lot about how to correctly index with Docbook/Publican, but I'm still unable to find an acceptable solution. Existing XML, which typically looks like this, will show up with an additional blank line between the section header and the included diagram. ~~~~ <section id="mthXxxx"><title>method</title> <indexterm><primary>method</primary> <secondary>of Class</secondary></indexterm> <indexterm><primary>method</primary> <secondary>method</secondary> <tertiary>of Class</tertiary></indexterm> <mediaobject> <imageobject> <imagedata fileref=".." /> </imageobject> </mediaobject> <para>Returns .. ~~~~ Moving the <indexterm> into the <title> (as shown below) will remove the blank line, but any <xref> links to this id will show up with a glaring trailing blank, even if I carefully orchestrate <indexterm> and <indexterm>. ~~~~ <section id="mthXxxx"><title>method<indexterm> <primary>method</primary> <secondary>of Class</secondary> </indexterm><indexterm> <primary>method</primary> <secondary>method</secondary> <tertiary>of Class</tertiary> </indexterm></title> ~~~~ Moving the <indexterm> into the following paragraph isn't a nice option either, as any <xref> links should really point to the heading, not (depending on the diagram size) maybe much further down. As I'm having the same issue with indexed examples without titles, where I cannot see *any *possibility to move the <indexterm> to, I'm wondering if Publican could be instructed to simply ignore whitespace that gets introduced with <indexterm>
_______________________________________________ publican-list mailing list [email protected] https://www.redhat.com/mailman/listinfo/publican-list Wiki: https://fedorahosted.org/publican
