从 master 与 master/docs 或 gh-pages 分支发布的 GitHub Pages

Question

我已经能够从 master 分支在 GitHub Pages 上的我的域下发布 GitHub 站点，没有问题，但是在文档中它说使用 gh-pages 分支或 master/docs 来发布项目。我的主页 index.html 文件/资产还有一个存储库，其中链接到每个已发布的 GitHub 存储库（已发布到我的域名.com/repo-name）。

为什么我能够从 master 分支发布？是否有任何理由从 gh-pages 分支或 master/docs 发布而不是发布项目存储库？

Answer 1

GitHub Pages 可以从任何这些来源发布：gh-pages 分支、master/docs，或仅从存储库本身发布。这更多的是您使用哪条路线的偏好。

例如，Jekyll使用 master/docs 选项进行发布。docs 文件夹之外的存储库的其余部分用于实际的 Jekyll 代码。一个可能的原因是具有新功能的 PR 还必须包含该新功能的文档。否则不会合并。

gh-pages 选项意味着可以以不同的方式调整或管理代码和文档。它们生活在同一个仓库中，但分支可以以不同的速度生长。

就技术差异而言，据我所知，每个选项都没有技术成本/收益。这正是您想要组织代码和文档的方式。

希望有帮助！