On 26 February 2014 10:36, Kurt Callaway <[email protected]> wrote:
> Hi!
>
> I'm using asciidoc 8.6.8 to build large docs concurrently in HTML and
> Docbook/PDF.
>
> For the PDF outputs (since users may print them to harcopy), I include an
> Index at the back, using asciidoc's "indexterm:[]" macro throughout the
> document to pick up the needed terms.
>
> 1.)  I staked the location for the index by placing [index] at the end of
> the master file of my book.  I wanted a section title for it, so I added a
> text line "Error Code Index" under that.  Unfortunately, while that title
> shows up correctly in PDF at the head of the index, it also appears in HTML,
> where it is displayed by itself (even though there is of course no index).
> Is there a way to get the section title to display only during a2x()'s
> Docbook/PDF processing and not during asciidoc()'s HTML processing?  I'm
> considering a conditional inclusion macro around the line, similar to a
> suggestion of Dan Allen's from a post in October 2013:
>       ifdef::basebackend-docbook[Error Code Index]
> Is this the best way to approach it?

Hi Kurt,

Yes, conditional macro or attribute reference will do it.

>
> 2.)  Another problem was that many terms I needed to index have commas in
> them.  Saw an entry in this forum from last December that said footnote
> macro strings must be quoted if they contain commas.  Happily, using quotes
> also works for indexterm strings.

That applies to all macro parameters that contain commas, because
commas normally separate parameters they need to be quoted to include
them in the parameter.

Cheers
Lex

>
> 3.)  Although not really an asciidoc issue, I will note that the a2x
> processing defaults to two-column indices.  To force a single column index,
> I changed my a2x() incantation to include '--xsltproc-opts "--stringparam
> column.count.index 1" '.  Worked like a charm.
>
> Thanks,
> Kurt Callaway
> Houston, Texas
>
> --
> You received this message because you are subscribed to the Google Groups
> "asciidoc" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at http://groups.google.com/group/asciidoc.
> For more options, visit https://groups.google.com/groups/opt_out.

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to