Spiga

关于文档写作工具

2005-07-29 20:30 by 马维峰, 1752 visits, 网摘, 编辑

不知大家团队都在使用什么样的文档书写工具,是不是还是和笔者一样在使用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文档等等。

Add your comment

12 条回复

  1. #1楼 非非.Net      2005-07-29 20:38
    非常期待谁能介绍一份好的文档写作工具...

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

    但是工作太忙...实在是没有时间啦...哎
      回复  引用  查看    
  2. #2楼[楼主] 马维峰      2005-07-29 21:14
    个人觉得Wiki应该不错,但是没有使用经验,希望有谁介绍一下使用经验,也好试用一下。至于其他工具,并不太指望,不知道SPS里有无类似功能?
      回复  引用  查看    
  3. #3楼 ocean      2005-07-29 21:47
    对于代码的注释,可以直接用工具从cs文件中提取出来,java的代码注释也可以提取出来。
    对于需求或者设计文档,实际上用工具并没有什么太大意义。需求文档本身就是文本的。用word也没有什么关系。
    sps是作为企业门户平台来使用, 没有什么文档协作工具,文档写作工具就是word,实际上大家并没有真正用好word,如果你真的用好word,你就会发现它不难用,而且和别的软件比起来是天壤之别了。如果只是打打字,那和写字板都差不多。
      回复  引用  查看    
  4. #4楼[楼主] 马维峰      2005-07-29 21:58
    @ocean
    Word当然很好用,个人Blog里就有不少随笔,-:)
    但是问题是缺乏多人协作功能,文档不仅仅是代码的一个注释,使用doc工具提取的是代码的说明文档,这个只是最基本的东西,一个好的产品,文档还需要很多。
      回复  引用  查看    
  5. #5楼 gamix2005-07-29 23:35
    好像以前接触过一个可以生成文档的工具,具体叫什么忘记了。就是你使用微软的XML注释的标准,然后使用那套工具就可以了,支持中文的。
      回复  引用    
  6. #6楼 ShiningRay      2005-07-30 00:17
    其实早就有标准了,那就是DocBook
      回复  引用  查看    
  7. #7楼 NetCobra      2005-07-30 00:46
    DocBook没有可视化编辑工具,入门门槛太高了。
      回复  引用  查看    
  8. #8楼 limodou[未注册用户]2005-07-30 12:52
    python的文档是用tex,不是wiki。wiki是一种合作写作的方式,它使用的格式应该是结构化文本。
      回复  引用    
  9. #9楼[楼主] 马维峰      2005-07-30 14:39
    @limodou
    呵呵,记错了。Python文档的首页都有说明。
    @ShiningRay @NetCobra
    DocBook是Unix下的标准文档工具,不过不是可视化对于我们这些一直在Windows下开发的人员来说,确实难用。
      回复  引用  查看    
  10. #10楼 路过[未注册用户]2007-03-15 09:17
    我觉得word的功能已经很强大了!
    最近天天跟word玩。发现很多以前没注意到的功能。
    比较麻烦的是要自己定义一个文档的标准。这个心里没底。

    至于其它的文档软件正在寻找中。。
      回复  引用    
  11. #11楼 Beautiguide[未注册用户]2008-04-20 16:07
    论单用户,目标文档是打印演示非出版及网络,word已经无敌了。多用户的一直还在寻找,望高人指点一下。个人认为wiki比较适合,但对于高级一点的应用,没有看到很好的wiki的例子,希望有高人介绍一下。
      回复  引用    
  12. #12楼 perseusli[未注册用户]2008-07-21 16:47
    DocBook有可视化的编辑工具了,http://www.xmlmind.com/xmleditor/download.shtml
      回复  引用    



发表评论

昵称: [登录] [注册]

主页:

邮箱:(仅博主可见)

评论内容:

  登录  注册

[使用Ctrl+Enter键快速提交评论]

0 203102




相关文章:

相关链接: