sgml-dtd-3.1

Introduction to sgml-dtd

Download location (HTTP):       http://www.docbook.org/sgml/3.1/docbk31.zip
Download location (FTP):        
Version used:                   3.1
Package size:                   60 KB
Estimated Disk space required:  336 KB

The sgml-dtd package contains document type definitions for verification of sgml data files against the DocBook rule set. These are useful for structuring books and software documentation to a standard allowing you to utilize transformations already written for that standard.

sgml-dtd depends on:
unzip-5.50 and sgml-common-0.6.3

Installation of sgml-dtd

Install sgml-dtd by running the following commands:

cp docbook.cat docbook.cat.orig &&
sed -e '/ISO 8879/d' docbook.cat.orig > docbook.cat &&
cp docbook.cat docbook.cat.orig &&
sed -e '/gml/d' docbook.cat.orig > docbook.cat &&
cp docbook.cat docbook.cat.orig &&
sed -e 's|DTDDECL "-//OASIS//DTD DocBook V3.1//EN"|SGMLDECL|g' \
docbook.cat.orig > docbook.cat &&
install -d /usr/share/sgml/docbook/sgml-dtd-3.1 &&
chown -R root:root . &&
chmod -R 755 . &&
install docbook.cat /usr/share/sgml/docbook/sgml-dtd-3.1/catalog &&
cp -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-3.1 &&
install-catalog --add /etc/sgml/sgml-docbook-dtd-3.1.cat \
/usr/share/sgml/docbook/sgml-dtd-3.1/catalog &&
install-catalog --add /etc/sgml/sgml-docbook-dtd-3.1.cat \
/etc/sgml/sgml-docbook.cat

Command explanations

cp docbook.cat docbook.cat.orig
sed -e '/ISO 8879/d' docbook.cat.orig > docbook.cat
cp docbook.cat docbook.cat.orig
sed -e '/gml/d' docbook.cat.orig > docbook.cat
These commands remove the ENT definitions from the catalog file.

cp docbook.cat docbook.cat.orig
sed -e 's|DTDDECL "-//OASIS//DTD Docbook V3.1//EN"|SGMLDECL|g' \
docbook.cat.orig > docbook.cat
This command replaces the DTDDECL catalog entry, which is not supported by Linux SGML tools, with the SGMLDECL catalog entry.

Configuring sgml-dtd

Config files

/etc/sgml/catalog

Configuration Information

The above installation script updates the catalog.

Using sgml-dtd with gnome requires the following:
cat >> /usr/share/sgml/docbook/sgml-dtd-3.1/catalog << "EOF"
  -- Begin Gnome addition to catalog --

PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN" "png-support-3.1.dtd"

  -- End Gnome addition to catalog --
EOF

Using only the most current 3.x version of sgml-dtd requires the following:
cat >> /usr/share/sgml/docbook/sgml-dtd-3.1/catalog << "EOF"
  -- Begin Single Major Version catalog changes --

PUBLIC "-//Davenport//DTD DocBook V3.0//EN" "docbook.dtd"

  -- End Single Major Version catalog changes --
EOF

Contents

The sgml-dtd package contains DTD files and MOD files.

Description

DTD files

DTD files contain a document type definition which defines the element types and the attribute lists that can be used in the corresponding SGML files.

MOD files

MOD files contain components of the document type definition that are sourced into the DTD files.