有选择地禁用readthedocs语法高亮显示

Question

我有一个RST文件,我不希望任何语法高亮.它包含多个文字块和文件顶部的高亮指令,以尝试禁用语法高亮:

.. highlight:: none

::

  Text that happens to contain words like list, None, etc.

::

  Another literal block with words like list, None, etc.

项目中的其他一些RST文件使用语法高亮显示,使用如下指令:

.. highlight:: bash

当我在工作站上使用sphinx构建文档时,sphinx正确地突出显示启用的语法并禁用禁用语法高亮显示的语法.但是,当在readthedocs网站上构建时,在包含RST文件的文字块中会出现不需要的Python语法突出显示.. highlight:: none.突出显示"无"和"列表"之类的单词.

如何在此RST文件中有选择地禁用语法突出显示,同时将语法高亮显示在其他位置？

Answer 1

您可以直接使用两个突出显示指令,.. highlight:: none紧接着使用::.前者被后者覆盖,后者使用后一种语言的语法突出显示.

我不会连续使用两个指令.

我只使用一个指令,然后是我要强调的代码.

至于使用哪种语法,你可以使用text哪个只是普通的旧文本none,或者组成一些不是Pygments词法分析器的东西,比如moosehair.有关更多信息,请参阅显示代码示例

.. code-block:: text

    Plain old text

或者,如果你在你的设置conf.py,highlight_language = 'none'你可以使用:::

::

    Plain old text