Product SiteDocumentation Site

Publican 2.0

Users Guide

Publishing books, articles, papers and multi-volume sets with DocBook XML

Edition 1.0

Team Publican

Don Domingo

Red Hat Engineering Content Services

Brian Forté

Red Hat Engineering Content Services

Rüdiger Landmann

Red Hat Engineering Content Services

Joshua Oakes

Red Hat Engineering Content Services

Joshua Wulf

Red Hat Engineering Content Services

Edited by

Brian Forté

Red Hat Engineering Content Services

Edited by

Rüdiger Landmann

Red Hat Engineering Content Services

Jeff Fearn

Extensive review, rough drafts, persistent annoyances. 
Red Hat, Engineering Operations Logo

Josef Hruška

Checking the Czech examples in Entities and translation 
Fedora Localization Project

Legal Notice

Copyright © 2009 Red Hat, Inc This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at http://www.gnu.org/licenses/fdl.txt).
Abstract
This book will help you install Publican. It also provides instructions for using Publican to create and publish DocBook XML-based books, articles and book sets. This guide assumes that you are already familiar with DocBook XML.

Preface
1. Document Conventions
1.1. Typographic Conventions
1.2. Pull-quote Conventions
1.3. Notes and Warnings
2. We Need Feedback!
Introduction
1. Installing Publican
1.1. Linux operating systems
1.1.1. Fedora
1.1.2. Red Hat Enterprise Linux 5
1.1.3. Ubuntu
1.1.4. Debian
1.2. Windows operating systems
2. Publican commands
2.1. Command options
2.2. Actions
3. Creating a document
3.1. Files in the book directory
3.1.1. The publican.cfg file
3.1.2. Book_Info.xml
3.1.3. Author_Group.xml
3.1.4. Chapter.xml
3.1.5. Doc_Name.xml
3.1.6. Doc_Name.ent
3.1.7. Revision_History.xml
3.2. Adding images
3.3. Adding files
3.4. Preparing a document for translation
3.5. Building a document
3.5.1. Building a document created with Publican 0
3.6. Packaging a book
3.6.1. Types of RPM packages
3.6.2. The publican package command
3.7. Conditional tagging
3.7.1. Conditional tagging and translation
3.8. Pre-release software and draft documentation
3.8.1. Denoting pre-release software
3.8.2. Denoting draft documentation
3.8.3. Denoting draft documentation of pre-release software
4. Branding
4.1. Installing a brand
4.2. Creating a brand
4.3. Files in the brand directory
4.3.1. The publican.cfg file
4.3.2. The defaults.cfg file and overrides.cfg file
4.3.3. publican-brand.spec file
4.3.4. README
4.3.5. COPYING
4.3.6. Common Content for the brand
4.3.7. The css subdirectory
4.3.8. The images subdirectory
4.4. Packaging a brand
5. Using sets
5.1. Stand-alone sets
5.2. Distributed sets
6. Building a website with Publican
6.1. The website structure
6.1.1. Creating the website structure
6.2. The home page
6.3. Installing, updating and removing documents
6.3.1. Installing, updating and removing documents manually
6.3.2. Installing, updating and removing documents as RPM packages
6.4. Automating publishing
7. Frequently Asked Questions
A. Disallowed elements and attributes
A.1. Disallowed elements
A.2. Disallowed attributes
B. Command summary
C. publican.cfg parameters
D. Language codes
E. Revision History