code-block ::にオプションの引数がない場合、Sphinxのhighlight_language設定オプションのポイントは何ですか？

Question

code-block ::にオプションの引数がない場合、Sphinxのhighlight_language設定オプションのポイントは何ですか？

デフォルトのhightlight_languageが設定されていますが、コードを指定するたびに言語を記述する必要がある場合は、configオプションが必要なのはなぜですか？

何か間違っていますか？

編集：ログから、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::ディレクティブは、何らかの理由で明示的に言語を指定したい場合にのみ使用してください。それは次のようになります

：

:: 

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

Answer 2

code-block::ディレクティブを使用する場合、言語の指定はオプションです。

documentationで説明されているように、デフォルトの言語強調表示はpythonです。 highlight_languageを設定すると、これを変更できます。言語を指定せずにcode-block::を使用すると、cコードが強調表示されます。