ant - Ant Task 使用 docco 创建 docs 目录树

Question

我有一个 ant 文件，可以用docco生成 coffeescript 文档。它工作正常，除了它当前将所有文档文件转储到 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 文件夹中为文件集中的每个文件生成 docs 目录路径，而无需一一进行。

Answer 1

应用任务的使用<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>