mod_wiki

俺の考えた最高のWikiシステム

mod_wikiは軽量、高速、CLIフレンドリなGitベースのWikiシステムです。

特徴

• gitによる履歴管理
• Markdown記法による書式
• Pure C (apache module)

mod_wiki はこんな人にオススメです

• WEBブラウザを使わずにemacsやvimなど、お気に入りのテキストエディタで編集したい
• RDBを使いたくない
• 文書もSCMで管理したい、そしてgitが好き

ソースコード

https://github.com/hamano/apache-mod-wiki

ビルド

% ./autogen.sh
% ./configure --with-apache=<APACHE_DIR> \
    --with-discount=<DISCOUNT_DIR> \
    --with-libgit2=<LIBGIT2_DIR>
    --with-clearsilver=<CLEARSILVER_DIR>
% make
# make install

依存ライブラリ

• discount
  • http://www.pell.portland.or.us/~orc/Code/discount/
• libgit2
  • http://libgit2.github.com/
• Clearsilver
  • http://www.clearsilver.net/

設定例

httpd.conf に

LoadModule wiki_module modules/mod_wiki.so
<Location />
  SetHandler wiki
  WikiRepository /path/to/repository.git
  WikiName "My Wiki"
  WikiCss /style.css
</Location>

使い方

参照

gitレポジトリに test.md というMarkdown記法のファイルをpushすると、

http://example.com/test というURLで参照出来ます。

編集

git clone して、お気に入りのエディタで編集、git commit & git push

検索

grep <KEYWORD> *.md

あるいは git clone して、git grep <KEYWORD>

あるいは google検索

履歴

git log

TODO

• とは言ってもWEBインターフェースは必要
• ページキャッシュ機能(memcached, redisなど)
• git以外の別のSCMには対応はしないだろうな