DAITEI's blog

sphinxを使ってみようと勉強を始めた。
WEB APIのドキュメントを書くのが最初の目的だったので、"sphinxcontrib.httpdomain" 拡張を使おうと思った。
conf.pyに以下を記述して、

extensions = [
    'sphinxcontrib.httpdomain',
]

"make html"を実行すると。

 $ make html
Running Sphinx v1.8.4
loading translations [ja]... done

Extension error:
Could not import extension sphinxcontrib.httpdomain (exception: No module named 'sphinxcontrib')
make: *** [Makefile:19: html] エラー 2

なになに？sphinxcontrib が無い？何故だ？
ちゃんと、 「/usr/lib/python2.7/dist-packages/sphinxcontrib/httpdomain.py」はあるぞ!
conf.pyに以下を記述して、

import sys
print sys.path

"make html"を実行すると。

 $ make html
Running Sphinx v1.8.4
['/usr/share/sphinx/scripts/python3', '/usr/lib/python37.zip', '/usr/lib/python3.7', '/usr/lib/python3.7/lib-dynload', '/usr/local/lib/python3.7/dist-packages', '/usr/lib/python3/dist-packages']
loading translations [ja]... done

Extension error:
Could not import extension sphinxcontrib.httpdomain (exception: No module named 'sphinxcontrib')
make: *** [Makefile:19: html] エラー 2

おっと？python3.7用が動いている...。
/etc/alternativeを調べてみると、

 $ ls -l /etc/alternatives| grep sphinx
lrwxrwxrwx 1 root root  47 10月  2 15:26 sphinx-apidoc -> /usr/share/sphinx/scripts/python3/sphinx-apidoc
lrwxrwxrwx 1 root root  48 10月  2 15:26 sphinx-autogen -> /usr/share/sphinx/scripts/python3/sphinx-autogen
lrwxrwxrwx 1 root root  46 10月  2 15:40 sphinx-build -> /usr/share/sphinx/scripts/python3/sphinx-build
lrwxrwxrwx 1 root root  51 10月  2 15:26 sphinx-quickstart -> /usr/share/sphinx/scripts/python3/sphinx-quickstart

...なぜ、python3になってるのかな...。
下記コマンドでpython2に変更する。

 $ sudo update-alternatives --config sphinx-build
 $ sudo update-alternatives --config sphinx-quickstart
 $ sudo update-alternatives --config sphinx-apidoc
 $ sudo update-alternatives --config sphinx-autogen

無事、httpdomainが使えました。