Title Bout: Jim v. Doctools
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.zipNote 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'`;doneNow 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 catalogNow, 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 printMovin' right along...
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/catalogWhoa! 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 :)