This page serves as a central location for all things related to Publican. Publican was formerly known as Documentation-Devel.
- 1 Public Announcement
- 2 Publican List
- 3 IRC Log of Publican Meeting
- 4 Official Publican Site
- 5 Installing Publican
- 6 Publican on Fedora Tips and Tweaks
The semi-official announcement is at: http://www.redhat.com/archives/fedora-docs-list/2008-February/msg00091.html.
Here is the text:
>From Brian Forte: ---- Brisbane, Queensland, 2008/02/14 -- Red Hat Engineering Content Services is pleased to announce Publican, a new publishing package. Publican -- which has been used by Red Hat's Documentation Group for almost two years -- takes DocBook XML input and outputs HTML, plain Unicode text and PDF. This output can be branded with the following brands: Fedora, Red Hat, and JBoss. A default, generic brand is also included. Further brands can be added, either by request, or by direct customisation. (To request an additional brand, submit a bug via <https://bugzilla.redhat.com/>. Submit the bug against the "Red Hat Enterprise Linux" product, and the "publican" component.) But "make html" and "make pdf" are, perhaps, the least of Publican. What makes Publican worth announcing are "create_book" and "make dist-srpm". "create_book" does what the command name implies: it creates a directory of the XML files you need to start writing a book or article using DocBook XML as well as a ready-to-roll Makefile for outputting HTML, text and PDF. "make dist-srpm" takes a book, turns it into a tarball, adds an appropriate specfile and then wraps the whole thing up into a src.rpm. This makes it easy to incorporate documentation into the standard distribution build chain. Publican is being incorporated into the Fedora tree in the coming days and weeks. To learn more, members of the Publican development and documentation team will be answering questions in #fedora-docs on irc.freenode.net on Thursday 2008/02/14 from 12:00 Australian Eastern Standard Time (2008/02/14 02:00 UTC/GMT; 2008/02/14 IST; 2008/02/13 22:00 American EDT; 2008/02/13 19:00 American PDT). ---- Kind Regards, Murray.
Publican list is used to inform users of the current Publican version, upgrades and changes, bug fixes, and for Publican discussions.
All writers and translators are encouraged to subscribe:
IRC Log of Publican Meeting
The meeting referenced above was held as scheduled on Thursday, 14 February at 0200 UTC. The transcript can be read here .
Official Publican Site
The Fedora Hosted site contains the code and some additional documentation:
Publican is available in the official Fedora repositories. To install it with user documentation, run this command:
yum install publican-doc publican-fedora
Publican on Fedora Tips and Tweaks
If you're running Fedora, you'll need to do a little tweaking to get Publican working properly.
The only Publican brand packages available in the Fedora repository are for Fedora and oVirt. If you want to build Red Hat- or JBoss-branded documents, you will need their respective brand packages. Download and install the Red Hat Enterprise Linux 5 packages — publican-redhat and publican-jboss.
The publican-fedora brand package contains an incorrect graphic, does not support languages that are written right-to-left (like Arabic, Hebrew, and Persian), and does not contain recent localisations of the "Common Content" sections. Delete your /usr/share/publican/Common_Content/common and /usr/share/publican/Common_Content/fedora directories and replace them with the versions contained in this archive. This fixes BZ#492041 and issues like BZ#442642.
- BZ# 492689 This issue affects Publican 0.44 (the current version in Fedora) and Publican 0.45 (the current version in Red Hat Enterprise Linux, if installed on Fedora).Symptom — If you build a PDF of a document that contains a