python-sphinx - ReST 中的代码和代码块指令有什么区别？

Question

在我尝试过的每个渲染器中，code和 code-block似乎有完全相同的结果:一段代码。两者都生成完全相同的 html - 包括类和标签类型(使用我认为它是 docutils？):

<pre class="code [language] literal-block">

那么，有什么区别呢？为什么我们两者都有？是否有任何渲染器以不同方式渲染它们？有语义上的区别吗？

Answer 1

code是一个 reStructuredText 指令。code-block是一个 Sphinx 指令。
code-block与 code 有一组不同的选项指示。
例如。 :emphasize-lines:
当您使用 Sphinx 时，我建议您使用 code-block指示。

使用 code-block 时我总是得到正确的突出显示。使用 code 时我有时会得到颜色，有时只是文字代码块。我还没有弄清楚 conf.py 中可以预测生成彩色输出的设置组合。
code指令确实具有文档既可以在 Sphinx 文档树中使用，也可以同时作为独立的 reStructuredText 文档使用的优点。