我和我的团队发现用 wiki 记录我们的项目(一个带有 API 的开发平台)对我们和用户都很有用。由于一些组织问题,我们被迫在没有网络连接的情况下进行多站点开发。我们已经切换到 DVCS (Mercurial) 并且在这方面取得了巨大的成功。wiki 文档被证明是一个问题,因为中央站点是使用 MediaWiki 设置的。异地人员无法访问或编辑 wiki。
是否有任何不需要服务器/数据库并且可以在 DVCS 环境中使用的 wiki 风格的包?
更新:应该是开源和跨平台的
我和我的团队发现用 wiki 记录我们的项目(一个带有 API 的开发平台)对我们和用户都很有用。由于一些组织问题,我们被迫在没有网络连接的情况下进行多站点开发。我们已经切换到 DVCS (Mercurial) 并且在这方面取得了巨大的成功。wiki 文档被证明是一个问题,因为中央站点是使用 MediaWiki 设置的。异地人员无法访问或编辑 wiki。
是否有任何不需要服务器/数据库并且可以在 DVCS 环境中使用的 wiki 风格的包?
更新:应该是开源和跨平台的
我可以推荐TiddlyWiki。它不需要任何网络服务器,只需要一个浏览器,将整个 Wiki 文档存储在一个 HTML 页面中。这可以通过 Mercurial 轻松共享。
编辑: 检查此页面,它讨论了如何将 TiddlyWiki 与 DVCS 一起使用。它涉及使用名为 SynchroTiddly 的扩展。
DokuWiki将所有数据存储在纯文本文件中。您可以为每个开发人员安装本地 Web 服务器,并使用您的 VC 系统在开发人员之间进行同步。
ikiwiki:http ://ikiwiki.info/将信息直接存储在 VCS 中(它支持 mercurial 作为后端)。
http://zim-wiki.org/
这是一个桌面 wiki(所见即所得的编辑,虽然不是很复杂的格式),它将所有内容存储在纯文本文件中。这意味着您可以将文件保存在版本控制中,并拥有友好的编辑体验。
它甚至内置了 Bazaar 支持更新:还有 Git、Mercurial 和 Fossil。
[我知道,聚会迟到了-为阅读此问题的其他人而写作...]
也许您应该查看从源代码自动生成文档。这样,文档将自动受到版本控制。
许多生成器支持通过可以添加到存储库的纯文本文件添加其他文档。
看看Fossil,它是一个 DVCS,包含一个内置的 wiki 和错误跟踪系统。这可能正是您想要的。阅读网站,有一个内置的网络服务器。您可以使用 CGI 脚本打开与人的连接(化石网站是化石 DVCS)。在使用它之后,您可能会决定将您的代码也移到它上面。它是开源的,并且确实具有跨平台构建。
最终使用 python、cherrpy 和 mercurial 编写了我自己的系统。也许有一天它会开源。感谢所有的建议。
http://hatta-wiki.org/是在 Mercurial 存储库上运行的 wiki。
有趣的是它如何处理冲突:同时编辑在提交时被静默合并,即使与冲突标记发生冲突和提交!没关系,因为:
这种安排会促使您再次编辑以立即解决冲突 - 但不会强迫您这样做。
MoinMoin 支持将您的页面存储在 Mercurial 存储库中:http: //moinmo.in/Storage2009/HelpOnStorageConfiguration#Mercurial_Backend_.28hg.29
这很有趣,因为 MoinMoin 已经存在了一段时间,得到了很好的支持,并且具有丰富的功能集(但这只是我的观点;不要相信我的话,自己看看 ;-))。