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: /_site

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

bundle exec jekyll build

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

至此完毕。

留意
从 AdminLTE 3.0.3 起,_config.yml 中不需要 url 项,通过 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

相关链接:

搭建博客jekyll(blog)

Jekyll搭建写作环境问题集锦

windows系统下安装jekyll报错:Error installing jekyll

下载 Jekyll,并使用它在本地搭建一个博客

jekyll 出现…(Bundler::GemNotFound)问题解决方法

解决部署在vps上的jekyll静态博客中的url被替换为http://localhost:4000

jekyll博客搭建之艰辛之路

Jekyll模板介绍