似乎Github在其reStructuredText渲染器中不支持sphinx.ext.doctest语法,这在尝试包含 doctest样式代码块时会导致一些问题(.. doctest
)在README.rst中,它被转换为文档索引(由sphinx呈现)。如果我用其他东西替换.. doctest
指令,它就不能在Sphinx上作为doctest正确呈现,但如果我不删除指令,则代码块不会呈现 at all (见this gist)。
理想情况下,我想找到一个在两个环境中都能做正确事情的解决方案,但如果失败了,有没有办法可以回退到.. code
块或其他一些支持的格式(例如rST相当于<NoScript>
标签)?