gollum:给wiki插上git的翅膀

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

Gollum 的截图如下

Gollum

基本的环境

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

MacBook Pro 10.10.1
Homebrew 0.9.5
ruby 2.0.0p481 (2014-05-08 revision 45883) [universal.x86_64-darwin14]

安装 gollum

这里我使用官方推荐的安装方式:

The best way to install Gollum is with RubyGems:

$ sudo gem install gollum

安装过程遇到了如下问题：Gem::Installer::ExtensionBuildError: ERROR: Failed to build gem native extension.

GemEerror

这个bug困扰了我大半天，最好无奈我只能找来梯子外出询问，最后找到的解决的办法,办法就是在执行gem安装命令之前在命令行执行以下代码：

$ bundle config --local build.charlock_holmes --with-ldflags='-L.-Wl,-O1 -Wl,--as-needed -rdynamic -Wl,-export-dynamic -Wl,--no-undefined -lz -licuuc'

执行完成后，再继续安装gollum,安装成功会如下图所示：

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

$ gollum --v
  gollum 3.1.1

ok,现在我们就可以愉快的开始折腾gollum

创建自己的wiki系统

建立一个名字为”myWiki”的目录使用git进行管理。进入到wiki目录，在wiki目录下启动gollum。

mkdir myWiki
cd myWiki
git init
gollum

这是命令行会显示如下：

[2015-01-23 13:43:12] INFO  WEBrick 1.3.1
[2015-01-23 13:43:12] INFO  ruby 2.0.0 (2014-05-08) [universal.x86_64-darwin14]
== Sinatra/1.4.5 has taken the stage on 4567 for development with backup from WEBrick
[2015-01-23 13:43:12] INFO  WEBrick::HTTPServer#start: pid=95946 port=4567
localhost - - [23/Jan/2015:13:43:14 CST] "GET / HTTP/1.1" 302 0
- -> /

打开你最爱的浏览器，输入localhost:4567，奇迹就出现了！

github的wiki在本地进行编辑

开通Wiki

登陆Github，找到你所开通的Github项目的Settings栏目，开通Wikis，如果只希望别人可读不可写，勾选：Restrict edits to Collaborators only。如下图所示：

Clone Wiki到本地

git clone相应wiki的git地址，请格外注意，地址是在你 Repositories的git地址之前加上wiki：

Repositories地址

git@github.com:nicesu/blog-theme.git

wiki地址

git@github.com:nicesu/blog-theme.wiki.git

使用git clone命令进行clone到本地的blogWiki目录下

$ git clone it@github.com:nicesu/blog-theme.wiki.git blogWiki

执行这个操作我遇到了俩个该死的问题：

Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

fatal: remote error: access denied or repository not exported

第一个问题是因为我的github没有添加本地的SSH keys,解决办法是在本地生成密钥对，然后添加到github的账号中。

第二个问题.....是因为我忘记要先在Repositories中创建一个wiki的页面！

花了一天的时候来挖坑和填坑，希望对大家有点帮助！

用golllum来编辑github的wiki

通过以上的过程，我们已经clone了Repositories的wiki到我们本地，进入它的目录，执行:

$ gollum

然后我们就可以在浏览器里进行操作：

在这里我们可以创建新的wiki,也可以修改我们过去创建好的wiki，而且支持的格式非常多：

编辑完成后，使用git命令进行提交

cd ~/wiki
git add .
git commit -am"嘿嘿，我就想试试可以提交吗“
git push

有了这个，突然间很想写wiki!

原文地址