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?
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.
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.
