gpt4 book ai didi

dita - 当我不编写计算机文档时,我使用哪种 DITA 主题类型?

转载 作者:行者123 更新时间:2023-12-01 15:42:33 25 4
gpt4 key购买 nike

我是一名技术作家,使用 DITA 编写通用业务流程标准。我之所以选择使用 DITA,是因为它具有出色的主题组合、内容引用和条件分析功能,所有这些都将帮助我控制复杂的、相互关联的文档。

我需要选择要使用的主题类型。

我有三个选择:

  1. 我可以专门设计自己的主题类型来满足我的确切需求
  2. 我可以使用主题topic。
  3. 我可以使用一个或所有 OASIS 计算机文档主题(概念/任务/引用)。

选项 1 不现实,因为我无法接触到 DITA 开发人员。再加上设计特化,即使是伪代码也不是微不足道的。

这使选项 2 和 3 成为现实。

选项 2 让我使用主题 topic。这给了我灵 active ,因为它是最宽容的主题类型。它也是最“干净”的,因为我没有使用为其他东西设计的主题类型。然而,主题 topic 实际上是特化的基础,不应该直接使用。

选项 3 让我使用计算机文档主题。我或多或少可以让我的内容适合他们。但是,它们实际上是为以特定方式编写的“三联帮助”类型的内容而设计的。例如,这些主题类型通常用于根据 John Carroll 的极简主义写作,该极简主义鼓励用户实验并关注用户的任务。我的文件类型有强制要求,我不想在我的写作中鼓励极简主义原则。

选项 2 和 3 都涉及妥协。对于编写流程标准,两者哪个更好?

最佳答案

另一种选择是使用 DITA for Publishers 项目提供的主题类型,这些主题类型旨在模拟典型的非技术文档发布组件:文章、章节、小节、边栏和部分。

出版商项目的 DITA 在 http://dita4publishers.sourceforge.net .

请注意,如果您只需要一个有区别的主题类型标签名称,那么定义新的主题类型非常容易:这完全是一个复制、粘贴和重命名的练习,任何人都可以做到。

http://www.xiruss.org/tutorials/dita-specialization/ 的配置和特化教程引导您完成它,尽管现在看它们我发现主题特化教程实际上比只做一个简单的仅根标记名特化更复杂。

关于dita - 当我不编写计算机文档时,我使用哪种 DITA 主题类型?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/15156444/

25 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com