new publishing package: publican

Murray McAllister murray.mcallister at gmail.com
Thu Feb 14 01:09:48 UTC 2008


>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.

---------------------------------------------------------------------
pub   1024D/81B3FDEB 2007-09-19 [expires: 2008-09-18]
Key fingerprint = 4ED9 9907 5BF0 4132 2B46  20D1 C0C6 362D 81B3 FDEB
Murray McAllister (Fedora Docs Project / mdious) <murray.mcallister at gmail.com>
sub   2048g/B04CFA0C 2007-09-19 [expires: 2008-09-18]




More information about the fedora-docs-list mailing list