1.3. OSX Lion

Test
  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.