Re: Help Getting Docbook working.

[John Fleck <jfleck inkstain net>]

Daniel -

The problem seems to be that your SGML catalog does not point to the
GNOME DocBook DTD.

You need to have the SGML_CATALOG_FILES environmental variable declared, and
it needs to point to your main SGML catalog, and you then need to have David
Mason's GNOME DocBook DTD installed, with a pointer to that in your catalog
file(s).

There's more info here:
http://developer.gnome.org/projects/gdp/handbook/gdp-handbook/gettingstarted.html#INSTALLINGDOCBOOK

However, it may not be worth your while to pursue this path. You're working
with the old SGML version of DocBook, and we're now using the XML version of
DocBook 4.0 for our docs.

Cheers,
John

On Mon, Aug 05, 2002 at 05:27:13PM -0400, Daniel Carrera wrote:
> 
> I've been trying to get docbook working.  I have it installed, but it
> doesn't seem to recognize any of the tags.
> 
> Sample file:
> <!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[]>
> 
> <article id="index">
> <sect1 id="intro">
>     <title>Introduction</title>
>     <para>This is an introduction.</para>
> </sect1>
> </article>
> 
> 
> Here is the output:
> 
> $ db2html sample.sgml
> output is sample
> Using catalogs: /etc/sgml/sgml-docbook.cat
> Using stylesheet:
> /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl#html
> Working on: /home/daniel/sample.sgml
> jade:/home/daniel/sample.sgml:1:69:W: cannot generate system identifier
> for public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"
> jade:/home/daniel/sample.sgml:1:70:E: reference to entity "ARTICLE" for
> which no system identifier could be generated
> jade:/home/daniel/sample.sgml:1:0: entity was defined here
> jade:/home/daniel/sample.sgml:1:70:E: DTD did not contain element
> declaration for document type name
> jade:/home/daniel/sample.sgml:3:12:E: there is no attribute "ID"
> jade:/home/daniel/sample.sgml:3:19:E: element "ARTICLE" undefined
> jade:/home/daniel/sample.sgml:4:10:E: there is no attribute "ID"
> jade:/home/daniel/sample.sgml:4:17:E: element "SECT1" undefined
> jade:/home/daniel/sample.sgml:5:10:E: element "TITLE" undefined
> jade:/home/daniel/sample.sgml:6:9:E: element "PARA" undefined
> 
> 
> This is what I have done so far:
> 
> 1.-
> Downloaded gdp-both.dsl and copied it to
> /usr/lib/sgml/stylesheets/cygnus-both.dsl
> 
> It seems that docbook is looking for the stylsheet:
> /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl
> 
> I tried replacing that one instead, but I only got more errors.
> Furthermore, I would expect any stylesheet to recognize <para>, <title>
> and the like.
> 
> 2.-
> I've downloaded the png-support-3.1.dtd and saved it to /usr/lib/sgml/ on
> my Red Hat system.
> 
> 3.-
> I didn't have a /usr/lib/sgml/CATALOG file.  It seems that docbook is
> using /usr/lib/sgml/docbook.cat instead.  I added the entry to
> /usr/lib/sgml/docbook.cat and copied that to /usr/lib/sgml/CATALOG
> anyways.
> 
> 
> 
> 
> I really don't know what to do at this point.  It's frustrating that it's
> so difficult to get DocBook working.
> 
> Could someone please help.
> 
> 
> Daniel.
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list