設計ドキュメント作成ツールとしてSphinxとReVIEWについて調べた - 勘と経験と読経

主に作業メモ。ソフトウェア開発プロジェクトでは多かれ少なかれ様々なドキュメントを作成する。一般的にはMicrosoft OfficeなどのOAソフト(つまりWordやExcel)で文書を作成するのだけれども、これが非常に管理し難い。本当はWikiなどで管理するのがいいのだけれども、「納品」とか「持ち出し」を考えたときに、Wikiサーバを立てるのはあまりうまくない。というわけで以前に少しだけチェックしていたドキュメント作成ツールについて改めて調べてみた。 Sphinx Python製のドキュメント生成ツールである。reStructuredText記法という文法で記述したテキストツールをCUIでコンパイルすると、HTMLやPDFなどの各種ドキュメントを生成してくれる。 インストールは非常に容易 (Windowsだが、他のOSでも簡単なのだと思う) reStructuredText記法は、Wik

[kgrock]

設計ドキュメント作成ツールとしてSphinxとReVIEWについて調べた

[kdmsnr]

トラップって何だろう。完成品としてのhtmlって何だろう。

[tak4hir0]

主に作業メモ。ソフトウェア開発プロジェクトでは多かれ少なかれ様々なドキュメントを作成する。一般的にはMicrosoft OfficeなどのOAソフト(つまりWordやExcel)で文書を作成するのだけれども、これが非常に管理し難い。本当はW