共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 跳转至页
回复
我要赚赏金打赏帖 |
|
|---|---|
| bsp_log:RTT分级日志封装被打赏¥16元 | |
| SEGGER RTT常用API函数讲解被打赏¥14元 | |
| 【S32K3学习整理】S32K388 四核启动被打赏¥23元 | |
| 【S32K3学习整理】Lockstep和Decoupled 模式被打赏¥28元 | |
| 嵌入式芯片调试神器-J-Link RTT被打赏¥21元 | |
| 人体红外PIR感应传感器使用(ESP32S3)被打赏¥26元 | |
| 一种有效完成脚本程序测试的方法被打赏¥28元 | |
| WorkBuddy搭配SolidCraft给开发板做两件式外壳被打赏¥33元 | |
| 开箱一块k230被打赏¥33元 | |
| 【瑞萨RA8D1测评】RA8D1+lwIP网络验证与TCPOTA的实验记录被打赏¥33元 | |
我要赚赏金
