(已解决)restructuredtext+sphinx 修改 html theme

驿窗 · 2020-10-30 15:12:59

使用sphinx自带的bizstyle theme没有问题，运行后生成html样式如下：

.

我想把bizstyle改成Sphinx Bootstrap Theme，链接在这里：
https://ryan-roemer.github.io/sphinx-bo … EADME.html

按它的安装说明，我运行：
pip install sphinx_bootstrap_theme

然后修改conf.py，在文件最上方添加：
import sphinx_bootstrap_theme
在文件中间theme处修改为：
html_theme = 'bootstrap'
并在下面添加一行：
html_theme_path = sphinx_bootstrap_theme.get_html_theme_path()

然后运行make html会报错，全部错误信息如下：

Running Sphinx v1.7.9

Configuration error:
There is a programable error in your configuration file:

Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/sphinx/config.py", line 161, in __init__
    execfile_(filename, config)
  File "/usr/lib/python3/dist-packages/sphinx/util/pycompat.py", line 150, in execfile_
    exec_(code, _globals)
  File "conf.py", line 9, in <module>
    import sphinx_bootstrap_theme
ImportError: No module named 'sphinx_bootstrap_theme'

Makefile:20: recipe for target 'html' failed
make: *** [html] Error 2

有点搞不懂了，应该咋搞？

最近编辑记录驿窗 (2020-11-13 09:32:50)

依云 · 2020-10-30 15:46:06

你的安装有问题。去找找你装哪儿了，为什么 Python 找不到。
另外你这是 Debian 吧？

驿窗 · 2020-10-30 16:02:47

对，debian~
你说的安装有问题，是指sphinx安装？

依云 · 2020-10-30 16:11:39

是指你 pip 安装的 sphinx_bootstrap_theme。
我移一下帖子。

驿窗 · 2020-10-30 16:16:45

我在这个目录里能找到sphinx_bootstrap_theme目录和sphinx_bootstrap_theme-0.7.1.dist-info目录：
.local/lib/python2.7/

那些sphinx自带的theme，在这里：
.local/lib/python2.7/site-packages/sphinx/themes/

我把phinx_bootstrap_theme目录拷贝到.local/lib/python2.7/site-packages/sphinx/themes/目录，结果还是不行~

依云 · 2020-10-30 16:53:10

你跑 sphinx 的 Python 不是 3 么？

驿窗 · 2020-10-30 21:26:45

果然，我用pip3 install sphinx_bootstrap_theme 再装了一次，之后make html已经不报错了，生成的html页面也是正确的~

Arch Linux

#1 2020-10-30 15:12:59

(已解决)restructuredtext+sphinx 修改 html theme

#2 2020-10-30 15:46:06

Re: (已解决)restructuredtext+sphinx 修改 html theme

#3 2020-10-30 16:02:47

Re: (已解决)restructuredtext+sphinx 修改 html theme

#4 2020-10-30 16:11:39

Re: (已解决)restructuredtext+sphinx 修改 html theme

#5 2020-10-30 16:16:45

Re: (已解决)restructuredtext+sphinx 修改 html theme

#6 2020-10-30 16:53:10

Re: (已解决)restructuredtext+sphinx 修改 html theme

#7 2020-10-30 21:26:45

Re: (已解决)restructuredtext+sphinx 修改 html theme

页脚