Standard Generalized Markup Language (SGML)

This chapter contains DocBook SGML document type definitions (DTDs), DocBook DSSSL Stylesheets and DocBook tools to validate, transform, format and publish DocBook documents.

SGML Common-0.6.3

Introduction to SGML Common

The SGML Common package contains install-catalog. This is useful for creating and maintaining centralized SGML catalogs.

Package information

Installation of SGML Common

First apply the patch:

patch -Np1 -i ../sgml-common-0.6.3-manpage-1.patch

The autotools files included with SGML Common are old. Use the following commands to regenerate the files.

aclocal &&
automake -acf &&
autoconf

Install SGML Common by running the following commands:

./configure --prefix=/usr --sysconfdir=/etc &&
make &&
make install &&
install-catalog --add /etc/sgml/sgml-ent.cat \
    /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &&
install-catalog --add /etc/sgml/sgml-docbook.cat \
    /etc/sgml/sgml-ent.cat
[Tip]

Update hint

Remove the above catalog items prior to upgrading with:

install-catalog --remove /etc/sgml/sgml-ent.cat \
    /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &&
install-catalog --remove /etc/sgml/sgml-docbook.cat \
    /etc/sgml/sgml-ent.cat

Configuring SGML Common

Config files

/etc/sgml/sgml.conf

Configuration Information

No change in this file is necessary.

Contents

The SGML Common package contains install-catalog, sgmlwhich, SGML entities files and XML entities files.

Description

install-catalog

install-catalog creates a centralized catalog that maintains references to catalogs scattered throughout the /usr/share/sgml directory tree.

sgmlwhich

sgmlwhich will print to standard output the name of the main configuration file.

SGML entities files

SGML entities files contain the basic character entities defined with SDATA entries.

XML entities files

XML entities files contain the basic character entities defined by a hexadecimal representation of the Unicode character number.