sphinx + ipython notebook (jupyter)

備忘録

ipython notebookで作ったファイルをipython nbconvert --to rst hoo.ipynb

すると

In[1]

Out[1]

などの情報が出力されずに困った．

http://nbsphinx.readthedocs.io/en/latest/usage.html

よりrstにconvertせずにipynbをそのままtoctreeで読み込む事によりこの問題を回避

sphinxの設定はデフォルトの場合，conf.pyがあるディレクトリで

python -m sphinx . _build/html

とすればよい

sphinx-autobuild が超便利

以上