自定义 DITA ID 生成
Arbortext Editor 可为 DITA 文档中的元素生成 ID。根据当前文档中的标题、文档和元素信息生成这些 ID。默认情况下,根据当前日期和时间将 8 位十六进制数字追加到初始 ID (例如 DITAAuthoringOverview-030963B9)。这些生成的 ID 极有可能在一组 DITA 文档中唯一。使用 generate_id 函数生成 DITA ID。也可以手动输入 ID (如果在文档类型的文档类型配置文件 (.dcf) 中启用了该功能)。
可通过以下方式生成 DITA ID:
• 选择 >
• 选择生成 ID 工具栏按钮
• 选择修改属性对话框、“文档结构图”属性显示、“列”视图修改属性列或“列”视图 ID 列中的生成 ID 按钮
• 从资源管理器的新建主题选项卡创建新的 DITA 主题
• 保存从 DITA 文档类型的一个模板文件创建的 DITA 主题
在这种情况下,首次保存文档时,Arbortext Editor 自动为主题生成 ID。
默认情况下,ID 不显示在“列”视图列或资源管理器中。ID 显示在“编辑”视图或修改属性对话框中。
可以在以下位置修改现有 ID:
• 修改属性对话框
• “文档结构图”属性显示
• “列”视图修改属性列
• “列”视图 ID 列
可以手动输入更新的 ID,也可以使用生成 ID 按钮生成新 ID。如果试图使用生成 ID 按钮更改现有 ID,则会提示您确认想要替换现有 ID。如果手动输入新 ID,则不会显示此提示。
可以通过以下方式自定义默认 DITA 文档的 ID 生成行为:
• 将 ditahideids 选项设置为 off。
这使 ID 显示在资源管理器浏览器中,并在资源管理器的新建主题选项卡上显示 ID 选项。
• 将 generateuniqueid 选项设置为 off。
这可通过删除追加到 ID 的十六进制字符串缩短默认 ID。
• 在 DITA 文档类型的文档类型配置文件 (.dcf) 中,将 DITA id 属性的 AttributeOptions 元素上的 dialogHidden 或 screenHidden 属性设置为 true。
这会隐藏 Arbortext Editor 对话框和视图中的 id 属性。
• 在 .dcf 文件中,将 Options 元素上的 assignId 属性设置为 no。
这可防止用户修改自动生成的 ID。
• 在首选项对话框的列类别中,选中 ID 列框。
这在 DITA 映射的“列”视图中显示 ID 列。还可以更改 ID 列在此对话框中的显示顺序。