DITA 在技术文档业内,一度是霸主级的存在。这套方法论最初源自 IBM,以细粒度划分文档单元、单源多种发布形式、易于内容重用而著称,被世界上众多行业以及企业所采用,影响力不言而喻。即使笔者的当前所从事的技术文档工作践行 Docs like code 方法论,但学习业内经典方法论可开阔从业者眼界,还可能给当前工作以启迪。于是笔者在工作之余开始阅读 IBM 的经典书籍《DITA Best Practices》。
笔者一边看书一边做笔记,梳理出书中前三章最核心的知识内容。即使在 Oxygen 中做了小练习,但如果没有长期且持续的操练机会,一些不常用的 tag 知识点仍有可能随时间流逝而变得生疏,属于典型的“不用就忘,一用就捡起”。因此边看书边记录就显得很有必要了。
脑图可清晰地展示节点之间的关系,能让人快速回忆起知识框架,非常适合用来梳理 DITA topic 下的常用标签。笔者在学习 DITA topic 时,尝试着使用脑图来梳理一个典型的 DITA topic 模板。笔者根据书本梳理出的模板如下,分为 Task、Concept、Reference 三类:



如果你是想要从事技术文档工作的在校大学生,或是工作中未使用 DITA 但想要了解学习 DITA 的文档从业者,笔者希望以上三幅简单梳理的脑图能帮助到你。
随着笔者学习到《DITA Best Practices》中更靠后的章节,也会提炼出书中的知识框架和一些关键知识点,在此分享出来。如果你正在学习 DITA,可保持关注哦~
网友评论