mac下利用gollum工具为自己github上的项目搭建本地wiki

参考文章：

gollum:给wiki插上git的翅膀 gollum 是github的使用的一个基于markdown的 wiki系统的构造工具，简单实用。gollum直接和git集成不需要数据库，你可以选择在Web页面撰写文档，也... 简书 - www.jianshu.com

基于Git的维基管理：gollum

请先在自己的mac中安装gollum，步骤如下

1.brew install icu4c

2.gem install charlock_holmes -- --with-icu-dir=/usr/local/opt/icu4c

3.gem install gollum

国内网段在安装过程中会出现如下的错误：

ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)

其原因是ruby 的gem被和谐了，现在淘宝的ruby工程师架设了rubygems的国内镜像。使用方法如下：（可以参考原文：http://www.haorooms.com/post/gem_not_use）

gem sources --remove https://rubygems.org/


gem sources -a https://ruby.taobao.org/


gem sources -l


*** CURRENT SOURCES ***

https://ruby.taobao.org

然后在运行gem命令就可以了！

然后选择自己在github上的某个项目，比如我这里选择的项目地址为:git@github.com:felayman/felay-demos.git

点击项目下的Wiki按钮,找到该项目对应的wiki的git地址,我的wiki地址为：https://github.com/felayman/felay-demos.wiki.git

然后 cd felay-demos.wiki/

执行gollum,该命令会在后台启动一个web程序,端口号为4567，然后打开浏览器,输入localhost:4567，即可看到自己在github上的某个项目的wiki了。

这个时候看到自己的github上的wiki为下图所示：




打开localhost:4567，本地的wiki为：




接下里就是在本地通过git来管理github上的wiki了。

此时我们可以看到自己的wiki项目在本地的目录文件，如下

其中只有一个Home.md文件，我们执行如下操作

vim Hello.md,内容为Hello,my wiki。

git add Hello.md

git commit -am 'commit Hello.md'

git push

然后重新执行gollum命令，就可以看到本地的wiki文件会同步到github上去了，如下图：

然后我们再在本地通过一个支持markdown的工具,比如我喜欢用atom 跟 brakets ,用来管理自己在github上的wiki，就非常方便了。