如何将 Jupyter 笔记本导出为其他格式

主要观点:在使用 Jupyter Notebook 时,常需将其作为除 notebook 文件外的其他形式分发,最可能是为给非技术用户分享内容,nbconvert 是内置工具可将 notebook 导出为多种格式,如 html、latex、pdf 等,其使用 jinja 模板,依赖 pandoc 和 tex,还可批量转换多个 notebook 及创建配置脚本,转换时可使用-execute标志执行 notebook 代码,也可创建 Python 脚本编程执行 notebook,nbconvert 有很多配置选项可自定义。

关键信息:

  • 常用导出格式及命令:jupyter nbconvert notebook.ipynb --to format(format 可为多种格式)
  • 批量转换命令:jupyter nbconvert notebook*.ipynb --to formatjupyter nbconvert notebook1.ipynb notebook2.ipynb --to format
  • 执行 notebook 命令:jupyter nbconvert --execute my_notebook.ipynb --to pdf
  • Python 脚本执行 notebook 代码示例
  • 可通过readthedocs了解更多信息

重要细节:

  • nbconvert 用 jinja 模板将.ipynb文件转换为其他静态格式
  • 转换为 restructuredtext 或 latex 时需安装 pandoc
  • 转换为 html 有 full 和 basic 两种模式
  • 执行 notebook 时代码不能有错误,否则转换失败
  • 可通过documentation here了解配置选项
阅读 14
0 条评论