DITA 入 門 DITA 概 要 と 主 要 な 機 能 について 2011 年 6 月 27 日 DITAの 背 景 Darwin Information の 略 Typing 技 術 文 書 の 生 成 および 管 理 仕 様 2005 年 5 月 OASIS 3 日 として 標 準 承 認 情 報 のモジュール 化 と 再 利 用 がテーマ 2010 年 12 V1.2 月 1 日 が 承 認 2 AntennaHouse, Inc. 2011 1
DITAの 構 成 (トピックとマップ) マップ HTML 用 トピック トピック マップ 社 内 向 けPDF 用 マップ EPUB 用 トピック トピック マップ 社 外 向 けPDF 用 3 AntennaHouse, Inc. 2011 トピックとは 見 出 しと 内 容 をもつ 情 報 の 単 位 ( 原 則 1ファイル1トピック) ひとつ 質 問 ("How do?", "What is?", "What went に 対 して 答 えるもの 十 分 に 短 く かつ それ 自 身 で 意 味 が 分 かる 程 度 に 長 いもの 4 AntennaHouse, Inc. 2011 2
マップとは 個 々のトピックが どのように 結 合 され ネストされるか を 決 める 階 層 構 造 目 次 やアウトラインに 相 当 する 情 報 5 AntennaHouse, Inc. 2011 DITAの 特 徴 ( 要 素 ) generic Topic(DITAにとって 最 も 基 本 的 な 情 報 タイプ) <topic> <title>トピックの 見 出 し</title> <body> <p> <ul> <ol> <image> <table> <section>...etc HTMLと そっくり 6 AntennaHouse, Inc. 2011 3
DITAの 特 徴 ( 構 造 ) DITA マップ タイトル トピック タイトル 本 文 DocBook ブック タイトル チャプター タイトル 本 文 別 の 所 でも 再 利 用 しやすい トピック タイトル 本 文 ここだけ 抜 き 出 すのは 難 しいかも チャプター タイトル 本 文 7 AntennaHouse, Inc. 2011 リンクのいろいろ <xref> 要 素 HTMLの<a> 要 素 に トピックの 相 当 最 後 にまとめ 比 較 的 自 由 に 書 ける て 書 く <xref> <xref> <related-links> 要 素 <related-links> <link> <link> 8 AntennaHouse, Inc. 2011 4
マップでリンク 関 係 を 表 現 <topicref href="a.dita"> <topicref href="a1.dita"/> <topicref href="a2.dita"/> </topicref> <reltable> <relrow> <relcell>a.dita</relcell> <relcell>b.dita</relcell> </relrow> </reltable> 目 次 に 相 当 する 部 分 関 連 テーブル 9 AntennaHouse, Inc. 2011 関 連 テーブル(1) トピック 間 の 関 連 をマップに 記 述 concept task reference 製 品 概 要.dita ラジオの 聴 き 方.dita 音 楽 ファイルの 再 生.dita リファレンス 編.dita 新 機 能.dita 製 品 概 要.dita ワンセグの 視 聴 方 法.dita リファレンス 編.dita トピックにではなくマップに 具 体 的 には 10 AntennaHouse, Inc. 2011 5
関 連 テーブル(2) <reltable> <relheader> <relcolspec type="concept"/><relcolspec type="task"/><rel </relheader> <relrow> <relcell> <topicref 製 品 概 要 href=".dita "/> </relcell> <relcell> <topicref ラジオの href=" 聴 き 方.dita "/> <topicref 音 楽 ファイルの href=" 再 生.dita "/> </relcell> <relcell> <topicref リファレンス href=" 編.dita " linking=" targetonly "/> </relcell> </relrow> <relrow> <relcell> <topicref 新 機 能.dita href=" "/> <topicref 製 品 概 要 href=".dita "/> </relcell> 11 AntennaHouse, Inc. 2011 もうひとつのマップ(ブックマップ) 印 刷 書 籍 用 のマップ <bookmap> <booktitle> 書 籍 のタイトル</title> < <frontmatter>... 前 付 け <chapter>... 章 <chapter> 印 刷 物 ならではの 構 造 が 書 ける <appendix>... 付 録 <backmatter>... 後 付 け...etc 12 AntennaHouse, Inc. 2011 6
特 殊 化 (1) 情 報 タイプを 追 加 できる HTMLっぽい 基 本 トピック topic glossary concept MYconcept より 専 門 的 に task reference MYtask 13 AntennaHouse, Inc. 2011 特 殊 化 (2) concept 情 報 タイプ それは 何 か という 問 いに 答 える 例 製 品 概 要 はじめに...etc task 情 報 タイプ 手 順 を 記 述 例 電 源 の 入 れ 方 予 約 録 画 の 仕 方 reference 情 報 タイプ 機 能 や 仕 様 の 記 述 例 関 数 仕 様 部 品 仕 様 glossary 情 報 タイプ 用 語 集 を 記 述 MYtask 情 報 タイプ 自 社 製 品 専 用 の 操 作 手 順 を 記 述 14 AntennaHouse, Inc. 2011 7
トピック 再 利 用 の 方 法 複 数 のマップを 使 う conref を 使 属 う 性 条 件 処 理 を 使 う その 他 (keyref) DITA 1.2 から 15 AntennaHouse, Inc. 2011 複 数 のマップを 使 う はじめに.dita 下 位 モデル.map 電 源 を 入 れる.dita 本 製 品 の 特 徴.dita 音 楽 を 聴 く.dita 充 電 する.dita 問 合 せ 先.dita ラジオを 聴 く.dita 上 位 モデル.map 録 音 する.dita 16 AntennaHouse, Inc. 2011 8
conref 属 性 を 使 う <title> 商 標 の 注 記 </title> トピックファイル <conbody> <ul> 電 子 書 籍 端 末 の 紹 介 <li tm_ipad id=" "> 電 子 書 籍 端 末 には ipad Kindle ipad はアップルの 登 録 商 標 です GALAPAGOS 等 多 数 があります </li> <li tm_kindle id=" "> Kindle はアマゾンの 登 録 商 標 商 です 標 および 登 録 商 標 </li> <ul> <li conref ="tm.dita #tm/ tm_ipad "/> <li tm_gala id=" "> <li conref ="tm.dita #tm/ tm_kindle "/> GALAPAGOS はシャープの 登 録 <li conref ="tm.dita #tm/ tm_gala "/> 商 標 です </ul> </li> </ul> </conbody> tm.dita concept @id="tm" 17 AntennaHouse, Inc. 2011 条 件 処 理 を 使 う(1) トピックの 中 の 特 定 のコンテンツを 条 件 ( 読 者 層 プラットフォーム 等 製 )により 品 出 力 結 果 を 変 える コンテンツを 出 力 する/しない(フィルタリング) コンテンツに 画 像 を 付 け 加 える/ 加 えない(フラッギング) 18 AntennaHouse, Inc. 2011 9
条 件 処 理 を 使 う(2) <note product =" 上 位 モデル"> 充 電 が 完 了 するのに30 分 程 かかります 度 </note> <note product =" 下 位 モデル"> 充 電 が 完 了 するのに60 分 程 かかります 度 </note> <note> 充 電 中 は 電 源 を 入 れないでください </note> <prop product att=" " val=" 上 位 モデル" action=" " /> include <prop product att=" " val=" 下 位 モデル" action=" " /> exclude 上 位 モデル.ditaval 充 電 時 間.dita 取 扱 説 明 書 ( 上 位 モデル) 充 電 が 完 了 するのに30 分 程 度 かかります 充 電 中 は 電 源 を 入 れないでください 19 AntennaHouse, Inc. 2011 その 他 (keyref) リンク 先 のリダイレクト トピックファイル 最 新 情 報 は 下 記 を 参 照 してください keyref ="lastinfo " /> <link 2010 年 用 のマップファイル <topicref keys="lastinfo" href="www.aaa.2010.html" scope="external" /> 2011 年 用 のマップファイル <topicref keys="lastinfo" href="www.aaa.2011.html" scope="external" /> 最 新 情 報 は 下 記 を 参 照 してください www.aaa. 2010.html 最 新 情 報 は 下 記 を 参 照 してください www.aaa. 2011.html 20 AntennaHouse, Inc. 2011 10
付 録 DITAをPDFにするには DITA Open を 使 います Toolkit PDFだけでなく XHTML HTML Help Eclipse Help Java Help...etc 入 手 先 http//sourceforge.net/projects/dit 21 AntennaHouse, Inc. 2011 付 録 Open Toolkit がやってくれること トピックファイルや 画 像 等 の 素 材 集 をめる audienceやproductなどの 条 件 処 理 属 性 を 解 決 する フラグメント 単 位 の 再 利 用 (conref 属 性 )を 解 決 マップファイルを 基 にトピックファイルをまとめる PDF(など)を 出 力 などなど 22 AntennaHouse, Inc. 2011 11
付 録 DITA Open Toolkit を 起 動 する 1. startcmd.bat を 実 行 して 2. DOS 窓 から ant -Dargs.input= MyMap.ditamap -Dtranstype= pdf と 入 力 するだけです マップの 指 定 他 にもいろいろ 起 動 時 オプションがあります 23 AntennaHouse, Inc. 2011 12