DocBook

ドキュメント作成ツールの検討(Sphinx、ReVIEWとか)

今後、マニュアルを書いてメンテナンスも継続的にしていく機会が丁度ありそうなので、現時点(2012/05/02)でどのツールが自分たちにフィットするか検討してみた。ツールの候補は以下。なお、過去の仕事ではWordとDocBookは経験あり。 Word DocBook Sphinx ReV…

Mavenを使った簡単DocBook入門

先ほど、DocBookは最終的な成果物であるHTML、PDFに変換できるようになるまで大変と書きました。しかし、Mavenを使うとそれも簡単になってきています。 JBoss.orgが提供している、maven-jdocbook-pluginを利用した、超簡単方法について紹介したいと思います…

意外と乱立しているmaven-docbook-plugin

http://www.jboss.org/maven-jdocbook-plugin/ JBoss.orgによる実装 JBossのプロダクトで使われている。SeamとかHibernateとか。 JIRAに辿れなかったけどググったら https://jira.jboss.org/jira/browse/MPJDOCBOOK のよう 最近はあんまり更新なし http://co…

PDFへの変換

DocBookからPDFに変換する方法を模索中。 Apache FOPを使ってみたけど、色んな所で書かれているように微妙。やっぱりTex最強っぽい?というわけで、DocBook->Texへの変換方法を調べてみる。参考になりそうなところ。 db2latex http://db2latex.sourceforge.n…

Visual DocBook Editorを試してみた

MacBookで試してみた。eclipse-europa-fall2では、以前日記に書いた通り、MacではVisualPageEditorが正常に動かないので、eclipse-europa-winterをベースとしたJBossToolsで実験。手順 eclipse-europa-winterをインストール JBossTools2.0.1.GAをインストー…

Visual DocBook Editor

In Relation To...におもしろい記事が。 HowToCreateAVisualDocBookEditorIn10Minutes JBossToolsのVisualPageEditor(XHTMLなどをビジュアルに編集できるJBoss Tools HTML Editorです)を利用して、DocBookのビジュアルエディタを作ったという内容。例えば、…