Re: DOCBOOK-APPS: Docbook setup on Debian 3.0

[Mike M <linux-support at earthlink dot net>]

On Wednesday 26 February 2003 03:42, Yann Dirson wrote:
> On Tue, Feb 25, 2003 at 07:52:49PM -0500, Mike M wrote:
> > The wiki didn't discuss the setting up SGML_CATALOG_FILES
> > environment var which took the most time for me.
>
> Sure it doesn't !  There should absolutely be no reason to tweak that
> just to get running.  What's happennning when you unset
> SGML_CATALOG_FILES ?

I wish that were the case.  TDG makes a strong case for setting the var 
though.

TDG section A.2.1 states:
First, the catalog needs to be set up as described in Section A.1.3 in order 
for Jade to be able to parse your DocBook documents. In addition, Jade comes 
with its own catalog file that you must add to the SGML_CATALOG_FILES 
environment variable or otherwise make available to Jade.

I am not sure what "otherwise make available to Jade" means, but setting the 
environment variable works well enough.

This is what works for me:
export SGML_CATALOG_FILES=\
"/usr/share/sgml/OpenJade/catalog:/usr/share/sgml/entities/sgml-iso-entities-8879.1986/catalog"

unset SGML_CATALOG_FILES results in:

openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl:1:73:W: 
cannot generate system identifier for public text "-//James Clark//DTD DSSSL 
Style Sheet//EN"
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl:50:0:E: 
reference to entity "STYLE-SHEET" for which no system identifier could be 
generated
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl:1:0: 
entity was defined here
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl:50:0:E: 
DTD did not contain element declaration for document type name
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/dbl10n.ent:298:0:E: 
notation "DSSSL" for entity "dbl1tr" undefined
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/dbl10n.ent:82:0:E: 
notation "DSSSL" for entity "dbl1el" undefined

and much more like it.

export SGML_CATALOG_FILES="/usr/share/sgml/OpenJade/catalog" results in:

openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/../common/dbl1no.dsl:2:66:W: 
cannot generate system identifier for public text "ISO 8879:1986//ENTITIES 
Added Latin 1//EN"
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/../common/dbl1no.dsl:3:5:E: 
reference to entity "lat1" for which no system identifier could be generated
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/../common/dbl1no.dsl:2:0: 
entity was defined here
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/../common/dbl1ro.dsl:2:66:W: 
cannot generate system identifier for public text "ISO 8879:1986//ENTITIES 
Added Latin 1//EN"
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/../common/dbl1ro.dsl:3:5:E: 
reference to entity "lat1" for which no system identifier could be generated
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/../common/../common/dbl1ro.dsl:2:0: 
entity was defined here

and much more like it.
-- 
Mike M.