ProductsDesktop Server For Scientific Computing For IBM POWER For IBM System z For SAP Business Applications Red Hat Network Satellite ManagementExtended Update Support High Availability High Performance Network Load Balancer Resilient Storage Scalable File System Smart Management Extended Lifecycle SupportDeveloper Studio Portfolio Edition Web Framework Kit Application Platform Web Server Data Grid Portal Platform Red Hat JBoss A-MQ Red Hat JBoss Fuse SOA Platform Business Rules Management System (BRMS) Data Services Platform Messaging JBoss Operations Network JBoss Community or JBoss enterprise
SolutionsApplication development Business process management Enterprise application integration Interoperability Operational efficiency Security VirtualizationSolaris to Red Hat Enterprise Linux Migration overview Migrate from your UNIX platform How to migrate to Red Hat Enterprise Linux Upgrade to the latest Red Hat Enterprise Linux release JBoss Enterprise Middleware Benefits of migrating to Red Hat Enterprise Linux Migration services Start a conversation with Red Hat
TrainingPopular and new courses Red Hat JBoss Administration curriculum Core System Administration curriculum JBoss Middleware Development curriculum Advanced System Administration curriculum Linux Development curriculum Cloud Computing, Virtualization, and Storage curriculum
ConsultingBusiness Process Management Cloud and Virtualization Custom Software Development Enterprise Data and Storage Systems Management Migrations
Red Hat Introduces Publican
February 20, 2008
by Fedora Team
Free software is becoming increasingly popular with non-technical users and, as a result, good documentation is becoming more important. The greatest barrier to achieving good, free documentation has not been a lack of interested contributors, but the difficulty of the tools required to create and manage regularly updated and complex documents.
Thankfully things have just got a lot easier: Publican has arrived. Red Hat‘s documentation team has been using this tool, which automates the process of creating all the files needed to begin a new document, as well as exports the finished content into many of the most common formats including HTML and PDF. Now they’ve opened it up to the world and it is being hosted by the Fedora Project, whose own documentation team is set to adopt it.
Jared Smith, a member of the Fedora Documentation Project, spent some time talking about his first experiences with Publican:
I probably spent at least a good twenty or thirty hours (or more) setting up the infrastructure for the last DocBook project I started …mostly setting up files (and the various links between them), tweaking the Makefiles, etc. It was not exactly my definition of the word ‘fun’.
So on a whim last night, I figured I’d start checking out Publican and see how long it would take. In less than 15 minutes, I had Publican installed and an existing DocBook document ported over to it (the new revision of the Software Management Guide, as part of the Fedora Documentation Project). You can see the HTML output of my endeavor here, complete with Fedora branding and everything.