Re: [Re: Kudos and question]

[Pal Domokos <pal.domokos@usa.net>]

Hi Greg,

Thanks for your help, jade is working fine for me now!

Cheers,
Pal

(PS: I think every author could do with a Jade Mini HOWTO.)

"Greg Ferguson" <gferg@hoop.timonium.sgi.com> wrote:
> On Mar 23,  4:11pm, Pal Domokos wrote:
> > Subject: Re: Kudos and question
> > > [...]
> > > In case anyone is interested, here are the tools being used for
> > > processing on metalab:
> > >
> > >   =======================
> > >   For support of linuxdoc:
> > >   =======================
> > >
> > > sgml-tools 1.0.9 -
> > >
>   ftp://ftp.us.sgmltools.org/pub/SGMLtools/v1.0/sgml-tools-1.0.9.tar.gz
> > >
> > > htmldoc (1.8.4) -
> > >   ftp://ftp.easysw.com/pub/htmldoc/1.8.4/htmldoc-1.8.4-source.zip
> > >
> > > fltk 1.0.7 (required by htmldoc for their GUI; I built it anyway) -
> > >   ftp://ftp.fltk.org/pub/fltk/1.0.7/fltk-1.0.7-source.zip
> > >
> > > ld2db -
> > >   http://www.cl.cam.ac.uk/users/rrt1001/ld2db.zip
> > >
> > >   ======================
> > >   For support of DocBook:
> > >   ======================
> > >
> > > Jade (1.2.1) -
> > >    ftp://ftp.jclark.com/pub/jade/jade-1.2.1.tar.gz
> > >
> > > DSSSL (1.52) -
> > >    http://nwalsh.com/docbook/dsssl/db152.zip
> > >
> >
> > let me note that the documentation for DSSSL is here:
> >    http://nwalsh.com/docbook/dsssl/db152d.zip
> 
> Good point. You can also get to the DocBook Stylesheet
> documentation from a link found here: http://nwalsh.com/docbook/dsssl/
> 
> 
> > > DocBook DTD (3.1) -
> > >    http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zip
> > >
> >
> > The DocBook HOWTOs on linuxdoc are of the type
> > <!DOCTYPE Article PUBLIC "-//Davenport//DTD DocBook V3.0//EN">,
> > while the DocBook DTD is 3.1, with the following line in the
> > docbook.cat file:
> > PUBLIC "-//OASIS//DTD DocBook V3.1//EN" "docbook.dtd".
> > Is this OK?
> 
> Ideally, they should be authored/set as 3.1 to work with
> the stock 3.1 DocBook DTD.
> 
> I made two modifications to the default SGML catalog file
> that comes with the 3.1 DocBook DTD distribution (docbook.cat).
> Ideally, I should have created a new catalog and referenced
> it via the SGML_CATALOG_FILES environment variable, OR
> referenced it on the command line when the necessary tools
> are invoked.
> 
> Anyway, here are the changes...
> 
> 1) In the "DocBook driver file" listing, which contains the line:
> 
> 	PUBLIC "-//OASIS//DTD DocBook V3.1//EN" "docbook.dtd"
> 
>     I added:
> 
>         PUBLIC "-//Davenport//DTD DocBook V3.0//EN" "docbook.dtd"
> 
>     So I now have:
> 
> 	[...]
>         -- DocBook driver file .................................. --
> 
>         PUBLIC "-//OASIS//DTD DocBook V3.1//EN" "docbook.dtd"
>         PUBLIC "-//Davenport//DTD DocBook V3.0//EN" "docbook.dtd"
> 	[...]
> 
> 2) I found information on a "warning" that gets generated from jade.
>    It's supposed to be harmless, but is annoying. From the DocBook DTD
>    documentation, under step 2 of the "installing the docbook dtd"
>    section (http://nwalsh.com/docbook/dsssl/doc/install.html)
> 
>      "Note, however, that Jade does not understand the DTDDECL
>       directive in catalog files and will issue a warning if
>       you use docbook.cat unchanged."
> 
>     I removed the DTDDECL line:
> 
>         DTDDECL "-//OASIS//DTD DocBook V3.1//EN" "docbook.dcl"
> 
> 
> > > Entities -
> > >    ftp://ftp.ornl.gov/pub/sgml/WG8/DOCS/
> > >
> >
> > What are these? What are they needed for? They don't seem to be
> > entities to me.
> 
> I was missing the *.gml files (a form of ISO entity files) declared
> in the docbook.cat default catalog. I  loaded the missing file from the
> site above. The files go into the same directory as where the DTD
> distribution is installed.
> 
> > [...]
> 
> 
> Jorge (Godoy) or others may be able to provide more information on
> this,  and perhaps provide a more elegant solution to the problems
> and changes I outlined above. All I know is that this setup does
> seem to work quite well for both linuxdoc and docbook SGML; and
> that was the desired outcome.
> 
> regards,
> 
> 
> -- 
> Greg Ferguson     - s/w engr / mtlhd         | gferg@sgi.com
> SGI Tech Pubs     - http://techpubs.sgi.com  | 
> Linux Doc Project - http://www.linuxdoc.org  |


____________________________________________________________________
Get free email and a permanent address at http://www.netaddress.com/?N=1


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org