Product SiteDocumentation Site

Publican 1.3

Users Guide

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

Edition 1.3

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

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!
3. Acknowledgements
Introduction
1. Installing Publican
1.1. Installing Publican on Linux operating systems
1.1.1. Installing Publican on Fedora
1.1.2. Installing Publican on Red Hat Enterprise Linux 5
1.1.3. Installing Publican on Debian
1.1.4. Installing Publican on Ubuntu
1.2. Installing Publican on Windows operating systems
2. Publican commands
2.1. Global 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. Preparing a document for translation
3.4. Building a document
3.4.1. Building a document created with Publican 0
3.5. Packaging a book
3.5.1. Types of RPM packages
3.5.2. The publican package command
3.6. Conditional tagging
3.6.1. Conditional tagging and translation
3.7. Pre-release software and draft documentation
3.7.1. Denoting pre-release software
3.7.2. Denoting draft documentation
3.7.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. 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