Re: Installing a local SGML DTD

[Douglas Bates <bates@stat.wisc.edu>]

Arnaud Vandyck <arnaud.vandyck@ulg.ac.be> writes:

> You should ask this question on debian-sgml list...
> 
> http://lists.debian.org/debian-sgml/
> 
> I'd put the dtd in /usr/local/name-of-the-dtd and add it to the
> catalog with update-catalog (see the man)

Thanks for the information.  I'm afraid that I still don't understand
how the entry is added to the catalog with update-catalog.  The
man page shown below indicates that one can only update a centralized
catalog by adding an ordinary catalog.  I didn't see how
update-catalog can be used to add the location of a DTD to a catalog.

UPDATE-CATALOG(8)              Debian GNU/Linux              UPDATE-CATALOG(8)



NAME
       update-catalog - create or update entry in SGML catalog file

SYNOPSIS
       update-catalog [options] --add --super centralized_catalog

       update-catalog [options] --add centralized_catalog ordinary_catalog

       update-catalog [options] --remove --super centralized_catalog

       update-catalog [options] --remove centralized_catalog ordinary_catalog

DESCRIPTION
       update-catalog  inserts,  updates  or removes entries in the SGML super
       catalog /etc/sgml/catalog and the SGML centralized catalogs located  in
       /etc/sgml.

OPTIONS
       --add  Adds  an  entry for the centralized_catalog in the super catalog
              /etc/sgml/catalog, or an entry for the ordinary_catalog  in  the
              centralized_catalog.

       --remove
              Removes  the  entry  for  the centralized_catalog from the super
              catalog /etc/sgml/catalog, or the entry for the ordinary_catalog
              from the centralized_catalog.

       --quiet
              Prevents the usual diagnostic output.

       --test Prevents the update of the catalog and writes the resulting SGML
              catalog to standard output.

       --version
              Displays the version information and exits.

       --help Display the usage information and exits.

COPYRIGHT
       Copyright 2001, Ardo van Rangelrooij.

       This is free software; see the GNU General Public Licence version 2  or
       later for copying conditions.  There is no warranty.



Debian Project                   February 2001               UPDATE-CATALOG(8)

Douglas Bates <bates@stat.wisc.edu> wrote:

> I am running the testing (sarge) distribution and would like to
> install a DTD for SGML files.  The files come from Oxford University
> Press (OUP).  The dtd itself is in the file ouphead.dtd and a typical
> public identifier is 
> 
> <!--Typical public identifier "-//OUP//DTD Article Header Database//EN"
> 
> Could someone please advise me on where to install the DTD so it is
> accessed by programs like sgml2xml?  Looking at other examples it
> seems to me that I want to end up with a symbolic link like
>  /usr/share/sgml/OUP/dtd/Article_Header_Database -> ../../dtd/ouphead.dtd
> 
> Are there other things that I need to do to update catalogs?  I did
> install the sgml-base and sgml-base-doc packages but the documents in
> sgml-base-doc seem to be incomplete.
> 
> My ultimate goal is to build DOMs from these files in Python scripts
> and process them that way.  I plan on using sgml2xml to convert these
> to XML then use a reader such as xml.dom.ext.reader.PyExpat.Reader
> Does this seem to be a reasonable approach to building a DOM or can I
> use the sgmllib in Python directly?
> 
> -- 
> Douglas Bates                            bates@stat.wisc.edu
> Statistics Department                    608/262-2598
> University of Wisconsin - Madison        http://www.stat.wisc.edu/~bates/