差分
この文書の現在のバージョンと選択したバージョンの差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
programming:python:sphinx:start [2011/07/27 01:45] yuki |
— (現在) | ||
---|---|---|---|
ライン 1: | ライン 1: | ||
- | ====== sphinx ====== | ||
- | pythonベースのドキュメント整形言語。とでも言えばいいのか。 | ||
- | * 公式 | ||
- | * http://sphinx.pocoo.org/ | ||
- | * http://sphinx-users.jp/ | ||
- | * 翻訳文書 | ||
- | * http://sphinx.shibu.jp/ | ||
- | |||
- | * Windowsで開始 | ||
- | * http://sphinx-users.jp/gettingstarted/install_windows.html | ||
- | * 割と書いてある通り。Python 2.7.2でも順当に動く。 | ||
- | * "make html"とだけ書いたバッチファイル作って楽しよう。 | ||
- | * _build/htmlの中身にショートカット作って楽しよう。 | ||
- | * バージョン管理はsubverionとかgitとかMercurialとか? | ||
- | * 例 : http://togakushi.bitbucket.org/bitbucket.html | ||
- | |||
- | * 描画補助 | ||
- | * Sphinxは、何故か文字列こねくり回してダイアグラム書いちゃおうぜ、なノリが実装されてる。 | ||
- | * まずは試してみる | ||
- | * http://interactive.blockdiag.com/ | ||
- | * いろいろ書いてある | ||
- | * http://docs.ssm.myz.info/yakumo3/index.html | ||
- | * blockdiag | ||
- | * http://blockdiag.com/blockdiag-ja/build/html/index.html | ||
- | * ブロックダイアグラム生成ツール。 | ||
- | * windowsで使用する場合は、今でも問題が起きるかもしれない。 | ||
- | * http://99blues.dyndns.org/blog/2011/01/blockdiag_for_win/ | ||
- | * 文字の折り返しってどうやるんだろう。 | ||
- | * 文字量に応じてサイズを可変にするのってどうやるんだろう。 | ||
- | * seqdiag | ||
- | * シーケンス図生成ツール | ||
- | * actdiag | ||
- | * 業務フロー生成ツール | ||
- | * nwdiag | ||
- | * ネットワーク図生成ツール | ||
- | * graphviz | ||
- | * 単品でも割と有名なダイアグラム生成ツール | ||
- | * DOT言語使うアレ |