iliuyong 发表于 2013-2-4 14:39:16

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.修改了写死的路径,为相对路径
@echo offSET JAVA_HOME=..\jre6SET NUTZ_HOME=..\lib\nutz-1.b.37-jdk6.jarSET ZDOC_HOME=..\lib\nutzdoc-1.14.jarSET ITEXT_CORE=..\lib\iText-2.1.7.jarSET ITEXT_Asian=..\lib\iTextAsian.jarSET ITEXT_FONT=..\fontSET PATH=%PATH%;%JAVA_HOME%\binSET CLASSPATH=.;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\rt.jarSET CLASSPATH=%CLASSPATH%;%ITEXT_CORE%;SET CLASSPATH=%CLASSPATH%;%ITEXT_Asian%;SET CLASSPATH=%CLASSPATH%;%ITEXT_FONT%;SET CLASSPATH=%CLASSPATH%;%ZDOC_HOME%;SET CLASSPATH=%CLASSPATH%;%NUTZ_HOME%;java org.nutz.doc.Doc %1 %2 %3 %4 %5 %6 %7 %8 %9@echo on
页: [1]
查看完整版本: zDoc 的确是个很好的文档工具,语法比docbook要简洁