Install Xcode from Mac App store.
Xcode is about 4GB. Be prepared to wait. It has things you need, though.
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.
Open a terminal.
Install dependencies for publican, which are available as ports:
$
sudo port installdocbook-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
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
Install FOP if you want PDFs to work:
$
sudo port installfop
$
echo"FOP_OPTS='-Xms50m -Xmx700m'" > ~/.foprc
Check out Publican Main branch. This command should be run from your user home directory, for instance /Users/yourusername
$
git clonegit://git.fedorahosted.org/publican.git
Change directories:
$
cdpublican/publican
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
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
$
publican create--name=testbook
$
cd testbook
$
publican build--formats=html --langs=en-US
Open the tmp/en-US/html/index.html
file in a browser to prove that it built correctly.
Procedure 1.2. Install a brand
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
Either check out the SVN for your brand, or get a pre-built brand from a friend.
The SVN location for the brands supplied by Red Hat is http://svn.fedorahosted.org/svn/publican
If you use a pre-built brand, extract it as necessary.
If you got the brand from SVN, build it.
$
cd publican/publican-jboss
$
publican build--formats=xml --langs=all --publish
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.