Title Bout: Jim v. Doctools

Wednesday March 28, 2001 | Permalink | Comments (5)

Well, here I am. I have a site to collect my thought. I have my new Handspring to do PalmOS programming with. I have the beginnings of a PalmOS Developer's Document. I want to make it into a full fledged HOWTO written in the LDP or Doctools style. I'm going to continually update this story to track my progress and questions. I've been tearing my hair out on this one. Any tips would be appreciated.[Update Thu Mar 29 13:28:29 AKST 2001] I got it working! Read on for details.

I'm starting with the docbook install mini-howto from http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/

I'm going with openjade instead of jade. Seems to do the same things. I'm installing everything in /usr/local/sgml (even though this should do XML as well). Here's what I'm installing

openjade 1.3 http://openjade.sourceforge.net/
DocBook SGML DTD (v3.1 and v4.1 ) http://www.oasis-open.org/docbook/sgml/index.html
ISO8879 ENTITY SGML
- http://www.oasis-open.org/cover/topics.html#entities
- http://www.oasis-open.org/cover/ISOEnts.zip
- http://www.oasis-open.org/cover/isoENT-tar.gz
DocBook DSSSL. I'm getting both the norman walsh base and the ldp additions.
- http://nwalsh.com/docbook/dsssl/
- http://www.linuxdoc.org/authors/tools/ldp.dsl
I'm not installing Sgmltools-lite, htmldoc, or docbook2X. I don't think I need them yet.

Now to the install

First openjade. It seems to be a well behaved GNU autotools app. I got it with ./configure --prefix=/usr/local/sgml/openjad-1.3 && make && make install

Now I'm ready to install the docbook DTD's. No compiling just unpacking

styx:~# cd /usr/local/sgml/
styx:/usr/local/sgml# 
styx:/usr/local/sgml# mkdir docbook
styx:/usr/local/sgml# cd docbook
styx:/usr/local/sgml/docbook# mkdir 3.1 4.1 
styx:/usr/local/sgml/docbook# cd 3.1
styx:/usr/local/sgml/docbook/3.1# unzip -a /usr/local/sgml/0archive/docbk
styx:/usr/local/sgml/docbook/3.1# cd ../4.1/
styx:/usr/local/sgml/docbook/4.1# unzip -a /usr/local/sgml/0archive/docbk41.zip

Next, unpack the ISO8879 Entities

styx:/usr/local/sgml/docbook/4.1# unzip -a /usr/local/sgml/0archive/ISOEnts.zip 
styx:/usr/local/sgml/docbook/4.1# cd ../3.1/
styx:/usr/local/sgml/docbook/3.1# unzip -a /usr/local/sgml/0archive/ISOEnts.zip

Note that the files from ISOent-tar.gz end in.ent, but need to end in .gml. Here is a one line bash script to move them all to the right name.


styx:/usr/local/sgml/docbook/3.1# cd /tmp
styx:/tmp# mkdir ents
styx:/tmp# cd ents
styx:/tmp/ents# tar -xzf /usr/local/sgml/0archive/isoENT-tar.gz 
styx:/tmp/ents# for i in `find . -type f`;do mv $i `echo $i | sed -e 's/.ent/.gml/g'`;done

Now that they are all renamed, I'll get them into the 3.1 and 4.1 directories respectively. I see that there is a bit of filesystem redundancy with my install method. But I want to be overly cautious right now because I've learned from previous attempts that I know nothing about how this really works yet :)

styx:/tmp/ents# cd /usr/local/sgml/docbook/3.1
styx:/usr/local/sgml/docbook/3.1# cp /tmp/ents/* .
styx:/usr/local/sgml/docbook/3.1# cd ../3.1/
styx:/usr/local/sgml/docbook/3.1# cd ../4.1/
styx:/usr/local/sgml/docbook/4.1# cp /tmp/ents/* .

Now the howto says to make symlinks from the .cat file to a catalog file.

styx:/usr/local/sgml/docbook/4.1# ln -s docbook.cat catalog
styx:/usr/local/sgml/docbook/4.1# cd ../3.1/
styx:/usr/local/sgml/docbook/3.1# ln -s docbook.cat  catalog

Now, moving on to the DSSSL. Again, just unzipping with no compilation required.

styx:~# cd /usr/local/sgml/
styx:/usr/local/sgml# mkdir dsssl
styx:/usr/local/sgml# cd dsssl
styx:/usr/local/sgml/dsssl# unzip -a /usr/local/sgml/0archive/db164.zip
styx:/usr/local/sgml/dsssl# cd docbook/
styx:/usr/local/sgml/dsssl/docbook# cp /usr/local/sgml/0archive/ldp.dsl html/
styx:/usr/local/sgml/dsssl/docbook# cp /usr/local/sgml/0archive/ldp.dsl print

Movin' right along... This is the bugger. You have to setup and SGML_CATALOG_FILES shell variable. Since I don't know which catalog files I'll actually use to produce one of these thingies, I'm not sure whether I need to use all of them. This is where I'm starting. I saved the following in a file called ldp_environ.sh.


JADE_HOME=/usr/local/sgml/openjade-1.3
SGML_SHARE=/usr/local/sgml

PATH=$PATH:$JADE_HOME/bin

# DSSSL stylesheets
#       Norm Walsh's Modular DocBook Stylesheets
SGML_CATALOG_FILES=$SGML_SHARE/dsssl/docbook/catalog
#       OpenJade stylesheets
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$JADE_HOME/dsssl/catalog
#       sgmltools-lite's stylesheets
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/stylesheets/sgmltools/sgmltools.cat

# DocBook DTD
#       From OASIS-Open.org
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.1/catalog
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/4.1/catalog
#       These old ones were installed with doctools-1.2 from XFree86.org
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/2.4.1/catalog
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.0/catalog

# sgmltools-lite catalogs for LinuxDoc
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/dtd/sgmltools/catalog

export JADE_HOME SGML_SHARE PATH SGML_CATALOG_FILES
##########################################################################################

Now I can do something like this...


styx:/usr/local/sgml# . /etc/profile
styx:/usr/local/sgml# echo $PATH
/bin:/usr/bin:/usr/local/openjade-1.3/bin
styx:/usr/local/sgml# echo $SGML_CATALOG_FILES 
/usr/local/sgml/dsssl/docbook/catalog:/usr/local/sgml/openjade-1.3/dsssl/catalog:/usr/local/sgml/docbook/3.1/catalog:/usr/local/sgml/docbook/4.1/catalog

The HOWTO Says I'm done now, minus of course the components I chose not to install.

There is a sample document located on the howto page (http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/using.html). I'll try to use it as input first.

The first time I ran jade I was missing libraries. Easily fixed. I added openjade-1.3 to my ld.so.conf file and ran ldconfig. It's odd that openldap doesn't create a lib directory it just sticks it all in the PREFIX directory.

Doh! This is the place I always get stuck. I'm really glad I'm recording all this, because I hope somebody will be able to help.

styx:/usr/local/sgml# openjade -t sgml -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl test.sgml

openjade:/usr/local/sgml/docbook/3.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/dbcent.mod:145:0:E: cannot open "/usr/local/sgml/docbook/3.1/iso-grk4.gml" (No such file or directory)
openjade:/usr/local/sgml/docbook/3.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/3.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:73:W: cannot generate system identifier for public text "-//James Clark//DTD DSSSL Style Sheet//EN"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: reference to entity "STYLE-SHEET" for which no system identifier could be generated
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:0: entity was defined here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: DTD did not contain element declaration for document type name
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:66:0:E: notation "DSSSL" for entity "dbl1el" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:75:0:E: notation "DSSSL" for entity "dbl1en" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:84:0:E: notation "DSSSL" for entity "dbl1es" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:93:0:E: notation "DSSSL" for entity "dbl1et" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:102:0:E: notation "DSSSL" for entity "dbl1fi" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:255:0:E: notation "DSSSL" for entity "dbl1zhcn" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:111:0:E: notation "DSSSL" for entity "dbl1fr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:165:0:E: notation "DSSSL" for entity "dbl1nl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:174:0:E: notation "DSSSL" for entity "dbl1no" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:201:0:E: notation "DSSSL" for entity "dbl1ptbr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:267:0:E: notation "DSSSL" for entity "dblib.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:183:0:E: notation "DSSSL" for entity "dbl1pl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:120:0:E: notation "DSSSL" for entity "dbl1hu" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:192:0:E: notation "DSSSL" for entity "dbl1pt" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:129:0:E: notation "DSSSL" for entity "dbl1id" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:138:0:E: notation "DSSSL" for entity "dbl1it" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:270:0:E: notation "DSSSL" for entity "dbparam.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:147:0:E: notation "DSSSL" for entity "dbl1ja" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:210:0:E: notation "DSSSL" for entity "dbl1ro" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:30:0:E: notation "DSSSL" for entity "dbl1ca" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:219:0:E: notation "DSSSL" for entity "dbl1ru" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:39:0:E: notation "DSSSL" for entity "dbl1cs" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:156:0:E: notation "DSSSL" for entity "dbl1ko" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:228:0:E: notation "DSSSL" for entity "dbl1sk" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:237:0:E: notation "DSSSL" for entity "dbl1sl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:48:0:E: notation "DSSSL" for entity "dbl1da" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:246:0:E: notation "DSSSL" for entity "dbl1sv" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:57:0:E: notation "DSSSL" for entity "dbl1de" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:311:12:E: element "STYLE-SHEET" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:312:24:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:8:E: there is no attribute "USE"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:105:E: element "STYLE-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:315:25:E: element "STYLE-SPECIFICATION-BODY" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:27:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:46:E: there is no attribute "DOCUMENT"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:59:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:55:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:0: start tag was here
openjade:E: specification document does not have the DSSSL architecture as a base architecture
This is a TestJohnDoeLj.doe@jdoe dot comv1.02000-12-30jldThis is a test DocBook document.Test 1Test section 1.Test 1.1Test section 1.1Test 1.2-- Test section 1.2 
openjade -t sgml -d $DSLFILE test.sgmlTest 2Test section 2.Test 2.1Test section 2.1
	Test 2.2Test section 2.2

[Update Thu Mar 29 10:44:20 AKST 2001]

I sent an email off to the doctools@linuxdoc.org mailing list and have (promptly) gotten some suggestions. I need to reduce my SGML_CATALOG_FILES variable to only the catalogs I am using for this compile: DSSSL, Docbook4.1, and openjade's catalog files. Here is my SGML_CATALOG_FILES variable now.

styx:/usr/local/sgml# echo $SGML_CATALOG_FILES
/usr/local/sgml/dsssl/docbook/catalog:/usr/local/sgml/openjade-1.3/dsssl/catalog:/usr/local/sgml/docbook/4.1/catalog

Whoa! of noteworthy interest, I have no catalog files in openjade. Greg suggests looking for a usr/local/sgml/openjade-1.3/dsssl/catalog file. I don't have that. I'll press and post to the list in a minute. So here I go with another attempt at compiling test.sgml. Using the command from Greg....

styx:/usr/local/sgml# openjade -t sgml -i html -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl test.sgml
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/dbcent.mod:145:0:E: cannot open "/usr/local/sgml/docbook/4.1/iso-grk4.gml" (No such file or directory)
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:73:W: cannot generate system identifier for public text "-//James Clark//DTD DSSSL Style Sheet//EN"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: reference to entity "STYLE-SHEET" for which no system identifier could be generated
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:0: entity was defined here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: DTD did not contain element declaration for document type name
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:66:0:E: notation "DSSSL" for entity "dbl1el" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:75:0:E: notation "DSSSL" for entity "dbl1en" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:84:0:E: notation "DSSSL" for entity "dbl1es" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:93:0:E: notation "DSSSL" for entity "dbl1et" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:102:0:E: notation "DSSSL" for entity "dbl1fi" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:255:0:E: notation "DSSSL" for entity "dbl1zhcn" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:111:0:E: notation "DSSSL" for entity "dbl1fr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:165:0:E: notation "DSSSL" for entity "dbl1nl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:174:0:E: notation "DSSSL" for entity "dbl1no" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:201:0:E: notation "DSSSL" for entity "dbl1ptbr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:267:0:E: notation "DSSSL" for entity "dblib.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:183:0:E: notation "DSSSL" for entity "dbl1pl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:120:0:E: notation "DSSSL" for entity "dbl1hu" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:192:0:E: notation "DSSSL" for entity "dbl1pt" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:129:0:E: notation "DSSSL" for entity "dbl1id" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:138:0:E: notation "DSSSL" for entity "dbl1it" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:270:0:E: notation "DSSSL" for entity "dbparam.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:147:0:E: notation "DSSSL" for entity "dbl1ja" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:210:0:E: notation "DSSSL" for entity "dbl1ro" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:30:0:E: notation "DSSSL" for entity "dbl1ca" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:219:0:E: notation "DSSSL" for entity "dbl1ru" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:39:0:E: notation "DSSSL" for entity "dbl1cs" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:156:0:E: notation "DSSSL" for entity "dbl1ko" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:228:0:E: notation "DSSSL" for entity "dbl1sk" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:237:0:E: notation "DSSSL" for entity "dbl1sl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:48:0:E: notation "DSSSL" for entity "dbl1da" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:246:0:E: notation "DSSSL" for entity "dbl1sv" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:57:0:E: notation "DSSSL" for entity "dbl1de" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:311:12:E: element "STYLE-SHEET" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:312:24:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:8:E: there is no attribute "USE"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:105:E: element "STYLE-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:315:25:E: element "STYLE-SPECIFICATION-BODY" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:27:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:46:E: there is no attribute "DOCUMENT"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:59:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:55:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:0: start tag was here
openjade:E: specification document does not have the DSSSL architecture as a base architecture
This is a TestJohnDoeLj.doe@jdoe dot comv1.02000-12-30jldThis is a test DocBook document.Test 1Test section 1.Test 1.1Test section 1.1Test 1.2-- Test section 1.2 
openjade -t sgml -d $DSLFILE test.sgmlTest 2Test section 2.Test 2.1Test section 2.1
	Test 2.2Test section 2.2

Plot thickens. I noticed there was a dsssl subdirectory in the openjade source tree. Just for giggles I copied it into /usr/local/sgml/openjade-1.3. This is where my $SGML_CATALOG_FILES expects to find it.

Wooohoooo! It Worked

I was just able to compile the 3.1 version of the HOWTO-howto. A big round of Thanks to Greg Fergusson and Dan Scott for there suggestions :)

5 Comments

By jim on March 29, 2001 4:19 AM

From: James Weller jim.weller@gci.net
To: docbook@linuxdoc.org
Subject: Problem: Setup Docbook Tools and Running First Test
Date: Thursday, March 29, 2001 12:03 AM

Hi,
I've set up doctools and am using doctools for the first time. I'll
spare the list the noise of a descritpion because I have a detailed
description and history of what I've done thus far and the error
messages I'm recieving at the following URL

http://www.jimweller.net/article.php?sid=26&mode=&order=0

I hope one of the more experience doctools users can shed some light on
this for me. Thx in advance.

Jim Weller

_________________________
http://list.linuxdoc.org/

By jim on March 29, 2001 4:20 AM

From: Greg Ferguson gferg@hoop.timonium.sgi.com
To: James Weller jim.weller@gci.net
Subject: Re: Problem: Setup Docbook Tools and Running First Test
Date: Thursday, March 29, 2001 6:08 AM

>
> http://www.jimweller.net/article.php?sid=26&mode=&order=0

I like the detail you've captured.

> DTDDECL catalog entries are not supported

Those warnings are to be expected using DocBook 4.1.
You'll get a whole lot of them and they are annoying as hell. I
thought at one point I had a workaround, but I don't believe it
worked (needed to tweak one of the catalog files...). Maybe
I'll look at this again, at some point.

Let's concentrate on the $SGML_CATALOG_FILES variable.
For a DocBook 4.1 (DTD) SGML file, I use:

/usr/local/sgml/docbook/4.1/catalog:
/usr/local/sgml/dsssl/docbook/catalog:
/usr/local/sgml/openjade-1.3/dsssl/catalog

Let's make sure /not/ to reference the 3.1 catalog when processing
a 4.1 document instance...ALSO, make sure these files exist! If
not, it's an installation problem...

$ ls -l /usr/local/sgml/docbook/4.1/catalog
/usr/local/sgml/dsssl/docbook/catalog
/usr/local/sgml/openjade-1.3/dsssl/catalog

Once this env variable is set as shown above (and we've verified that
the files do exist), on to running openjade:

$ openjade -t sgml -i html -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl
test.sgml

OR (using the ldp stylesheet):

$ openjade -t sgml -i html -d $SGML_SHARE/dsssl/docbook/html/ldp.dsl#html
test.sgml

Let me know how it goes.

r,
Ferg

By jim on March 29, 2001 4:21 AM

From: daniels@ca.ibm.com
To: James Weller jim.weller@gci.net
Subject: Re: Problem: Setup Docbook Tools and Running First Test
Date: Thursday, March 29, 2001 8:21 AM

Hmm. I haven't read the DocBook mini-HOWTO, but I did very recently install
the DocBook 4.1 XML support and got it working.

Maybe we should try this by narrowing it down to one variable at a time,
rather than adding every available version of DocBook to your
SGML_CATALOG_FILES variable all at once.

If you know the version of DocBook you're working with, can you display the
contents of the directory that contains its DTD and any subdirectories with
'ls -l'?

Can you display the contents of test.sgml for us, so we know which version
of DocBook you're working with?

(Apologies for the lengthy post...)

My directory structure looks like:

[dan@denials dan]$ ls -l /usr/lib/xml/docbook-4.1
total 348
-rw-r--r-- 1 root root 2409 Mar 24 09:57 40chg.txt
-rw-r--r-- 1 root root 603 Mar 24 09:57 41chg.txt
-rw-r--r-- 1 root root 3936 Mar 24 09:57 ChangeLog
-rw-r--r-- 1 root root 8352 Mar 24 09:57 calstblx.dtd
-rw-r--r-- 1 root root 6268 Mar 24 09:53 dbcentx.mod
-rw-r--r-- 1 root root 1605 Mar 24 09:53 dbgenent.mod
-rw-r--r-- 1 root root 59188 Mar 24 09:53 dbhierx.mod
-rw-r--r-- 1 root root 4316 Mar 24 09:53 dbnotnx.mod
-rw-r--r-- 1 root root 203338 Mar 24 09:53 dbpoolx.mod
-rw-r--r-- 1 root root 3693 Mar 24 14:46 docbook.cat
-rw-r--r-- 1 root root 4658 Mar 24 09:58 docbookx.dtd
drwxrwxr-x 2 root root 4096 Mar 24 09:49 ent
-rw-r--r-- 1 root root 448 Mar 24 09:58 readme.txt
-rw-r--r-- 1 root root 12587 Mar 24 09:53 soextblx.dtd
[dan@denials dan]$ ls -l /usr/lib/xml/docbook-4.1/ent
total 96
-rw-rw-r-- 1 root root 3866 Mar 24 09:49 iso-amsa.ent
-rw-rw-r-- 1 root root 2548 Mar 24 09:49 iso-amsb.ent
-rw-rw-r-- 1 root root 718 Mar 24 09:49 iso-amsc.ent
-rw-rw-r-- 1 root root 3227 Mar 24 09:49 iso-amsn.ent
-rw-rw-r-- 1 root root 1313 Mar 24 09:49 iso-amso.ent
-rw-rw-r-- 1 root root 3709 Mar 24 09:49 iso-amsr.ent
-rw-rw-r-- 1 root root 3220 Mar 24 09:49 iso-box.ent
-rw-rw-r-- 1 root root 4311 Mar 24 09:49 iso-cyr1.ent
-rw-rw-r-- 1 root root 1910 Mar 24 09:49 iso-cyr2.ent
-rw-rw-r-- 1 root root 834 Mar 24 09:49 iso-dia.ent
-rw-rw-r-- 1 root root 3002 Mar 24 09:49 iso-grk1.ent
-rw-rw-r-- 1 root root 1735 Mar 24 09:49 iso-grk2.ent
-rw-rw-r-- 1 root root 2563 Mar 24 09:49 iso-grk3.ent
-rw-rw-r-- 1 root root 2649 Mar 24 09:49 iso-grk4.ent
-rw-rw-r-- 1 root root 4554 Mar 24 09:49 iso-lat1.ent
-rw-rw-r-- 1 root root 8759 Mar 24 09:49 iso-lat2.ent
-rw-rw-r-- 1 root root 4085 Mar 24 09:49 iso-num.ent
-rw-rw-r-- 1 root root 4590 Mar 24 09:49 iso-pub.ent
-rw-rw-r-- 1 root root 3002 Mar 24 09:49 iso-tech.ent

Wonderful, eh? No messy renaming scripts, I just had to put the 'ent'
directory in a subdirectory of the docbook-4.1 directory. And I didn't need
to link 'docbook.cat' to 'catalog', since I'm building up
SGML_CATALOG_FILES myself.

I wrote a little script that takes care of the dirty details of
SGML_CATALOG_FILES and jade; only two entries were needed in
SGML_CATALOG_FILES:
[dan@denials dan]$ cat `which dbxml`
#!/bin/bash
export
SGML_CATALOG_FILES=/usr/lib/xml/docbook-4.1/docbook.cat:/usr/doc/jade-1.2.1/dsssl/catalog
jade -t sgml -i html -d
/usr/lib/sgml/stylesheets/nwalsh-modular/html/ldp.dsl
/usr/doc/jade-1.2.1/pubtext/xml.dcl $@

Note that I copied the 'ldp.dsl' stylesheet into the same directory as the
nwalsh-modular stylesheets. My installation of Jade is from the Red Hat 6.2
RPM; non-Red Hat users could probably just 'locate xml.dcl' and use the
corresponding path.

Dan
--------------------------------------------------------------------------------

Dan Scott -- DB2 ID (App. Dev. Team)
Email: daniels@ca.ibm.com

James Weller on 03/29/2001 04:03:31 AM

Please respond to James Weller

To: docbook@linuxdoc.org
cc:
Subject: Problem: Setup Docbook Tools and Running First Test

From: Jim Weller jim.weller@gci.net
To: docbook@linuxdoc.org
Subject: Re: Problem: Setup Docbook Tools and Running First Test
Date: Thursday, March 29, 2001 12:37 PM

All,
Thank You for your replies.

I've honed down my SGML_CATALOG_FILES variable to include only the DSSSL and
DTD 4.1 catalog files. Of notworthy interest my openjade installation is
missing a 'dsssl' subdirectory.

And then in the middle of this email it worked! I repeat IT
WORKED!!!!!!!!!!!!!!!!!!!!!!!!! WooHooo!!!!

I copied the dsssl subdirectory from the openjade source tree into
/usr/local/sgml/openjade-1.3. I just pulled down the HOWTO-HOWTO.sgml and
compiled it successfully. I've done 3.1 and 4.1 sgml docs at this point.

Thank You *ALL* so much. I am absolved. I thought I would have to take up
burger flippin' as my new career :) Next get the XML stuff working. Then
WRITE DOCS! Woohoooo!

PS I'm still getting this error sometimes ....

openjade:/usr/local/sgml/docbook/3.1/dbcent.mod:145:0:E: cannot open
/usr/local/sgml/docbook/3.1/iso-grk4.gml (No such file or directory)

----- Original Message -----
From: Greg Ferguson
To: James Weller
Sent: Thursday, March 29, 2001 6:02 AM
Subject: Re: Problem: Setup Docbook Tools and Running First Test

> >
> > http://www.jimweller.net/article.php?sid=26&mode=&order=0
>
> I like the detail you've captured.
>
> > DTDDECL catalog entries are not supported
>
> Those warnings are to be expected using DocBook 4.1.
> You'll get a whole lot of them and they are annoying as hell. I
> thought at one point I had a workaround, but I don't believe it
> worked (needed to tweak one of the catalog files...). Maybe
> I'll look at this again, at some point.
>
> Let's concentrate on the $SGML_CATALOG_FILES variable.
> For a DocBook 4.1 (DTD) SGML file, I use:
>
> /usr/local/sgml/docbook/4.1/catalog:
> /usr/local/sgml/dsssl/docbook/catalog:
> /usr/local/sgml/openjade-1.3/dsssl/catalog
>
> Let's make sure /not/ to reference the 3.1 catalog when processing
> a 4.1 document instance...ALSO, make sure these files exist! If
> not, it's an installation problem...
>
> $ ls -l /usr/local/sgml/docbook/4.1/catalog
> /usr/local/sgml/dsssl/docbook/catalog
> /usr/local/sgml/openjade-1.3/dsssl/catalog
>
>
> Once this env variable is set as shown above (and we've verified that
> the files do exist), on to running openjade:
>
> $ openjade -t sgml -i html -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl
> test.sgml
>
> OR (using the ldp stylesheet):
>
> $ openjade -t sgml -i html -d $SGML_SHARE/dsssl/docbook/html/ldp.dsl#html
> test.sgml
>
> --
>
> Let me know how it goes.
>
> r,
> Ferg
>
>

By jim on March 29, 2001 4:22 AM

From: Greg Ferguson gferg@hoop.timonium.sgi.com
To: Jim Weller jim.weller@gci.net; docbook@linuxdoc.org
Subject: Re: Problem: Setup Docbook Tools and Running First Test
Date: Thursday, March 29, 2001 12:42 PM

On Mar 29, 12:37pm, Jim Weller wrote:
> Subject: Re: Problem: Setup Docbook Tools and Running First Test
> All,
> Thank You for your replies.
>
> I've honed down my SGML_CATALOG_FILES variable to include only
> the DSSSL and DTD 4.1 catalog files. Of notworthy interest my
> openjade installation is missing a 'dsssl' subdirectory.
>
> And then in the middle of this email it worked! I repeat IT
> WORKED!!!!!!!!!!!!!!!!!!!!!!!!! WooHooo!!!!
>
> I copied the dsssl subdirectory from the openjade source tree into
> /usr/local/sgml/openjade-1.3. I just pulled down the HOWTO-HOWTO.sgml
> and compiled it successfully. I've done 3.1 and 4.1 sgml docs at
> this point.

Good. As I said I think openjade got confused with overriding
methods (3.1 v. 4.1).

> openjade:/usr/local/sgml/docbook/3.1/dbcent.mod:145:0:E: cannot open
> /usr/local/sgml/docbook/3.1/iso-grk4.gml (No such file or directory)

You can get that file from me:

http://www.ibiblio.org/gferg/ent/iso-grk4.gml

Drop it in the location specified in the error msg. If you're
missing others, lmk.

--
Ferg

Title Bout: Jim v. Doctools

The HOWTO Says I'm done now, minus of course the components I chose not to install.

Wooohoooo! It Worked

Categories:

5 Comments