DITA Open Toolkit 安装与使用指南

1. 项目目录结构及介绍

DITA Open Toolkit（简称 DITA-OT）是一个基于Java的开源发布引擎，专为Darwin Information Typing Architecture（DITA）格式的内容设计。下面是其核心目录结构概述：

• bin：存放可执行脚本，包括用于生成输出的dita命令。
• doc：包含项目文档，如用户手册和开发者指南。
• lib：项目运行所需的依赖库，如Ant、Saxon等。
• plugins: 存放各种插件，这些插件支持不同的转换类型和功能扩展。
• samples: 提供示例DITA内容，帮助用户快速上手。
• src: 源代码目录，包括核心Java源码和其他资源。
• tools: 工具集，可能含有辅助开发或构建过程的脚本或应用。
• gradlew, gradlew.bat: Gradle Wrapper脚本，用于跨平台执行Gradle任务，无需事先安装Gradle。

2. 项目的启动文件介绍

DITA-OT的核心操作并非通过一个典型的“启动文件”进行，而是通过命令行工具来驱动。主要的交互点是位于bin/目录下的dita脚本（在Windows系统中为dita.bat）。这个脚本允许用户通过指定输入文件、输出格式和附加选项来处理DITA内容。因此，实际上，“启动”DITA-OT意味着在命令行中调用该脚本，例如：

cd path/to/dita-ot/bin
./dita --input=myDitaMap.ditamap --format=html

这将把名为myDitaMap.ditamap的DITA映射文件转换为HTML格式。

3. 项目的配置文件介绍

DITA-OT的主要配置不集中于单一文件，而分散在多个地方，包括但不限于：

• ant-build.xml: 虽然不是直接的配置文件，但Ant构建脚本（在根目录下）控制了整个构建流程，可以根据需要修改。
• plugin.xml 文件分布在每个插件目录内，定义了插件的行为、参数和依赖。
• build.gradle: 使用Gradle作为构建工具后，此文件成为关键的配置点，控制编译、测试、打包等环节。

对于用户级的配置，DITA-OT通常会在用户的主目录下创建.ditaot preferences.properties文件或通过命令行参数接受配置值，允许用户定制化某些行为，比如指定默认的输出格式或插件路径。然而，更深入的配置调整可能涉及编辑特定插件内的配置文件或直接在构建过程中通过参数注入进行。

请注意，实际的配置细节和使用方法会随着DITA-OT版本的更新而有所变化，建议总是参考最新的官方文档以获取最准确的信息。