Re: [docbook-apps] plea for help with index generation

[Ian Castle <ian dot castle at coldcomfortfarm dot net>]

Here's a simple example. See if this works with your setup.

There are some places were jadetex can't cope with index entries:
notably if the indexterm is in a cell in a table. There may be one or
two other similar cases where it won't work if the indexterm is nested
in some fairly deep structure.

You'll need to run pdfjadetex three times so ensure that all forward and
backward references are resolved.


Good luck!

Ian.




On Thu, 2003-09-11 at 03:59, Mike Haberman wrote:
> Hello All,
> 
>    I am converting a document from page maker to docbook.  I am only
>    3 weeks old to all this -- but I have exhausted google.
> 
>    I need help with index generation for pdf.  I am using
>    docbook 4.2 with dsssl (1.78).
> 
>    After my command pipeline, my index entries have ?? for the page
>    references.
> 
>    Here's my pipeline:
> 
>       1. collateindex.pl -N -o index.sgml
>       2. openjade -t sgml -d
> $HOME/docbook/docbook-dsssl-1.78/html/docbook.dsl -V html-index book.sgm
>       3. collateindex.pl -o index.sgml HTML.index
>       4. openjade -t tex -V tex-backend -d book.dsl book.sgm
>       5. pdfjadetex book.tex
> 
> 
>       When I run step 5.  I get a lot these errors:
>       ! pdfTeX warning (dest): name{1743} has been referenced but does not
> exist, replaced by a fixed one
> 
>       I've tried to run step 4 (and step 5) a bunch of times-- but no help.
>       Table of contents references are fine.
> 
>       I am willing to try another command pipeline, but I need to
>       stick with dsssl and I need pdf for the final output.
> 
> 
>       Thanks so much.  I appreciate any help that others can lend.
> 
>       mike haberman
> 
> 
> 
>       version info:
>       -------------
>       collateindex.pl is from the 1.78 distribution
>       openjade:I: OpenJade version "1.3.1"
>       openjade:I: OpenSP version "1.3.4"
>       pdfjadetex: pdfTeX (Web2C 7.3.3.1) 3.14159-0.14h-released-20010417
>                          kpathsea version 3.3.3.1
> 
> 
>      P.S.  I get the following errors when I run step 2:
> 
>      openjade:/home/mikeh/docbook/docbook-dsssl-1.78/html/../catalog:28:0:W:
>      DTDDECL catalog entries are not supported
>      openjade:/home/mikeh/docbook/docbook-dsssl-1.78/html/../catalog:28:0:W:
>      DTDDECL catalog entries are not supported
> 
> 
> 
> To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org.
> 

<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
<!ENTITY index.xml SYSTEM "index.xml">
]>
<book>

<chapter><title>Test Of Indexes</title>

<para>This is a test of indexes. It might also be about fish<indexterm><primary>Fish</primary></indexterm>.</para>
</chapter>
&index.xml;
</book>

<!DOCTYPE style-sheet PUBLIC "-//OpenJade//DTD DSSSL Style Sheet//EN" [
<!ENTITY html-ss 
  PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl>
<!ENTITY print-ss
  PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA dsssl>
]>
<style-sheet>
<style-specification id="print" use="print-stylesheet">
<style-specification-body> 

</style-specification-body>
</style-specification>

<style-specification id="html" use="html-stylesheet">
<style-specification-body>

</style-specification-body>
</style-specification>
<external-specification id="print-stylesheet" document="print-ss">
<external-specification id="html-stylesheet"  document="html-ss">
</style-sheet>

#!/bin/sh

# First, create an empty file so we have something to include

collateindex.pl -N -o index.xml

# Now create index HTML.index file

openjade -v -t xml -V html-index -V nochunks -dsmall.dsl#html /usr/share/sgml/xml.dcl small.xml > /dev/null

# Now create the index for real

collateindex.pl -o index.xml HTML.index

# Now process the whole thing in the normal manner

openjade -v -t tex -V tex-backend -dsmall.dsl#print /usr/share/sgml/xml.dcl small.xml

#
# Now run pdfjadetex three times to make sure all the forward/backend references have been resolved

pdfjadetex small.tex
pdfjadetex small.tex
pdfjadetex small.tex


To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org.