Re: [docbook] errors when following a crash course

[Timo Veith <tv@rz-zw.fh-kl.de>]

scott wiseman wrote:
 > I overlooked something - you are attempting to process an XML file, not
> an
> SGML file.

Hm, I only copied and pasted the text from the earlier mentioned website
and ran the command. I didn't know the difference between a XML file and
a SGML file. I found one difference to be the <?xml...?> declaration. (
here http://docbook.org/tdg/en/html/ch02.html )

I also tried to give a dtd explicitly like it's shown in the url above
but with my local file like so:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"/usr/share/sgml/docbook/xml-dtd-4.3/docbookx.dtd">
<book>
<bookinfo>
<title>Hello, world</title>
</bookinfo>
<chapter id="introduction">
<title>Hello, world</title>
<para>This is my first DocBook file.</para>
</chapter>
</book>

And this works:

$ docbook2html myfirst.xml -o output/
Using catalogs: /usr/share/sgml/sgml-iso-entities-8879.1986/catalog,
/usr/share/sgml/xml-iso-entities-8879.1986/catalog,
/usr/share/sgml/openjade-1.3.2/catalog,
/usr/share/sgml/openjade-1.3.2/dsssl/catalog,
/usr/share/sgml/docbook/sgml-dtd-3.0/catalog,
/usr/share/sgml/docbook/sgml-dtd-3.1/catalog,
/usr/share/sgml/docbook/sgml-dtd-4.1/catalog,
/usr/share/sgml/docbook/dsssl-stylesheets-1.77/catalog,
/usr/share/sgml/docbook/sgml-dtd-4.0/catalog,
/usr/share/sgml/opensp-1.5.1/OpenSP/catalog
Using stylesheet:
/usr/share/sgml/docbook/utils-0.6.12/docbook-utils.dsl#html
Working on: /home/timo/tmp/docbook/myfirst.xml
Done.

> That means it should probably be looking in
> /usr/share/sgml/xml-iso-entities-8879.1986/ for the entity file.  Look
> there
> to see what the name of the file is - even though it is in a different
> directory than the files you found, it still might be called
> ISOamsa.ent. Find
> the following phrase in dbcentx.mod (somewhere before lines 307-309):
> 
> <![%xml.features;[
> 
> <!ENTITY % ISOamsa.module "INCLUDE">
> <![%ISOamsa.module;[
> <!ENTITY % ISOamsa
> PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow
> Relations//EN//XML"
> "ent/iso-amsa.ent">
> <!--end of ISOamsa.module-->]]>
> 
> and change the file name from "ent/iso-amsa.ent" to the full path of the
> file
> you found, e.g.,
> "/usr/share/sgml/xml-iso-entities-8879.1986/ISOamsa.ent". Do
> the same for all the other entity files and it should work.  File a bug
> with
> whomever supplied the package and tell them the problem so they can fix
> it.
> 
> HTH

I will rather read and play a little more before I edit those files
which came with the gentoo package and/or blame someone for something
that I haven't understood completely and thus use it the wrong way.

Thanks for your help! I'll probably be back soon :)

Timo