Question

如何在Sphinx中禁用语法高亮？

我已尝试设置highlight language to 'none'和setting ..language:: none。

我尝试删除html和make clean。但语法突出显示在那里。（使用Alabaster主题）

conf.py配置了这些扩展程序：

extensions = ['sphinx.ext.autodoc',
    'sphinx.ext.doctest',
    'sphinx.ext.todo',
    'sphinx.ext.coverage',
    'sphinx.ext.ifconfig',
    'sphinx.ext.viewcode',
    'sphinx.ext.githubpages',
    'numpydoc',
    ]

编辑：嗯，似乎viewcode扩展正在执行此操作it is quite hard coded

Answer 1

viewcode仅将语法突出显示应用于Python源文件。要仅在这些文件中禁用突出显示，您可以通过在lexer逻辑添加, 'none'中修改此行来编辑文件来源。

    if env.config.highlight_language in ('python3', 'default', 'none'):

您好像已经提交了PR for it。

对于Sphinx在叙述文档中呈现的所有其他文件，您可以在conf.py中全局禁用突出显示：

highlight_language ='none'

然后，这将由您在viewcode中的修改继承。

Answer 2

这是fixed ..已在1.6版本中修复

在Sphinx中禁用语法突出显示（Alabaster主题）

2 个答案: