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/ 来查看效果。

对外发布(非 Github)

在 _config.yml 中增加

url: /_site

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

bundle exec jekyll build

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

至此完毕。

留意
从 AdminLTE 3.0.3 起,_config.yml 中不需要 url 项,通过 baseurl 定义。
如:

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

相关链接:

搭建博客jekyll(blog)

Jekyll搭建写作环境问题集锦

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

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

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

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

jekyll博客搭建之艰辛之路

Jekyll模板介绍