GitHub Pages

Github Pages 是面向用户、组织和项目开放的公共静态页面搭建托管服 务，站点可以被免费托管在 Github 上，你可以选择使用 Github Pages 默 认提供的域名 github.io 或者自定义域名来发布站点。Github Pages 支持 自动利用 Jekyll 生成站点，也同样支持纯 HTML 文档，将你的 Jekyll 站 点托管在 Github Pages 上是一个不错的选择。

还没用过 Github Pages 制作网站?通过 Jonathan McGlone 写的这篇奇妙的指南来创建和运行 Github Pages 这篇指南将告诉你关于 Git, GitHub 和 Jekyll 的相关知识，来建立一个属于你自己的站点。

项目站点的网址结构

你最好在将 Jekyll 站点提交到 gh-pages 之前先预览一下。因为 Github 上项目站点的子目录结构会使站点的网址结构变得复杂。为了正确构建站点，你的链接应该是这样的形式：site.github.url。

``` html
{% raw %}
<!-- 用于静态名称的样式表... -->
<link href="{{ site.github.url }}/path/to/css.css" rel="stylesheet">
<!-- 用于动态URL的文档、页面... -->
<a href="{{ page.url | prepend: site.github.url }}">{{ page.title }}</a>
{% endraw %}

用这种方法你就可以在本地从根地址预览站点，而在 Github 上以 
`gh-pages` 分支生成站点的时候能以 `/project-name` 为根地址并且正确地
显示。
## 将 Jekyll 部署到 Github Pages 上
Github Pages 依靠 Github 上项目的某些特定分支来工作。Github Pages
分为两种基本类型：用户/组织的站点和项目的站点。搭建这两种类型站
点的方法除了一些小细节之外基本一致。
<div class="note protip">
  <h5>使用 <code>github-pages</code> gem包</h5>
  <p>
    我们在Github的朋友提供了
    <a href="https://github.com/github/pages-gem">github-pages</a>
    gem包来管理Jekyll和其在Github Pages上的依赖。使用这个包可以让你在将网站部署到Github Pages上时，
    不会因为各种不同版本的gem包而导致意外报错。想要在你的项目中使用当前部署版本的gem包，
    在你的 <code>Gemfile</code> 中添加如下内容：  
``` ruby
{% raw %}
source 'https://rubygems.org'
require 'json'
require 'open-uri'
versions = JSON.parse(open('https://pages.github.com/versions.json').read)
gem 'github-pages', versions['github-pages']
{% endraw %}

这回保证你再运行 <code>bundle install</code> 命令时，
你能够安装正确版本的 <code>github-pages</code> gem包。
如果执行失败，将上述内容简化为：

{% raw %}
source 'https://rubygems.org'
gem 'github-pages'
{% endraw %}

不过你要经常执行 <code>bundle update</code> 命令哦~~
如果你想要在 Windows 上安装 <code>pages-gem</code> ，你可以参考 Jens Willmer 的这篇博文 <a href="http://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46#github-pages-and-plugins">how to install github-pages gem on Windows (x64)</a>。

项目的站点

不同于用户和组织的站点，项目的站点文件存放在项目本身仓库的 gh-pages 分支中。该分支下的文件将会被 Jekyll 处理，生成的站点会被 部署到你的用户站点的子目录上，例如 username.github.io/project （除 非指定了一个自定义的域名）。

Jekyll 项目本身就是一个很好的例子，Jekyll 项目的代码存放在 master 分支 ， 而 Jekyll 的项目站点（就是你现在看见的网页）包含在同一仓库的 gh-pages 分支 中。