Product SiteDocumentation Site

Chapter 6. Publican

6.1. Installing Publican
6.2. Creating a New Document
6.3. Validating a Document
6.4. Building a Document
6.5. Publishing a Document
6.5.1. Adding a New Document
6.5.2. Updating a Document
6.5.3. Removing a Document
6.6. Packaging a Document
Publican is an open-source publishing system for documentation authored in DocBook XML. It can be used to create and build individual articles and books, manage multiple book sets, or to maintain entire documentation websites. In addition, it can also be used to create RPM packages for easy distribution of documentation builds to other machines.
Publican produces high-quality documents in a number of commonly used file formats such as HTML, PDF, or EPUB. To ensure that all documents produced for a specific project have a consistent look, it uses so-called brands to add logos, define color schemes, and set the overall visual style of the output files.
The Fedora Documentation Project uses Publican to produce all documents located on the Fedora Documentation website.

6.1. Installing Publican

To install Publican itself and the fedora brand that is used by the Fedora Documentation Project, type the following at a shell prompt as root:
yum install publican publican-fedora
By default, only the common brand is installed with the publican package. There are many brands in Fedora repositories, such as oVirt (publican-ovirt), JBoss (publican-jboss), or genome (publican-genome).