如何更改 rtd 背景颜色？

Question

我想更改 Read the Docs theme sphinx-doc 的背景颜色。

主题是使用 sass 编写的，我找到了没有定义的变量 $section-background-color。

如果我在项目的任何地方用另一个值替换 #2980B9，它就不起作用。这种疯狂的蓝色仍然是从某处取回的。

这个背景色是在哪里定义的？

我也尝试将_theme_variables_sass中的所有$blue替换为$red。

Answer 1

有（至少）两种方法可以更改 sphinx_rtd_theme 样式：

编辑用于构建主题的源 SASS，如 docs 中所述。请确保 Sphinx 使用的是您新建的 sphinx_rtd_theme，而不是 PyPI-installed（原始）版本。
使用自定义 CSS 文件覆盖所需的 CSS 规则作为回答 here。

我发现#2 简单得多。例如，假设我想更改标题、徽标和侧面搜索栏后面的背景颜色。查看默认构建（检查页面样式），背景颜色在 class .wy-side-nav-search 中设置，因此只需在 <project-dir>/_static/css 中创建一个 custom.css 文件 [=43] =]

.wy-side-nav-search{ background-color:<#yourHexColor> }

然后，在conf.py中添加：

def setup (app):
    app.add_stylesheet('css/custom.css')

make clean、make build 和中提琴。

至于背景颜色的定义位置，我看得不够深入无法说清楚，但希望这能让您（和未来的访问者）获得想要的结果。

Answer 2

如 NickT 的回答，但使用 css 变量，并设置移动版本 header 颜色 -

body {
  --themecolor: black;
}

.wy-side-nav-search {
  background-color: var(--themecolor);
}
.wy-nav-top {
  background-color: var(--themecolor);
}

如何更改 rtd 背景颜色？

How to change the rtd background color?

css

sass

python-sphinx

read-the-docs