Re: DOCBOOK: [website] newbie q

[Bob Stayton <bobs@caldera.com>]

> From: Daniel Veillard <veillard@redhat.com>
> 
> On Sun, Nov 04, 2001 at 08:59:48AM +0000, Dave Pawson wrote:
> > At 22:43 03/11/2001 +0200, Oleg Tkachenko wrote:
> > >Hello there!
> > >
> > >I've started playing with website DTD and everything seems to be Ok, 
> > >except rather long site generation. Is I realize, major part of the 
> > >processing time is wasted on download of imported docbook stylesheets from
> > >http://docbook.sourceforge.net. Is this done by design or I can freely 
> > >change this import declarations to use local docbook xsl copy?
> > 
> > Yes, it can be changed.
> > 
> > Simply install a copy of the DTD on your hard disk, and change the system 
> > reference
> > to the disk based copy instead of the web based one.
> > 
> > If you disconnect from the Internet you will find out which files need 
> > changing.
> > HTH DaveP
> 
>   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*.
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^)

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