我正在为涉及多个开发人员的项目编写文档。我们使用Subversion(SVN)来处理我们的代码库。
我使用HelpNDoc编写了文档文档的初稿,我喜欢它,它具有良好的树视图和易用性;问题是只有一个文件,因此我不知道如何使用SVN来允许其他开发人员为文档做出贡献并对其进行更新。
你知道它是否可能吗?如果没有,你能建议一个好的软件,易于使用,可以与SVN一起使用的文档的树形视图,还是让多个用户可以更新它?我们使用Windows。
答案 0 :(得分:2)
HelpNDoc项目是基于SQLite开源数据库引擎的二进制文件。优点是整个文档存储在一个文件中,因此可以轻松地复制,移动,共享,备份...... 然而,一个缺点是它必须在任何版本控制系统中作为二进制内容签入,包括Subversion:在这些文件上不能进行diff和merge。
一种可能的解决方案是在HelpNDoc的库中使用外部文档:每个用户都可以使用自己的文档(可以是Word文档,HTML网页...)和主要的HelpNDoc项目。创建时包含这些文档。请参阅"在生成时包含文件"在以下分步指南中:How to add an item to the library
答案 1 :(得分:0)
文件数量无关紧要,实际格式(文本/ *或二进制) - 确实如此。如果SVN |任何VCS可以合并两个具有不同历史记录的HelpNDoc文件(只需手动尝试),您就会感到高兴
答案 2 :(得分:0)
我曾经使用Helpinator获取软件文档,它非常接近HelpnDoc,但它的存储格式更适合版本控制。