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

Question

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

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

我做错了什么吗？

编辑:从日志中删除代码块的参数。

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:: 指令只有在出于某种原因想要明确指定语言时才应使用。默认情况下，您应该使用一个简单的 :: block :

Examples of Python source code or interactive sessions are represented using standard reST literal blocks. They are started by a :: at the end of the preceding paragraph and delimited by indentation.

(来源:http://www.sphinx-doc.org/en/stable/markup/code.html)

它看起来像这样:

::

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