使用 DITA 文档的配置文件
DITA 文档支持
Arbortext Editor 配置功能。配置属性的值将显示在“列”视图、“文档结构图”和
修改属性对话框中。但是,只能在
应用配置文件对话框中更改配置值。尝试在“列”视图或“文档结构图”中更改属性值将调用
应用配置文件对话框。在
修改属性对话框中,配置文件值为只读并且可以使用按钮
调用
应用配置文件对话框。
每个默认的 DITA 文档类型都有一个关联的配置文件 (.pcf),此文件包括以下基于标准 DITA 属性的配置类别和值:
DITA 属性 | 配置类别 | 配置值 |
audience | Audience | • Novice • Expert |
platform | Platform | • MS-Windows • Unix/Linux |
product | Product | • Project-X • Project-Y • Project-Z |
otherprops | Other | • Blue • Green |
您可以根据需要更改与这些属性关联的配置类别和值。还可以添加其他配置类别。请注意,尽管在 .pcf 文件中单个属性的多个值通常以分号分隔,但 DITA 标准使用空格来分隔多个值。默认情况下,DITA 文档类型 .pcf 文件使用空格来分隔单个属性的多个值,以与标准相符。
默认的 .pcf 文件还包含以下设置配置文件组:
• Windows Expert - 将 Platform 设置为 MS-Windows 并将 Audience 设置为 Expert。
• Unix Novice - 将 Platform 设置为 Unix/Linux 并将 Audience 设置为 Novice。
扩展配置支持
以下是扩展默认配置支持的一些建议方法:
• DITA 标准 otherprops 属性 - 您可以将此属性用于自定义配置类别。
• 其他 DITA 标准属性 - 尽管其他 DITA 标准属性并不预备用作配置元数据,但您可以将 CDATA 类型的标准 DITA 属性用于自定义配置类别。
• 专门化 DITA 属性 - 您可以专门化 DITA 标准 props 属性以创建配置类别所需的任何属性。
• 命名空间属性 — 您可以为配置属性建立一个 XML 命名空间,然后将该命名空间添加到 DITA 文档的根元素。
建议您修改要扩展配置以添加命名空间声明的 DITA 文档类型的模板文档和示例文档。例如,以下是 DITA 主题模板文档的根元素:
<topic id="topic1">
以下是带有命名空间声明示例的根元素:
<topic id="topic1" xmlns:custProf="http://www.acme.com/namespaces/profiling>
您随后可以在 .pcf 文件中将命名空间中定义的属性用于配置类别。请注意,您必须在属性之前添加命名空间。例如:custProf:security。
您可以将命名空间属性用于文档中的任何元素,甚至那些没有标准 DITA 元数据属性的元素。
有关配置文件的配置方面的详细信息,请参考 Customizer's Guide 中的 Customizing your Site’s Profiling Configuration。
DITAVAL 文件和配置
DITA 标准还通过
DITAVAL 文件对条件处理提供支持。您可以对 DITA 文档同时使用 DITAVAL 文件和配置文件。但优先使用 DITAVAL 文件并在任何配置文件生效之前会应用在 DITAVAL 文件中定义的规则。
您可以通过以下方式使用现有 .pcf 文件作为 DITAVAL 文件的基础:
• 选取 > > 或
编辑 DITAVAL 文件来对 DITAVAL 文件进行处理时,
DITAVAL 编辑器对话框将打开,其中包含与当前主题或映射关联的任何
.pcf 文件中的配置信息。
• 在 Arbortext Editor 中直接使用 DITAVAL 文件时,可以选取 > 将 .pcf 文件中的设置配置文件组导入到当前 DITAVAL 文件。
• 在 DITAVAL 编辑器对话框中编辑 DITAVAL 文件时,可以使用导入配置文件按钮将配置文件设置和设置配置文件组从 .pcf 文件导入到当前 DITAVAL 文件。
配置文件底纹
可以通过配置有色底纹来区分配置文件组、属性和值。有关为配置文件值配置底纹的详细信息,请参阅
为配置元素使用底纹。
在配置文件底纹激活后,针对 DITA 文档,配置文件底纹如下显示:
• 主题引用和元素内容以为其配置文件/值设置的颜色加以显示。
• 在“文档结构图”和“列视图”视图中,配置的元素由图标
指示
通过 set showprofileshading 命令激活底纹。
在应用配置文件对话框中会显示为文档类型实例配置的所有配置文件底纹。有关如何在对话框内显示配置文件底纹的原则,请参考配置文件底纹。