目标

在本地搭建一个 Jekyll 环境供测试，远程搭一个环境供部署，简化发布流程，直接使用 Git 推送即可发布文章。

以下内容中给出的链接都是 Jekyll 官方网站 Jekyll • Simple, blog-aware, static sites，如果需要中文，可自行前往简体中文网站：Jekyll • 简单的静态博客网站 查找对应内容。

搭建

本地

环境

环境为 Mac OS X Yosemite 10.10.3

Jekyll

安装 RVM

使用 RVM 管理 Ruby。RVM 实用指南 - Wiki » Ruby China

$ curl -L get.rvm.io | bash -s stable
$ source ~/.bashrc
$ source ~/.bash_profile
安装 Ruby
$ rvm install 2.2
$ rvm use 2.2
$ rvm use 2.2 --default
设定 Gems 镜像

强烈建议设定镜像，否则可能会无法下载 Jekyll。RubyGems 镜像 - 淘宝网

$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
安装 Jekyll

官方网站：Jekyll • Simple, blog-aware, static sites，简体中文网站：Jekyll • 简单的静态博客网站

$ gem install jekyll

开始

建立网站
$ jekyll new my-awesome-site
$ cd my-awesome-site
$ jekyll serve
版本管理
$ cd my-awesome-site
$ git init
$ git add --all
$ git commit -m 'Initial commit'

到这一步，本地 Jekyll 搭建完毕，所有需要做的修改都建议在本地测试，再推送到远端。 建议一开始就将所有需要的文件纳入版本管理，方便以后的修改。

服务器

环境

环境为 Linode Ubuntu 14.04 LTS

Jekyll

安装 RVM
$ gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
$ curl -sSL https://get.rvm.io | bash -s stable
$ usermod -G rvm root
$ source /etc/profile.d/rvm.sh
$ exit
$ ssh root@ubuntu
安装 Ruby
$ rvm install 2.2
$ rvm use 2.2
$ rvm use 2.2 --default
安装 Node.js
$ apt-get install nodejs
安装 Jekyll

官方网站：Jekyll • Simple, blog-aware, static sites，简体中文网站：Jekyll • 简单的静态博客网站

$ gem install jekyll

部署

Git 配置

参考此链接在服务器上建立 Git 仓库：Git - 配置服务器

在建立 Git 仓库时不要禁用 git 用户的 shell 权限，否则推送后无法执行 jekyll build 来构建网站。 建立 Git 仓库后执行下面的命令：

$ usermod -G rvm git
自动部署

参考 Jekyll 官网链接 Deployment methods 中 Git post-receive hook 一节设置

使用

评论系统

参考 Jekyll Installation Instructions | DISQUS 与 dcreager.net – Adding Disqus comments 将 Disqus 代码加入到模板文件中。

Google Analytics

将统计代码加入到模板文件中的 body 标签内。

格式

强烈建议使用 Markdown 作为内容语言，方便编写也修改。

Markdown 格式参考：Markdown 语法说明(简体中文版)。

Markdown 编辑器：StackEdit

资源

建议将资源放在单独的目录中如 assets 目录，并在其中建立文章链接名字对应的目录，将资源放在其中，在文章内使用相对链接引用即可。

参考资料