Gollum

Gollum (local editor for GitHub Wiki Pages)

Setup for openSUSE LEAP 15.2

Install these packages:

sudo zypper in ruby2.5-devel ruby2.5-rubygem-bundler git-core \
     make cmake gcc gcc-c++ libopenssl-devel libxml2-devel

WARNING!

I don't understand why this command did NOT install ruby2.5-devel:

sudo zypper in -t pattern devel_ruby 

NOTE: To access Gollum remotely from other machine you may need to enable access to TCP port 4567 on openSUSE's firewall using:

sudo firewall-cmd --add-port=4567/tcp
sudo firewall-cmd --add-port=4567/tcp --permanent

Setup for Ubuntu 18.04 LTS

Install Ruby 2.5 and Gollum's requirements:

sudo apt-get install ruby-dev ruby-bundler \
      make cmake gcc libssl-dev libxml2-dev

Common setup

Clone this Wiki project:

mkdir -p ~/projects
cd ~/projects
git clone https://github.com/hpaluch/hpaluch.github.io.wiki.git
cd hpaluch.github.io.wiki/

Install Gollum and its dependencies (may ask for sudo password):

bundler install

Running Gollum

Issue:

./run_gollum.sh

Point your browser to http://localhost:4567

Important notes:

• Gollum sees only commited (=repository) changes, that means you need to invoke git add/commit to see them