[publican-list] Publican Install on Os X Lion 7.2.3 - We think we have it

[Jeff Fearn]

Nice work George & Misty!

FYI the brands are also in the Publican git repo. In step 8 you ran 'cd 
publican/publican' from there you can 'cd ../publican-fedora' and use 
the brand there. This is the only place we will be making updates, so 
it's safer to use than the svn repo.

Cheers, Jeff.

On 05/18/2012 12:51 PM, George Grenley wrote:
> With a gob of support from Misty and Rudi, we managed to get Publican running under Lion. Here's what we did. Please try this, or at least let me know if there is anything that seems ambiguous.
>
>
>
> Installing Publican on OS X Lion  ¶
>
> 1. Install Xcode from Mac App Store.
>
> It is about 4 GB. Be prepared to wait. It has thngs 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 window. You will need an adminstrative password.
>
> 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. sudo cpan Locale::Maketext::Gettext Locale::PO DateTime::Format::DateParse Syntax::Highlight::Engine::Kate XML::TreeBuilder File::Inplace String::Similarity HTML::FormatText::WithLinks::AndTables
>
> Note: these installs will generate lots of messages, including warnings. Don’t worry about them.
>
> 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, i.e. /Users/yourusername. The command is:
>
> git clone git://git.fedorahosted.org/publican.git
>
>   8. Change directories:
>
>   cd publican/publican
>
> This directory should contain a file named Build.pl. Check to be sure all has gone well.
>
> In the publican directory, run:
>
> perl ./Build.PL
>
> Then
>
> ./Build
>
> These, too, will generate LOTS of warnings. Ignore them
>
> Run the following command to install Publican and put all of its bits into /opt/local
>
> sudo ./Build install
>
>
>
> You are now done with the basics.
>
> 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 in a browser to prove that it built properly.
>
> open tmp/en-US/html/index.html
>
>
>
> Install a brand ¶
>
> Only once, fix the permissions of the Common Brand. 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 if 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 or specifying the --brand option when creating your book.
>
>
>
> _______________________________________________
> publican-list mailing list
> publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list
> Wiki: https://fedorahosted.org/publican


-- 
Jeff Fearn <jfearn at redhat.com>
Senior Software Engineer
Red Hat