タイトルまんまなんだけど。
SphinxとPlantUMLとGulpとBrowser-Syncでドキュメントをサクサク書けるようにしてみた。
https://github.com/sonodar/sphinx-plantuml-browsersync
Windowsでも可。npmやpipのインストールでコケる場合はMSBuildにパスを通す必要があるかも。
以下、各要素の概要。
Sphinx
reStructureTextというMarkdownみたいな記法でドキュメントを生成するコマンドラインツール。Python製。
PlantUML
独自の記法(DSL)で記載したテキストをUMLの図に変換するコマンドラインツール。Java製。
Browser-Sync
HTMLファイル等の変更をリアルタイムにブラウザに反映させるNode.js製のライブラリ。
上記とGulpのファイル変更検知機能(watch)と併せて利用することでドキュメントを編集した内容がブラウザに即時反映されるようにしている。