from Hacker News

Show HN: Realms Wiki – Simple Git-backed wiki inspired by Gollum

by scragg on 9/10/14, 5:07 PM with 16 comments

• by josegonzalez on 9/10/14, 6:06 PM

  We setup multiple[1] Gollum wikis at work, and had the following changes:

  - Removed a bunch of features that were confusing to our non-dev users

  - Used nginx/lua to do custom OAuth-based authentication [2]

  - Set the committer's name and email to the currently authenticated user (from an env var in the request)

  - Mucked around with the templates

  - Added a /_status endpoint to do simple healthchecks for our load-balancer

  - Extended `process_page_link_tag` to make it a bit more flexible when constructing links

  - Added hipchat notifications for when pages are updated

  Would be nice to see a system that allowed us to do the above, as we're not really all that in love with Gollum. The git part was great for our initial migration, not so great for wiki fault-tolerance...

  [1] One for employees, one for freelancers, etc. [2] Blog post on oauth with nginx/lua here: http://chairnerd.seatgeek.com/oauth-support-for-nginx-with-l...

• by spindritf on 9/10/14, 7:27 PM

  Inspired by Gollum, Ghost, and Dillinger

  What are those? Gollum is a wiki[1], yes? Ghost is the new blogging platform[2]? What's Dillinger?

  [1] https://github.com/gollum/gollum

  [2] https://github.com/tryghost/Ghost

• by coolsunglasses on 9/10/14, 7:00 PM

  Probably a good time to mention similar alternatives that I liked a bit better than Gollum such as:

  https://www.branchable.com/

  and

  http://gitit.net/

• by sc00ty on 9/10/14, 9:56 PM

  Kind of curious why the suggested way of installing is directly into the root python install. I figured it would have some sort of guide using virtualenv. I did see a requirements.txt in the repo, so I tried installing it in a virtual environment myself but had some issues compiling some modules (Tried both 2.7 and 3.4). I gave up at that point because it was more trouble than it was worth.

  I really like the idea of this wiki as well as the look of it. I could definitely see myself using this in the future. I had spent some time a couple months ago looking into what Flask-based wikis were available but my results turned up very little. I'll definitely be watching this repo as it grows.

• by fiatjaf on 9/10/14, 11:34 PM

  Ok, maybe someone would want to check the Smallest Federated Wiki: https://github.com/fedwiki/wiki-node

• by mhd on 9/10/14, 10:34 PM

  I like the concept of the split-screen markdown editor, I had some pretty decent success with non-technical people when we were using jottit for some RPG background documentation. Definitely going to take a look at that, especially if the prerequisites (both packages/daemons and mem/cpu) aren't too high for a low-end VPS.

• by syntax_erorr on 9/10/14, 10:38 PM

  Having just spent the past two days searching around for a git-backed python-based markdown-enabled personal wiki...I am so stoked that one just popped up here. Very cool!

  I'm loading up with Vagrant right now. Any thoughts on dockerizing it?

• by rsync on 9/10/14, 7:21 PM

  Can this be run over SSL out of the box, or do I need to wrap it up somehow ?