怎样让公司全员贡献结构化内容？

- 1 - 

问题

一个朋友在一个生产型企业的文档团队负责产品文档，他们使用DITA来编写各类文档，比如：公司管理文档、产品介绍、产品使用说明、产品安装手册等。

DITA 是基于XML的体系结构，用于编写、制作、交付面向主题的信息类型的内容。DITA的单源内容可以通过不同的方法进行重用，生成不同的交付内容。由于DITA过去用于大型技术手册的编写、管理和交付，它能够满足所有可能呈现给读者的信息发布类型的要求。DITA可用于技术手册、交互培训，教材、标准、报告、商业文档、贸易书籍、旅游和自然指南等书籍的编写。 

文档工程师跟产品工程师沟通各种产品的细节，形成文档的素材，然后根据这些素材编写相关手册。但是，公司所有人其实都产生内容，而文档工程师在企业里人数屈指可数，文档工程师输出的内容有限。

文档工程师熟悉XML/DITA及相关工具，这是他们的专业技能。但对于产品工程师、市场营销人员、经理等角色的人，他们不懂什么是XML，什么是DITA，让他们使用XML来写文档太为难他们了。怎样能让这些人不使用XML也能直接贡献内容而又不失去结构化文档的能力呢？

- 2 - 

解决方案

对于这种情况， OASIS在DITA的基础上设计了lwDITA ( Lightweight DITA)， 简称为轻量级DITA。 

轻量级DITA（LwDITA）是达尔文信息类型体系结构（DITA）的简化版本。轻量级DITA通过以下改进让全员参与内容创作、协作和发布变为可能：

1. 减少元素类型和属性集

2. 使用更严格的内容模型

3. 减少功能集

4. 并支持3中不同格式编写 - XML，HTML5和Markdown

简而言之，非文档工程师使用类似于印象笔记的方式编写文档，文档工程师使用以上提到的3种格式的任意一种来编写，然后由文档工程师把各种格式的内容汇集然后统一发布。 

以下是轻量级DITA规范的整理：

赶快试试吧！

- 3 - 

参考

• LightWeidht DITA

  http://docs.oasis-open.org/dita/LwDITA/v1.0/LwDITA-v1.0.html