在RST-Sphinx文档中更改语法突出显示

Question

我正在使用RST编写文档并使用Sphinx生成HTML。

在代码示例中，我们希望用户输入的命令默认为斜体 - 是否有办法使此代码变为粗体？

例如::

ACOS# this is some text that is currently italics but i would like it to be bold

Answer 1

#字符会将其后的文本解释为注释。默认情况下，它以斜体显示。 CSS规则位于pygments.css中（位于输出目录中的_static中）：

.highlight .c { color: #408090; font-style: italic } /* Comment */

如果要将其更改为粗体，则规则应为：

.highlight .c { color: #408090; font-weight: bold } /* Comment */

要实现这一目标，您可以执行以下操作：

1. 将默认pygments.css文件复制到Sphinx项目中的_static文件夹。

2. 如上所述更改CSS规则。

3. 重新生成项目输出。现在将使用您自定义的pygments.css而不是默认值。

这是另一种使用sphinx-rtd-theme的方法。

1. 创建一个名为mystyle.css的文件，并将其放在项目的_static目录中。

2. 将此行添加到conf.py（请参阅http://www.sphinx-doc.org/en/stable/config.html#confval-html_style）：

   html_style = 'mystyle.css'
   

3. 将以下内容添加到mystyle.css：

   @import "css/theme.css";
   
   .highlight .c { font-weight: bold; font-style: normal  } /* Comment */