结构化写作第5部分-应用DITA元素

2023-12-19 浏览：42 次作者：admin

假设您已经完成了内容审查以确定应该在哪里重用内容，您已经选择了工具，现在您准备使用DITA来开发XML格式的内容。我把最近几篇博文的所有部分放在一起，分享了DITA元素应用于内容时的样子。我还将介绍如何解释主题变化以及为什么要开发信息模型。

应用DITA元素的示例

让我们看一个例子。基于内容复用的概念，组织最小有意义块的内容，假设我们有一个题目叫“如何验证包内容”，这个题目有一些简单的部分。这个主题在三个不同的产品中应该是相同的，所以我们决定将它作为我们自己的主题，并在三个产品中重用它。该主题包含说明，因此我们希望将其用作任务信息类型。在任务元素中，可以使用20多个其他元素来构建任务内容。我们决定在介绍段落中使用上下文元素，在过程中使用步骤，在结果中使用结果。以下是我们示例中结构类型、内容和相关DITA元素的外观:

结构类型	内容	DITA元素
标题1	如何验证包装内容	任务(标题)
介绍段落	开始前验证包装内容。	语境
(程序) 第一步第二步第三步	打开盒子。找到装箱单。将内容与装箱单进行比较。	步骤
结果	现在您已经完成了验证包内容的工作。	结果

使用条件属性计算主题变化。

使用上面的例子，假设我们有第四个产品(产品D)，它的描述是相同的，但是有一个额外的步骤。通过在XML创作程序中设置条件属性(其中之一是product ),您仍然可以重用该主题。在这里，您可以添加不同的产品。然后，当您对内容进行一些更改时，您可以将产品条件属性应用于特定的元素。发布产品内容时，重用的主题将与具体的产品内容一起显示。

因此，DITA为您提供了处理异常的灵活性，这确实有助于构建内容重用案例，并再次降低了创建和翻译的成本。

验证结构

记录信息模型中的元素

有许多DITA元素，并且通常有多种方法来定义结构，因此您应该与团队一起确定如何构建内容。例如，完成这个过程后，您可能会发现只使用了20-30个元素。您所做的关于如何构建内容的决策应该在一个称为信息模型的文档或Web输出中捕获，以便作者可以一致地创建内容。信息模型应该包含要使用的元素、描述、上下文和示例。