ドキュメントを書かなくてはと書いてから早一ヶ月半も経つものの、一行も書いていなかったわけですが、ようやく書こうかなという気がおきてきました。
今回はDocBookで書いてみようと思っていたので、DocBook で文書を書こう！などを参考しにしながら、やってみています。
DocBookからHTMLへの変換は、docbook-xslを使うのが良さそうだったので、Cygwinでdocbook-xslとdocbook-xml-4.3、libxmlとlibxsltを入れました。単にHTMLにするだけならば、
xsltproc /usr/share/docbook-xsl/html/docbook.xsl doc.xml
でHTMLにできます。このままだと出力エンコーディングがISO-8859-1になっているために、日本語がすべて文字参照になってしまうので、/usr/share/docbook-xsl/html/docbook.xslの中でxsl:outputでencodingを指定している部分をutf-8などにしておいた方が良さそうです。