Jupyter notebook 转pdf时出现的一个错误（只出现前4页）及原因分析

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/RobertChenGuangzhi/article/details/83830980

问题描述

最近迷上了利用Jupyter notebook 为工具学习有关Python语言方面的知识。遇到该错误纯粹是个偶然，这应该算是Jupyter notebook的一个bug。

问题的出现是这样的：我读到书籍《Automate the boring stuff with Python》¹的170页的时候，有这样一句话：

Adding parentheses will create groups in the regex: (\d\d\d)-(\d\d\d-\d\d\d\d). Then you can…

在Jupyter notebook能正确显示，如下图：

可是当我利用Jupyter notebook将该notebook转换成pdf的时候，发现总是得到Jupyter notebook的部分内容，在pdf中显示为4页内容；而在Jupyter notebook的后面好多内容，都没在pdf中显示出来。

苦思不得其解，我查看Jupyter notebook的服务器端，发现：

上述是一个 $\LaTeX$方面的错误.

原因分析

从上图可以清晰的看出原因之所在。Jupyter notebook转换成pdf格式的时候，借助于本机上的 $\LaTeX$软件进行中间的转换工作，亦即，在进行转换pdf的时候，先将Jupyter notebook转换成 $\LaTeX$代码，再利用TeX live (我电脑上安装的是Tex live)编译 $\LaTeX$代码，编译完成后得到pdf格式文件。针对本问题的notebook实例，在notebook中碰巧出现了：

(\d\d

而经过我查看中间的 $\LaTeX$代码，发现在其中有\d内容。熟悉 $\LaTeX$的朋友很容易明白，在其代码中\起到输入 $\LaTeX$指令的作用。而在此例中， $\LaTeX$引擎没发现指令\d的存在，所以 $\LaTeX$引擎报错，pdf的生成工作到此为止。这就是整个问题所在。

解决方案

这真是Jupyter notebook软件的一个bug。它在转换pdf时，将本来应该是用户内容的部分转换而成为了 $\LaTeX$中的并不存在的命令。

熟悉 $\LaTeX$的朋友自然容易知道解决方案：手工改动 $\LaTeX$代码，在凡事\d的地方都换位\\d，但是Jupyter notebook中的代码部分不用替换。

遇到这个问题，真是个偶然！！

---

1. Albert Sweigart. Automate the boring stuff with Python. No Starch Press, 2015. ↩︎