jupyter-notebook - 为 Juptyer 笔记本添加 reStructuredText 支持

Question

我需要在 JupyterLab 中查看 reStructuredText 文件，到目前为止我发现的最好的是 @akaihola's answer到相关 issue on github .

我添加了一个解决方法，允许在不查看源代码的情况下渲染文件，如下所示。

Answer 1

如果其他人可能需要它，这是我现在正在使用的解决方案:

import docutils.core
import docutils.writers.html5_polyglot
from IPython.core.magic import register_cell_magic, register_line_magic
from IPython.display import HTML

@register_cell_magic
def rst(line, cell):
    "Render ReStructuredText"
    writer = docutils.writers.html5_polyglot.Writer()
    return HTML(docutils.core.publish_string(cell, writer=writer).decode('UTF-8'))

@register_line_magic
def rstfile(filename):
    "Render ReStructuredText"
    writer = docutils.writers.html5_polyglot.Writer()
    with open(filename, 'r') as file:
        cell = file.read()
    return HTML(docutils.core.publish_string(cell, writer=writer).decode('UTF-8'))

查看 rst文件，没有来源:

%rstfile <your-rst-filename>

要使用原始解决方案，作为 rst单元格，显示 ReStructuredText 源和渲染输出:

%%rst
============
 Main title
============

Some **heavy** markup.