如果code-block ::没有可选参数,那么Sphinx highlight_language配置选项有什么意义？

Question

如果code-block ::没有可选参数,那么Sphinx highlight_language配置选项有什么意义？

它说它设置了默认的hightlight_language,但是如果每次指定代码都需要说明语言,为什么需要配置选项？

难道我做错了什么？

编辑:当我删除codeblock的参数时从日志中.

C:\c\Sponge\SpongeDocs\source\plugin\scheduler.rst:25: ERROR: Error in "code-block" directive:
1 argument(s) required, 0 supplied.

.. code-block::

    taskBuilder.execute(new Runnable() {
        public void run() {
            logger.info("Yay! Schedulers!");
        }
    });

Answer 1

文档在这里有点模糊。事实上，..code-block::仅当您出于某种原因要明确指定语言时才应使用指令。默认情况下，您应该使用一个简单的::块：

Python 源代码或交互式会话的示例使用标准 reST 文字块表示。它们由上一段::末尾的a 开始，并以缩进分隔。

（来源：http : //www.sphinx-doc.org/en/stable/markup/code.html）

它看起来像这样：

::

    var hello = "Hello, World!";
    console.log(hello);