markdown + git 最适合程序员的wiki系统

26 Sep 2014

gollum 是github的使用的一个基于markdown的 wiki系统。 最重要的是gollum直接和git集成不需要数据库，你可以选择在Web页面撰写文档，也可以用你喜欢的markdown工具编辑文档在命令行进行提交。 “markdown+git = wiki” 这对程序员来讲绝对是最棒的选择。

Gollum wiki 的截图如下

Mac下安装的适合遇到了一些小问题，所以在这里记录一下安装过程 。

基本的环境

在安装之前，假定我们已经拥有了mac 下的包管理工具 homebrew 及 ruby 运行环境。我当前的工作环境如下:

1. Mac 10.9
2. homebrew 0.9
3. ruby 2.0

安装 Gollum

我们可以选择通过二进制或者源码的方式进行安装。

二进制安装

在安装的时候会出现找不到libiconv所以需要安装下面的依赖库

brew install libxml2 libxslt
brew link libxml2 libxslt --force
wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz
tar xvfz libiconv-1.13.1.tar.gz
cd libiconv-1.13.1
./configure --prefix=/usr/local/Cellar/libiconv/1.13.1
make
sudo make install

通过Gem安装 gollum

[sudo] gem install gollum

源码安装

git clone https://github.com/gollum/gollum
cd gollum
bundle install

安装成功后尝试着在终端输入下面的命令，如果能够正常显示版本号则说明安装成功.

gollum --v

创建自己的wiki系统

接下来我们就可以建立自己的wiki系统了，建立一个名字为”wiki”的目录使用git进行管理。进入到wiki目录，在wiki目录下启动gollum

mkdir wiki
cd wiki
git init
gollum

显示如下：

[2015-01-21 14:03:45] INFO  WEBrick 1.3.1
[2015-01-21 14:03:45] INFO  ruby 2.0.0 (2013-05-14) [x86_64-darwin12.4.1]
== Sinatra/1.4.5 has taken the stage on 4567 for development with backup from WEBrick
[2015-01-21 14:03:45] INFO  WEBrick::HTTPServer#start: pid=17699 port=4567

接下就可以在浏览器中访问了 http://localhost:4567/

创建wiki文档可以选择在全部Web界面进行操作，也可以选择在终端命令行进行提交管理markdown文件，在浏览器中进行查看。