将 Jupyter Notebook 转换为 PDF 时如何渲染图像？

Question

我使用“nbconvert”和“notebook-as-pdf”模块将我的 Jupyter Notebooks 转换为 PDF 文件，并在命令行中执行以下操作：

jupyter nbconvert --to PDFviaHTML <mynotebook.ipynb>

笔记本中显示的 Markdown 单元格中引用的图像（png 文件）不会在生成的 PDF 文件中呈现。 我通过以下方式引用 MD 单元格中的图像：

.[sometext](relativepath/filename.png)

或者

<img src="relativepath/filename.png">

作为解决方法，我可以在菜单“下载为...”中将笔记本下载为 HTML。 图像在生成的 HTML 文件中正确呈现（假设图像在正确的位置提供，这里是笔记本目录的“相对路径”子文件夹）。

有谁知道可行的解决方案？ （我主要尝试使用 PDF via LaTex 转换解决方案，不幸的是在我的 M1 Mac 笔记本电脑上遇到了问题，这就是我首先使用 PDFviaHTML 解决方案的原因）。

Answer 1

jupyter nbconvert --to pdfviahtml notebook.ipynb

对我来说开箱即用

pip install notebook-as-pdf

使用https://pypi.org/project/notebook-as-pdf/

安装使用铬，显然这是确保 html 渲染用作 pdf 输入而不是通过 latex 走更复杂的路线的巧妙技巧。方法是“所见即所得”，这正是我们所需要的我想这也是你提问的动机。

另请参阅 https 上关于如何将其纳入 ploomber 管道的冗长讨论：//github.com/ploomber/ploomber/issues/658和相应的问题https：//github.com/ploomber/ploomber/issues/675

可能只是大写/小写的方式

PDFviaHTML

不工作或类似的明显/简单的问题是在路上？

有关我们环境的更多详细信息：

python --version
Python 3.9.10

jupyter --version
jupyter core     : 4.7.1
jupyter-notebook : 6.4.3
qtconsole        : 5.2.2
ipython          : 7.27.0
ipykernel        : 6.3.1
jupyter client   : 7.0.2
jupyter lab      : 3.3.2
nbconvert        : 5.6.1
ipywidgets       : 7.7.0
nbformat         : 5.1.3
traitlets        : 4.3.3

这些计算机是用于测试的 Mac OS 机器和用于生产的 Ubuntu 20.04 LTS 或 miniconda docker 映像。