Tools for creating documentation: LaTeX, pandoc, Jekyll and related; setup for Ubuntu 12.04.

docs_publ_tools_ubuntu_install.sh

## Jekyll: first setup ruby, gem (see ubuntu workstation setup notes);
## also need Javascript runtime: Node.js works
sudo apt-get install nodejs
sudo gem install json
sudo gem install rdoc
sudo gem install pygments.rb
sudo gem install jekyll

## LaTeX
sudo apt-get install texlive-full
sudo apt-get install texmaker

## pandoc:
##  old versions in Ubuntu repositories;
##  build using Haskell platform
##  http://johnmacfarlane.net/pandoc/installing.html
sudo apt-get install haskell-platform
cabal update
cabal install pandoc pandoc-citeproc
## pandoc executable now in ~/.cabal/bin/
## addo to .bashrc (or ~/.bash_aliases):
##  [ -d "$HOME/.cabal/bin" ] && export PATH="$HOME/.cabal/bin:$PATH"

## pandoc extension for jekyll:
##  http://www.jekyll-plugins.com/plugins/jekyll-pandoc-plugin
## note edit in my fork for jekyll 2.*
##  https://github.com/multidis/jekyll-pandoc-plugin
## sudo gem update jekyll (if needed)
sudo gem install pandoc-ruby
## set _config.yml appropriately for each jekyll site