1. Install Xcode from Mac App store.

   Note

   Xcode is about 4GB. Be prepared to wait. It has things you need, though.
2. Install Macports from http://guide.macports.org/chunked/installing.macports.html. Everything you install with it goes into /opt/local, away from your normal OS files.
3. Open a terminal.
4. Install dependencies for publican, which are available as ports:

   $sudo port install docbook-xml docbook-xsl docbook-sgml-4.2 perl5 bash-completion p5-file-pushd p5-config-simple p5-file-find-rule p5-file-slurp p5-class-trigger p5-time-hires p5-list-moreutils p5-ipc-run3 p5-class-accessor p5-test-perl-critic p5-xml-libxslt p5-locale-gettext p5-image-size p5-file-copy-recursive p5-datetime p5-archive-zip p5-timedate p5-html-format p5-dbd-sqlite p5-xml-simple p5-devel-cover p5-test-pod p5-test-pod-coverage p5-template-toolkit

5. Install CPAN modules for dependencies which can't be satisfied with ports. Note: this step will generate lots of messages, including warnings. Don't worry about them.

   $sudo cpanLocale::Maketext::Gettext Locale::PO DateTime::Format::DateParse Syntax::Highlight::Engine::Kate XML::TreeBuilder File::Inplace String::Similarity HTML::FormatText::WithLinks::AndTables

6. Install FOP if you want PDFs to work:

   $ sudo port install fop

   $ echo "FOP_OPTS='-Xms50m -Xmx700m'" > ~/.foprc

7. Check out Publican Main branch. This command should be run from your user home directory, for instance /Users/yourusername

   $ git clone git://git.fedorahosted.org/publican.git

8. Change directories:

   $ cd publican/publican

9. This directory should contain a file named Build.pl. Verify that you are in the correct directory, then run the following command. Ignore all the messages you get.

   $ perl ./Build.PL

   $ ./Build

10. Run the following command to install Publican and put all of its bits into /opt/local:

    $ sudo ./Build install

Procedure 1.1. Create and build a book

1. $ publican create --name=testbook

2. $ cd testbook

3. $ publican build --formats=html --langs=en-US

4. Open the tmp/en-US/html/index.html file in a browser to prove that it built correctly.

Procedure 1.2. Install a brand

1. Fix the permissions of the Commons Brand. You have to do this only once. This is a bug that will be addressed eventually.

   $ find /opt/local/share/publican -type f |xargs sudo chmod 644

2. Either check out the SVN for your brand, or get a pre-built brand from a friend.
   1. The SVN location for the brands supplied by Red Hat is http://svn.fedorahosted.org/svn/publican
   2. If you use a pre-built brand, extract it as necessary.
3. If you got the brand from SVN, build it.

   $ cd publican/publican-jboss

   $ publican build --formats=xml --langs=all --publish

4. Install the brand.

   $ sudo publican install_brand --path=/opt/local/share/publican/Common_Content

   You can now use the brand in your books by editing your book's publican.cfg file or specifying the --brand option when creating your book.