デジタルドキュメントシンポジウム2009

DITAによるコンテンツの構造化・再利用のメリット
加藤哲義
DITAコンソーシアムジャパン事務局長
XMLコンソーシアム エバンジェリスト
株式会社ジャストシステム
tetsuyoshi.kato@justsystems.com© DITA Consortium Japan, Tetsuyoshi Kato 2009

２００９年１１月２７日
1

DITAコンソーシアムジャパン
http://dita-jp.org/

2

XMLコンソーシアム

http://www.xmlconsortium.org/

3

アジェンダDITAによるコンテンツ制作の姿
DITAによるコンテンツの構造化と再利用
DITAのトピックライティング
まとめ4

DITAによるコンテンツ制作の姿

5

DITAとはDarwin Information Typing Architecture OASIS （構造化情報標準促進協会）が策定する、文書情報の制作、管理、活用のための、XMLに準拠したアーキテクチャ。


2001年
2004年
2005年5月
2007年8月

IBMが社内文書用SGML後継技術として開発
DITA仕様書をOASISに寄贈
OASIS DITA1.0仕様承認
OASIS DITA1.1仕様承認

6

ありがちな文書制作 ＝ 一刀彫りのように文書を作る職人（ワープロ、DPT）

作品（文書）

文書単位で完結している
使い回しが効かない
制作工程はシーケンシャル
様式、体裁、用語は人依存
7

DITA＝文書をコンポーネント化し、分業制作する仕組み
構成設計

作業者の割り当て
同時進行の分業

パーツの蓄積と管理

アセンブリ

一刀彫りに比べて工程が多いが・・・
8

新らしいバージョン「考える茶髪の人」の制作は？
構成設計

作業者の割り当てパーツの蓄積と管理アセンブリ

頭部パーツだけ入れ替え、あとはそのままでアセンブリ
茶髪の頭部だけ作る

変更無し
新バージョンの出来上がり

9

新しい作品「ダビデ像」の制作は？
構成設計

作業者の割り当て同時進行の分業

パーツの蓄積と管理アセンブリ

腕と台は「考える人」のパーツを流用してしまう。

10

DITAによる文書制作・パブリッシングの流れ
文書内容（トピック）構成情報（マップ） 出力様式（XSLT）「DITA入門」
Topicとは

MapとはDITAとはDITAとは組版用
スタイル変換

Mapの構成方法「DITA入門」
PDFPDF

Topicとは
Mapとはオンラインヘルプ用

スタイル変換Topicのコーディング

アウトプット「DITAによる制作手法」「DITA入門」
オンラインヘルプ

DITAとはTopicのコーディング
Mapの構成方法

HTML用
スタイル変換｢DITAによる制作手法」

Webマニュアル

11

マップ（文書構成）

トピック（文書内容）

ＤＩＴＡ専用エディタ「XMetaL Author」（ジャストシステム）の 画面例（http://www.justsystems.com/jp/services/jdita/index.html）

要素12

「DITA入門」のマップ

マップ

トピック

「DITA入門」マップ（DITA入門.ditamap）のソースコード

使用ソフト：xfy DITAエディタ(ジャストシステム） 以下同様。

(http://just-enterprise.com/product/xfy/dita.html)
13

トピック内容の記述

14

「トピックとは」のソースコード

データモデル「DITA入門」マップをOpenToolkitでPDF
やHTMLに出力すると

15

PDF出力例

マップの情報から表紙、目次、索引、章立て、各ページ内容がスタイル付けされ、出力される。

16

PDF出力例

17

HTML出力例

18

DITAによるコンテンツの構造化と再利用

19

DITAの三権分立
従来型のＸＭＬボキャブラリはここが分かれていない。

文書内容

構成情報

トピック

マップ

出力様式
XSLT
CSS

この分立と組合せによる再利用性の向上

20DITAの構造化とは（１）

文書内容（トピックコンテンツ）の構造化（情報タイプ）



文書自体の構造化（コンテンツモデル）
 文書構成（マップ）の設計
 内容（トピック）粒度の設計

21

情報タイプ

伝えるべき情報の性格に応じて、トピックの情報タイプを選択
Generalization（一般化）
基本トピックコンセプト・トピック

タスク・トピック

リファレンス・トピック

概念・言葉解説

作業手順解説コマンド・API一覧

グロサリー・トピック
用語集

Specialization（特殊化）22基本トピックのXML構造
基本トピック
タイトル
概要・結論
本文

XML準拠の要素（タグ）で表される。

リンク
セクション
段落タイトル

箇条書き

段落表

23

特殊化されたタスクトピックのXML構造
タスクトピック

基本トピックから特殊化された要素

タイトル
概要・結論
タスク本文
必要条件
リンク
背景
ステップ

指示
結果
事後確認

結果
24

要素（タグ）による構造化のメリット


出力スタイルの設定（XSLTによる要素変換）
 スタイルの統制 いわゆるワンソースマルチユース

ファイル横断的な要素の検索、更新、追加 （ファイル単位より細かい）要素単位での部品化、再利用 要素単位での更新履歴管理

情報タイプによる記述構成の統制
 構造が決まっているので、書きやすく、読みやすい。

25

DITAの構造化とは（２）

文書内容（トピックコンテンツ）の構造化（情報タイプ）



文書自体の構造化（コンテンツモデル）
 文書構成（マップ）の設計
 内容（トピック）粒度の設計

戦略性が必要

再利用性（部品化）の可能性
今後の更新の可能性
階層化の可能性担当ライターの割り当て
26

トピック再利用のパターン
・トピックファイルの再利用（topic reference）

共通性の高い内容を独立したトピックファイルにして、マップやトピックから参照

・トピックコンテンツの一部を再利用 （content reference)
あるトピックから別のトピック内容の一部を参照

・条件によってトピックコンテンツの一部を選択的に再利用（conditional text)
製品名などの候補文字列から動的な選択
出版時に最適な部分を選択出力
27

topic referenceの例
マップ
サブマップ
マップから参照されるトピック

トピックから参照されるトピック

実体ファイルのないタイトルだけのトピック

28

conditional text の例
使用エディタ ： 「XMetaL Author」（ジャストシステム） 以下、同様。
（http://www.justsystems.com/jp/services/jdita/index.html）

Windows向けマニュアル

Linux向けマニュアル

製品名やOS、対象とするユーザの種類などの条件を判断して出力する内容を自動的に切り替えることが可能。
例：OSごとに異なる動作環境を自動出力する
29
29

content referenceの例

他のトピック内容の一部を参照し利用する。
例：既存のトピックに記載されている動作環境の表を挿入する

30

DITAのトピックライティング

31

ブック指向からトピック指向へ 従来の文書・・・ブック指向
 書籍の体裁で提供することを目的とし、章・節・項の構成を有する
 DITA文書・・・トピック指向
 意味を成す最小粒度の独立した文書部品であるトピックの組み合わせで作られる

32

トピックベースの読者
インターネット時代、ユーザは自分に必要なトピックを拾い読みし、関連性（リンク）で、任意に知識を拡張していく癖がついてきた。

第一章

第二章

Topic

Map

第三章
順序性に拘束される
ブック指向

ネットワーク型のトピック指向
33

トピック・ライティングのポイント
・１トピックに１テーマ （トピック間の依存性を排除）
・より簡潔に、かつ無駄なことは書かない
・正確な単語を吟味して使う （ユーザは単語でトピックを検索する）
・ライターは内容（topic）の執筆に、編集者は構成（map）の工夫に、それぞれ専念する。

34

まとめ35

DITAのメリット
 読み手にとってのメリット 記載内容の主題、目的、構造が明確なので理解が早い トピック単位に理解を進め得る
 求める情報に辿り着きやすい 情報の取捨選択が容易

36

DITAのメリット 書き手にとってのメリット トピック化により記載すべき主題、目的、内容が明快
 マップにより、自分が受け持つトピックの背景、位置付けが明快
 情報タイプによって構造が決まっているので内容に専念できる
 見映え、体裁は一切考慮せず内容に専念できる 誰かがすでに記載した類似トピックを検索し、参考にできる

37

DITAのメリット

 管理者にとってのメリット 執筆、翻訳、承認がトピックベースにコンカレントにできる 既存トピックを使い回すことで生産性が向上
 レビューフローを効率化できる（コンテンツへのダイレクトコメント）
 改訂管理、版管理が容易になる
 文書品質の標準化が容易になる

38

DITA（コンポーネント・パブリッシング）によるパラダイムシフト
構成者、執筆者、体裁デザインの分離
マップ制作者の重要性

WYSIWSGとの決別

コンポーネント化

徹底した再利用化と統制トピック・ライティング
データベース管理

版管理、履歴管理

・共通部品化・多言語化
・多様な出力フォーマット
・コンテンツの横断的流用

分業同時進行平準的表現用語・統制

タスク管理

制作プロセスのリエンジニアリング

文書制作はオブジェクト指向システム開発のスタイルに近づいていく 39

DITAの投資対効果が重要
分業制作が必要な大規模文書（一冊で1000ページとか）版改訂が多い文書（最低1年に1～2回とか）定型的なレイアウトでいい文書（B2CよりB2B文書）
一つの内容を多様な出力形態にする場合（PDFとHTMLとか）一つの内容を多国語化する場合（20カ国語版とか）
B2B（業界内、海外、経営統合など）でコンテンツを交換する事態

ROI

プロセス改革
役割の変化
ライティング方法の変化
既存文書のトピック化
自動組版への対応
システム投資40

DITAはマニュアル制作に留まらない
OASISで検討中の特殊化分野
学習・トレーニング教材（DITA 1.2で採用）
DITA Learning and Training Content Specialization Sub-committee

機械工業（DITA 1.2で採用）

DITA Machine Industry Specialization Sub-committee

半導体DITA Semiconductor Information Design Sub-committee

一般企業文書DITA for Enterprise Business Documents Sub-committee

ヘルプ・システム
DITA Help Sub-committee

技術標準仕様
DITA for Technical Standard

41

企業コンテンツの核が無いため文書は散在
ﾏｰｹﾃｨﾝｸﾞ

カスタマーサポート

企画
販売促進
設計
教育

試作
生産マニュアル42

DITAは企業コンテンツのハブになり得る
ﾏｰｹﾃｨﾝｸﾞ

カスタマーサポート

企画
販売促進

DITA

設計

教育

試作
生産マニュアル43

お問い合せDITAコンソーシアムジャパン 事務局
TEL : 03-5412-8330
E-Mail : info@dita-jp.org
http://www.dita-jp.org
107-8640
東京都港区北青山1-2-3 青山ビル7F
株式会社ジャストシステム 新規事業企画開発部内
TEL:03-5412-8277

http://www.justsystems.com/jp/services/jdita/index.html※本書に記載されている商品名、会社名などの固有名詞は、各社の商標及び登録商標です。
※本書の著作者はDITAコンソーシアムジャパンおよび加藤哲義となります。
44