This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: [website] newbie q
- To: veillard at redhat dot com
- Subject: Re: DOCBOOK: [website] newbie q
- From: Bob Stayton <bobs at caldera dot com>
- Date: Mon, 05 Nov 2001 09:36:26 -0800 (PST)
- Cc: daveP at dpawson dot freeserve dot co dot uk, docbook at lists dot oasis-open dot org,oleg at tkachenko dot org
- List-Id: <docbook.lists.oasis-open.org>
Excellent. Thanks for the quick and thorough response
on catalogs. Very useful.
bobs
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: bobs@caldera.com
> From: Daniel Veillard <veillard@redhat.com>
>
> On Mon, Nov 05, 2001 at 12:33:12AM -0800, Bob Stayton wrote:
> > > From: Daniel Veillard <veillard@redhat.com>
> > > Even better: don't change the files, just make sure you have a local
> > > catalog and tools supporting catalogs (XML or SGML).
> >
> > Daniel,
> > Since you are the author of xsltproc, perhaps you
> > could give an example of the proper use of catalogs with
> > your tool? Catalogs are great, *when they work*.
>
> :-)
>
> Sure, have a look at
> http://xmlsoft.org/catalog.html
>
> > But it's frustrating when you try to use catalogs
> > and they don't work. It is hard to figure out *why*
> > they don't work. Did I give it the right syntax?
> > Did it find my catalog? Which relative path didn't
> > it get? Was there something wrong
> > with the catalog file? Or the catalog entry?
> > Is there a debug option that traces the catalog resolution
> > process? The latter would be especially nice. 8^)
>
> Hum, export XML_DEBUG_CATALOG=1 should do this. This may
> be incomplete or too verbose but the facility is there.
>
> I think the page addresses most of those points, using
> the xmlcatalog command with the --shell option is IMHO a good
> way to learn an debug XML catalog construction. It is supposed to
> work with SGML catalogs too but I don't claim the same level
> of support (for example libxml2 2.4.7 broke the SGML Catalog
> handling, I got the bug report only yesterday, it's now fixed
> in 2.4.8).
>
> Since XML Catalogs are a bit new I have put an example
> "installation ready" (at least for unices) of
> DocBook XML 4.1.2 + XML Catalogs at:
> ftp://xmlsoft.org/test/dbk412catalog.tar.gz
>
> Daniel
>
> --
> Daniel Veillard | Red Hat Network https://rhn.redhat.com/
> veillard@redhat.com | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
> http://veillard.com/ | Rpmfind RPM search engine http://rpmfind.net/
----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>