タグ

ブックマーク / gitpub.hatenablog.com (1)

  • Sphinxでのドキュメント作成をそれなりに快適に書く方法 - /dev/null

    前回書いた通り、ドキュメント作成にSphinxを使い始めています。 Markdownと違って単一のページを書くのはちょっと大仰な感じしますが、体系的なドキュメント書くのには構造がしっかりしている分いい感じ。 ところがMarkdownと違って書いてプレビューしたいなと思う度に make html するのは辛い。しかもその後ブラウザで開く必要あり。開いていてもリロード。 これではSphinx始めたてで、文法と文書がリンクできない人間にはちょっとつらい。 前回、コマンド一発でhtmlが吐かれるところまではできています。 SublimeText2でSphinx-Build - /dev/null これはあんまり苦じゃありません。そこまでbuildが遅いわけでもないので。大体1秒もあれば終わる。 あとはこれを自動でプレビューし変更を感知してリロードしてくれればそれなりに書ける環境が出来上がるのではな

    Sphinxでのドキュメント作成をそれなりに快適に書く方法 - /dev/null
  • 1