docbook: index generation
Subject:
Re: Re: index generation
From:
Peter Jay Salzman ####@####.####
Date:
2 Apr 2003 20:43:37 -0000
Message-Id: <20030402204335.GA721@dirac.org>
begin Greg Ferguson ####@####.####
> On Wed, 2 Apr 2003 09:45:49 -0800 Peter Jay Salzman ####@####.#### wrote:
>
> > hi greg et al,
> >
> > ok, first an apology. i didn't know about the mailing list search, but
> > i do now. :) anyway, i'm getting an error. here's a snippet of the
> > makefile:
> >
> > STYLE='/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/ldp.dsl'
> > TARGET=lkmpg
> >
> > all:
> > collateindex.pl -N -o index.sgml
> > jade -t sgml -V html-index -d ${STYLE} ${TARGET}.sgml
> >
> >
> > at this point (the invocation of jade), i get an error:
> >
> > jade:index.sgml:1:6:E: document type does not allow element "INDEX"
> > here
> > jade:lkmpg.sgml:96:85:E: end tag for "APPENDIX" which is not finished
> >
> > index.html contains (in its entirety):
> >
> > <index>
> >
> > <!-- This file was produced by collateindex.pl. -->
> > <!-- Remove this comment if you edit this file by hand! -->
> > </index>
> >
> >
> > lkmpg.sgml (the relevent portion) contains:
> >
> > <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
> > <!ENTITY TheIndex SYSTEM "index.sgml">
> > ]>
> > <book>
> > ...
>
>
> As someone else suggested, try it outside of a container element:
>
> ...
> <appendix><title>Where To Go From Here</title>&WhereFromHere;</appendix>
> &TheIndex;
> </book>
>
> Also, if referencing the LDP stylesheet (I assume it's the same as what
> is provided on our website), you need to use an identifier when utilizing
> it in a jade command line:
>
> STYLE='/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/ldp.dsl#html'
>
hi john and greg,
thank you! progress is being made! lkmpg.html has an index :), but
lkmpg.ps doesn't :(. makefile is at the bottom.
is there a way to generate an index for the postscript version of the
guide?
the whole build process is kind of a black box to me, but it seems like
ldp_print (or perhaps htmldoc?) may need to be hacked. is that about
right?
if so, i'm willing to be happy with an index just in the html version.
btw, i really like the search utility for this list. it's much better
than what my LUG uses (lugod.org). but is there a way to do searches
with "and"? something google-like:
"+index +postscript"
pete
TARGET=lkmpg
STYLE='/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/ldp.dsl'
JADEOPTIONS=-t sgml -i html -V nochunks -d $(STYLE)\#html
new:
# Generate the index
collateindex.pl -N -o index.sgml
jade -t sgml -V html-index -d ${STYLE}\#html ${TARGET}.sgml
collateindex.pl -g -t Index -i doc-index -o index.sgml HTML.index
jade ${JADEOPTIONS} ${TARGET}.sgml > ${TARGET}.html
-ldp_print ${TARGET}.html
make tidy