commit - 克隆和提交 BitBucket 项目的“Wiki”存储库的最佳实践

Question

在 BitBucket 中，您可以为项目创建 Wiki。但是，Wiki 本身是一个与源代码库分开的代码库。当您克隆它时，它会创建一个名为“wiki”的存储库。

克隆这个 repo 的理想或常规位置在哪里？你把它放在源代码库中吗？如果是这样，您在从源代码库提交时是否 .gitignore /wiki？或者您是否在源代码库中包含 wiki 代码库？

推送时，您是否提交两次，一次是在源代码库中，一次是在 wiki 代码库中？或者您可以修改源的 git 以同时提交源和 wiki 吗？

谢谢你。

Answer 1

理想的方法是使用 Git 的子模块功能：

$ cd project
$ git submodule add https://bitbucket.org/user/project.git/wiki

这将创建一个文件夹wiki和.gitmodules文件，然后：

$ cd wiki
$ nano Home.md

更改文件中的一些信息，并且：

$ git add .
$ git commit -m "Some comment"
$ git push origin master

返回项目：

$ cd ..
$ git add .
$ git commit -m "Added wiki module"
$ git push [remoteName] [remoteBranch]

有了这个，项目 repo 将生成一个链接，一个特定的 wiki repo 提交，您可以只更新其中一个。

我希望这是有帮助的。

更多信息：https ://git-scm.com/book/en/v2/Git-Tools-Submodules

Answer 2

我为存储库维护以下结构。

这个想法是维护代码仓库和它的相关维基作为兄弟姐妹。这样就不需要告诉 .gitignore 忽略任何 wiki 相关文件。此外，您只需推送到您正在进行更改的存储库。希望，这就是你要找的。