This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: [docbook] errors when following a crash course
- From: Neil Roeth <neil at occamsrazor dot net>
- To: Timo Veith <tv at rz-zw dot fh-kl dot de>
- Cc: docbook at lists dot oasis-open dot org
- Date: Tue, 3 May 2005 22:15:05 -0400
- Subject: Re: [docbook] errors when following a crash course
- References: <200504281530.15528.tv@rz-zw.fh-kl.de><17010.7934.87598.526959@ml330.occamsrazor.net><200505021744.42287.tv@rz-zw.fh-kl.de>
On May 2, Timo Veith (tv@rz-zw.fh-kl.de) wrote:
> Am Freitag 29 April 2005 13:48 schrieben Sie:
> > On Apr 28, Timo Veith (tv@rz-zw.fh-kl.de) wrote:
> > > Hi docbook list readers,
> > >
> > > I am trying to follow this howto here:
> > > http://opensource.bureau-cornavin.com/crash-course/
> > >
> > > Chapter 2.3 shows an example file.
> > > http://opensource.bureau-cornavin.com/crash-course/hello-world.html
> > >
> > > When I do as they say, I get the following output:
> > >
> > > $ docbook2html myfile.docbook
> > > 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-4.1/catalog,
> > > /usr/share/sgml/docbook/sgml-dtd-4.0/catalog,
> > > /usr/share/sgml/docbook/dsssl-stylesheets-1.77/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.2/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/tv/tmp/docbook/myfile.docbook
> > > jade:/usr/share/sgml/docbook/sgml-dtd-4.2/dbcentx.mod:308:0:E:
> > > cannot find "ent/iso-amsa.ent"; tried
> >
> > The catalog /usr/share/sgml/sgml-iso-entities-8879.1986/catalog should
> > have the information about where the entities files like
> > ent/iso-amsa.ent are, so look in that catalog, see what it references
> > and figure it out from there. For example, on my Debian system, the
> > file is called ISOamsa.ent, so maybe it is just a mismatch in names.
>
> Hello Neil,
>
> thank you for your reply. I am absolutely new to this so please forgive me
> my questions if they are stupid.
>
> I took a look at those files.
>
> /usr/share/sgml/sgml-iso-entities-8879.1986/catalog references this:
>
> PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN"
> ISOamsa.ent
>
> and /usr/share/sgml/docbook/sgml-dtd-4.2/dbcentx.mod (line 307-309):
>
> <![ %ISOamsa.module; [
> %ISOamsa;
> ]]>
>
> and here is the contents of that dir:
>
> $ ls -1 /usr/share/sgml/sgml-iso-entities-8879.1986
> ISOamsa.ent
> ISOamsb.ent
> ISOamsc.ent
> ISOamsn.ent
> ISOamso.ent
> ISOamsr.ent
> ISObox.ent
> ISOcyr1.ent
> ISOcyr2.ent
> ISOdia.ent
> ISOgrk1.ent
> ISOgrk2.ent
> ISOgrk3.ent
> ISOgrk4.ent
> ISOlat1.ent
> ISOlat2.ent
> ISOnum.ent
> ISOpub.ent
> ISOtech.ent
> catalog
>
> So it seems like jade is looking for a file with all lowercase letters and
> I've got ISOamsa.ent. What can I do?
I overlooked something - you are attempting to process an XML file, not an
SGML file. 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
--
Neil Roeth
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org