Ant任务用docco创建docs目录树

时间:2013-03-07 03:05:45

标签: ant documentation coffeescript docco

我有一个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目录路径,而不是逐个遍历它们。

1 个答案:

答案 0 :(得分:1)

使用apply 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>