RISE项目：将Jupyter Notebook演示文稿导出为PDF的完整指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00656/article/details/148553010

RISE项目：将Jupyter Notebook演示文稿导出为PDF的完整指南

概述

RISE是一个强大的Jupyter Notebook扩展，它可以将Notebook转换为交互式幻灯片演示。在实际工作中，我们经常需要将这些动态演示转换为PDF格式以便分享或存档。本文将详细介绍两种主流方法：使用nbconvert工具链和使用decktape工具，帮助您轻松实现这一需求。

方法一：使用nbconvert导出PDF

完整步骤

生成HTML幻灯片 首先使用以下命令将Notebook转换为HTML幻灯片并启动本地服务器：
```
jupyter nbconvert --to slides your_talk.ipynb --post serve
```
这会生成一个本地网页，通常地址为http://127.0.0.1:8000/your_talk.slides.html#/
添加打印参数 在URL末尾添加?print-pdf参数（注意需要移除原有的#符号），新URL应类似：
```
http://127.0.0.1:8000/your_talk.slides.html?print-pdf
```
此时页面会以纵向排列方式显示所有幻灯片。
通过Chrome打印为PDF
- 打开浏览器打印对话框（快捷键Ctrl/Cmd+P）
- 目标打印机选择"另存为PDF"
- 布局选择"横向"
- 边距设置为"无"
- 勾选"背景图形"选项
- 点击保存

命令行一键导出

对于熟悉命令行的用户，可以直接使用以下命令完成导出：

google-chrome --headless --print-to-pdf=your_talk.pdf http://127.0.0.1:8000/your_talk.slides.html?print-pdf

JavaScript依赖注意事项

如果您的幻灯片中使用了基于JavaScript的库（如Bokeh），需要特别注意：

确保定义JS代码的单元格没有被RISE跳过
即使这些单元格在实时演示中可以跳过，但在PDF导出时必须包含
可以使用"Notes"幻灯片类型标记这些单元格，这样它们不会出现在演示中但会包含在PDF里

方法二：使用decktape导出PDF

安装与配置

安装decktape
```
npm install decktape
```
启动Jupyter Notebook服务器
```
jupyter notebook
```
注意：确保RISE的autoLaunch选项已禁用，否则decktape可能会在打印前退出幻灯片视图。

执行导出

使用以下命令格式进行导出：

$(npm bin)/decktape rise <Jupyter-Notebook-URL> <输出文件路径>

具体示例：

$(npm bin)/decktape rise http://localhost:8888/notebooks/your/notebook.ipynb?token=YourJupyterSessionToken /path/to/outputfile.pdf

注意：URL中需要包含Jupyter Notebook服务器的会话token，该token在启动服务器时会显示在命令行中。

常见问题解决方案

自定义幻灯片尺寸 如果修改过默认的演示尺寸，需要添加-s参数：

$(npm bin)/decktape rise -s 1500x900 https://localhost:8888/...

SVG渲染问题 遇到SVG文件渲染问题时，可以尝试更新decktape版本或查阅相关解决方案。
数学公式渲染问题 如果数学公式显示不正常，尝试重新渲染。
片段显示问题 当前decktape的RISE插件默认禁用片段(fragments: false)，可以将插件中的相应行改为fragments: true，这样每个片段会单独显示为一页幻灯片，之后可以手动删除不需要的页面。