结构化写作第6部分-发布XML内容
2018-11-08 08:30:00
使用DITA创建一些XML内容后,您就可以将内容发布到一个或多个输出。用于发布的构建块是XML文件,DITA映射和样式表。XML创作程序提供了一系列发布选项。我们来看看它是如何工作的。
使用DITA映射组装内容
要组装XML文件,您需要在XML创作程序中创建DITA映射,这是将所有XML文件提取到有组织的组中的一种方法。DITA映射就像Microsoft Word文档中的目录,只有您从多个文件创建它。在此示例中,输出A的DITA映射将包括主题1,2和3.输出B的DITA映射将包括主题1,3和6。

您可以随时在DITA地图中添加和删除主题,也可以拥有构成文档的多个DITA地图。
发布内容
在DITA地图中汇编内容后,您可以同时将其发布到多个输出,具体取决于您的XML创作工具。一些标准输出包括PDF,EPUB,Kindle,HTML和在线帮助系统。

如果您为产品,版本或受众等内容创建了一些条件属性,则可以在发布步骤中选择这些选项。例如,在我之前的博客文章中,我给出了一个示例,其中三个产品都具有相同的指令,称为“如何验证包内容”。第四个产品有另外一个指令。要为第四个产品添加变体,您需要将产品条件属性应用于包含附加指令的特定元素。然后,当您发布第四个产品的说明时,您将在条件选项中选择该产品。结果如下:
产品A,B和C. | 产品D. |
如何验证包装内容 在开始之前验证包内容。
现在你已经完成了验证包内容的工作。 | 如何验证包装内容 在开始之前验证包内容。
现在你已经完成了验证包内容的工作。 |
因此,您可以一次编写内容但添加变体,然后在发布步骤中选择这些选项。如果您翻译内容,这可以节省大量成本,因为一旦您翻译了核心说明,您只需将变体发送给翻译。在这种情况下,您将发送14个单词而不是46个单词。您可以节省大量成本。
样式表定义格式
XML创作程序附带标准样式表或XSLT(可扩展样式表语言转换),它为DITA标准和每种输出类型中的每个元素定义样式。您可以修改样式表以应用公司的样式,例如字体类型和颜色,但它确实需要一些编码技能。
结论
XML创作的内容有很多发布选项,例如从各种文件中选择内容并能够发布到多个输出。
结构化写作是一个复杂的主题,因为它可以以多种不同的方式应用。在这一系列博客文章中,我专注于如何使用基于XML的创作程序在技术内容方面应用结构化写作,但还有更多应用程序。这是我在结构化写作系列中的最后一篇博文,我希望你喜欢这个系列。