在同一 git 目录结构中管理代码和文档

我将一个项目从 Google Code 转移到了 Github。该项目在一个目录结构中包含代码和文档。

我想使用Github的“Pages”功能来托管html文档。理想情况下，我想做 1push提交对代码和文档的更改。

我怎样才能实现这个目标？

到那个时刻GitHub 页面 http://pages.github.com/，您有用户页面和项目页面。
我假设你说的是后者，这意味着你需要创建自己的gh-pages分支，从您的master在此新的空分支中创建分支，如 GitHub 文档页面中所述。

从那里开始，当您在您的master and gh-pages分支，您可以一次推送两个分支（git push --all)

当您绝对想同时查看两个目录结构时，问题就开始了。
最简单的解决方案是：

• 您的存储库集的一个克隆master branch.
• gh-pages 分支上的一个克隆（同一存储库）。
• 从第一个存储库到第二个存储库的符号链接（它允许您在同一目录结构中对代码和文档进行修改。从 Vista 开始，Windows 甚至支持符号链接）。
• 一个 git 别名脚本，以便自动执行命令序列'git push master origin; cd ../secondRepo; git push gh-pages origin'

您可以尝试将文档存储库作为主存储库的子模块，但是......这似乎比它应该的更复杂：请参阅“如何添加 git repo 作为其自身的子模块？ （或者：如何以编程方式生成 GitHub Pages？） https://stackoverflow.com/questions/5296236/how-to-add-a-git-repo-as-a-submodule-of-itself-or-how-to-generate-github-page".

2016 年 8 月更新：更简单的 GitHub Pages 发布 https://github.com/blog/2228-simpler-github-pages-publishing现在允许将页面文件保存在same分支（没有了gh-pages需要）：

您终于可以在一个分支中更新代码和页面。