docbook: Thread: Problem: Setup Docbook Tools and Running First Test

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

----- Original Message -----
From: ####@####.####
To: "James Weller" ####@####.####
Sent: Thursday, March 29, 2001 8:20 AM
Subject: Re: Problem: Setup Docbook Tools and Running First Test

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: ####@####.####


James Weller ####@####.#### on 03/29/2001 04:03:31 AM

Please respond to James Weller ####@####.####

To:   ####@####.####
cc:
Subject:  Problem: Setup Docbook Tools and Running First Test


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/

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)

Jim Weller

----- 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
>
>

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)

Jim Weller

----- 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
>
>

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