smeagol -- A Read-Only Gollum Server
DESCRIPTION
Smeagol is a server that can run a read-only version of a Gollum wiki. This can be useful when you want to maintain a standalone copy of a Github wiki but you want to update it through the Github interface.
Smeagol follows the rules of Semantic Versioning and uses TomDoc for inline documentation.
INSTALLATION
You can install Smeagol with RubyGems:
$ [sudo] gem install smeagol
And then, if you want code highlighting, follow the Installation Guide for Pygments.
Ta da. You're ready to go.
RUNNING
To run smeagol, simply change directories to your Gollum repository and run the
smeagol
executable from the command line:
$ cd /path/to/repo
$ smeagol
This will run a web server at http://localhost:4567
. You can change the port
by setting the --port
or -p
option on the command line.
UPDATING
There are two ways to update the repository through Smeagol:
- Auto Update
- Manual Update
To setup Smeagol to automatically update your repository in fixed intervals,
simply pass the --auto-update
option in the command line and Smeagol will
automatically perform a git pull origin master
on your repository once per
day.
To perform a manual update, simply go to the URL,
http://localhost:4567/update
, and Smeagol will perform a git pull. Change the
URL to your appropriate hostname and port.
CONTRIBUTE
Have a great idea for Smeagol? Awesome. Fork the repository and add a feature or fix a bug. There are a couple things I ask:
- You must have tests for all code you check in.
- Create an appropriately named topic branch that contains your change.
Also, to run the Cucumber tests in Smeagol, you must first install rdiscount
:
$ gem install rdiscount