安装完DITA OT和所需的Java Deevelopment Kit之后,下一步便是建立文件夹结构,用于测试和发布。建立DITA输入文件夹(用于存放DITA源文件)和输出文件夹(用于存放DITA发布的输出文件)能有助于避免混淆,让DITA OT发布过程更顺利。
输入文件夹
如果你使用的是单独的DITA OT发布环境,一个良构的文件夹层级能帮助你记录DITA源文件。以下是一些建立输入文件夹的最佳实践:
-
不要打乱DITA层级。存储DITA内容的方式可能会与DITA OT解析与生成某些发布类型相冲突。因此,最好避免将map与所引用文件存储在同一层级的文件夹中。
-
管理公共内容。如果你有topic在多个map引用,将它们存放在同一个文件夹下(可命名为“shared”或者“reused”),以便能快速找到。
输出文件夹
默认设置下,DITA OT生成的输出文件夹放在DITA OT文件夹中(之前版本的DITA OT使用的默认输出文件夹的名称为out)使用相同的源内容,发布相同的输出物,DITA OT默认会替换之前已生成的版本。例如,昨天你已经从m_ducks.ditamap中发布了PDF,今天再次发布m_ducks.ditamap文件,默认会删除昨天发布的PDF,替换为今天发布的PDF。(如果你使用另一个map生成PDF,或者使用同一个map生成HTML,昨天生成的PDF会保留。)
注: 如果你之前已经生成了PDF,并且在Adobe Reader 或者 Acrobat Pro中打开了该PDF,发布新版本时DITA OT不会覆盖前一个PDF版本。
为确保DITA OT不会替换掉已有的输出物,建立out 文件夹及其子文件夹。如此,当运行DITA OT时,可以根据需求将输出物生成于子文件夹中。有许多方法可以帮助你组织输出文件夹,包括:
- 根据输入内容的体系
- 根据输出类型
- 根据日期
- 根据测试次数
练习
- 创建一个新的文件夹并命名为sources。
- 打开在课程开始前你已经下载的samples文件夹。
- 从samples文件夹中复制ducks 文件夹到你刚创建的sources 文件夹。