2009年11月8日日曜日

JBossのテンプレートでDocBook - (2/8) -

準備する

ライブラリーとスタイルシートをダウンロードします。

DocBookテンプレートはJBossのMavenリピジトリからダウンロードします。

DocBookスタイルシート docbook-xsl-1.75.2.zip
DocBookテンプレート jbossorg-docbook-xslt-1.1.0.jar
jbossorg-jdocbook-style-1.1.0.jdocbook-style
フォント jbossorg-fonts-1.0.0.jdocbook-style
(さざなみフォント)
XSLTプロセッサ saxon6-5-5.zip
ライブラリー Xerces-J-bin.2.9.1.zip
fop-0.95-bin.zip
highlight-1.0.0.jar
jhighlight-1.0.jar
ビルドツール Ant 1.7
※antコマンドが実行できるように設定しておいてください。
XalanとSaxon
JBoosのDocBookテンプレートを使ってDocBookを作成する場合、 XSLTプロセッサはSaxonを選択する方が無難かも?
highlightライブラリーを使って拡張変換処理をしているみたいで、この処理の実行時にXalanではエラーになってしまう。
xslファイルのネームスペースを利用して拡張変換処理クラスの処理を有効にするのだけれど
ネームスペースの指定方法がSaxonとXalanでは違っていてXalanので設定の仕方がよく分からなかった。
適当な場所に作業フォルダー(C:\mybook)を作り、ダウンロードしたファイルを配置します。
  • C:\mybook
    • doc
      • inc
        • HelloWorld.java
      • book.xml
      • chapter.xml
    • html
    • lib
      • fop-0.95
        • fop.bat
      • saxon6-5-5
        • saxon-jdom.jar
        • saxon-xml-apis.jar
        • saxon.jar
      • xerces-2_9_1
        • xercesImpl.jar
      • highlight-1.0.0.jar
      • jhighlight-1.0.jar
    • pdf
    • resources
      • docbook-xsl-1.75.2
        • fo
        • xhtml
      • j-docbook-fonts
        • fonts
      • j-docbook-style
        • images
          • images
            • community
            • my-image.png
      • j-docbook-xslt
        • xslt
    • build.xml
    • fop.xconf
jbossorg-fonts-1.0.0.jdocbook-style は拡張子を *.zip に変更して解凍します。
フォルダ名をj-docbook-fontsに変更して配置します。
jbossorg-jdocbook-style-1.1.0.jdocbook-style は拡張子を *.zip に変更して解凍します。
フォルダ名をj-docbook-styleに変更して配置します。
jbossorg-docbook-xslt-1.1.0.jar は拡張子を *.zip に変更して解凍します。
フォルダ名をj-docbook-xsltに変更して配置します。
fop.xconfはlib/fop/conf フォルダにあるファイルをコピーします。
docフォルダにソースドキュメントを作成します。
resources/j-docbook-style/images/imagesフォルダに ドキュメント作成に使うイメージファイルを配置します。
ビルド後、htmlフォルダにhtmlファイルが出力されます。
ビルド後、pdfフォルダにpdfファイルが出力されます。