凉水代码

Code Cold Water

导航

在Eclipse中结合Ant自动化帮助文档

Posted on 2011-03-06 15:17  凉水代码  阅读(1141)  评论(0编辑  收藏  举报

在前面记录过在Eclipse 中使用WikiText写文档后,但是每一次都要右键-->WikiText-->Generate HTML这样一个过程,如果文档很多,则会非常麻烦。还好,WikiText与Ant集成可以自动生成HTML文档

以下为我使用Ant自动生成文档,这是我的项目目录

wiki下的lib包主要是保存了wiki的*core*.jar这样的包。这些包从 这里 可以下载 mylyn-wikitext-standalone-latest.zip lib下就是那里面的几个jar包

我现在打开build.xml在里面写上

1 <?xml version="1.0" encoding="UTF-8"?>
2  <project name="myproject" basedir="." default="wiki">
3 <property name="wikitext.standalone" value="${basedir}/wiki/lib" />
4 <!-- path to wikitext standalone package -->
5 <path id="wikitext.tasks.classpath">
6 <fileset dir="${wikitext.standalone}">
7 <include name="org.eclipse.mylyn.wikitext.*core*.jar" />
8 </fileset>
9 </path>
10 <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/internal/wikitext/mediawiki/core/tasks/tasks.properties" />
11 <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/wikitext/core/util/anttask/tasks.properties" />
12
13 <target name="wiki" description="Generate HTML from textile source">
14 <wikitext-to-html markupLanguage="Textile" overwrite="true">
15 <fileset dir="${basedir}/wiki/doc">
16 <include name="*.textile" />
17 </fileset>
18 </wikitext-to-html>
19 </target>
20 </project>

不需要解释的是 wikitext.standalone 和wikitext.tasks.classpath,其实我也不知道这样弄做什么,即然与Eclipse集成了,还要再弄一个standalone,

需要解释的是target中的wikitext-to-html,markupLanguage是说使用的是哪一种标记语言,我使用的是Textile,fileset里面是包含的.textfile文件

写完之后用在ant中显示应当是这样的:

双击wiki运行脚本,如果不出错,在/wiki/doc下面应当看到有html文件生成了。他没有指定输出路径,生成的html文件和.textile文件是在同一个目录下面,如果想作进一步的处理,可以将html文件拷贝到另一个地方集中。关于如何copy文件,就请另外看ant的用法,这里先不讲了。