读书人

zDoc 确确实实是个很好的文档工具,语法

发布时间: 2012-08-27 21:21:57 作者: rapoo

zDoc 的确是个很好的文档工具,语法比docbook要简洁
zDoc 项目地址 http://code.google.com/p/nutz/wiki/zdoc_overview
先引用 zDoc 项目的目的

?文档,我认为只要做到下面两件事:

    让每篇文档很容易写 让每篇文档可以同时被多人写

那么,对在开源项目的文档写作方面的工作,会有很大帮助的。?

类似 Word 的桌面文档工具并不适合多人协同工作 除非你给MS纳钱,架个 SharePoint 类的服务器 文档的改动历史追踪很困难 跨平台性不太好(因为兼容性的问题) 在线文档应用并不适写庞大的文档 Google Doc 之类的,当文档大的时候,编辑起来会很慢 总有意外的小Bug,而且通常很恼人

所以,我必须构建自己的文档写作方式。我注意到两个事实:

    对于文档变动的管理,我想现在的版本控制系统已经做的足够好了(比如 SVN, Git, Mercurial)。 市面上所有的操作系统都会对纯文本文件(尤其是 UTF-8)支持的很好。(比如 Windows的Nodepad++,Editplus,Ultra-Edit 以及 Linux 下的 Vim 等)

所以,我打算将这两个事实充分利用起来。尤其幸运的是我本人就是一名程序员,于是我便是建立了一个小小的文本文件解析渲染器 -- zDoc。

?

下载zdoc后发现

有几个缺点

1.没有集成所有需要的文件再一起

2.依赖计算机必须装jre

3.路径很多都是写死的

?

所有我修改了下zdoc 的批处理修改点如下

1.所有需要的文件都集成打偶1个目录下

2.集成jre6,这样可以解包即用

3.修改了写死的路径,为相对路径

  竟然有人用这个工具 ...  竟然有人用这个工具 ...

读书人网 >软件架构设计

热点推荐