关于文档写作工具

不知大家团队都在使用什么样的文档书写工具,是不是还是和笔者一样在使用Word,也许个人或者2-3人还好办,最后合并汇总就可以了,但对于大的项目、团队、文档这样显然不合适。第一,工作无法多人协作,或者多人协作不方便;第二,效率不好,最后需要汇总组织;第三,格式转换比较麻烦,生成帮助文档格式或其他格式比较困难;第四,文档基于格式而不是数据,无法统一更改格式(模版的概念)。

先看看微软MSDN的文档:

微软VS 2005中的MSDN没有内容的页面:

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Insert introduction here.

Subhead
Insert section body here.

Subhead
Insert section body here.

Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.



而在其上一级页面可以有子页面的列表,如:

This section features topics related to the Web Designer environment.
In This Section
      Visual Studio Web Site Designers and Editors
      Visual Studio Web Designer Keyboard Shortcuts

至少表明,微软应该在使用一套基于Web(?)的文档书写工具,可以设定模版,可以有很多自动功能,是否Wiki?这样的工具对于团队协作,文档书写个人觉得很重要,而对于这方面的工具和资料不太熟悉,欢迎讨论。

例如Python的文档是使用Wiki工具完成,然后使用工具转换为Html格式,帮助文档,PDF文档等等。

posted on 2005-07-29 20:30 马维峰 阅读(1883) 评论(12) 编辑 收藏

评论

#1楼 2005-07-29 20:38 非非.Net      

非常期待谁能介绍一份好的文档写作工具...

WORD确实太难用了...哎...本想自己动手写一套如笔者所说的B/S工具

但是工作太忙...实在是没有时间啦...哎
 回复 引用 查看   

#2楼[楼主] 2005-07-29 21:14 马维峰      

个人觉得Wiki应该不错,但是没有使用经验,希望有谁介绍一下使用经验,也好试用一下。至于其他工具,并不太指望,不知道SPS里有无类似功能?  回复 引用 查看   

#3楼 2005-07-29 21:47 ocean      

对于代码的注释,可以直接用工具从cs文件中提取出来,java的代码注释也可以提取出来。
对于需求或者设计文档,实际上用工具并没有什么太大意义。需求文档本身就是文本的。用word也没有什么关系。
sps是作为企业门户平台来使用, 没有什么文档协作工具,文档写作工具就是word,实际上大家并没有真正用好word,如果你真的用好word,你就会发现它不难用,而且和别的软件比起来是天壤之别了。如果只是打打字,那和写字板都差不多。
 回复 引用 查看   

#4楼[楼主] 2005-07-29 21:58 马维峰      

@ocean
Word当然很好用,个人Blog里就有不少随笔,-:)
但是问题是缺乏多人协作功能,文档不仅仅是代码的一个注释,使用doc工具提取的是代码的说明文档,这个只是最基本的东西,一个好的产品,文档还需要很多。
 回复 引用 查看   

#5楼 2005-07-29 23:35 gamix

好像以前接触过一个可以生成文档的工具,具体叫什么忘记了。就是你使用微软的XML注释的标准,然后使用那套工具就可以了,支持中文的。  回复 引用   

#6楼 2005-07-30 00:17 ShiningRay      

其实早就有标准了,那就是DocBook
 回复 引用 查看   

#7楼 2005-07-30 00:46 NetCobra      

DocBook没有可视化编辑工具,入门门槛太高了。  回复 引用 查看   

#8楼 2005-07-30 12:52 limodou[未注册用户]

python的文档是用tex,不是wiki。wiki是一种合作写作的方式,它使用的格式应该是结构化文本。  回复 引用   

#9楼[楼主] 2005-07-30 14:39 马维峰      

@limodou
呵呵,记错了。Python文档的首页都有说明。
@ShiningRay @NetCobra
DocBook是Unix下的标准文档工具,不过不是可视化对于我们这些一直在Windows下开发的人员来说,确实难用。
 回复 引用 查看   

#10楼 2007-03-15 09:17 路过[未注册用户]

我觉得word的功能已经很强大了!
最近天天跟word玩。发现很多以前没注意到的功能。
比较麻烦的是要自己定义一个文档的标准。这个心里没底。

至于其它的文档软件正在寻找中。。
 回复 引用   

#11楼 2008-04-20 16:07 Beautiguide[未注册用户]

论单用户,目标文档是打印演示非出版及网络,word已经无敌了。多用户的一直还在寻找,望高人指点一下。个人认为wiki比较适合,但对于高级一点的应用,没有看到很好的wiki的例子,希望有高人介绍一下。  回复 引用   

#12楼 2008-07-21 16:47 perseusli[未注册用户]

DocBook有可视化的编辑工具了,http://www.xmlmind.com/xmleditor/download.shtml  回复 引用   

公告

昵称:马维峰
园龄:7年2个月
粉丝:45
关注:0

统计

  • 随笔 - 345
  • 文章 - 24
  • 评论 - 1665

搜索

 

常用链接

我的标签

随笔分类(437)

随笔档案(350)

文章分类(34)

文章档案(24)

GIS站点

个人链接

积分与排名

最新评论

阅读排行榜

评论排行榜

推荐排行榜