Re: Detecting stylesheets and DTDs (fwd)

[Dan Mueth <d-mueth uchicago edu>]

Hi GNOME packagers,

I wanted to draw your attention to a thread we've had on gnome-doc-list.
For documentation to work properly, we require that certain XML
stylesheets and DTDs which are not part of GNOME be installed and
registered in the catalog properly.  Currently most distributions don't do
this correctly.

Please help us make sure that various distributions update their packages
if they need to, so that users will have good XML/DocBook packages to run
GNOME 2 on top of.

For details, see the thread from gnome-doc-list:

http://mail.gnome.org/archives/gnome-doc-list/2002-January/msg00040.html
http://mail.gnome.org/archives/gnome-doc-list/2002-January/msg00041.html
http://mail.gnome.org/archives/gnome-doc-list/2002-January/msg00042.html
http://mail.gnome.org/archives/gnome-doc-list/2002-January/msg00048.html
http://mail.gnome.org/archives/gnome-doc-list/2002-January/msg00051.html
http://mail.gnome.org/archives/gnome-doc-list/2002-January/msg00052.html

Thanks.

Dan

---------- Forwarded message ----------
Date: Thu, 17 Jan 2002 22:47:46 -0600 (CST)
From: Dan Mueth <d-mueth uchicago edu>
To: Daniel Veillard <veillard redhat com>
Cc: Eric Baudais <baudais okstate edu>,
     GNOME Doc List <gnome-doc-list gnome org>
Subject: Re: Detecting stylesheets and DTDs


On Thu, 17 Jan 2002, Daniel Veillard wrote:

> On Wed, Jan 16, 2002 at 09:12:38PM -0600, Eric Baudais wrote:
> > > My understanding is the RH7.2 is not quite right w/r/t the XML catalog,
> > > but that rawhide is fine.  I'm not sure of the status of other distros.
> >
> > This is fine, but there needs to be more information about how to properly
> > install the XML catalogs than DV's webpage.  His webpage is written from a
> > developer's prespective and has a lot of information about debugging a
> > catalog and implementation.  It lacks information about installation and
> > setting up the catalog.  I believe if we are to take this approach
> > documentation is key.
>
>   The best seems to give the sequence needed to add the set of resources
> to the local catalog. I think extracting the install and removal scripts
> of the RawHide RPMs and explaining them a bit should be sufficient for
> most users.

This documentation would be very helpful.

I think the checks we will be doing in the configure scripts for
ScrollKeeper and the GNOME packages will be:

A) xmlcatalog /etc/xml/catalog "-//OASIS//DTD DocBook XML V4.1.2//EN"

and

B) xmlcatalog /etc/xml/catalog
http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl

[we will also test for the existance of libxml2-devel (for xml2-config),
libxslt (for xsltproc), and maybe some other stuff]

So, if you want to check out if your distribution has things set up
properly:

1) make sure you have a recent libxml2 (b/c you need xmlcatalog),
xsltproc, and xml2-config
2) make sure you have docbook-dtd412-xml and docbook-style-xsl installed.
3) make sure commands (A) and (B) above return "file:///" followed by a
path, and not "No entry for ...".
4) make sure the two files returned by (A) and (B) actually exist on your
machine

If you have everything installed and it doesn't work right, you should
upgrade your packages.  If they are up-to-date, you may consider
contacting the packager of docbook-dtd412-xml and/or docbook-style-xsl
for your distribution and ask them to verify the catalog registration is
being done properly.

Dan

_______________________________________________
gnome-doc-list mailing list
gnome-doc-list gnome org
http://mail.gnome.org/mailman/listinfo/gnome-doc-list