搭建基于Gollum的Wiki网站

发表于 更新于 分类于 ， ， ， ， ， 阅读次数： 评论： 本文字数： 1.7k 阅读时长 ≈ 5 分钟

搭建基于Gollum的Wiki网站

Gollum是一个建立在Git之上的简单wiki系统。Gollum Wiki只是一个具有特定性质的git存储库：

  • 支持 Markdown 语法
  • 可以包含其他内容，例如页面的图像，PDF和页眉/页脚。
  • 咕噜页面：
    • 可以写成各种标记。
    • 可以使用您喜欢的系统编辑器或IDE进行编辑（提交后将显示更改）或使用内置的Web界面进行编辑。
    • 可以在所有版本中显示，还原等。
  • Gollum 与 GitHub wiki 基本兼容
  • Gollum 支持的高级功能：

安装说明

我为了安装这个Gollum真的是遇到了很多问题，可以说是刚好卡在了一个特殊的节点吧。

  1. CentOS 8 安装的ruby最高只能安装2.5.9版本，而Gollum最低要求要2.6.0😅。 所以，被迫先迁移到CentOS Stream 8，但好像没用，repo库里还是只有2.5.9版本。
  2. 然后我尝试用RVM版本管理器去安装Ruby，又无法导入GPG密钥。 后来用他们的Web服务器，总算是可以导入了。

安装

安装 RVM

  1. 安装 GPG 密钥，在终端运行以下代码：

    1
    2
    3
    gpg2 --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
    或
    gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

    如果以上两条命令都没有用，提示gpg: keyserver receive failed: Server indicated a failure的话，再使用下面这个不太安全的 Web 服务器导入密钥：

    1
    2
    curl -sSL https://rvm.io/mpapis.asc | gpg --import -
    curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -

  2. 安装 RVM：

    1
    \curl -sSL https://get.rvm.io | bash -s stable

  3. 更新shell环境

    1
    2
    3
    source ~/.bashrc
    source ~/.bash_profile
    source /usr/local/rvm/scripts/rvm

    检查是否安装成功：

    1
    2
    rvm -v
    rvm list known

  4. 安装 ruby 先修改 RVM 的 Ruby 安装源到 Ruby China 的 Ruby 镜像服务器，这样能提高安装速度

    1
    2
    3
    4
    5
    6
    echo "ruby_url=https://cache.ruby-china.com/pub/ruby" > /usr/local/rvm/user/db

    或

    gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
    gem sources -l

    开始安装：

    1
    rvm install ruby-head

安装 Gollum

1
rvm install current && rvm use current

安装 gem 编译依赖项：

1
yum install icu

安装 Gollum：

1
gem install gollum

检查是否安装成功：

1
gollum --v

使用

1
2
3
4
5
cd /www/wwwroot
mkdir gollumWiki
cd gollumWiki
git init
gollum

访问http://localhost:4567即可看到一个创建新Home页面的界面

后记

折腾到现在，我对Gollum已经有些不耐烦了，太过于麻烦，太过于复杂，其实后面我还弄了一下unicorn，为了给Gollum配置一个更好的web服务，但没成功。回过头来看，弯路太多，与初衷渐行渐远，遂放弃。还是转投MediaWiki吧，虽然要学一个新的语法。