DocBookで技術ドキュメント記述
2004年11月14日(日) 06:52
使用してみた感じ
・構造を書けば良いので、ドキュメント類には適している模様
・xmlなのでhtmlやpdfの複数フォーマットへ変換が可能
・LaTex経由でpdfにするには、DocBookの他にLaTeXの知識が必要
・fo経由ではapache-foのバージョンが現在0.2であるため、殆ど機能がNotImplementedで使い物にならない
LaTeX経由でpdfにする際のメモ
・xmlからLaTeXに変換するためのxslはdb2latexを使用した
・db2latexで変換をすると、DocBookのprogramlistingがVerbatimになるので、変換後verbatimに全置換するかxslの該当部分を修正する必要が有る
・verbatimは段落を「入力されたまま」に表示するLaTeXのコマンドだが、使い勝手はいまいち。pythonのドキュメント用マクロ等を参考に修正した方が良い
・xslを実行する環境はいろいろ有るが、OSXであればxsltprocが手軽。殿環境でも使用可能なJavaではsaxonが一番うまくいった(xsltprocより良い)。XALANではうまくいかなかった。
・Windows／OSXでLaTeX環境を揃える場合は、LATEX 2ε美文書作成入門を購入するのが良い。CDに必要な物が殆ど入っていて、インストーラもついている。LaTexの解説も手に入る（せっかくだから下のリンクで買ってください^o^;）。
・構造を書けば良いので、ドキュメント類には適している模様
・xmlなのでhtmlやpdfの複数フォーマットへ変換が可能
・LaTex経由でpdfにするには、DocBookの他にLaTeXの知識が必要
・fo経由ではapache-foのバージョンが現在0.2であるため、殆ど機能がNotImplementedで使い物にならない
LaTeX経由でpdfにする際のメモ
・xmlからLaTeXに変換するためのxslはdb2latexを使用した
・db2latexで変換をすると、DocBookのprogramlistingがVerbatimになるので、変換後verbatimに全置換するかxslの該当部分を修正する必要が有る
・verbatimは段落を「入力されたまま」に表示するLaTeXのコマンドだが、使い勝手はいまいち。pythonのドキュメント用マクロ等を参考に修正した方が良い
・xslを実行する環境はいろいろ有るが、OSXであればxsltprocが手軽。殿環境でも使用可能なJavaではsaxonが一番うまくいった(xsltprocより良い)。XALANではうまくいかなかった。
・Windows／OSXでLaTeX環境を揃える場合は、LATEX 2ε美文書作成入門を購入するのが良い。CDに必要な物が殆ど入っていて、インストーラもついている。LaTexの解説も手に入る（せっかくだから下のリンクで買ってください^o^;）。
