# Docbook

We will assume that our docbook document is in `File.xml`

## Setting up Docbook in Arch

To set up docbook running on arch:

    $ pacman -S docbook-xml docbook-xsl libxslt libxml2

## Validating XML file

To validate the XML file use:

    $ xmllint --valid --noout File.xml

This will generate no output if the file is proper XML.

## Converting into XHTML

### Single file

To convert into a XHTML file (single file) use:

    xsltproc /usr/share/xml/docbook/`pacman -Q docbook-xsl | cut -d ' ' -f 2 | cut -d '-' -f 1`/xhtml/docbook.xsl File.xml > Output.html

### Segmented

To convert into a a segmented XHTML file (each section in its own file) use:

    xsltproc /usr/share/xml/docbook/`pacman -Q docbook-xsl | cut -d ' ' -f 2 | cut -d '-' -f 1`/xhtml/chunk.xsl File.xml

## Automating

You can add these to `~/.bashrc`(or similar shell startup file):

    alias doc2html1="xsltproc /usr/share/xml/docbook/xhtml/docbook.xsl"
    alias doc2multihtml="xsltproc /usr/share/xml/docbook/xhtml/chunk.xsl"
    alias docvalidate="xmllint --valid --noout"

Category:

- Office