ProductsDesktop Server Red Hat Enterprise Linux OpenStack Platform For IBM POWER For IBM System z For SAP Business Applications Red Hat Satellite Management For Scientific ComputingExtended Update Support High Availability High Performance Network Load Balancer Resilient Storage Scalable File System Smart Management Extended Lifecycle SupportAccelerate Automate Integrate Red Hat JBoss Developer Studio Portfolio Edition Web Framework Kit Application Platform Web Server Data Grid Portal Fuse Red Hat JBoss A-MQ SOA Platform BRMS Data Services Platform JBoss Operations Network JBoss Community or JBoss enterprise
SolutionsWhy Red Hat Why open hybrid cloud? The new IT Public cloud Cloud resource library Private cloud Infrastructure-as-a-Service (IaaS) Platform-as-a-Service (PaaS) Cloud applications and workloadsSolaris 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
TrainingClassroom training Red Hat Online Learning Virtual training Remote classroom training On-site team training Online Learning LabsPopular and new courses Red Hat JBoss Administration curriculum Core System Administration curriculum Red Hat JBoss Middleware Development curriculum Advanced System Administration curriculum Linux Development curriculum Cloud Computing, Virtualization, and Storage curriculum
ConsultingSOA and integration Business 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.