docbook-3.1-dtd

#### Beyond Linux® From Scratch (systemd Edition) - Version r13.0-475

### Chapter 48. Standard Generalized Markup Language (SGML)

- Prev

  sgml-common-0.6.3

- Next

  docbook-4.5-dtd

- Up
- Home

# docbook-3.1-dtd

## Introduction to DocBook-3.1 SGML DTD

The DocBook 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.

### Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

### Package Information

- Download (HTTP): https://archive.docbook.org/sgml/3.1/docbk31.zip

- Download MD5 sum: 432749c0c806dbae81c8bcb70da3b5d3

- Download size: 55 KB

- Estimated disk space required: 676 KB

- Estimated build time: less than 0.1 SBU

### DocBook-3.1 SGML DTD Dependencies

#### Required

libarchive-3.8.7 and sgml-common-0.6.3

## Installation of DocBook-3.1 SGML DTD

### Note

The package source is distributed in `zip` format and requires unzip (actually a symlink to bsdunzip from libarchive). You should create a directory and change to that directory before unzipping the file to ease the removal of the source files after the package has been installed.

Install DocBook-3.1 SGML DTD by running the following commands:

    sed -i -e '/ISO 8879/d' \
           -e 's|DTDDECL "-//OASIS//DTD DocBook V3.1//EN"|SGMLDECL|g' \
           docbook.cat

This package does not come with a test suite.

Now, as the `root` user:

    install -v -d -m755 /usr/share/sgml/docbook/sgml-dtd-3.1 &&
    chown -R root:root . &&
    install -v docbook.cat /usr/share/sgml/docbook/sgml-dtd-3.1/catalog &&
    cp -v -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

sed -i -e '/ISO 8879/d' docbook.cat: This command removes the ENT definitions from the catalog file.

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

## Configuring DocBook-3.1 SGML DTD

### Config Files

`/etc/sgml/catalog`

### Configuration Information

The above installation script updates the catalog.

Using only the most current 3.x version of DocBook SGML DTD requires the following (perform as the `root` user):

    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

Installed Programs: None
Installed Libraries: None
Installed Files: SGML DTD and MOD files
Installed Directory: /usr/share/sgml/docbook/sgml-dtd-3.1

### Short Descriptions

`SGML DTD files` | contains a document type definition which defines the element types and the attribute lists that can be used in the corresponding SGML files
`SGML MOD files` | contains components of the document type definition that are sourced into the `DTD` files

- Prev

  sgml-common-0.6.3

- Next

  docbook-4.5-dtd

- Up
- Home