Ruby jekyll 安装 | 网游世界

因 AdminLTE3 问题需要使用 jekyll，因此在此记录一下安装过程。以便在网站上发布，非 Github。

下载并安装 ruby 及开发套件
地址在：https://rubyinstaller.org/downloads/
推荐：Ruby+Devkit 2.6.6-1 (x64)

安装注意
安装时，选择勾选
MSYS2 development toolchain
在完成安装时，勾选
Run ‘ridk install’ to setup MSYS2 and development toolchain

之后在弹出的窗口中，选择 1，即 MSYS2 base installation

更换国内源
命令行中运行，

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

确保只有 gems.ruby-china.com

安装依赖包 bundler 和 jekyll

gem install bundler
gem install jekyll

进入项目目录，安装项目依赖并运行 jekyll

cd /d f:\AdminLTE3\docs
bundle install
bundle exec jekyll serve -w

-w 参数检查文件变动。

之后，通过 http://localhost:4000/ 来查看效果。

注意：centos 不能以 root 执行 bundle install。
因此你需要添加新用户。

adduser zhang3
passwd zhang3

# 原文件权限为只读，更改权限后才可编辑
chmod 660 /etc/sudoers
vi /etc/sudoers
# 找到
root ALL=(ALL) ALL

# 并在下方添加
zhang3 ALL=(ALL) ALL

# 还原权限
chmod 440 /etc/sudoers

对外发布（非 Github）

在 _config.yml 中增加，站点域名

url: https://3vshej.cn

，之后在项目目录下运行。

bundle exec jekyll build

将 _site 目录复制到外网站点上，即可。

至此完毕。

留意
baseurl 定义。
如：

baseurl: /AdminLTE/AdminLTE-3.x/docs/

报错信息
使用 gem install jekyll 时，报：ERROR: Failed to build gem native extension，这是因为缺少 ruby 开发包，你需要安装它：

在 Windows 上
见本文的“安装注意”。

在 centos 上

yum install ruby-devel

ubuntu 上

sudo apt-get intall ruby-dev

相关文章：