技术写作理论知识- DITA

日期:

最佳答案

在晚期,技巧文档写作方法更其他文档没什么差别,都是线性的写作方法,一般一个产品对应一本文档,跟着科技行业的日益开展,技巧文档写作须要越来越多,一个产品每每有多个系列,像同一款汽车,有高中低三种设置,他们大年夜部分是雷同,只有少部分差别,假如按照线性的写作方法,要写三回,固然有人会说断定没这么傻,写三回,断定 and paste,这种方法同样带来成绩,就是假如修改会至少要改三个处所,常常轻易出错。

针对这种成绩,模块化的写作方法应运而生,DITA就是其中的佼佼者。DITA(Darwin Information Typing Architecture)是一种基于XML言语跟信息分类的材料开辟方法。利用DITA的材料开辟方法,可能很好的处理同源跟重用成绩。

DITA最早有IBM提出,现今曾经标准化,具体可能拜见 https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita

现在市场上用的最多的DITA写作东西就是 Arbortext 了,基于XML言语,写作与款式分别。

利用DITA的方法开辟文档的流程一般式如许:

从上图我们可能很直不雅的看出Topic可能被差其余Map引用,从而做到同源跟重用,而Topic不决定发布件的格局,可能做到内容与款式分别。

InfoMapping是一个用于 分析、构造跟表达 信息的 原则、技巧跟标准的凑集 。 DITA是一种基于XML的文档开辟方法。 团体懂得DITA是材料工程方法,是术,InfoMapping是信息现实,是道。两者结合起来,就是技巧文档写作的现实基石。