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 off SET JAVA_HOME=..\jre6 SET NUTZ_HOME=..\lib\nutz-1.b.37-jdk6.jar SET ZDOC_HOME=..\lib\nutzdoc-1.14.jar SET ITEXT_CORE=..\lib\iText-2.1.7.jar SET ITEXT_Asian=..\lib\iTextAsian.jar SET ITEXT_FONT=..\font SET PATH=%PATH%;%JAVA_HOME%\bin SET CLASSPATH=.;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\rt.jar SET 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