From mboxrd@z Thu Jan 1 00:00:00 1970 From: Wookey To: Peter Toft Cc: docbook-tools-discuss@sourceware.cygnus.com Subject: Re: Indexes in PDF docs Date: Wed, 19 Dec 2001 22:49:00 -0000 Message-id: References: X-SW-Source: 2001/msg00029.html On Thu 22 Feb, Peter Toft wrote: > On Thu, 22 Feb 2001, Paul Webb wrote: for clarity - I'm working with Paul Webb on the same docs > > I have marked up my document by using the > > ... method as described in > > 'DocBook: The Definitive Guide' I've also managed to produce an index in the > > HTML version of the doc by using collateindex.pl. > > But how do I produce an index in the PDF? Can I use collateindex.pl in > > conjunction with some other commands or is there an alternative method? > Sure you can; > For HTML as well as PS/PDF I use > perl ./collateindex.pl -s Symbols -t Index \ > -g -i index -N -o index.sgml > cp *.sgml tempdir > (cd tempdir; jade -t sgml -ihtml -d $(cygnus)\#print \ > -V html-index -V nochunks MAIL_FILE.sgml > foo.html) > perl ./collateindex.pl -s Symbols -t Index -g -i index \ > -o index.sgml tempdir/HTML.index > If it bites back mail me again. I don't quite get how this is supposed to work. The above is essentially what we are doing for our HTML output (apart from the -V nochunks) and I get an sgml index file which refers to tags in the HTML output. But I don't understand how to get from here to a PDF file. The nub seems to be jade -t sgml -ihtml -Vhtml-index generates an index file collateindex put this back into sgml form, then jade -t sgml -ihtml reprocesses the original including the index on the end into indexed html. So is the equivalent for pdf as follows:? jade -t sgml -ihtml -Vhtml-index generates an index file collateindex put this back into sgml form, then jade -t tex -ihtml pdfjadetex pdfjadetex pdfjadetex ie I just change the backend type? And what does that -i option do? /usr/doc/jade doesn't seem to mention it, but it appears to be important. If not do I need different index-generating options -i and -V If I just try the above then I get a 5M tex file (instead of the 1Mb I was previously getting) and attempting to process it to PDF with jadetex make Tex barf with 'out of memory' almost immediately. Maybe this is working but I'm up against the 'TeX memory problem' again? Trying a slightly different tack (as I'm not sure about that -i option): jade -t sgml -ihtml -V html-index generates an index file collateindex put this back into sgml form, then jade -t tex -V html-index pdfjadetex pdfjadetex This produces a sensible size tex file and it processes OK. It even has an index, but most of the page numbers are '?' and the rest are '-999', so that's not quite right. It feels like I'm getting warm.... Trying the above without even -V html-index on the second jade run works a bit better still - now I have about a third of the index page numbers filled in, but only around page 12, pages 70-76 and page 124. Nor do they point to the correct pages :-( Can someone tell me if I'm on the right track so I can try the right things/ask the right questions? Or even better just tell me which rune I need :-) Is it just a matter of changing the second jade run or do I need to generate the index with different options in the first place? thanx muchly. Wookey -- Aleph One Ltd, Bottisham, CAMBRIDGE, CB5 9BA, UK Tel (00 44) 1223 811679 work: http://www.aleph1.co.uk/ play: http://www.chaos.org.uk/~wookey/ From mboxrd@z Thu Jan 1 00:00:00 1970 From: Wookey To: Peter Toft Cc: docbook-tools-discuss@sourceware.cygnus.com Subject: Re: Indexes in PDF docs Date: Fri, 23 Feb 2001 09:08:00 -0000 Message-ID: References: X-SW-Source: 2001-q1/msg00029.html Message-ID: <20010223090800.Emy7cUWU5MwLUhiHVWSVGa_L-TNYPwlNOGlzjTQj9uA@z> On Thu 22 Feb, Peter Toft wrote: > On Thu, 22 Feb 2001, Paul Webb wrote: for clarity - I'm working with Paul Webb on the same docs > > I have marked up my document by using the > > ... method as described in > > 'DocBook: The Definitive Guide' I've also managed to produce an index in the > > HTML version of the doc by using collateindex.pl. > > But how do I produce an index in the PDF? Can I use collateindex.pl in > > conjunction with some other commands or is there an alternative method? > Sure you can; > For HTML as well as PS/PDF I use > perl ./collateindex.pl -s Symbols -t Index \ > -g -i index -N -o index.sgml > cp *.sgml tempdir > (cd tempdir; jade -t sgml -ihtml -d $(cygnus)\#print \ > -V html-index -V nochunks MAIL_FILE.sgml > foo.html) > perl ./collateindex.pl -s Symbols -t Index -g -i index \ > -o index.sgml tempdir/HTML.index > If it bites back mail me again. I don't quite get how this is supposed to work. The above is essentially what we are doing for our HTML output (apart from the -V nochunks) and I get an sgml index file which refers to tags in the HTML output. But I don't understand how to get from here to a PDF file. The nub seems to be jade -t sgml -ihtml -Vhtml-index generates an index file collateindex put this back into sgml form, then jade -t sgml -ihtml reprocesses the original including the index on the end into indexed html. So is the equivalent for pdf as follows:? jade -t sgml -ihtml -Vhtml-index generates an index file collateindex put this back into sgml form, then jade -t tex -ihtml pdfjadetex pdfjadetex pdfjadetex ie I just change the backend type? And what does that -i option do? /usr/doc/jade doesn't seem to mention it, but it appears to be important. If not do I need different index-generating options -i and -V If I just try the above then I get a 5M tex file (instead of the 1Mb I was previously getting) and attempting to process it to PDF with jadetex make Tex barf with 'out of memory' almost immediately. Maybe this is working but I'm up against the 'TeX memory problem' again? Trying a slightly different tack (as I'm not sure about that -i option): jade -t sgml -ihtml -V html-index generates an index file collateindex put this back into sgml form, then jade -t tex -V html-index pdfjadetex pdfjadetex This produces a sensible size tex file and it processes OK. It even has an index, but most of the page numbers are '?' and the rest are '-999', so that's not quite right. It feels like I'm getting warm.... Trying the above without even -V html-index on the second jade run works a bit better still - now I have about a third of the index page numbers filled in, but only around page 12, pages 70-76 and page 124. Nor do they point to the correct pages :-( Can someone tell me if I'm on the right track so I can try the right things/ask the right questions? Or even better just tell me which rune I need :-) Is it just a matter of changing the second jade run or do I need to generate the index with different options in the first place? thanx muchly. Wookey -- Aleph One Ltd, Bottisham, CAMBRIDGE, CB5 9BA, UK Tel (00 44) 1223 811679 work: http://www.aleph1.co.uk/ play: http://www.chaos.org.uk/~wookey/