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

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>