aron/install_notes/gitit_install_notes

Basic Install

The current released version of gitit on the hackage site (0.8.1) is incompatible with the newest version of pandoc (1.9) and did not properly protect itself using versioning to require an older pandoc. You must install gitit from source!

You can grab John’s canonical version of gitit (now at 0.9, but not at hackage yet, soon!) here: https://github.com/jgm/gitit

Or you can grab mine (which won’t work until I more properly document all the changes I made to get the pagedown wysiwyg editor working) here: https://github.com/ahmadia/gitit

Steps

  1. Install modified pandoc
  2. Install modified gitit
  3. Customize gitit template files (particularly page.st)
  4. Install customized mathjax
  5. Install pagedown wysiwyg Markdown editor

Installing from source repositories using cabal

git clone https://github.com/jgm/gitit.git
cd gitit
cabal install #cabal will grab dependencies if it can find them

Still to do

  • restore preview button when the markdown WYSIWYG editor is not configured (port 5001 access)
  • fix CSS/HTML elements so that the preview pane from the pagedown editor has fixed maximum height
  • document the changes made to gitit’s template page.st file to get side-by-side preview editing working.
  • installer?