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: "scott wiseman" <scott at intercore dot net>
- Cc: <docbook at lists dot oasis-open dot org>
- Date: Tue, 3 May 2005 19:12:29 -0700
- Subject: RE: [docbook] errors when following a crash course
-----Original Message-----
From: Neil Roeth [mailto:neil@occamsrazor.net]
Sent: Tuesday, May 03, 2005 7:15 PM
To: Timo Veith
Cc: docbook@lists.oasis-open.org
Subject: Re: [docbook] errors when following a crash course
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
> http://www.avidware.net/spam/
> 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
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org