共同制作软件产品文档解决方案

协同制作软件产品文档解决方案

搞软件的都知道最头大就是写软件文档了,什么白皮书、用户手册，帮助文档什么的一大堆。常规的做法是，使用Word写或专门的CHM制作软件（如RoboHelp）。如果是一个人做倒也行，产供销一条龙全包了。如果项目组开发软件，特别是产品化软件，文档往往需要多人协作参与审阅或制作，没有一个好协作工具，往往是牛头不对马嘴，产品与文档无法同步，大型软件更是如此。

最新出炉的商务协作精灵是一款商务协作软件，可以用于商务项目管理与协作、开发团队协作CHM等软件文档、项目需求管理、个人事务助理、网络资料收集等。使用商务协作精灵来协同制作软件产品文档简直是完美，现将使用方法介绍给大家共享。

软件主界面：

服务器端使用了IIS+SOAP/WebService方式，用户登录后就可以使用全部功能。主界面左边的<项导航树>类似一个活页夹,可以包容不同种类的数据，网络内的用户均可以进行访问，并且可以为每一项单独设定权限。在上图项导航树中单击右键出现以下菜单：

可以在项导航树中的新建数据项，可以是RTF文本、文件夹、HTML等，您也可以自行定义或从作者网站下载更多的数据类型插件。新建界面如下：

下面我们以编写一个ActiveX对象的帮助文档为例说明使用方法：

选择文件->导入功能，出现以下导入对话框，从对话框看，目前仅仅支持从COM组件库导入，今后可能支持从多种数据源导入。

单击下一步，选择要导入的ActiveX 控件Comct232.ocx，并修改相应的参数，支持模板参数的设定。

单击开始导入，系统开始导入该OCX的对象的方法属性等，并自动生成COM对象的结构和说明，以下是导入的结果。

用户可以打开导航树中的每一项，下一步就是设置访问权限了，在<项属性>中我们可以为导入的每一项设定网络用户的访问权限，当多人进行协作时特别有用。界面如下图：

完毕后，局域网内部的用户就可以根据权限进行项数据的编辑修改等操作。并且每一个数据项均可以进行附件操作和批注操作，很方便。

附件操作支持外部文件或内嵌对象.

数据编辑功能也是很强大，支持表格等所见即所得的可视化设计，如下图：

最后是文档输出：

目前支持CHM、Word、Web Help、模板四种文档输出方式，下面为输出CHM为例说明如下：

选择<文件>-<导出>功能，或在项导航树上单击右键，选择<导出>功能。选择对应的导出格式。如果以下四种不能满足要求，商务协作精灵还支持您进行定制导出插件，从而达到更多的导出格式。据悉，新版中将开发出支持导出为MS Help 2.x格式的导出插件。

导出的操作方法基本类似。

接下来我们要选择要导出的项：

设置修改要导出为CHM的相关参数，如标题、按钮布局等。看下图中输出模板，内置了两种输出模板，您也可以很方便地定制自己的输出模板，比如在您公司的软件文档中包含公司Logo等。