使用docco创建文档目录树的Ant任务

Question

我有一个用docco生成coffeescript文档的ant文件。它工作得很好，除了它当前将所有文档文件转储到docs文件夹中。我希望docs文件夹镜像我的脚本目录的结构，而不是将所有文件都直接放到一个目录中。

<target name="documentation" description="Generate Docco Documentation for coffee files">
    <apply executable="docco" verbose="true" force="true" failonerror="true">
        <srcfile />
        <fileset dir ="${src.script.dir}" >
            <include name="**/*.coffee"/>
        </fileset>
    </apply>
</target>

我知道docco有一个--output参数，但是我不确定如何在docs文件夹中为fileset中的每个文件生成docs目录路径，而不是逐个遍历它们。

Answer 1

对 task使用<srcfile>和<targetfile>参数应该可以解决这个问题。

下面是一个将扩展名为.a的文件移动到.b扩展名的示例：

<apply executable="mv" dir="./" relative="true">
   <mappedresources>
        <fileset dir="." includes="**/*.a"/>
   </mappedresources>
   <mapper type="glob" from="*.a" to="*.b"/>
   <srcfile/>
   <targetfile/>
</apply> 

还可以看看Mapper类型。

在你的案例中尝试类似的东西：

<target name="documentation" description="Generate Docco Documentation for coffee files">
    <apply executable="docco" verbose="true" force="true" failonerror="true">
        <srcfile />
        <fileset dir ="${src.script.dir}" >
            <include name="**/*.coffee"/>
        </fileset>
        <arg value="--output">
        <mapper type="glob" from "*.coffee" to="*.html"/>
        <targetfile/>
    </apply>
</target>