External
Overview
External are tools that come from other projects, outside Marakana. We copy/paste them here mostly for consistency, so everyone points to the same toolchain and is on same page.
Setup
Asciidoc
Make sure you only use our version of Asciidoc. To do so, simply add it to your path:
# Asciidoc Specific export PATH=$PATH:/Users/marko/github/external/asciidoc
Omni Graffle
In Terminal:
ln -s ~/github/external/omnigraffle-stencils/ ~/Library/Application\ Support/OmniGraffle/Stencil
(You may have to rm previous folders for your Stencils)
A2X Setup
-
I installed all this (under Requirements): http://www.methods.co.nz/asciidoc/a2x.1.html
-
Using MacPorts on OSX: http://guide.macports.org/#installing
-
A useful GUI here: http://porticus.alittledrop.com/
-
And had to this tiny adjustment: http://blog.peopleareducks.com/2009/12/04/installing-dblatex-from-the-latest-macports/
-
Update
/opt/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty
and add the following section:
% ############################################################################## % ### Page Parameters - Added by Marko/Marakana % ### See http://en.wikibooks.org/wiki/LaTeX/Page_Layout for details % ############################################################################## \setlength{\paperwidth}{8.5in} \setlength{\paperheight}{11in} \setlength{\hoffset}{-1in} \setlength{\voffset}{-1in} \setlength{\oddsidemargin}{2cm} \setlength{\marginparsep}{0cm} \setlength{\marginparwidth}{0cm} \setlength{\textwidth}{17cm} \setlength{\topmargin}{0.5cm} \setlength{\headsep}{2cm} \setlength{\textheight}{22cm} \setlength{\footskip}{1.5cm}