如何在一个分支中构建文档并自动将build / html复制到gh-pages分支中

时间:2011-10-13 17:08:40

标签: git github python-sphinx

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的合并策略。

子树合并和这些技术似乎是用于合并外部存储库,而不是同一个存储库中的东西。

2 个答案:

答案 0 :(得分:0)

你可以创建一个空的分支,你只能提交你的html。 只需按照here中“项目页面”的github页面说明进行操作。

答案 1 :(得分:0)

我发现these steps对于发布到gh-pages这样的其他分支非常有用。您还可以在Google上搜索其他一些脚本,但该脚本的文字看起来更加清晰。

通常,这些步骤是: -将您当前的outdir添加到.gitignore -将整个仓库克隆到outdir以在其中启动.git,清理它并建立一个gh-pages分支 -制作从outdir推送的版本。

您可以遵循在mastergh-pages here中使用两个单独文件夹的代码,注释为俄语,但命令不言自明。