3. OSX Lion

  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.