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

Python sphinx 有选择地禁用readthedocs语法高亮显示,python-sphinx,restructuredtext,read-the-docs,Python Sphinx,Restructuredtext,Read The Docs,我有一个RST文件,我不想要任何语法突出显示。它包含多个文字块和文件顶部的highlight指令,用于尝试禁用语法高亮显示: .. highlight:: none :: Text that happens to contain words like list, None, etc. :: Another literal block with words like list, None, etc. 项目中的其他一些RST文件使用语法高亮显示和以下指令: .. highlight

我有一个RST文件,我不想要任何语法突出显示。它包含多个文字块和文件顶部的highlight指令,用于尝试禁用语法高亮显示:

.. 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语法突出显示。。突出显示::无
。突出显示“无”和“列表”等词


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

您可以直接连续使用两个突出显示指令,
。。突出显示::无
,紧接着是
。前者被后者覆盖,后者应用后者语言的语法高亮显示

使用,通常是Python3

我不会连续使用两个指令

我将只使用一个指令,后面是我要突出显示的代码

至于要使用哪种语法,您可以使用纯旧文本的
text
none
,或者编写一些不是Pygments词法的东西,比如
moosehear
。有关更多信息,请参阅

.. code-block:: text

    Plain old text
或者,如果您在
conf.py
中设置,
突出显示语言='none'
,则可以使用

::

    Plain old text