轻量级DITA - 让公司全员贡献结构化内容

面对非文档工程师不熟悉XML/DITA的问题,OASIS推出了LwDITA,它是DITA的简化版,允许员工通过XML、HTML5或Markdown轻松编写内容。LwDITA降低了内容创作的门槛,使得全员可以更方便地贡献内容,文档工程师则负责整合和统一发布。
摘要由CSDN通过智能技术生成

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
  • 1
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值