[publican-list] Install Publican on OSX Lion (now with fewer steps)

[Misty Stanley-Jones]

Changes:
* Fewer steps
* All paths are taken care of automatically
* Not having to install ImageMagick or Makefile::Parser

If you tried the first revision of these instructions and you want to clean things up and start fresh, follow these instructions to uninstall Macports, and then begin at step 2 below (Macports should still be in your Downloads):

sudo port -fp uninstall --follow-dependents installed
sudo rm -rf /opt/local
sudo rm -rf /Library/Tcl/macports1.0


Install Publican on OSX
---------------------------------------------------------
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 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

6. Install FOP if you want PDFs to work: 
	a. sudo port install fop
	b. echo "FOP_OPTS='-Xms50m -Xmx700m'" > ~/.foprc  (to fix a quirk with Fop)

7. Check out Publican 2.x branch:
	a. svn co http://svn.fedorahosted.org/svn/publican/branches/publican-2x
	b. cd publican-2x/

8. In the publican-2x directory, run "perl ./Build.PL". If all goes well, run "./Build".

9. Run the following command to install Publican and put all of its bits into /opt/local
	sudo ./Build install 

10. Create and build a book: 
	a. publican create --name=testbook
	b. cd testbook
	c. publican build --formats=html --langs=en-US
	d. Open the tmp/en-US/html/index.html in a browser to prove that it built properly.