[publican-list] Install Publican on OS X Lion - Working

[Misty Stanley-Jones]

I think it gets you Perl and GNU Make. It is possible you could just rely on Macports entirely. It is a bit more difficult for me to remove Xcode than to remove Macports, so I have not tested without it. This procedure relies on the Perl provided by Macports.

----- Original Message -----
> From: "Darrin Mison" <dmison at redhat.com>
> To: "Misty Stanley-Jones" <misty at redhat.com>
> Cc: "Publican discussions" <publican-list at redhat.com>, "Engineering Content Services Writing projects."
> <content-services-list at redhat.com>
> Sent: Thursday, November 10, 2011 2:12:03 PM
> Subject: Re: Install Publican on OS X Lion - Working
> 
> What's required from XCode ?
> 
> It's a 4 gig download and then even more than that to install it.
> 
> 
> 
> On 10/11/2011, at 10:30 AM, Misty Stanley-Jones <misty at redhat.com>
> wrote:
> 
> > I'd appreciate it if someone could test this procedure for me. It
> > has worked several times now for me on OS X Lion.
> > 
> > Notes:
> > 1. I have not dealt with installing extra brands at all yet.
> > 2. Steps 1-6 are preparatory work and hopefully some of it will be
> > streamlined in the future.
> > 3. Everything is stored in /opt/local along with the rest of the
> > Macports stuff. This segregates it from your OS install.
> > 4. It is easy to uninstall Macports, and doing so would also take
> > Publican with it. See the Macports documentation.
> > 5. At the moment, you have to override some path settings for every
> > Publican command you run. The way around this is to create a
> > symbolic link from /opt/local/share/publican to
> > /usr/share/publican. This impacts #3 above, but is a minimal risk.
> > A longer-term solution to this is underway.
> > 6. The commands below are meant to be pasted into the command line
> > as a single line each.
> > 
> > 
> > Procedure:
> > 
> > 1. Install Xcode from Mac App Store
> > 
> > 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 ImageMagick +perl +no_x11
> > 
> > 5. Install Perl modules available as Macports. They will pull in
> > more dependencies and install them all under /opt/local.
> > sudo port install 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
> > 
> > 6. Install CPAN modules for dependencies which can't be satisfied
> > with ports. The first line forces Makefile::Parser to install even
> > though its tests fail.
> > sudo cpan -f -i Makefile::Parser
> > sudo cpan Locale::Maketext::Gettext Locale::PO
> > DateTime::Format::DateParse Syntax::Highlight::Engine::Kate
> > XML::TreeBuilder
> > 
> > 7. Check out Publican 2.x branch:
> > svn co
> > http://svn.fedorahosted.org/svn/publican/branches/publican-2x
> > cd publican-2x/
> > 
> > 8. In the publican-2x directory, run:
> > perl ./Build.PL
> > 
> > 9. In the publican-2x directory, run:
> > ./Build
> > 
> > 10. Run the following command to install Publican and put all of
> > its bits into /opt/local:
> > sudo ./Build install --install_path
> > datadir=/opt/local/share/publican --install_path
> > generated=/opt/local/share/publican/sitetemplate  --install_path
> > web=/opt/local/share/publican/sitetemplate --install_path
> > templates=/opt/local/share/publican/templates --install_path
> > etc=/opt/local/etc --install_path
> > completion=/opt/local/etc/bash_completion.d
> > 
> > 11. Create a book.
> > publican create --name=testbook
> > --common_config=/opt/local/share/publican
> > --common_content=/opt/local/share/publican/Common_Content
> > 
> > 12. Change to the book's main directory: cd testbook
> > 
> > 13. Build the book, pointing to the proper places for things
> > Publican expects to find in /usr:
> > publican build --formats=html --langs=en-US
> > --common_config=/opt/local/share/publican
> > --common_content=/opt/local/share/publican/Common_Content
> > 
> > 14. Open the tmp/en-US/html/index.html in a browser to prove that
> > it built properly.
> > 
> 

-- 
Misty Stanley-Jones, RHCE 
Content Author, ECS Brisbane 
☺: misty (Freenode IRC) ✉: misty at redhat.com ☏: + 61 7 3514 8105 ☏: 88105