使用Jekyll和Coding Pages搭建静态网站 - 《我爱编程》

安装Gem
安装Jekyll
开始使用Jekyll
Jekyll主题
本地运行

这里介绍的是在Mac OS X El Capitan环境下使用Jekyll的流程。

安装Gem

安装Jekyll需要用到Gem这个Ruby包管理器。Gem官方安装教程点这里。

查看/更新Gem版本：

# 检查gem版本    
gem -v      
# 更新Gem(将提示权限)    
gem update --system

由于Gem source源在国内基本无法访问，这里将源替换为淘宝的镜像：

gem sources --remove http://rubygems.org/
gem sources -a https://ruby.taobao.org/
# 查看当前源
gem sources

安装Jekyll

通过Gem安装Jekyll：

# 安装jekyll(将提示权限)
$ gem install jekyll
# 安装成功之后，查看版本号
$ jekyll -v
# 安装rdiscount，是Jekyll依赖的一个包
$ gem install rdiscount

Mac OS X El Capitan引入了SIP（System Integrity Protection），限制了一些目录的写入权限，使用Gem安装Jekyll的时候会遇到 /user/bin 没有权限写入的问题。解决办法是可以将Jekyll安装到其他目录下：

sudo gem install -n /usr/local/bin jekyll

可能要设置环境变量：

export PATH=/usr/local/bin:$PATH

这样就可以了。

开始使用Jekyll

创建自己的静态网站可以有两种方式：

1.cd到目标目录下，自己新建：

# 在该目录下初始化一个新的静态网站
jekyll new .

2.在现有模板的基础上修改。一般情况下，总是要找一个适合主题，所以直接在这个主题下修改就好了。

Jekyll主题

Jekyll的开源主题很丰富，适合个人博客和企业建站的都有，这也正是弃用Hexo而选择Jekyll的一大原因。主题可自行搜索。使用步骤比较简单：

1.clone该项目，或者直接下载项目
2.解压，进入项目根目录，执行以下命令：

# cd into project directory
cd centrarium
# install Bundler if you don't have it already
gem install bundler
# install jekyll, jekyll-archives, and jekyll-sitemap
bundle install

有些主题的演示项目需要执行上述安装，安装过程中 `bundle install`` 会默认从 http://rubygems.org/ 上找相关组件，这里需要替换成淘宝的源:

bundle config mirror.https://rubygems.org https://ruby.taobao.org

重新执行 `bundle install`` 进行安装即可。

本地运行

在根目录下执行：

# 开启jekyll本地预览
jekyll server

服务器启动成功后，即可通过浏览器输入 http://localhost:4000 访问站点，某些主题可能设置了子路径，比如：http://localhost:4000/centrarium。接下来，就可以修改项目中的文件来更新网站内容了。

## 部署到Coding Pages

在Coding.net新建一个项目，将博客所在项目push到新建的项目中，推荐的做法是创建一个新的coding-pages分支来作为启动Coding Pages之用（其他分支名也可以），然后切换到Pages标签，开启Pages服务，分支名填写为我们需要的分支，这里是coding-pages。

Coding会提供一个类似 `{user_name}.coding.me/{project_name}`` 的链接用于访问，同时在下方可以绑定自己的域名，很快生效，就可以通过域名访问站点了。