Github Pages 是面向用户、组织和项目开放的公共静态页面搭建托管服 务，站点可以被免费托管在 Github 上，你可以选择使用 Github Pages 默 认提供的域名 github.io 或者自定义域名来发布站点。Github Pages 支持 自动利用 Jekyll 生成站点，也同样支持纯 HTML 文档，将你的 Jekyll 站 点托管在 Github Pages 上是一个不错的选择。
Github Pages 依靠 Github 上项目的某些特定分支来工作。Github Pages 分为两种基本类型：用户/组织的站点和项目的站点。搭建这两种类型站 点的方法除了一小些细节之外基本一致。
用户和组织的站点被放置在一个特殊的专用仓库中，在该仓库中只存在 Github Pages 的相关文件。这个仓库应该根据用户/组织的名称来命名， 例如： @mojombo 的用户站点仓库 应该被命名为 mojombo.github.io 。
仓库中 master分支里的文件将会被用来生成 Github Pages 站点，所以请 确保你的文件储存在该分支上。
自定义域名不影响仓库命名
Github Pages 初始被设置部署在
username.github.io子域名上, 这就是为什么 即使你使用自定义域名仓库还需要这样命名。
不同于用户和组织的站点，项目的站点文件存放在项目本身仓库的 gh-pages 分支中。该分支下的文件将会被 Jekyll 处理，生成的站点会被 部署到你的用户站点的子目录上，例如 username.github.io/project （除非指定了一个自定义的域名）。
Jekyll 项目本身就是一个很好的例子，Jekyll 项目的代码存放在 master 分支， 而 Jekyll 的项目站点（就是你现在看见的网页）包含在同一仓库的 gh-pages 分支中。
你最好在将 Jekyll 站点提交到 gh-pages之前先预览一下。因为 Github 上项目站点的子目录结构会使站点的网址结构变得复杂。这里有一些处 理 Github Pages 子目录结构（username.github.io/project-name/）的方法 使你本地浏览的站点和部署在 Github Pages 上的站点一致，方便你的维护。
_config.yml 中，设置 baseurl 选项为 /project-name – 注意必须存在头部的斜杠以及不能有尾部的斜杠。{{ site.baseurl}}/path/to/css.css – 注意斜杠之后必须紧随变量（在 “Path” 之后）。{{ site.baseurl }}{{ post.url }} – 注意两个变量之间不存在斜杠。jekyll serve --baseurl ''命令，请确定在 --baseurl 的选项之后存在空串，这样的话你就可以在 localhost:4000 看到你的站点（站点根地址不存在 /project-name）。
用这种方法你就可以在本地从根地址预览站点，而在 Github 上以 gh-pages 分支生成站点的时候能以 /project-name 为根地址并且正确地显示。GitHub Pages 的文档，帮助和支持
想获得关于 Github Pages 的更多信息和解决方案，你应该访问 GitHub’s Pages 帮助部分。 如果无法找到解决方案，你可以联系 GitHub 支持。