目标

在本地搭建一个 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

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

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

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

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

1
$ gem install jekyll

开始

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

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

服务器

环境

环境为 Linode Ubuntu 14.04 LTS

Jekyll

安装 RVM
1
2
3
4
5
6
$ 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
1
2
3
$ rvm install 2.2
$ rvm use 2.2
$ rvm use 2.2 --default
安装 Node.js
1
$ apt-get install nodejs
安装 Jekyll

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

1
$ gem install jekyll

部署

Git 配置

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

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

1
$ usermod -G rvm git
自动部署

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

使用

评论系统

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

Google Analytics

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

格式

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

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

Markdown 编辑器:StackEdit

资源

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

参考资料