- 1 -
问题
一个朋友在一个生产型企业的文档团队负责产品文档,他们使用DITA来编写各类文档,比如:公司管理文档、产品介绍、产品使用说明、产品安装手册等。
DITA 是基于XML的体系结构,用于编写、制作、交付面向主题的信息类型的内容。DITA的单源内容可以通过不同的方法进行重用,生成不同的交付内容。由于DITA过去用于大型技术手册的编写、管理和交付,它能够满足所有可能呈现给读者的信息发布类型的要求。DITA可用于技术手册、交互培训,教材、标准、报告、商业文档、贸易书籍、旅游和自然指南等书籍的编写。
文档工程师跟产品工程师沟通各种产品的细节,形成文档的素材,然后根据这些素材编写相关手册。但是,公司所有人其实都产生内容,而文档工程师在企业里人数屈指可数,文档工程师输出的内容有限。
文档工程师熟悉XML/DITA及相关工具,这是他们的专业技能。但对于产品工程师、市场营销人员、经理等角色的人,他们不懂什么是XML,什么是DITA,让他们使用XML来写文档太为难他们了。怎样能让这些人不使用XML也能直接贡献内容而又不失去结构化文档的能力呢?
- 2 -
解决方案
对于这种情况, OASIS在DITA的基础上设计了lwDITA ( Lightweight DITA), 简称为轻量级DITA。
轻量级DITA(LwDITA)是达尔文信息类型体系结构(DITA)的简化版本。轻量级DITA通过以下改进让全员参与内容创作、协作和发布变为可能:
-
减少元素类型和属性集
-
使用更严格的内容模型
-
减少功能集
-
并支持3中不同格式编写 - XML,HTML5和Markdown
简而言之,非文档工程师使用类似于印象笔记的方式编写文档,文档工程师使用以上提到的3种格式的任意一种来编写,然后由文档工程师把各种格式的内容汇集然后统一发布。
以下是轻量级DITA规范的整理:
赶快试试吧!
- 3 -
参考
-
LightWeidht DITA
http://docs.oasis-open.org/dita/LwDITA/v1.0/LwDITA-v1.0.html