本文最早于2017.10.24发布于 TC互联技术传播社区，时任互联小编。内容未有更新，仅迁移备份至个人账号。

本文介绍何为Lightweight DITA，以及Lightweight DITA三种基本文件格式的特点和示例。

久闻DITA大名，但面对近200种元素望而生畏？

统一的DITA authoring tool，

人人都学是不是成本太高了点？

既有HTML文件，又有Markdown文件，

难不成都得先转一遍DITA XML？

专业TW，开发人员，市场人员，

难道就不能愉快地协同和复用了吗？

……

如果你有以上困惑和犹豫，那么了解下“苗条版”的DITA吧——Lightweight DITA。

或许，你会发现DITA不一样的性感，马上开启你的DITA之旅。

何为Lightweight DITA

Lightweight DITA，简称LwDITA，故名思义，轻（shou）量（shen）级（hou）的DITA标准。

相比于DITA 1.3，LwDITA具有以下特点：

• 元素类型更少（smaller element type）

• 元素的属性值更少（smaller element attribute set）

• 内容模型更严格（stricter content models）

• 功能设置更少（reduced feature set）

• 新增多媒体元素类型

除以上基本区别外，LwDITA相较于DITA 1.3最大的一个特点：能建立XML、HTML5、Markdown文件之间的映射。换言之，LwDITA支持建立由三种不同标记语言编写的topic文件组成的map。

从此，你可以：

• 体验更简洁、轻量级的DITA

• 不同格式偏好的技术写作者不必顾虑文件格式的“强行一致”

• 由不同标记语言编写的源文件能轻松转换并发布

是不是听着就很赞！！！下面就来细细一探究竟。

支持的文件格式

LwDITA支持三种文件格式：

• XDITA：基于XML

• HDITA：基于HTML5

• MDITA：基于Markdown

XDITA

使用XML编写的LwDITA文件格式，是DITA的一个子集，包含多媒体元素类型，能与HTML5文件相互转换。

XDITA适用于想使用DITA标准写作技术信息，却无需完整的DITA标准的技术写作者。

例如：

• 使用XML 编辑器，但只想使用DITA的部分元素和属性值

• 减少开发和维护样式表（CSS）的成本

• 让已有的DITA内容兼容Markdown或者HTML5内容

以下为一个XDITA topic示例：

XDITA topic example

以下为一个XDITA map示例：

XDITA map example

注意：XDITA 要求在 <topicmeta> 必须包含<navtitle> ，声明map中topic的标题。

HDITA

使用HTML5编写的LwDITA文件格式，包含定制的数据属性，以实现与DITA之间的相互转换。

HDITA特别适合下列群体：

• 市场文档写作者，不使用XML编辑器，但能贡献基于DITA的产品信息

• 使用HTML写作工具的开发人员

• 教师或培训师，想要为学习管理系统创建在线的课程内容

• 想使用移动端设备编辑内容的博主或内容架构师

• 只需编写内容但无需发布的文档作者

• 熟悉和偏好HTML5元素的文档写作者

以下为一个HDITA topic示例：

HDITA topic example

以下为一个HDITA map示例：

HDITA map example

MDITA

使用Markdown编写的LwDITA文件格式。包含两种类型：

• 核心类型（core profile）对应Github Flavored Markdown。

• 扩展类型（extended profile）适用于特殊的Markdown Flavor，提供DITA-like的体验

MDITA特别适合下列群体：

• 市场文档写作者，不使用XML编辑器，但能贡献基于DITA的产品信息

• 贡献产品文档的开发人员，但希望自由选择标记语言文档编辑工具

• 负责API文档应用的开发或者技术写作者，需要将内容与其他技术文档应用共享

• 想要使用移动端（但不支持XML编辑器）编辑的写作者

• 希望内容后期能快速地转换为结构化的内容

• 希望利用DITA重用和发布机制，但不依赖于XML标签的写作者

MDITA topic示例

核心类型（core profile）

包含Markdown业已支持的元素：

• Title
• Paragraph
• Section title
• Unordered list
• Table
• Code block

MDITA core profile对应Github Flavored Markdown Spec.

以下为一个MDITA core-profile topic示例：

MDITA core-profile topic

扩展类型（extended profile）

MDITA extended profile支持以下两类情况，与其他LwDITA文件格式或DITA1.3转换性更好。

• YAML front matter header 。

  可用于提供 @id 属性，同时也可以包含prolog metadata信息。

  若topic需要添加YAML front matter header，务必将其放在MDITA文件的文件头位置，且必须用两行 三短线之间。

• 其他HDITA支持的属性和元素类型。

以下是一个MDITA extended-profile topic示例。

MDITA extended-profile topic

MDITA map示例

MDITA map example