Github pages：为什么我需要一个 gh-pages答案

【问题标题】：Github pages: Why do I need a gh-pagesGithub pages：为什么我需要一个 gh-pages
【发布时间】：2016-03-14 03:00:43
【问题描述】：

我已经使用 Github pages 部署了一个个人博客，我看到一些教程告诉你创建一个 gh-pages 分支。我这样做了，但是，我对网站的更改只有在我对我的主人进行更改时才可见。所以，我对为什么需要 gh-pages 感到困惑？有人可以解释一下吗。谢谢

【问题讨论】：

【解决方案1】：

【讨论】：

还有什么理由继续使用gh-pages，还是现在建议只使用master 分支？将您的网站代码单独保存被认为是更好的代码组织，还是根本没有必要？
假设我创建了一个新的 repo 并在其中创建了一个 /docs 文件夹。我在 docs 文件夹上上传了一个静态站点，并将源指向它。在这种场景下，那master有什么用呢？
@TotZam：我还没有看到将文档保存在单独分支中的充分理由。相反，GitHub only searches in the default branch，所以你让贡献者为你的文档贡献 PR 变得更加困难。

【解决方案2】：

您在 master 分支上为每个 github 个人或组织托管一个网站。这用于个人网站或组织网站。

这样的个人或组织网站托管在 username.github.io 上，位于 master 分支的专用 repo 中。

例如，我的个人博客位于takacsmark.github.io，它托管在名为https://github.com/takacsmark/takacsmark.github.io 的存储库中，代码位于存储库的主分支中，takacsmark.com 通过 CNAME 文件中的 CNAME 文件指向该站点回购。

如果你想为github上的项目创建一个专用站点，你可以创建一个项目级别的github页面。这意味着它不是一个单独的repo，就像上面的个人网站示例. 相反，它应该位于项目 repo 的 gh-pages 分支下。

查看 bootstrap repo 以获取项目 gh-pages 示例。

【讨论】：

GitHub Pages 确实应该在 their docs 中对此进行区分。当一个人考虑建立一个 GitHub Pages 存储库以将一个项目与整个个人网站作为项目进行比较时，gh-pages 分支是有意义的。

【解决方案3】：

GitHub 上可以有两种类型的页面。第一种类型在master 分支中有文件，并且repo 必须以与<username|organization>.github.{io|com} 相同的方式命名。这种类型的存储库只能有一个。

页面的url是：http://<username|organization>.github.io或.com

第二种页面对仓库名称没有任何限制，但页面需要在gh-pages分支。

页面的url是：http://<username|organization>.github.io/<repo_name>或.com

更多详情here.

【讨论】：

是的，但是 gh-pages 是做什么用的？
我认为，从答案中可以看出。如果您在第一类页面 (http://<username|organization>.github.io) 上托管您的博客，那么创建 gh-pages 和所有 jekyll 代码或纯 html 进入 master 是没有意义的。如果您正在做第二种类型的页面，则反之亦然。
所以，如果我想获得一个域名（即 mydomain.com），我不能在 master 分支上使用它，因为 remo 需要是 username.github.io ？出于这个原因，我需要一个 gh-pages 吗？我理解正确吗？
不，我所描述的是默认行为。 GitHub 使您的内容可用的默认 URL。您可以通过提供 CNAME 文件来更改它并正确设置 DNS help.github.com/articles/quick-start-setting-up-a-custom-domain