docbook: docbook newbie questions
Subject:
docbook newbie questions
From:
"Robert B. Easter" ####@####.####
Date:
28 Dec 2000 21:27:39 -0000
Message-Id: <00122815033609.21151@comptechnews>
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/ ------------