Github将项目网站存储在项目存储库的单独分支(gh-pages)中。 我们掌握了一个sphinx包来构建我们的文档,并希望自动将生成的文档提交到gh-pages分支。
Sphinx配置和源代码不能在gh-pages分支本身,因为该分支只包含html。如果master没有'自己的html版本,这将是看到的(使用.git忽略,如此处所示{{3 }})。如果它是版本会发生什么。
我想键入make publish并让它构建文档(我们已经将它作为make目标),然后将这些更改应用到gh-pages分支(实际上强制执行)。
问题是gh-pages实际上是doc / build / html的内容,所以标准合并似乎不起作用。
存储更改,更改分支以及在冲突中应用结果,似乎无法指定-ours的合并策略。
子树合并和这些技术似乎是用于合并外部存储库,而不是同一个存储库中的东西。
答案 0 :(得分:0)
你可以创建一个空的分支,你只能提交你的html。 只需按照here中“项目页面”的github页面说明进行操作。
答案 1 :(得分:0)
我发现these steps对于发布到gh-pages
这样的其他分支非常有用。您还可以在Google上搜索其他一些脚本,但该脚本的文字看起来更加清晰。
通常,这些步骤是:
-将您当前的outdir
添加到.gitignore
-将整个仓库克隆到outdir
以在其中启动.git,清理它并建立一个gh-pages
分支
-制作从outdir推送的版本。
您可以遵循在master
和gh-pages
here中使用两个单独文件夹的代码,注释为俄语,但命令不言自明。