由主存储库管理的GitHub wiki

我希望在开发代码的同时为我的项目管理GitHub wiki。例如：

分支机构

• 主机（稳定版本）
  • 开发（下一版本的开发）
  • 其他。。。（可能的其他开发/功能分支）

理想情况下，我希望wiki包含在项目的子文件夹（例如/wiki）中。然后，当我对代码进行更改时，我也可以同时更新wiki（代码+文档更改）。这也意味着我的所有开发代码和文档都将在“开发”分支中自包含，直到我与“主”分支合并。希望，即使是通过手动过程，GitHub wiki也会在与master合并后更新，以反映更改

---

我已经了解了Git的子模块特性，但据我所知，它通常只指向一个版本。我希望以某种方式遵循我的代码开发，这样分支和合并就可以正常工作。

如“”中所述，您可以在子模块中进行修改和更新，只要您同时提交父repo，以便记录“

wiki

”的新状态sub repo.

如果您打算在本地机器上使用Gollum来显示和处理GitHub wiki（您可能应该这样做），那么如果使用子模块，您将遇到麻烦

Gollum希望对本地Git存储库进行本地提交（但不是推送），但是在子模块中。Git实际上是包含本地存储库的文件，而不是真正的Git存储库。这会导致咕噜断裂

子模块还存在版本未耦合到父存储库以及未完全解耦的问题。每次更改文档时，源代码存储库都希望推送新的wiki版本号（而不是wiki内容），这是一种麻烦

我使用的解决方案只是将wiki存储库克隆到主项目目录中的一个目录中，并将其添加到.gitignore。通过在项目之间为目录使用一致的名称（例如github wiki），可以最大限度地减少wiki不在.gitignore中并意外上载到主存储库的可能性

---

为了保持一致性，他的方法也适用于GitHub页面，尽管这是不必要的，因为他们没有遇到Gollum的问题。

谢谢，这比我找到的其他信息更好地解释了这一点。它是如何处理分支/合并的？我可以在我的存储库“开发”分支中拥有wiki的“开发”分支，然后轻松处理合并以掌握吗？@MisterDai每个repo（父repo和子模块repo）都有自己的分支集，独立于一个repo到另一个repo。您可以随时更改子模块中的分支，前提是您花时间返回父repo并提交，以便记录子模块的新状态。它是否工作过？我有一个与比特桶。我担心，所有使用维基subrepo的解决方案最终都会失败。应该修复的是，GitHub/BitBucket Wiki是指向主repo上的特定提交的指针，而不是单独的repo。从来没有这样做过，而是转移到其他地方，因为这样就不需要进一步调查了。在构建我的项目时，我曾使用脚本将我的wiki更改部署到github，这非常有效，意味着我不必担心分支和子模块等问题。。。