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

Question

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

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

标签： githubdeploymentgithub-pages

Answer 1

GitHub Pages 可以从任何这些来源发布：gh-pages 分支、master/docs，或者只是从 repo 本身。您使用哪条路线更像是一种偏好。

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

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

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

希望有帮助！