Building Publican 1.99 on Ubuntu 10.04

From Crashcourse Wiki

Given that Red Hat's Publican DocBook-based publishing system is currently at version 1.99, it's likely that it will be available as a Ubuntu .deb package or two at some point in the near future but if you don't feel like waiting, here's how you can download the source and build it on Ubuntu 10.04.

Send comments/feedback to rpjday@crashcourse.ca.

Contents 1 Checking out the source 2 The dependencies 3 The build, test and installation 4 Building the User Guide

[edit] Checking out the source

If you want to follow the development trunk, chances are you don't need any of the Subversion branches or tags, so check out the source with:

$ svn co http://svn.fedorahosted.org/svn/publican/trunk

That will actually give you multiple component trunks -- the one you care about is, unsurprisingly, publican.

[edit] The dependencies

Let me save you some dependency-resolution time:

$ sudo apt-get install \
libfile-pushd-perl \
libconfig-simple-perl \
libxml-treebuilder-perl \
libfile-find-rule-perl \
libmakefile-parser-perl \
liblocale-maketext-gettext-perl \
perlmagick \
libimage-size-perl \
libdatetime-perl \
liblocale-po-perl \
libxml-libxslt-perl \
libdatetime-format-dateparse-perl \
libsyntax-highlight-engine-kate-perl \
libtest-perl-critic-perl \
libtest-pod-coverage-perl \
libtest-exception-perl \
libdevel-cover-perl \
libdbd-sqlite3-perl

In addition, there are bugs in two current Ubuntu stable packages, so download and install the following:

* [libhtml-tree-perl_3.23-2]
* [libxml-treebuilder-perl_3.09-2]

and that should mostly do it for dependencies, but be prepared to still have to track down and install missing Perl modules when you do the build.

[edit] The build, test and installation

At this point, the following should work:

$ perl Build.pl
$ ./Build
$ ./Build test
$ sudo ./Build install

[edit] Building the User Guide

At this point, you might as well build the User Guide:

$ cd Users_Guide
$ publican build --formats="html,html-single,pdf,epub" --langs=en-US --publish --embedtoc

The end result -- the Users Guide in multiple output formats -- will be found in the publish/ directory.