zDoc 的确是个很好的文档工具,语法比docbook要简洁

zDoc 项目地址 http://code.google.com/p/nutz/wiki/zdoc_overview

先引用 zDoc 项目的目的

 文档，我认为只要做到下面两件事：

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

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

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

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

1. 对于文档变动的管理，我想现在的版本控制系统已经做的足够好了（比如 SVN, Git, Mercurial）。
2. 市面上所有的操作系统都会对纯文本文件（尤其是 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

评论

2 楼 iliuyong 2011-06-06  

zozoh 写道

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

1 楼 zozoh 2011-05-11  

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