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

问题描述

最近迷上了利用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的服务器端，发现：

上述是一个$\text{LATEX}$方面的错误.

原因分析

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

(\d\d

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

解决方案

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

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

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

---

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