新しいブログテーマ

sphinxjp.themes.tinkerbelizehole

Tinkerer のデフォルトテーマ flat があまり好みではなかったので, belizehole という名前の Sphinx テーマを適用してみました.

https://pypi.python.org/pypi/sphinxjp.themes.tinkerbelizehole/0.1.0

手順は以下の通りです. 実際には, virtualenv の環境を 1 つ専用に用意して作業してます.

$ python -V
Python 3.3.3
$ pip install sphinxjp.themes.tinkerbelizehole

## 必要なライブラリは以下の通り
$ pip freeze
...
Sphinx==1.2b3
...
Tinkerer==1.2.1
...
sphinxjp.themes.tinkerbelizehole==0.1.0
...

$ emacs conf.py
...
# Pick another Tinkerer theme or use your own
html_theme = "tinkerbelizehole"
...

## Sphinx 1.2 より前の場合は以下の行も編集する
# Add other Sphinx extensions here
extensions = [..., 'sphinxjp.themecore']
...

$ tinker -b

これで無事, 新しいテーマに切り替わりました.

PyPI のページには「Python 3 はサポートしていない」みたいに書いてありましたが, 普通に動きました. どうやら, このテーマの依存ライブラリ (これは Sphinx のテーマを自動で読み込むもの) である sphinxjp.themecore が Python 3 をサポートしていないために, このような記述があるようです. sphinxjp.themecore の作者の @shimizukawa さん聞いたら, 単に未検証だというだけだそうです. さらに, Sphinx 1.2b3 では既に本体に取り込まれているので, テーマだけインストールすれば html_theme の設定でテーマが適用されるそうです. すごいね.

このテーマはスマホ (私の場合は iPhone の Safari) で見ても, サイドバーが無く見やすいので気に入ってます. 作者は自称「プログラミングしょしんしゃ」の @naoiwata さんです.