2009年11月8日日曜日

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

おわりに

Webベースでドキュメントを作ろうと思ったときの選択肢としてはWiki、CMSなんかもあります。(もちろんBlogもありますし直接HTMLで作るのも当然ありです。)
ドキュメントの管理を考えるとDocBookがいいのかなと思っています。
ただ手軽さには難があるかなというのが正直なところです。
あとドキュメントの内容に比べてファイルが長くなるかなとも…
それで管理と手軽さでいくと結局、Wikiが無難なのかも?

今回はANTを使ってビルドしましたがMavenとmaven-jdocbook-pluginを使う方法もあります。(こちらの方法が正攻法だと思います。)
今回の方法はmaven-jdocbook-pluginの処理をantで書き直したような感じになると思います。
またの機会にmaven-jdocbook-pluginについてもまとめてみたいと思います。
参考
http://www.exacteye.com/docbook.html
http://www.docbook.org/tdg5/en/html/docbook.html
http://docbook.sourceforge.net/release/xsl/current/doc/index.html
http://www.sagehill.net/docbookxsl/index.html
http://xmlgraphics.apache.org/fop/0.95/fonts.html