帮助 > DITA 创作概述 > 自定义 DITA ID 生成
  
自定义 DITA ID 生成
Arbortext Editor 可为 DITA 文档中的元素生成 ID。根据当前文档中的标题、文档和元素信息生成这些 ID。默认情况下,根据当前日期和时间将 8 位十六进制数字追加到初始 ID (例如 DITAAuthoringOverview-030963B9)。这些生成的 ID 极有可能在一组 DITA 文档中唯一。使用 generate_id 函数生成 DITA ID。也可以手动输入 ID (如果在文档类型的文档类型配置文件 (.dcf) 中启用了该功能)。
可通过以下方式生成 DITA ID:
选择插入 > 生成 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 元素上的 dialogHiddenscreenHidden 属性设置为 true
这会隐藏 Arbortext Editor 对话框和视图中的 id 属性。
.dcf 文件中,将 Options 元素上的 assignId 属性设置为 no
这可防止用户修改自动生成的 ID。
首选项对话框的类别中,选中 ID 列框。
这在 DITA 映射的“列”视图中显示 ID 列。还可以更改 ID 列在此对话框中的显示顺序。