61、Ant任务参考指南

Ant任务参考指南

1. 自动化任务详情提取

Ant本身带有丰富的HTML格式文档，但为了给读者提供更便捷的快速参考，我们创建了一个自动化流程来分析Ant的源代码并直接提取任务详情。该流程利用了XDoclet的自定义功能，为每个任务生成一个XML文件。这些XML文件包含任务描述、支持的属性和元素名称、类型及描述等信息。具体步骤如下：
1. 利用XDoclet的自定义子任务、标签处理器和模板进行操作。
2. 使用 <concat> 合并XML文件。
3. 使用 <xslt> 将合并后的XML文件转换为HTML。

这个自动生成代码存在于Ant的源代码仓库中，未来Ant的版本有望采用此流程来改进在线文档。

2. 任务参考约定

任务以特定格式列出，如 <task-name> 任务简要描述 。属性按字母顺序先列出，随后是子元素，子元素用尖括号 < > 括起来。所有属性都有指定的类型，元素类型仅针对常见数据类型提供。布尔属性在值为 on 、 yes 或 true 时被视为 true ，其他值视为 false 。路径属性接受与平台无关的路径，使用冒号 : 或分号 ; 作为分隔符，正斜杠 / 或反斜杠 \ 作为目