Peterkeen/sites. Simple Git-backed Microsites. A few days ago I built a new tool I'm calling Sites.
It builds on top of git-backed wikis powered by GitHub's Gollum system and lets me build and deploy microsites in the amount of time it takes me to create a CNAME. Something that I've wanted for a very long time is a way to stand up new websites with little more than a CNAME and a few clicks. I've gone through a few rounds of trying to make that happen but nothing ever stuck. Furthest progressed was a Rails app exclusively hosting Comfortable Mexican Sofa, a simple CMS engine. I never ended up putting any sites on it, though. GitHub's Pages are of course one of the best answers, but I'm sticking to my self-hosting, built-at-home guns. A Short Code Tour The code is split up into four distinct parts: viewer is a Sinatra app that presents wiki content as web pages.
Demo Time Here's what the manager app presents when you just go to sites.bugsplat.info: If you click on one of those links, you'll get the familiar Gollum interface: Installation. Absolutely No Machete Juggling » Personal Wiki using GitHub and Gollum on OS X. I’ve been struggling for a while to get a good personal wiki solution going.
I have a bunch of requirements that have made this quite difficult: Access and edit wiki from browserRun in OS X (Laptop) and Linux (Workstation)Synchronized across all machinesCan use offline I tried using TiddlyWiki with DropBox as the cloud-based sync mechanism, but I use Google Chrome as my browser, which has a lot of trouble with the Java plugin that does the saving. There are command line arguments for Chrome that fix this, but that’s weirdly difficult to deal with on OS X. So my final solution, subject to improvement, is to use Gollum. There are a number of steps to getting this set up, so I’ve decided to document them here, both for the benefit of anyone else who wants to do this, as well as for myself if I have to set it up on another machine. In any case, get a Git repo set up on either GitHub or BitBucket. Now, clone your personal wiki somewhere handy.
God that’s hideous. Gollum/gollum. Gollum on Ubuntu/Linux Mint. Gollum is the wiki engine that is developed and deployed by GitHub.
The codes are hosted at It supports many syntaxes, including Markdown, ReStructuredText, Textile, MediaWiki, etc. To install: On Linux Mint 13 “Maya” (based on Ubuntu 12.04 “Precise Pangolin”), first get Ruby and RubyGems: Then install Gollum via RubyGems: An alternative to install Gollum is to build from source (taking version 2.5.0 as example): To use it, simply create a Git repository: Now point the browser to and you have a fully functional Wiki site up and running. One downside thus far is that Gollum doesn’t support multiple repositories and multiple users. One might want to run Gollum as a service/daemon with Upstart. Then I made a script called ~/.init/gollum.conf (create the directory ~/.init if it doesn’t exist, and replace USERNAME with your username below): Ask initctl to reload configurations: Happy writing wikis!
Like this: Like Loading... Git-backed wikis, Gollum, and simple installation experiences. The Zen of Wiki with Gollum - I am alberto.