使用 Jekyll 构建个人博客

I. 配置环境

首先，安装一个新的 ruby 版本，macOS 系统自带的默认没有写权限，不建议修改。

用 homebrew 安装这两个：

brew install chruby ruby-install

安装 ruby

ruby-install ruby

添加到 PATH

安装两个 gem

gem install jekyll bundler

II. 创建博客项目

经验跳过这一节，先找个中意的主题，然后将主题项目本身作为项目目录，因为大多数 Jekyll 主题都包含了整个项目目录，并且基本配置好了，当然也不排除有主题需要你自己手动配置，如果这样，那这节还有用。

找个工作目录，创建一个博客目录，然后打开目录：

jekyll new myblog
cd myblog

启动调试

bundle exec jekyll serve --livereload

如果运行失败，给 bundler 添加依赖 webrick：

bundle add webrick

调试运行在 localhost:4000

III. 从主题开始博客项目

安装主题

fork 主题

改名为博客名字 nuosferatu.github.io

Clone 主题的 repository

git clone git@github.com:nuosferatu/nuosferatu.github.io.git

打开到根目录，运行

bash tools/init.sh

运行 bundle 安装依赖

bundle

调试运行

bundle exec jekyll serve --livereload

IV. 常见问题：

‘a’ tag is missing a reference

'a' tag is missing a reference

这是 _config.yml 里面的 social 下面的 links 为空导致的，这里必须至少有一个才行，因为第一个 link 要作为页脚 copyright 那里的链接，主题要求这个是必填的，否则你就会得到

<a href="">Your Name</a>

GitHub Pages 构建时候就会报上面那个错误。

构建找不到图片等素材路径

_config.yml 中 baseurl 是你的资源文件的相对根路径，默认为空，就是你项目的根目录，这个不要改

push 代码到 GitHub

项目文件初始化之后，commit 之后，第一次 push 到 GitHub 的时候，可能有文件冲突，强制 push 以当前项目文件为准即可：

git push -u origin master -f

更换网站 favicon

尝试换网站 favicon 失败，以后再想想办法吧。