不使用 DITA 的五大原因

如果您身处技术传播领域,您应该听说过达尔文信息类型化体系结构 (DITA)。而且您很可能已经听说过,它是实现基于 XML 的文档管理的唯一正确途径。

虽然 DITA 非常智能,也是创新的重要标志,但我认为,一些炒作具有误导性。DITA 有其自己的作用,但不是万能的。所以,此处目的是客观看待DITA 可能是错误选择的原因,以便有利于驳斥明显关注另一方向的主流论调。

需要明确的是,我并不是想说,DITA 是糟糕的体系结构。我只是要加强对备选方案的讨论。在几年前的一次会议中,我参加了由某位著名专家主持的 DITA 研讨会。这位专家提出“拒绝 DITA 等同于相信世界是平的,我认为这种说法非常愚蠢”。因为持这种观点的人不断壮大,所以,我认为是应该说一些相反观点的时候了。

五大原因

该结构的定义非常复杂

当您第一次在某些能够发现 DITA的编辑器中,看到元素目录时,您会看到可用的元素让人眼花缭乱。例如,当在非特定的 DITA主题正文中(<topic>)工作时,您可能会看到大约三十种不同的有效元素。如果您需要三十种不同的选择,这当然是件好事……但是,我想大多数作者不需要这么多,他们也不会需要通过规范定义的数十个其他元素。

此外,您会遇到许多元素大量的有效属性,通常单一元素拥有二十个或更多的属性。这是很多苦于应对的标记,可能远远超过了您的需要。

当然,您可能会专门从事...但是我们会稍后谈论这个话题。

DTD 的复杂性 DTD

以及有关 DITA 规范的其他支持文件是复杂的“艺术”作品。然而,这使得理解它们变得异常困难。如果您需要排除故障或进行任何类型的维护,就要准备长期作战。

技术传播中“真实”标准的永久错觉

与所有标准一样,开箱即用型 DITA 可能并不是您非常想要的。因为预料到了这种可能性,所以 DITA 的创建者创建了高效的“专业化”机制,它允许定制/扩展默认的 DTD。它发挥了很好的作用,您可以让 DITA 符合您的需求。

话说回来,您自定义的内容越多,您与标准的偏差会越大。而且,您偏离得越多,您可能越会发现,只构建自己的结构定义本来是更加高效、有效的选择。您可能会发现,相比于强行让 DITA 适应您的需求,原来的结构定义和发布架构将更好地满足您的需求,最终,花费也会更少。

Toolkit 庞然大物

与 DITA 如此相似,Open Toolkit是一个工程奇迹。同样地,了解它需要非凡的工程技术。即使是基本的工具包操作也可能需要超凡的技术实力。

一旦您了解它,该工具包可以真正做一些令人印象深刻的工作。但问题是,它可能不是物有所值,特别是您希望自定义输出时(很可能!)。此外,它可能就像高射炮打蚊子 ——大材小用,具体取决于您的需求。所以,再次强调,更小、更灵活的备选方案可能更适合您,即便您必须自己构建它。

基于主题的创作可能不适合您

DITA 十分依赖基于主题的创作范式,如果能够有效地销售出去,这听起来还不错。然而,思维缜密的文档架构师也许能够忽视大众的看法,并认识到,基于主题的创作不是正确的方法。如果得出这个结论,DITA 可能最终是那个永远不会适合圆凿的方枘——不得其所。

我已经作了 15 年的技术作家,以不同的格式和针对各种行业撰写了数不清的网页。我从来没有遇到过使用基于主题的方法会更有效撰写的文档。如果当真如此,DITA 可能会迅速成为不太合适的选择。

总结

介于DITA已经很好地服务于众多公司和组织,它可能适合您。但是,如果有人告诉您,这是唯一的选择,请在您相信这种说法是欠考虑得。在技术方面,总会有另一种选择,往往是一个更好的选择。真正的创新者会寻找更好的选择,就像第一次提出DITA 的那些令人印象深刻的想法。