Introduction to DocBook-4.5 XML DTD
The DocBook-4.5 XML DTD-4.5
package contains document type definitions for verification of XML
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]](../images/note.png)
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
DocBook-4.5 XML DTD Dependencies
Required
libarchive-3.8.5 and libxml2-2.15.1
Installation of DocBook-4.5 XML 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 XML DTD by running
the following commands as the root
user:
install -v -d -m755 /usr/share/xml/docbook/xml-dtd-4.5 &&
install -v -d -m755 /etc/xml &&
cp -v -af --no-preserve=ownership \
catalog.xml docbook.cat *.dtd ent/ *.mod \
/usr/share/xml/docbook/xml-dtd-4.5
The shipped catalog.xml file handles
the formal public identifiers of the DocBook-4.5 XML DTD. We need
add some entries into its installation to handle the URLs of the
DTD as well, by running the following commands as the root user:
xmlcatalog --noout --add "rewriteSystem" \
"http://www.oasis-open.org/docbook/xml/4.5" \
"file:///usr/share/xml/docbook/xml-dtd-4.5" \
/usr/share/xml/docbook/xml-dtd-4.5/catalog.xml &&
xmlcatalog --noout --add "rewriteURI" \
"http://www.oasis-open.org/docbook/xml/4.5" \
"file:///usr/share/xml/docbook/xml-dtd-4.5" \
/usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
Create (or update) and populate the /etc/xml/catalog catalog file by running the
following commands as the root
user:
if [ ! -e /etc/xml/catalog ]; then
xmlcatalog --noout --create /etc/xml/catalog
fi &&
xmlcatalog --noout --add "delegatePublic" \
"-//OASIS//ENTITIES DocBook XML" \
"file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
/etc/xml/catalog &&
xmlcatalog --noout --add "delegatePublic" \
"-//OASIS//DTD DocBook XML" \
"file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
/etc/xml/catalog &&
xmlcatalog --noout --add "delegateSystem" \
"http://www.oasis-open.org/docbook/" \
"file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
/etc/xml/catalog &&
xmlcatalog --noout --add "delegateURI" \
"http://www.oasis-open.org/docbook/" \
"file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
/etc/xml/catalog
Configuring DocBook-4.5 XML DTD
Config Files
/etc/xml/catalog
Configuration Information
![[Caution]](../images/caution.png)
Caution
Various BLFS packages request DocBook
XML DTD version 4.x before V4.5, so the following step
must be done for those packages to be built successfully.
The above installation creates the files and updates the
catalogs. In order to utilize DocBook
XML DTD V4.5 when any version 4.x is requested in the
System Identifier, you need to add additional statements to the
catalog files. If you have any of the DocBook XML DTD's referenced below already
installed on your system, remove those entries from the
for command below
(issue the commands as the root
user):
for DTDVERSION in 4.1.2 4.2 4.3 4.4
do
xmlcatalog --noout --add "public" \
"-//OASIS//DTD DocBook XML V$DTDVERSION//EN" \
"http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd" \
/usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
xmlcatalog --noout --add "rewriteSystem" \
"http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
"file:///usr/share/xml/docbook/xml-dtd-4.5" \
/usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
xmlcatalog --noout --add "rewriteURI" \
"http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
"file:///usr/share/xml/docbook/xml-dtd-4.5" \
/usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
done