Gollum wikis

Gollum is a ruby package used to display github wikis on the web.

On linux

Runs on shadow as user Gollum, in /home/gollum
Some time after system updates run, Ruby Gems needs a rebuild. Try /tmp/ibex.log may need to run e.g. gem pristine nokogiri --version 1.6.8
- Should run this as user Gollum

This theoretically works but we have had issues getting pages to render correctly (on shadow).

This seems to work better.

Installation instructions:

Install jRuby (note: it MUST be jRuby, the C implementations of ruby don't work correctly on windows). You will probably want the exe-x64 download.
- When running through the installer, do not select "configure path for me" as this might mess with our EPICS path.
In the jRuby/bin directory run gem install gollum
Ensure the python2 command is accessible on your PATH
Run python2 -m pip install docutils==0.14 (or a later version if you desire). This includes the rest2html script which gollum uses to render restructured text.
Clone the user manual using git clone https://github.com/ISISComputingGroup/ibex_user_manual.wiki.git C:/Instrument/user_manual
Run jRuby\bin\gollum C:/Instrument/user_manual to run the gollum webserver
Navigate to http://localhost:4567/Home - this should display the wiki