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

你可能感兴趣的:(java,linux,SVN,vim,SharePoint)