でザイナーらしからぬ

でなりの雑記。ツイッターで済ませたくないこと書くとこ。

DjangoのdocstringやらなんやらをSphinxで吐き出してもらう

Python 始めました。

割と小ネタです… だいぶ初歩的な部分で詰まっていたので書きます。

目的

  • Djangoで書かれたプロジェクトの開発者向けのドキュメントを用意したい

やり方

コマンドライン上で下記をとりあえず実行

sphinx-apidoc -fF -o path/to/docs path/to/source '

そこで、path/to/docsの中にできたconf.pyの

# sys.path.insert(0, os.path.abspath('.'))

を、下記のように書き換える

sys.path.insert(0, os.path.abspath('../../path/to/source'))
from django.conf import settings
settings.configure()

その後、下記を実行

sphinx-build -a -b html path/to/docs path/to/docs/html '

そうするとpath/to/docs/htmlにいい感じのドキュメントができる(っぽい)

参考サイト

Sphinxの最初の一歩 — Sphinx 1.3.2 ドキュメント

www.marinamele.com

本読む宣言。

ブログのタイトルを厨二な感じに変えた。思いつき。

ところで、

www.amazon.co.jp

ポチった。 今月中に読んじゃう。 感想とか認めちゃう。

Excel「火曜は金曜」

また小ネタです。 いいじゃないか、小ネタ。

MacのExcel2008で、

名前 曜日 結果
hoge B
fuga C
piyo D
foo E

みたいな感じで、曜日ごとに特定の値を出力したかった。 実際はもうちょっと複雑な出力を行うものだったけど。

=LOOKUP(<結果列のセル>,{"月","火","水","木,"金","土","日";"A","B","C","D","E","F","G"})

という式を入力したら、

名前 曜日 結果
hoge B
fuga C
piyo D
foo B

となった。

他はちゃんとうまく出力されているのに、 なぜか「金」のことを「火」とおっしゃるExcel先生… いったい何が悪いのやら…

ちなみに、IF文をネストした式を書くとうまく動いた。 正直これしか対応が思いつかなかった…orz

【小ネタ】4月31日

小ネタを書いてもいいじゃない。人間だもの。

javascriptを書いててひょんな拍子に、うっかり

d = new Date("2015/04/31");

をしたら、dの中に5月1日のDateインスタンスができた。

この調子ならもしかして、と思って

d = new Date("2015/04/32");

したら Invalid Date だと言われた。

Android Chromeでちょっとつらかった話。

だいぶ前に起きた現象だけど記事にする。

javascriptでモダンなブラウザだと、

console.log()

の代わりに

console.table()

なるものが使える。

実際、デバッグなどでオブジェクトの中が(やや)見やすくなったりするので、たまに気が向くと使う。

しかし、うっかりAndroid ChromeでConsole.tableが使われているページを読み込むと、エラーをおこし、ページの読み込みが止まる。

AndroidGoogle Chromeでは止まらないので、Android Chromeはやっぱりツラい。


そろそろ業務・趣味問わず記事にしたい小ネタが積もってきてるのでこういうふうに消化しよう…