3

我正在为一个涉及多个开发人员的项目编写文档。我们使用 Subversion (SVN) 来处理我们的代码库。

我使用HelpNDoc编写了文档文档的初稿,我喜欢它的漂亮树形视图和易于使用;问题是只有一个文件,所以我不知道如何使用 SVN 来允许其他开发人员对文档做出贡献并对其进行更新。

你知道这是否可能吗?如果没有,您能否推荐一款易于使用、具有可与 SVN 一起使用的文档树视图或允许多个用户更新它的好软件?我们使用 Windows。

4

3 回答 3

3

HelpNDoc 项目是基于SQLite开源数据库引擎的二进制文件。优点是整个文档存储在一个文件中,因此可以轻松复制、移动、共享、备份......但是一个缺点是它必须在任何版本控制系统中作为二进制内容签入,包括Subversion: diff 和 merge 在这些文件上是不可能的。

一种可能的解决方案是使用 HelpNDoc 库中的外部文档:每个用户处理自己的文档(可以是 Word 文档和 HTML 网页...),并创建一个主 HelpNDoc 项目以在生成时包含这些文档时间。请参阅以下分步指南中的“在生成时包含文件”:如何将项目添加到库中

于 2016-09-21T08:47:16.583 回答
0

我曾经用Helpinator做软件文档,它和HelpnDoc很接近,但它的存储格式更适合版本控制。

于 2016-09-10T12:10:10.483 回答
0

文件的数量无关紧要,真正的格式(文本/ * 或二进制) - 确实如此。如果 SVN|任何 VCS 可以合并两个具有不同历史的 HelpNDoc 文件(只需手动尝试),你会很高兴

于 2016-09-09T12:41:46.170 回答