OS X 下使用 Jekyll 和 Coding Pages 搭建静态博客

Jekyll 是一个免费的简单静态网页生成工具，能够配合第三方服务例如 Disqus 实现一些扩展功能，不须要数据库支持。而且 Jekyll 能够部署在Github 或 Coding 上，能够绑定本身的域名，并且目前这是彻底免费的。

---

1，Git 安装

搭建博客须要用到 git，git --version 命令可查看本机是否已安装 git，若未安装可参考这篇博文进行安装。

2，安装 Homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
复制代码

3，Ruby 安装/升级

brew install ruby
复制代码

4，Gem 安装/设置

安装 Jekyll 须要用到包管理器 gem，gem -v 命令可查看本机是否已安装 gem，若未安装请自行安装。

因为众所周知的缘由，国内访问官方默认 gem sources 源速度不是十分理想，因此建议切换成国内的，利用 gem sources -l 命令可查看当前 gem sources 源：

gem sources --remove http://rubygems.org/
复制代码

而后利用如下命令将其替换为淘宝的（注意：这里的 http://rubygems.org/ 替换成当前 gem sources 源地址）：

gem sources -a https://ruby.taobao.org/
复制代码

5，安装 Jekyll 到本地

由于打算在 Coding Pages 上搭建，根据 Coding 帮助文档，Coding Pages 目前支持 jekyll 3.0，因此咱们须要指定版本安装 Jekyll，终端执行如下命令：

sudo gem install jekyll -v '3.0'
复制代码

输入密码后等待安装完成，执行如下命令尝试查看 Jekyll 版本号：

jekyll -v
复制代码

若能正确显示版本号 jekyll 3.0 表示安装成功。

6，本地创建博客

从零开始手动编写的话能够参考：这篇博文，同时网上有大量开发者们分享的模板可供选择使用：

Jekyll Themes

Github Jekyll Sites

本博客的搭建我选择了在该模板的基础上进行修改，在这里对原做者表示感谢，🙏

在终端中切换到合适的目录下执行如下命令：

git clone https://github.com/sl4m/skim.cc.git
复制代码

将模板 git 仓库下载到本地。

7，本地效果预览

终端中用 cd 命令切换到本地博客所在目录，即 skim.cc 目录下，执行 jekyll server 命令启动本地服务器，若启动成功可在浏览器中访问 http://0.0.0.0:4000/ 进行预览。

8，上传到 Coding Pages

在 Coding 新建一个项目，将博客所在项目 push 到新建的项目中，推荐的作法是建立一个新的 coding-pages 分支来做为启动 Coding Pages 之用（其余分支名也能够），而后切换到 Pages 标签，开启 pages 服务，分支名填写为咱们须要的分支，这里是 coding-pages。

9，服务器效果预览

这时 Coding 会提供一个相似 {user_name}.coding.me/{project_name} 的连接用于访问，例如项目名为 blog.eyrefree，则对应的访问地址是：

eyrefree.coding.me/blog.eyrefr…

10，绑定域名

默认提供的连接可能过长或者不便于平常使用，咱们也能够绑定本身的域名。

首先，须要提早准备一个域名，而后打开本身的域名控制面板，新建一个 CNAME 解析到 {user_name}.coding.me，例如个人是将 blog.eyrefree.org 解析到 eyrefree.coding.me；

而后，打开 Coding 项目页面切换到 pages 项，填入刚才的设置解析的域名 blog.eyrefree.org，点击“添加域名绑定”按钮便可，在浏览器中直接访问 blog.eyrefree.org 就能成功打开。

有时可能因为缓存或者解析时间的问题，稍等片刻便可。

11，编写博文

接下来就是平常的博文编写啦，这里是使用 markdown 格式的，编写完成后添加到 _posts 目录下 push 到 Coding 服务器便可，具体可参考这篇博文。

12，备注

嘛，大概就是这些内容了，有遗漏的话后期会继续补充，😝，个人博客在原模版基础上将 Google 统计，Disqus 评论，feedburner 等替换为了本身的，其余的一些修改详情参见个人 GitHub 仓库的 Jekyll 分支：

github.com/EyreFree/ey…

---

若有任何知识产权、版权问题或理论错误，还请指正。 https://juejin.im/post/5a320fb651882534af25f83a 转载请注明原做者及以上信息。