共2条
1/1 1 跳转至页
文档编写的出路何在?

一直使用Word编写文档,使用时间长了,就觉得Word文档有太大的缺点:
1、没法使用CVS进行有效的版本管理,因为CVS不支持二进制文件的比较。
2、多人编辑同一份文件时,[face=黑体]即使[/face]定义了模板,由于众多人为因素,文件格式常会不统一。
3、在非Windows环境下难以打开,这到不是主要问题。
最最头疼的是第二个问题。如果不同的文件要合并,大量的工作时间都耗费在格式对齐上。
使用DocBook?这是最近看到的一个文档编写的方法。使用xml或sgml编写文档,文档中使用标记语言,以纯文本保存,方便了版本管理。可以方便的转换为html,pdf,doc等格式。看起来不错,但是使用DocBook要组织开发人员学习,学习需要一定的时间,而且入门的难度远比Word大(当然学会后什么都是水到渠成的)。
而且有几个问题我还不知如何解决,Word中的组合图片打开后可以重编辑,DocBooks还没看到有类似的解决方法。目前DocBook没有Windows下简单易用的GUI工具,linux或Windows下的CygWin用户都只能采用命令行的方式编译转换文档。
恳请来往客谈谈你们开发中的文档是如何编写的。
关键词: 文档 写的 出路 何在
共2条
1/1 1 跳转至页
回复
打赏帖 | |
---|---|
【Cortex-M】Systick Timer使用被打赏10分 | |
分享汽车防盗系统的组成与分类(一)被打赏5分 | |
VOFA+波形显示+JYD-31蓝牙发送和解析不定长数据被打赏10分 | |
【换取手持数字示波器】-STM32F4PWM控制LED灯管亮度被打赏22分 | |
【换取手持数字示波器】STM32F4驱动RPR-0521RS照度、接近一体型传感器被打赏23分 | |
宏定义和const关键字定义被打赏5分 | |
【分享开发笔记,赚取电动螺丝刀】几个单片机I2S外设的BLCK时钟对比被打赏20分 | |
【功率监测与控制系统DIY活动成果贴】DIY功率计与LabVIEW数据采集被打赏100分 | |
【分享开发笔记,赚取电动螺丝刀】使用ESP32S3调试I2S音频模块MAX98357被打赏22分 | |
【Freertos】任务管理被打赏10分 |