css - Sphinx 内联代码高亮

Question

我使用 Sphinx 制作了一个包含代码示例的网站。我成功地使用了 .. code-block 指令来获得语法高亮显示。但是我无法使用此代码突出显示内联语法:

.. role:: bash(code)
   :language: bash

Test inline: :bash:`export FOO="bar"`.

.. code-block:: bash

    export FOO="bar"

产生此输出，即内联代码未突出显示，而 block 代码是:

对我来说，问题是为内联代码生成的 HTML 包含长类名，而它不为代码块生成。这是输出 HTML(为了便于阅读而缩进):

<p>Test inline:
    <tt class="code bash docutils literal">
        <span class="name builtin">
            <span class="pre">export</span>
        </span>
        <span class="name variable">
            <span class="pre">FOO</span>
        </span>
        <span class="operator">
            <span class="pre">=</span>
        </span>
        <span class="literal string double">
            <span class="pre">&quot;bar&quot;</span>
        </span>
    </tt>.
</p>


<p>Test code-block:</p>
<div class="highlight-bash">
    <div class="highlight">
        <pre>
            <span class="nb">export </span>
            <span class="nv">FOO</span>
            <span class="o">=</span>
            <span class="s2">&quot;bar&quot;</span>
        </pre>
    </div>
</div>

非常感谢任何帮助。

Answer 1

syntax_highlight是一个普通的docutils设置，可以在docutils.conf中设置.如果将此文件放在 Sphinx 的 configuration directory 中，Sphinx 也会尊重该文件。 (conf.py 所在的位置):

[restructuredtext parser]
syntax_highlight = short

这比修补 docutils 或 sphinx 代码或创建长名称 CSS 文件要好得多。