协同制作软件产品文档解决方案
添加时间: 2007-3-4 1:20:06 作者: 第九软件网 阅读次数:240 来源: http://d9soft.com
搞软件的都知道最头大就是写软件文档了,什么白皮书、用户手册,帮助文档什么的一大堆。常规的做法是,使用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等。


设置输出CHM窗口的参数。

最后输出的CHM文档(套用了模板,MSDN风格)如下:

您也可以输出为Word文档,过程与制作CHM类似,过程如下:

输出了带目录结构的word文档,您可以定制自己的输出Word模板,可以多人协作制作技术方案标书等,然后套用本公司的文档模板输出带完整目录结构的word文档。最后输出的文档如下:



输出为Web Help的方法操作也基本一样,协作的文档可以很方便地输出为带导航目录的Web Help,根据您的需要进行定制修改。效果如下:

难能可贵的是商务协作精灵对个人是免费的,您不需要购买就可以体验其强大的功能。下载地址在:http://www.smartitem.net
上一篇文章: 收藏夹管理也有大学问 按字母先后顺序排列 下一篇文章: 做一张能亮"红绿灯"的学生成绩表
相关文章:
相关软件:

