LinuxSA Mailing list archives

  From: Alan Kennington <ak.linuxsa@topology.org>
  To  : LinuxSA <linuxsa@linuxsa.org.au>
  Date: Thu, 2 Jan 2003 07:15:15 +1030

docbook "hello world" for SuSE linux

Can anyone tell me how to get a "hello world" DocBook document
going on SuSE linux?

I've just spent 2 working days reading dozens of documents on the
net and trying out various combinations, and the command "docbook2html"
does actually create the required output, but it always gives me a huge 
heap of error messages.
First it says that absolutely everything I've done is wrong and
incomprehensible, and then it creates the desired output.

The examples in the manuals I consulted all fail in this way.

Here's an (abbreviated) example SGML file design.sgml which I created:

==========================================================
<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">

<book>

[...]

<chapter><title>First chapter</title>

[...]

</chapter>
</book>
==========================================================

Language syntax is not what I'm asking about.
There are a zillion syntax manuals out there on the net,
including the standard DocBook manual.
The difficulty is with setting up the environment to get a
DocBook "hello world" document going.
I can do everything else as soon as the "hello world" is working.

My problem is that when I run "docbook2html" or "jade" or "nsgmls"
or anything else over the above file, I always get something like this:

==========================================================
Using catalogs: /usr/share/sgml/html/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/dtds/html/catalog, /usr/share/sgml/docbook/dsssl-
stylesheets-1.77/html/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/print/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/co
mmon/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/catalog, /usr/share/sgml/docbook-xml-website-2.0a2/example/bookmark/catalog, /usr
/share/sgml/jade_dsl/catalog
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.6/docbook-utils.dsl#html
Working on: /home/akenning/rohc/design.sgml
jade:/home/akenning/rohc/design.sgml:1:54:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V4.2//EN"
jade:/home/akenning/rohc/design.sgml:1:54:E: reference to entity "BOOK" for which no system identifier could be generated
jade:/home/akenning/rohc/design.sgml:1:0: entity was defined here
jade:/home/akenning/rohc/design.sgml:1:54:E: DTD did not contain element declaration for document type name
jade:/home/akenning/rohc/design.sgml:3:5:E: element "BOOK" undefined
jade:/home/akenning/rohc/design.sgml:4:9:E: element "BOOKINFO" undefined
jade:/home/akenning/rohc/design.sgml:5:6:E: element "TITLE" undefined
jade:/home/akenning/rohc/design.sgml:6:7:E: element "AUTHOR" undefined
jade:/home/akenning/rohc/design.sgml:4:9:E: element "BOOKINFO" undefined
jade:/home/akenning/rohc/design.sgml:5:6:E: element "TITLE" undefined
jade:/home/akenning/rohc/design.sgml:6:7:E: element "AUTHOR" undefined
jade:/home/akenning/rohc/design.sgml:4:9:E: element "BOOKINFO" undefined
jade:/home/akenning/rohc/design.sgml:5:6:E: element "TITLE" undefined
jade:/home/akenning/rohc/design.sgml:6:7:E: element "AUTHOR" undefined
[...]
===========================================================

...and so on and so on.

I always get the message

	"cannot generate system identifier for public text"

When I try changing the catalog file with the -c parameter, I get
even worse error messages.

I've worked out that the string "-//OASIS//DTD DocBook V3.1//EN"
is some sort of global identifier which is supposed to be mapped
somehow to a local file or URL. But even when I give such
a file as a parameter, the errors are similar.

I've tried using the ending .xml instead of .sgml.
Well, I've tried at least a hundred different ways of doing it.
Maybe it's not a good idea for me to list them all!!

I was kind of hoping that DocBook would be a simple as TeX, where you type

	tex filename.tex

and everything works fine.
Is there a simple command which will do this for DocBook?

Cheers,
Alan Kennington.

-- 
LinuxSA WWW: http://www.linuxsa.org.au/ IRC: #linuxsa on irc.openprojects.net
To unsubscribe from the LinuxSA list:
  mail linuxsa-request@linuxsa.org.au with "unsubscribe" as the subject