Subject:
Re: XML setup HOWTO??
From:
Tabatha Persad ####@####.####
Date:
29 Jun 2002 20:28:14 -0000
Message-Id: <20020629202747.WOTC15755.rwcrmhc53.attbi.com@there>
On Saturday 29 June 2002 08:44, Charles Curley wrote:
> I looked through http://www.jimweller.net/jim/dbxmlqs/ and my
> catalog files again, and realized that I didn't have docbkx412.zip.
> OK, you get that from OASIS. Weller's link to it is broken. OK, I
> found it again on the OASIS site. It's at the URL which is in the
> header of the test file,
> http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd.
> I have previously pulled that file in and tried to use it. It
> didn't work even when I changed the test file's system identifier
> to call out the docbookx.dtd directly instead of by URL.
>
> Furthermore, if jade is refusing to use the URL (see the compile
> trace below), is jade broken?
>
> I'm reading Erik Ray's Learning XML, O'Reilly, 2001. On page 33, he
> says that the system identifier (the URL in the prolog) "specifies
> the location of the DTD". If the system identifier tells me where
> the DTD is, why do I need a catalog at all?
As a matter of fact, O'Reilly's book on DocBook says that XML
requires a system identifier.
So I asked myself, Self, why do you have a catalog identifying XML
4.1.2 if it requires a system identifier?
Since the catalog can also contain PUBLIC and SYSTEM identifiers, as
well as CATALOGS pointing to other locations, I added the following
line:
SYSTEM "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
I forgot that I had done this, and the reason I had done it was the
same as you, openjade was not recognizing the doctype. When I added
the system identfier URI to my main catalog file it seemed to work
fine after that. I still left the line that points to the XML 4.1.2
catalog, but added the above to the end. By default, Docbook should
be looking for SYSTEM identifiers first, unless you've used the
"OVERRIDE YES" in the catalog, which will cause it to look for PUBLIC
identifiers first even if the SYSTEM identifiers are there.
Try adding that line to your main catalog file and process your
test.xml again with openjade to see if it will work. I'm hoping that
it will!
Let me know how it goes, too!
Tabatha
> On Fri, Jun 28, 2002 at 10:10:10PM -0400, Tabatha Persad wrote:
> > On Friday 28 June 2002 23:46, Charles Curley wrote:
> > > In any case, here is what I have:
> > >
> > > [ccurley@charlesc java]$ set | grep -i catalog
> > > SGML_CATALOG_FILES=/etc/sgml/catalog
> > >
> > > which contains:
> > >
> > > CATALOG /etc/sgml/sgml-docbook-3.0.cat
> > > CATALOG /etc/sgml/sgml-docbook-3.1.cat
> > > CATALOG /etc/sgml/sgml-docbook-4.0.cat
> > > CATALOG /etc/sgml/sgml-docbook-4.1.cat
> > >
> > > Which works fine for sgml docbook.
> >
> > I don't see anything pointing to an XML 4.1.2 catalog up there.
> > Could that be the problem? I have one on my machine, so I
> > thought I'd point that out. Not sure if it's a requirement or
> > not, since there is a url to the dtd, however it might help.
> >
> > > The test file starts with:
> > >
> > > <?xml version="1.0" encoding='ISO-8859-1'?>
> > > <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
> > >
> > > "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
> > >
> > > [
> >
> > That looks to me like it's supposed to (except after the url to
> > "docbookx.dtd" you should have [ ] > to close it off, right?).
> >
> > > > On Fri, Jun 28, 2002 at 04:20:47PM -0400, Greg Ferguson wrote:
> > > > > from http://www.tldp.org/authors/#resources
> > > > >
> > > > > DocBook XML 4.1.2 Quick Start Guide
> > > > > http://www.jimweller.net/jim/dbxmlqs/
> >
> > The link to Jim Weller's HOWTO, if done to the letter, will get
> > the tools working absolutely perfectly, I swear! I've forwarded
> > this to several people who've also had success. My only caveat
> > is that you appear to have the right version of openjade, so you
> > can just skip to the next set of steps, or else you'll end up
> > with me and have two different rpm versions, one in /bin and one
> > in /usr/local/openjade! (it was a blonde moment, I swear).
> >
> > In looking at the information below, it struck me that your
> > catalog is located in /etc/sgml, but in your openjade command you
> > are pointing to /usr/share/sgml...
> >
> > What I've done on my machine is put a master catalog file in
> > /usr/local/sgml. In that directory are the subdirs that contain
> > the catalogs for each version.
> >
> > For example, in my /usr/local/sgml/catalog file it reads like
> > this:
> >
> > CATALOG "/usr/local/sgml/openjade-1.3.1/dsssl/catalog"
> > CATALOG "/usr/local/sgml/dsssl/docbook/catalog"
> > CATALOG "/usr/local/sgml/docbook/4.1sgml/catalog"
> > CATALOG "/usr/local/sgml/docbook/4.1.2xml/catalog"
> >
> > ...and so forth. This is great because if I ever want to drop in
> > a new Docbook version, I just dump the folder into
> > /usr/local/sgml, and then in the catalog file add the path to the
> > catalog for that version. Done deal!
> >
> > My bash profile is set up to recognize "/usr/local/sgml" as
> > $SGMLHOME, so when I type my command to convert I would type:
> >
> > openjade -t xml -d $SGMLHOME/dsssl/docbook/html/ldp.dsl#html
> > $SGMLHOME/dsssl/docbook/dtds/decls/xml.dcl test.xml
> >
> > To this day, whenever I convert XML to HTML using openjade, I
> > still get a message, "openjade:/usr/local/sgml/catalog:6:140:E:
> > name expected" however it still processes everything fine.
> >
> > The only thing I can think of is to re-examine your paths to
> > everything and see if that makes a difference, otherwise you may
> > want to rebuild the tools.
> >
> > I hope some of this information helps even in a small way! Give
> > me a shout if I can help more!
> >
> > > > Thanks. Something still isn't right. I adjusted his command
> > > > line to use the actual locations of the relevant files, and
> > > > got this:
> > > >
> > > > [curley@charlesc foo]$ openjade -t xml -d
> > > > /usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.dsl#html
> > > > /usr/share/doc/openjade-1.3/pubtext/xml.dcl test.xml
> > > > openjade:test.xml:8:0:E: URL not supported by this version
> > > > openjade:test.xml:8:0:E: DTD did not contain element
> > > > declaration for document type name
> > > > openjade:test.xml:14:5:E: element "book" undefined
> > > > openjade:test.xml:16:11:E: element "bookinfo" undefined
> > > > openjade:test.xml:17:10:E: element "title" undefined
> > > > openjade:test.xml:18:11:E: element "author" undefined
> > > > openjade:test.xml:19:16:E: element "firstname" undefined
> > > > openjade:test.xml:20:14:E: element "surname" undefined
> > > > openjade:test.xml:22:14:E: element "copyright" undefined
> > > > etc...
> > > >
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 64:9:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 66:15:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 67:21:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 68:27:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 57:18:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 61:28:E: reference to undefined variable
> > > > "$verbatim-line-by-line$"
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:1 77:6:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:1 78:6:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 24:5:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 26:10:E: "element" is not the name of any flow object
> > > > class
> > > > openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/ldp.d
> > > >sl:2 15:5:E: "element" is not the name of any flow object
> > > > class Simple XML Sample Document John DoeCopyright © 2001 by
> > > > John Doe
> >
> > --
> > Tabatha Persad
> > Web: http://www.merlinmonroe.com
> > The Linux Counter Project Area Manager US:wa
> > (http://counter.li.org) Linux Documentation Project Editor
> > (http://www.tldp.org) Gnu Writing Movement Project Developer
> > (http://gwm.gnu.org)
> >
> > ______________________
> > http://lists.tldp.org/
--
Tabatha Persad
Web: http://www.merlinmonroe.com
The Linux Counter Project Area Manager US:wa (http://counter.li.org)
Linux Documentation Project Editor (http://www.tldp.org)
Gnu Writing Movement Project Developer (http://gwm.gnu.org)
