Lightweight DITA

Lightweight DITA（LwDITA）はDITAのサブセットであるXDITAと、XDITAと互換があるよう設計したHTML5で記述するHDITA、MarkdownとYAML Frontmatterで記述するMDITAを指します。DITA-OTの新しめのバージョンではformat="mdita"のようにして通常のDITAトピックと同様に処理可能です。
LwDITAについては以前に少し記事を書きました。併せてご覧ください。

• 「LwDITAで（途中まで）ドキュメントを書いてみました」https://blog.antenna.co.jp/ILSoft2/archives/12274
• 「MDITA（LwDITA uses Markdown）の書き方」https://blog.antenna.co.jp/ILSoft2/archives/11318

原稿形式選定

原稿形式選定にあたってのライバルは、様々な弊社出版物の実績があるCAS-UB、『Office Open XML Format入門』で利用されたsimpleDocといったものがありました。それらからの選定にあたって「執筆協力予定メンバー全員がそれらの原稿形式に慣れているわけではない」ということがあり、「原稿をプレーンテキストまたはHTMLで受けとれるならオーサリング作業は何とかなるだろう」という考えがあり、とりあえずということでLightweight DITAを採用することにしました。

• マークアップが不足して困ったとき別形式に移行しやすそう
• MarkdownやHTMLなら何とか書けるだろう

反省点

• DLとTableの使い分けははっきりさせておこう
• LwDITAのマークアップは最低限しかないので、DITAへの移行時にどうするかを詰めておく
• LwDITAでもkeyrefは使える

DLとTable、これは仕様の表についての話ですね。仕様についての書籍ですので、山のように登場します。
HTMLのセマンティクスでも、仕様や会社情報の列挙にtableを使うべきかDLを使うべきかというのは混乱しやすいですし、一概に片方のみを正解とも言えません。今回の仕様の表については「1箇所につき1仕様」「左にラベル、右に内容という構成」を考えると、DLを使用していればミスを減らせたのではないか、と後から思いました。また、MDITAの簡易マークアップによる表はsimpletableになりますが、（望ましい形への自動変換を自前で用意しない限り、）ページ数その他についてシビアになる制作物では使わない方が良いでしょう。なんならテーブルマークアップは手で書かずにデータ変換処理によって用意した方が良いです。

| Header |
|--------|
| Cell   |