Python sphinx 什么'；ReST中的代码和代码块指令之间的区别是什么？

在我尝试过的每个渲染器中，

code

和

code block

似乎都有完全相同的结果：一块代码。两者都生成完全相同的html——包括类和标记种类（使用我认为是docutils？）：

---

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

code

是一个重新构造的文本指令。

代码块

是斯芬克斯指令

代码块

有一组不同于

code

指令的选项。 例如，

：强调行：

当您使用Sphinx时，我建议您使用

代码块

指令

当使用

代码块时

我总能得到正确的突出显示。当使用

code

时，我有时会得到颜色，有时只是文字代码块。我还没有弄清楚conf.py中的哪些设置组合可以生成彩色输出

code

指令的优点是，该文档既可以在Sphinx文档树中使用，也可以作为独立的重构文本文档使用