DTDDoc doesn't handle symlinked dtd files well. For example the content of my buildant.xml is given below.
However the dtd file that it references is actually a symlink to elsewhere on my drive. When it generates the documentation, it puts everything into a subfolder, which references the root node of my drive
So my project_doc directory contains a folder "home/user/work/svn/trunk/src/" & the HTML pages incorrectly use absolute references, so the HTML pages all have broken links.
<?xml version="1.0"?>
<project name="DTDDocAnt" default="main">
<description>
This file shows how to call DTDDoc from within Ant.
It's an example for you :)
</description>
<!-- Tell ant where to find the code of the DTDDoc task.
You may have to change this if the two jars are not in your
path. -->
<taskdef name="DTDDoc"
classname="DTDDoc.DTDDocTask"
classpath="DTDDoc.jar"/>
<!-- Execute DTDDoc -->
<target name="main">
<!-- First, generate our own examples. -->
<DTDDoc showHiddenTags="false"
showFixmeTags="false"
sourceDir="project"
destDir="project_doc"
docTitle = "project Documentation">
<include name="**/*.dtd"/>
<exclude name="common/*.dtd"/>
</DTDDoc>
</target>
</project>
|