将重组后的文本转换为 jupyter notebook

Question

如何将重组文本（.rst 文件）转换为 jupyter notebook（.ipynb 文件）？

我已经搜索并尝试了包

rst2ipynb

，但是运行命令

rst2ipynb

会导致Windows 询问我“打开方式...”。我不知道其他选择。我更喜欢使用 Jupyter 的官方解决方案，因为我知道 rst 文件是 Jupyter 支持的原生支持格式之一。

Answer 1

使用 rst2ipynb

通过此处并单击“

Launch binder

”来启动远程临时 Jupyter 会话。

使用启动器窗格在 Jupyter 会话中打开终端。

按照建议here

安装pandoc

在终端中，输入：

conda install -c conda-forge pandoc -y

下一步，安装rst2ipynb。

在同一个终端，运行：

git clone https://github.com/nthiery/rst-to-ipynb.git
cd rst-to-ipynb
pip install .
cd ..

最后一个命令只是返回目录层次结构中的一个级别。

从您的本地计算机拖放您的

.rst

文件以转换为 Jupter 会话窗口左侧的文件导航窗格。它将文件上传到远程会话。

我的测试文件是这个

README.rst

：

https://github.com/RunestoneInteractive/RunestoneComponents/blob/master/README.rst

我下载了那个README文件的原始代码并重命名了它

RunestoneComponents.rst

.

运行转换

在终端，我跑了：

rst2ipynb RunestoneComponents.rst -o test.ipynb

将

.rst

文件的文件名替换为

RunestoneComponents.rst

。随心所欲地命名

test.ipynb

。

双击文件导航窗格中创建的

.ipynb

文件，它将在会话中作为笔记本打开。如果您愿意，可以右键单击以选择

Open With...

选项。
该会话是临时的，因此在文件导航窗格中，右键单击并选择将您在远程会话中创建的任何有用的笔记本文件下载回本地计算机。

rst2ipynb

带有自己的测试内容，您也可以转换它。

rst2ipynb rst-to-ipynb/tests/all.rst -o all_test.ipynb

您会看到 这会产生一个功能更全面的示例转换笔记本文件。如果有必要，你可以用它来指导你如何调整你的

.rst

输入。