■

23:22

reStructuredText入門 — Sphinx v1.0 (hg) documentation

プログラムのドキュメント作成のために軽量マークアップ言語を探し中。GitHubで使われてるMarkdownもいいけど、Python公式ドキュメントに使われてるreStructuredTextも良さげ。Sphinxていうツールを使えば、HTMLやPDF、ePubで出力できるらしい。

23:26

インデントによって、プレーンテキストに論理構造を作る。という書式が、僕は大好きみたい。Pythonしかり、YAMLしかり、reStructuredTextしかり。プレーンテキストだと、過去との差分が取りやすい。インデントで、ぱっと見で構造を把握しやすい。あたりが大きな利点か。