DocBookによるドキュメント作成：CodeZine
はじめに DocBookはテクニカルドキュメントをXMLで作成するためのOASIS標準で、SpringやHibernateのドキュメントはDocBookで生成されています。DocBookは特にコンピュータ関連のコンテンツに適しており、テクニカルコンテンツ用のDTD（Document Type Definition）とXMLスキーマによって定義された一連のXMLタグで構成されています。DocBookおよびその他のオープンソースプロジェクトには、DTDの他にも、DocBook対応のXMLをPDF、HTML、Eclipse Help、およびMANページに変換できるようにするツールとフレームワークのコレクションが用意されています。これにより、同じマテリアルを何度も記述したり、手動で形式を変換したりする手間を多少緩和することができます。 「そんな大騒ぎするほどのことでもないね。必要ならHTMLでもE
Neverbird - JBoss FAN:DocBook文書を日本語で書く
JBoss ManualにならってJBoss FANの文書をDocBook形式のXMLで書くことにしました。XMLで書いておけば、機械的にHTMLやXHTMLに変換したり、目次や索引を自動作成することができます。フリーのDocBookツールはいくつかありますが、Norman Walsh氏のDocBook XSLTスタイルシートを使うことにします。これとXalanのようなJava上で動作するXSLTプロセッサを組み合わせればJava版のDocBookツールができあがります。XSLTを使う理由はそのカスタマイズの容易さです。たとえば、各文書のフッタにコピーライトを入れるようなことをXSLTのテンプレートを書くことで実現できます。この文書では、DocBookの導入方法とDocbookで日本語文書を書くポイントをまとめてみます。 DocBook XSLスタイルシートは、古いバージョンではlinkや
DocBookを使ってみる
DocBookはコンピュータ技術系のドキュメントを記述するために定義されたXMLフォーマットの1つです。 DocBookのスキーマに従って記述されたXMLファイルは、XSLでHTML等のファイルに変換されます。 近頃はDocBookで記述されたドキュメントも珍しくなくなりました。 DocBookを使う理由としては次のようなものがあると思います。 文書構造が保たれる 章、節、段落、箇条書き等、文章構造を示すタグを使用することで、文章構造を意識した文章を記述することができます。 文章とデザインが分離される ドキュメントのデザインはXSLによる変換時に付加されます。 文章の作成者は見た目のデザインを気にせず、文章に集中できます。 また機械的に文章が処理されるためデザインに統一感が出ます。 文章の部品化 XMLの外部参照の機能を利用して、文章を幾つかのファイルに分けることがで
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
