选择性地禁用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 

当我在工作站上用狮身人面像构建文档时，狮身人面像正确地突出显示启用的语法，并禁用禁用语法高亮的地方。但是，当在readthedocs网站上构建时，在包含.. highlight:: none的RST文件的文字块中存在不需要的Python语法突出显示。突出显示诸如“无”和“列表”之类的词。

我该如何选择性地禁用此RST文件中的语法高亮显示，同时保持其他地方的语法高亮显示？

Answer 1

您直接连续使用两个突出显示指令，.. highlight:: none，紧接着是::。前者被后者覆盖，后者应用后者语言的语法突出显示。使用default language configured for syntax highlighting，通常是Python3。

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

我只会使用一个指令，然后是我想要突出显示的代码。

就使用哪种语法而言，您可以使用text，它只是普通的旧文本，none，或者构成不是Pygments词法分析器之一的内容，如moosehair。有关更多信息，请参阅Showing code examples。

.. code-block:: text 

    Plain old text 

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

:: 

    Plain old text