TXT2PYNB

TXT2PYNB 是一款 Sublime Text 扩展包，它可以处理包含行内注释 markdown 块的 Python（或 Julia）文件，并将其转换为 iPython（或 iJulia）笔记本（.ipynb）。请查看下面的 “标签” 部分或 “示例” 文件夹以获取脚本的示例。该扩展包将输出和脚本同名的笔记本，并保存在脚本相同的目录下。（例如，my_script.py 将在相同目录下输出 my_script.ipynb）

下载

此扩展包可以从 Sublime Text 的 软件包控制 中下载。安装软件包控制后，在“安装包”选项中搜索“TXT2PYNB”。

构建笔记本

在 Sublime Text 中安装后，TXT2PYNB 可以通过按 C + b 调用，其中 C 是苹果电脑上的 command 键，其他设备上的 ctrl 键。对于一些用户，TXT2PYNB 构建系统将默认调用 .py 或 .jl 脚本，但其他用户可能需要通过 工具->构建系统->TXT2PYNB 选项选择它。

或者，使用命令面板（cmd + shift + p）可以搜索并调用 TXT2PYNB。这对于经常使用其他 Python 或 Julia 脚本构建系统的用户来说特别有用。通过从本扩展包的文件夹中删除 TXT2PYNB.sublime-build 文件，可以关闭 TXT2PYNB 构建系统的默认调用。

脚本执行（用于 Sublime Text 之外）

Python 脚本执行的示例，Julia 类似。命令行可执行脚本 txt2pynb.py 位于 txt2pynb 文件夹中。

python /path/to/txt2pynb.py /path/to/example_script.py

标签

代码和Markdown的起始和结束标签遵循类似HTML的格式。建议将整个Markdown块注释掉，并将代码标签注释掉（如下所示），以保留脚本作为Python文件运行的 capability。

#<code>
# This is a comment inside of a code block
#</code>

'''<md>
This is markdown!
</md>'''

空格分隔

如果没有代码或Markdown标签，脚本将被解析为双空格分隔。请查看例子2，以了解这一演示。Markdown块必须以块注释格式存在，例如'''markdown'''（或“”“markdown”“”用于Julia）才能正确解析。此外，Markdown块可以压缩到代码块上方，以允许一个双空格分隔的单个Markdown和代码块，如《Examples》文件夹中的Example_2所示。

例子

请查看《Examples》文件夹中的示例代码和输出。

常见问题

• C+b没有输出。
  • 如果默认已为.py或.jl文件分配了构建系统，当脚本打开时可能需要手动更改构建系统，方法是在工具 > 构建系统中选择TXT2PYNB。同样，如果希望一个打开的.py或.jl文件使用不同的构建系统，请通过相同的过程切换回来。

待办事项

1. 添加从编辑过的笔记本中“拉回”代码的能力
2. 与iPython 3+的兼容性（输出版本4 .ipynb）