DITAのトピックベースライティングは支援物資の梱包方式と同じ
DITA Festa2011(2011年6月22日)の「美味しいDITAとEPUBの作り方」で講演したのですが、topic制作のコツは、支援物資の梱包方法と以下の点で酷似しているのです。要は受け手(読者)の使い安さを考えて、内容をちゃんと仕分けした状態で荷詰め(制作)しようね、ということです。
鉄則 | 支援物資の梱包 | トピックベースライティング | 意義 |
同一種によるパッケージング | 段ボール1箱には1種類の物資を詰める、あるいは箱内では同種のもので小分けする | ・1topicには1テーマを記載する。 ・1topic内ではsectionによる情報の再仕分けを行う |
受け手が中身の仕分けをしなくてすむ |
明快なラベリング | 段ボール箱の表面に内容物のラベルを貼る | ・具体的なtopic タイトル、sectionタイトルを付ける ・より細かな仕分けとラベリングには、表、dl(タイトル付リスト)を使う ・shortdescを記してタイトルを補足する |
受け手にとって必要かどうかの判断を速やかにさせる |
大きすぎないパッケージ | 運びやすく場所をとらない段ボール箱を使う | 1テーマを過不足なく説明することができる最小サイズのtopicを作る | 小ぶりのほうが受け手にとって使い易い(理解しやすい) |