Lightweight DITA（一）

文章介绍何为Lightweight DITA，以及Lightweight 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的一个子集，同时在DITA1.3 基础上新增了多媒体元素类型，能与HTML5文件相互转换。
XDITA适用于想使用DITA标准写作技术信息，却无需完整的DITA标准的技术写作者。例如：

• 使用XML 编辑器，但只想使用DITA的部分元素和属性值
• 减少开发和维护样式表（CSS）的成本
• 让已有的DITA内容兼容Markdown或者HTML5内容

XDITA topic示例


Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.

• Install light bulbs.




• Prepare remote control.




• Program lighting groups.

The following video demonstrates a recommended installation:

XDITA map示例

Remote Lighting Network
Remote Network Lighting
Introduction
Alternative lighting setups Low power installation
High power installation

HDITA

使用HTML5编写的LwDITA文件格式，包含定制的数据属性，以实现与DITA之间的相互转换。
HDITA特别适合下列群体：

• 市场文档写作者，不使用XML编辑器，但能贡献基于DITA的产品信息
• 使用HTML写作工具的开发人员
• 教师或培训师，想要为学习管理系统创建在线的课程内容
• 想使用移动端设备编辑内容的博主或内容架构师
• 只需编写内容但无需发布的文档作者
• 熟悉和偏好HTML5元素的文档写作者

HDITA topic示例

Installing and Setting up Remote Lighting

Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.

Steps

• Install light bulbs.




• Prepare remote control.




• Program lighting groups.

Example

The following video demonstrates a recommended installation:

HDITA map示例

Remote Lighting Network

Remote Lighting Network

• Introduction




• Alternative lighting setups

  
  
  
  

  • Low power installation

  
  

  • High power installation

  
  
  
  

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的示例：
# Installing and Setting up Remote Lighting

Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.

## Steps

1. Install light bulbs.
2. Prepare remote control.
3. Program lighting groups.

## Example
[!(image)]

• 扩展类型（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示例。
---
id: install-and-setup
author: Kevin Lewis
---

# Installing and Setting up Remote Lighting

Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.

Before you attempt to install your lighting kit, please turn off the power in your electrical circuit panel,

## Steps

1. Install light bulbs.
2. Prepare remote control.
3. Program lighting groups.

## Example

The following video demonstrates a recommended installation:

MDITA map示例
使用Markdown编辑map文件。
# Remote Lighting Network
- [Introduction](introduction.md)
- [Alternative lighting setups](alternatives.md)
- [Low power installation](low-power.md)
- [High power installation](high-power.md)

更多关于LwDITA的源文和详细信息，请戳：
http://docs.oasis-open.org/dita/LwDITA/v1.0/cnprd02/LwDITA-v1.0-cnprd02.html