【发布时间】:2019-01-31 18:27:53
【问题描述】:
我真正喜欢 Markdown 的地方在于我可以做到以下几点:
- 写
```回车 - 粘贴剪贴板中的所有垃圾
- 写信
``` - 我现在有一个工作代码块
在 RST 中,我必须执行以下操作:
- 写
.. codeblock::回车回车 - 粘贴
- 现在我需要缩进之前粘贴的所有行
RST 是否有任何更简单的方式来使用代码块而不需要前面的四个空格?
【问题讨论】:
我真正喜欢 Markdown 的地方在于我可以做到以下几点:
```回车
```
在 RST 中,我必须执行以下操作:
.. codeblock::回车回车
RST 是否有任何更简单的方式来使用代码块而不需要前面的四个空格?
【问题讨论】:
reST 中没有与 Markdown 的内联代码块相似的地方。只有these options:
有多种方法可以在 Sphinx 中显示语法突出显示的文字代码块:使用 reST doctest blocks;使用reST literal blocks,可选择与highlight 指令结合使用;使用code-block 指令;并使用literalinclude 指令。
如果您的编辑器缺乏自动缩进code-block 的能力,或者不允许您选择块并缩进四个空格,那么最好的选择可能是literalinclude。如果您重复引用相同的代码,它会特别有用。
附言-- 尝试在第二个 return 之后缩进四个空格。我在 PyCharm 中尝试过,但它没有缩进,但也许你的编辑器会这样做。有several open issues for PyCharm。
【讨论】: