ぼっちWikiに最適なGollum
GollumはデータベースにGitを使い、Markdownで書けるWiki。
Gollumの特徴は以下の通り。
- シンタックスハイライトや数式に対応している
- 様々な記法で書ける
gem
コマンドで簡単にインストールできる- データベースとしてGitを使うのでMySQLなどが不要
- Ruby+Sinatraで実装されている
- Rubyでマクロを書いて拡張できる
Gollumのインストール
ICUという文字コード変換ライブラリに依存しているのでまずはそれをインストール。
# OS Xの場合 $ brew install icu4c # Debian/Ubuntuの場合 $ sudo apt-get install libicu-dev
続いて、Gollum本体をインストール。
$ gem install github-markdown gollum
Gollumの起動
$ git init # 初回だけ $ gollum --mathjax --config auth.rb --allow-uploads
認証の設定
ぼっちWikiなので、他人に内容を見られてしまっては困る。
Gollumは普通のSinatraアプリと同じように、認証をつけることができる。
たとえばこんな感じのauth.rb
を作成するとBasic認証を追加できる。
module Precious class App < Sinatra::Base use Rack::Auth::Basic, "Restricted Area" do |username, password| [username, password] == ["foo", "bar"] end end end
※Basic認証&ファイルにパスワード直書きなので、盗聴やパスワード漏洩の可能性がある。あくまでも気休め。