【问题标题】:Coloring a text part doesn't work (Python 3 + Sphinx html)着色文本部分不起作用(Python 3 + Sphinx html)
【发布时间】:2020-09-17 12:10:48
【问题描述】:

我尝试了所有找到的解决方案,但都没有奏效。可能是 Python 2 或 3 和/或旧 Sphinx 版本的差异的原因。这就是我所拥有的:

  1. 具有独立构建和源目录的 Sphinx 项目
  2. 我将一个名为 custom.css 的文件放在 source/_static 中。内容:
    .blue {
        parent: bodytext;
        textColor: blue;
    }
  1. 我已经编辑了我的 conf.py 并在html_static_path = ['_static'] 下方添加了html_css_files = ['custom.css']

  2. 我在 *.rst 文档的顶部添加了.. role:: blue

  3. 我已经编辑了文件本身并写道:这是一个带有 :blue:`blue` 字的句子。

当我渲染我的项目时,html 源代码包含:This is a sentence with a <span class="blue">blue</span> word。

除了这个词根本不是蓝色的事实之外,一切都很好。它与其他颜色相同。

我错过了什么?

【问题讨论】:

  • 当您构建文档时,文件custom.css 是否被复制到构建目录中?您是否在浏览器的开发者工具中看到该文件的任何 404?
  • 是的,确实如此。它位于 html/_static/custom.css 中。据我所知,开发工具部分没有任何 404。

标签: html css python-3.x python-sphinx


【解决方案1】:

您的 CSS 语法不正确。应该这样做。

.blue {
    color: blue !important;
}

【讨论】:

  • 不,这也不起作用。刚刚尝试(再次)。在呈现的源代码中,它看起来与<span class="blue">blue</span> 相同。两种变体可能都可以工作,但在这里不行。我也在使用标准的 Sphinx 主题,没有任何特色。
  • 确保您的构建目录中的custom.css 具有我建议的更改并添加!important(参见编辑),并且该文件被浏览器加载。如果还是不行,那么使用检查器来确定实际应用到该选择器的样式,并找出如何覆盖它。
猜你喜欢
  • 2021-10-01
  • 2012-02-28
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2016-08-29
  • 2021-02-06
  • 1970-01-01
相关资源
最近更新 更多