docbook: Thread: docbook newbie questions

Ok, I used openjade.  It's installation is a little strange but I had success 
with:

cd /usr/local/sgml
unzip ~/docbk41.zip
unzip ~/db157.zip
tar -xvzf ~/openjade-1.3.tar.gz
cd openjade-1.3
./configure --prefix=/usr/local/sgml/openjade-1.3
make
make install

I had to install openjade to the same place the source code is. Using the 
Makefile.dist had problems with Vector, so I had to run configure.

Then I put this into my global /etc/profile:
# SGML DocBook openjade stuff
SGML_HOME=/usr/local/sgml
SGML_CATALOG_FILES=$SGML_HOME/dtd/docbook.cat:$SGML_HOME/dsssl/docbook/catalog:$SGML_HOME/openjade-1.3/dsssl/catalog
PATH=$PATH:$SGML_HOME/openjade-1.3/bin
export SGML_HOME SGML_CATALOG_FILES


With this setup, I tested out converting a copy of my 
Nvidia-OpenGL-Configuration-mini-HOWTO.sgml to html:

First, I edited the first line of file and changed the DocBook V3.1 to 
DocBook V4.1, then ran:

openjade -t sgml -i html -d $SGML_HOME/dsssl/docbook/html/docbook.dsl 
Nvidia-OpenGL-Configuration-mini-HOWTO.sgml

The output was:

reaster@comptechnews:~/ldp/mini-HOWTO$ openjade -t sgml -i html -d 
$SGML_HOME/dsssl/docbook/html/docbook.dsl 
Nvidia-OpenGL-Configuration-mini-HOWTO.sgml
openjade:/usr/local/sgml/dtd/docbook.cat:22:0:W: DTDDECL catalog entries are 
not supported
openjade:Nvidia-OpenGL-Configuration-mini-HOWTO.sgml:4:12:E: element 
"ARTHEADER" undefined
openjade:Nvidia-OpenGL-Configuration-mini-HOWTO.sgml:215:11:E: character data 
is not allowed here
openjade:Nvidia-OpenGL-Configuration-mini-HOWTO.sgml:215:39:E: end tag for 
"LISTITEM" which is not finished
openjade:Nvidia-OpenGL-Configuration-mini-HOWTO.sgml:216:18:E: character data 
is not allowed here
openjade:Nvidia-OpenGL-Configuration-mini-HOWTO.sgml:216:48:E: end tag for 
"LISTITEM" which is not finished
openjade:/usr/local/sgml/dtd/docbook.cat:22:0:W: DTDDECL catalog entries are 
not supported

[snip - a whole bunch more DTDDECL entries not supported]

-rw-r--r--   1 reaster  users       23246 Dec 28 13:53 
LinuxGL-QuakeWorld-mini-HOWTO.sgml
-rw-r--r--   1 reaster  users       28441 Dec 28 14:21 
Nvidia-OpenGL-Configuration-mini-HOWTO.sgml
-rw-r--r--   1 reaster  users        5397 Dec 28 14:28 t1.htm
-rw-r--r--   1 reaster  users       24697 Dec 28 13:54 test.html
-rw-r--r--   1 reaster  users        4642 Dec 28 14:28 x120.htm
-rw-r--r--   1 reaster  users        3428 Dec 28 14:28 x138.htm
-rw-r--r--   1 reaster  users        3342 Dec 28 14:28 x147.htm
-rw-r--r--   1 reaster  users        3946 Dec 28 14:28 x154.htm
-rw-r--r--   1 reaster  users        3960 Dec 28 14:28 x162.htm
-rw-r--r--   1 reaster  users        5253 Dec 28 14:28 x168.htm
-rw-r--r--   1 reaster  users        2235 Dec 28 14:28 x186.htm
-rw-r--r--   1 reaster  users        8819 Dec 28 14:28 x40.htm                
                  
I got files with x??? names and .htm endings.  I know that the section ids 
are supposed to be used as part of the html filename.  How can I make that 
happen and have .html endings?

Notice that it doesn't understand <artheader>.  I think that is causing the 
Introduction part of the file to be inside t1.htm instead of a separate file. 
I guess I can fix those listitems though.  The <screen> tags are not working 
the way they do on linuxdoc.org either - no grey table background.

I downloaded the ldp.dsl file.  Where do I put that and how do I use it? 
Also, I downloaded the entities.tar.gz file - where do I unpack it?

What would be the advantage or disadvantage of using DocBook XML instead of 
DocBook SGML?  (right now I'm using DocBook SGML I assume, unless I install 
the docbkx412.zip).

-- 
-------- Robert B. Easter  ####@####.#### ---------
- CompTechNews Message Board   http://www.comptechnews.com/ -
- CompTechServ Tech Services   http://www.comptechserv.com/ -
---------- http://www.comptechnews.com/~reaster/ ------------