Darwin 情報型アーキテクチャ

Darwin Information Typing Architecture ( DITA ) 仕様は、トピック指向の情報を作成および整理するための一連のドキュメント タイプと、ドキュメント タイプを組み合わせ、拡張し、制約するための一連のメカニズムを定義します。^{[1]これは、} OASIS DITA 技術委員会によって定義および管理されているオープン スタンダード^{[2]です。 [3]}

名前は次の要素に由来しています。

• ダーウィン：それは特殊化と遺伝の原理を用いており、それはある意味で博物学者チャールズ・ダーウィンの進化的適応の概念に類似している。
• 情報タイプ: 各トピックには、定義された主な目的 (手順、用語集のエントリ、トラブルシューティング情報) と構造があります。
• アーキテクチャ：DITAは拡張可能な構造のセットです。^[4]

トピックはコンテンツの再利用の基盤であり、^[5]複数の出版物で再利用することができます。トピック内のコンテンツの断片は、コンテンツ参照（conrefまたはconkeyref）というトランスクルージョンメカニズムを使用して再利用することができます。^[6]

DITA の最新バージョン (DITA 1.3) には、タスク、コンセプト、リファレンス、用語集エントリ、トラブルシューティングの 5 つの特殊なトピック タイプが含まれています。これら 5 つのトピック タイプはそれぞれ、タイトル要素、メタデータのプロローグ要素、および本文要素を含む汎用トピックタイプを特殊化したものです。本文要素には、 HTMLと同様に、段落、表、およびリスト要素が含まれています。

• タスクトピックは、タスクの達成方法を説明する手順を対象としています。これは、ユーザーが意図した結果を得るために実行する一連の手順をリストします。手順は、汎用 body 要素の特殊化である taskbody 要素に含まれています。steps 要素は、順序付きリスト要素の特殊化です。
• コンセプト情報はより客観的で、定義、ルール、ガイドラインが含まれます。
• リファレンストピックは、コマンド構文、プログラミング手順、およびその他のリファレンス資料を説明するトピックであり、通常は詳細な事実資料が含まれます。
• 用語集エントリトピックは、特定の用語の単一の意味を定義するために使用されます。このトピック タイプには、用語を識別して定義を提供するだけでなく、用語に適用される可能性のある頭字語や頭字語の展開とともに、基本的な用語情報も含まれる場合があります。
• トラブルシューティングのトピックでは、読者が修正したい可能性がある状態について説明し、その後にその原因と推奨される解決策の 1 つ以上の説明が続きます。

DITAマップは、コンテンツのコレクションを出版物に変換するために使用されるトピックのコンテナです。トピックに順序と構造を与えます。マップには、トピック間のハイパーリンクを定義する関係テーブル（reltables）を含めることができます。^[7]マップはネストすることができ、トピックや他のマップを参照したり、さまざまなコンテンツタイプやメタデータを含めることができます。

DITAには、トピックレベルと要素内の両方で、広範なメタデータ要素と属性が含まれています。 ^[8] 条件付きテキストを使用すると、オーディエンス、プラットフォーム、製品、その他のプロパティの属性に基づいてコンテンツをフィルタリングまたはスタイル設定できます。条件付き処理プロファイル（.ditavalファイル）は、条件付き処理に使用する値を識別するために使用されます。^[9]

DITA では、基本 DITA 要素と属性を特殊化することで、新しい要素と属性を追加できます。特殊化により、DITA は特定の業界や企業のニーズに応じて、新しいトピック タイプ、要素タイプ、および属性に対応できます。半導体業界などの特定の業界向けの DITA の特殊化は、 OASIS技術委員会または小委員会を通じて標準化されています。DITA を使用する多くの組織では、独自の特殊化も開発しています。

DITA の拡張性により、組織は特定の情報構造を定義して DITA を専門化し、標準ツールを使用して作業することができます。企業固有の情報アーキテクチャを定義できるため、企業は DITA を使用して、自社にとって意味のあるメタデータでコンテンツを充実させ、文書構造に関する企業固有のルールを適用することができます。^[6]

DITAコンテンツはトピックとして作成され、それぞれが個別のXMLファイルです。通常、各トピックは単一の目的を持つ特定の主題をカバーします。たとえば、概要を提供する概念トピックや、タスクの達成方法を説明する手順トピックなどです。^[10]コンテンツは、それが含まれるファイル構造に似た構造にする必要があります。^{[11] [12] [13]}

DITA マップおよびトピック ドキュメントはXMLファイルです。HTMLと同様に、出力に表示する必要がある画像、ビデオ ファイル、またはその他のファイルは参照によって挿入されます。DITAコンテンツの作成には、オーサリング時に必要なサポート レベルに応じて、任意のXML エディターまたはテキスト エディターを使用できます。専用エディターに搭載されているオーサリング支援機能には、WYSIWYGプレビュー レンダリング、検証、およびDITA-OTや ditacなどの DITA プロセッサーとの統合などがあります。

DITA は、エンドツーエンドのアーキテクチャとして設計されています。DITA 仕様には、DITA 言語の一部である要素、属性、ルールを示すだけでなく、DITA コンテンツを HTML、オンライン ヘルプ、印刷、コンテンツ配信プラットフォームなどの形式で公開するためのルールも含まれています。

たとえば、DITA 仕様では、要素Aのconref属性に要素Bへのパスが含まれている場合、要素Bのコンテンツは要素Aの場所に表示されると規定されています。DITA 準拠のパブリッシング ソリューション (DITA プロセッサ) は、指定された動作に従ってconref属性を処理する必要があります。条件付きテキスト、インデックス マーカー、トピック間リンクなど、その他の豊富な機能を処理するためのルールも存在します。DITA コンテンツを他の形式に変換し、DITA マークアップを解釈するための DITA 仕様の要件を満たすアプリケーションは、 DITA プロセッサと呼ばれます。

DITA は、ローカリゼーション属性グループを介して翻訳をサポートしています。要素の属性を設定して、要素のコンテンツを翻訳するかどうかを指定できます。要素コンテンツの言語を指定できるほか、書き方、インデックスのフィルタリング、最終形式に公開するときに挿入される用語も指定できます。^[14] DITA プロジェクトは、DITA-OT 用の DITA-XLIFF ラウンドトリップ ツール^{[15] [16]}や、 Swordfish Translation Editor や Fluenta DITA Translation Managerなどのコンピューター支援翻訳(CAT) ツールを使用して、 XLIFFファイルに変換し、元のマップとトピックに戻すことができます。Fluenta DITA Translation Manager は、OASIS の DITA Adoption TC が公開した記事「XLIFF を使用して DITA プロジェクトを翻訳する」で提案されている翻訳ワークフローを実装するように設計されたツールです。^[17]

DITA標準はOASISによって管理されています。最新（現在の）バージョンは1.3で、2015年12月に承認されました。DITA 1.3の正誤表文書は2018年6月に承認されました。^[18]

• 2001年3月IBMによるコアDTDとXMLスキーマ文法ファイルと入門資料の紹介^[19]
• 2004年4月OASIS DITA技術委員会が設立された^[20]
• 2005年2月IBMはオリジナルのDITA Open ToolkitプロジェクトをSourceForgeに寄贈しました。DITA標準とよく混同されますが、DITA-OTはOASIS DITA技術委員会とは提携していません^[21]
• 2005年6月 DITA v1.0がOASIS標準として承認
• 2007 年 8 月 DITA V1.1 が OASIS によって承認されました。主な機能は次のとおりです。
  • ブックマップの専門分野
  • コンテンツフィルタリングのためのDITAVAL構文の正式な定義
• 2010 年 12 月 DITA V1.2 が OASIS によって承認されました。主な機能は次のとおりです。
  • キーによる間接リンク
  • 新しいコンテンツ再利用機能
  • 頭字語を含む用語集のサポートが強化されました
  • 新しい業界の専門分野（トレーニング、機械）
  • 制御された値/分類法の新しいサポート (Subject Scheme の特殊化)
• 2015 年 12 月 17 日、DITA V1.3 が OASIS によって承認されました。主な機能は次のとおりです。
  • 仕様は現在、基本、^[22]、技術コンテンツ、^[23]、オールインクルーシブ（学習とトレーニングを含む）^{[24]の3つのパッケージで提供されています。}
  • 新しいトラブルシューティングトピックタイプ
  • スコープ付きキーを使用する機能
  • MathML、方程式、SVGをサポートする新しいドメイン
  • DITAの標準文法としてRelax NG XML構文を追加します。
• 2016年10月25日、DITA V1.3 Errata 01がOASISによって承認されました^[25]
• 2018年6月19日、DITA V1.3 Errata 02がOASISによって承認されました^[26]

<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> 
<map id= "map" xml:lang= "en" > <topicref format= "dita" href= "sample.dita" navtitle= "サンプル" type= "topic" /> </map>  
      

<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> 
<topic xml:lang= "en" id= "sample" > <title>サンプル</title> <body> <p> Hello World! </p> </body> </topic>  
  
  
   
  

<?xml version="1.0"coding="utf-8"?> 
<val> 
<prop att= "audience" val= "novice" action= "include" /> <prop att= "audience" val= "expert " action= "除外" /> </val>      
      

条件付きテキストの例:

<p>
  これはすべてのユーザー
にとって役立つ情報 です。 </p> <p audience= "novice" >これは初心者ユーザーにとって役立つ情報です。
 </p> <p audience= "expert" >これは専門家ユーザーにとって役立つ情報です。</p>     
 
         
 
          

• ドキュメントマークアップ言語の比較
• ドキュメントマークアップ言語のリスト

• OASISコンソーシアム公式サイト
• DITA 1.3 仕様
• DITA Open Toolkit 公式サイト