1. ホーム
  2. Web制作
  3. XML/XSLT

XMLおばちゃん″スピナー:DocBook XM

2022-01-12 18:16:49

ドキュメントを書き、それをさまざまな出力形式で作成する機能は、多くの開発チームの長年の夢でした。DocBookで XML は、セマンティックマークアップだけでなく、資料のフォーマットと出力の制御も維持します。
コントロールセマンティクスでは、文書を構成するセクションや段落を指定することができる。段落に含まれる項目は、さらに細かく指定することができる。例えば、リスト8に示すように、コマンド名と関数名を別々のタグに配置することができます。
リスト8. コマンドと関数を別々のタグでラップする
<para>The <command>compile</command> はそのソースコードを受け取ります。 を作成し、ファイル名に基づいて新しいクラスを構築します。例えば、ファイル名が <filename>HelloWorld</filename> とすると、生成されるクラスの名前は次のようになります。 <classname>HelloWorld</classname> となります。
異なる要素を表示する際に、異なる出力スタイルやフォーマットを選択することも、同じスタイルを選択することも可能である。さらに重要なのは、意味的な情報が返されるため(たとえば、ドキュメントにクラス名への参照が含まれている場合がある)、インデックスを書く際にリスト(ドキュメントに詳述されているすべてのクラス名を含む)を生成するために使用することができることである。
セマンティックタグに加えて、セクションや文書のさまざまな部分に特別なIDを付けて、文書のさまざまな部分へのリンクを確立することができます。いくつかのタイプ(セクション、パート、および目次を生成するその他のタイプ)は自動的に実行できますが、他のパートへのリンクを明示的に確立する必要があるものもあります。
これらのリンクは、変換先のフォーマットに変換する際に、自動的に適切なフォーマットに変換することができます。例えば、リンクは適切な HTML ページに変換されるか、ページ内のアンカーへのリンクに変換されます。PDFを生成する場合は、ターゲットセクションのページ番号を含めることができます。
この変換は、XSLTスタイルシートによって行われる。既存の標準DocBook XSLTスタイルシートは標準HTML、XHTML、PDF(FO標準経由)、Texinfo、Java Help、Manページへの変換をサポートしています。また、データは標準スタイルシートを用いて、様々なサイズやスタイル、ブック、A4ページ、スライドに変換することができます。
様々な出力形式とマークアップの柔軟性により、ドキュメント作成時に同じドキュメントソースコードを使用して、印刷マニュアル、インラインヘルプ、マンページ、オンラインおよびコンテキストを認識した情報を提供することが可能です。より伝統的なモデルでは、これらの要素は別々に記述することができます。
ドックブック XML 技術論文のコミュニティで広く受け入れられており、多くの企業がすべてのドキュメントにDocBookを使用している XML 規格(またはそのサブセット)。