DITAについて

Posted on

DITAのトピックベースライティングは支援物資の梱包方式と同じ

DITA Festa2011(2011年6月22日)の「美味しいDITAとEPUBの作り方」で講演したのですが、topic制作のコツは、支援物資の梱包方法と以下の点で酷似しているのです。要は受け手(読者)の使い安さを考えて、内容をちゃんと仕分けした状態で荷詰め(制作)しようね、ということです。

鉄則 支援物資の梱包 トピックベースライティング 意義
同一種によるパッケージング 段ボール1箱には1種類の物資を詰める、あるいは箱内では同種のもので小分けする ・1topicには1テーマを記載する。
・1topic内ではsectionによる情報の再仕分けを行う
受け手が中身の仕分けをしなくてすむ
明快なラベリング 段ボール箱の表面に内容物のラベルを貼る ・具体的なtopic タイトル、sectionタイトルを付ける
・より細かな仕分けとラベリングには、表、dl(タイトル付リスト)を使う
・shortdescを記してタイトルを補足する
受け手にとって必要かどうかの判断を速やかにさせる
大きすぎないパッケージ 運びやすく場所をとらない段ボール箱を使う 1テーマを過不足なく説明することができる最小サイズのtopicを作る 小ぶりのほうが受け手にとって使い易い(理解しやすい)