在我尝试过的每一个渲染器中,code
和code-block
似乎都有着完全相同的结果:代码块。两者都生成完全相同的html --包括类和标记类(使用我认为是docutils?):
<pre class="code [language] literal-block">
那么,有什么区别呢?为什么我们两者都有?是否有渲染器不同的渲染方式?有语义上的区别吗?
发布于 2016-02-03 02:27:50
code
是reStructuredText指令。code-block
是狮身人面像的指令。
code-block
与code
指令有不同的选项集。例如:emphasize-lines:
由于您正在使用狮身人面像,我建议使用code-block
指令。
当使用code-block
时,我总是得到正确的高亮显示。在使用code
时,我有时会得到颜色,有时只会得到文字代码块。我还没有弄清楚在conf.py中什么样的设置组合可预测地生成有色输出。
code
指令的优点是,文档既可以在Sphinx文档树中使用,也可以作为独立的reStructuredText文档使用。
https://stackoverflow.com/questions/34845889
复制相似问题