docbook: creating an index (follow-up)
Subject:
creating an index (follow-up)
From:
Greg Ferguson ####@####.####
Date:
4 Apr 2003 19:08:41 -0000
Message-Id: <200304041858.h34Iw2Kj026031@hoop.timonium.sgi.com>
After running into a few problems, I discovered that ldp.dsl
should *not* be used when building a back-of-the-book style index.
Here are the revised steps:
1. Add <indexterm> references into your SGML file.
2. Add an entity reference in your main SGML file:
<!DOCTYPE Article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY myindex SYSTEM "index.sgml">
..
]>
3. Include/reference the entity at the end of the file/document or
wherever you wish to have the index occur, but not inside of
another container element (with the exception of <book> or
<article> of course!):
&myindex;
</article>
4. Run the the tools to generate the index. Reference the generic
DocBook DSSSL stylesheet on the {open}jade command line:
collateindex.pl -N -o index.sgml
jade -t sgml -V html-index -d <style_path>/html/docbook.dsl <file>.sgml
collateindex.pl -g -t Index -i doc-index -o index.sgml HTML.index
You will now have an index.sgml file which can be used in conjunction
with a normal run of the tools (which you use to produce your HTML
files, etc).
That will work.
--
Greg Ferguson * SGI principal engr / LDP contributor
SGI Tech Pubs * http://techpubs.sgi.com/ | gferg(at)sgi.com
Linux Doc Project* http://tldp.org/ | gferg(at)metalab.unc.edu