IPython指令在构建文档期间创建损坏的输出

Question

我想使用sphinx和ipython指令构建文档。 我尝试在.rst文档中使用简单的命令：

.. ipython:: python

    import datatable as dt
    DT = dt.Frame(A=range(5))
    DT

在jupyter笔记本中，结果看起来不错：

但是在构建期间会使html结果损坏：

可能是什么原因？

它与熊猫或python一起很好地工作。

Answer 1

确保在conf.py中添加所需的扩展名：

extensions = ['IPython.sphinxext.ipython_console_highlighting',
              'IPython.sphinxext.ipython_directive']

Answer 2

ipython中的已知问题是要发布的链接：https://github.com/ipython/ipython/issues/11424