我是一名技术作家,正在使用DITA编写通用业务流程标准.我选择了DITA,因为它的主题,内容参考和有条件的分析,所有这些都将帮助我控制我的复杂,相互关联的文档的优异组装的使用.
我需要选择要使用的主题类型.
我有三个选择:
选项1是不现实的,因为我无法访问DITA开发人员.另外,即使伪代码设计专业化也不是一件容易的事.
这使得选项2和3成为现实.
选项2让我使用主题主题.这给了我灵活性,因为它是最宽容的主题类型.它也是最"干净"的,因为我没有使用为其他东西设计的主题类型.然而,主题主题实际上是专业化的基础,不应该直接使用.
选项3让我使用计算机文档主题.我可以或多或少地让我的内容适合他们.但是,它们实际上是用于以特定方式编写的"tripane help"类型的内容.例如,这些主题类型通常用于根据John Carroll的极简主义进行编写,该极简主义鼓励用户进行实验,并专注于用户的任务.我的文件要求提出要求,我不想在写作中鼓励极简主义原则.
选项2和3都涉及妥协.编写流程标准的两个中哪个更好？
小智 5
另一种选择是使用DITA for Publishers项目提供的主题类型,这些主题类型旨在为典型的非技术文档发布组件建模:文章,章节,小节,侧栏和部分.
DITA for Publishers项目位于http://dita4publishers.sourceforge.net.
请注意,如果您需要的话,定义新的主题类型是一个与众不同的主题类型标记名称,这很简单:它完全是复制,粘贴和重命名的练习,任何人都可以这样做.
http://www.xiruss.org/tutorials/dita-specialization/上的配置和专业化教程将引导您完成它,虽然现在看着它们,但我发现主题专业化教程实际上比仅仅做一个简单的根更加复杂 -仅限标记名称的专业化.