GitHub页面从master vs master / docs或gh-pages分支发布

问题描述 投票:0回答:1

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

为什么我可以从master分支发布?是否有任何理由要从gh-pages分支或master / docs发布而不是发布项目资源库?

github deployment github-pages
1个回答
0
投票

GitHub Pages可以从以下任何来源发布:gh-pages分支,master / docs,或仅从仓库本身发布。您更倾向于使用哪种路线。

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

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

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

希望有帮助!

© www.soinside.com 2019 - 2024. All rights reserved.