问题描述
最近迷上了利用Jupyter notebook 为工具学习有关Python语言方面的知识。遇到该错误纯粹是个偶然,这应该算是Jupyter notebook的一个bug。
问题的出现是这样的:我读到书籍《Automate the boring stuff with Python》1的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
\LaTeX
LATEX方面的错误.
原因分析
从上图可以清晰的看出原因之所在。Jupyter notebook转换成pdf格式的时候,借助于本机上的 LaTeX \LaTeX LATEX软件进行中间的转换工作,亦即,在进行转换pdf的时候,先将Jupyter notebook转换成 LaTeX \LaTeX LATEX代码,再利用TeX live (我电脑上安装的是Tex live)编译 LaTeX \LaTeX LATEX代码,编译完成后得到pdf格式文件。针对本问题的notebook实例,在notebook中碰巧出现了:
(\d\d
而经过我查看中间的
LaTeX
\LaTeX
LATEX代码,发现在其中有\d内容。熟悉
LaTeX
\LaTeX
LATEX的朋友很容易明白,在其代码中\
起到输入
LaTeX
\LaTeX
LATEX指令的作用。而在此例中,
LaTeX
\LaTeX
LATEX引擎没发现指令\d
的存在,所以
LaTeX
\LaTeX
LATEX引擎报错,pdf的生成工作到此为止。这就是整个问题所在。
解决方案
这真是Jupyter notebook软件的一个bug。它在转换pdf时,将本来应该是用户内容的部分转换而成为了 LaTeX \LaTeX LATEX中的并不存在的命令。
熟悉
LaTeX
\LaTeX
LATEX的朋友自然容易知道解决方案:手工改动
LaTeX
\LaTeX
LATEX代码,在凡事\d
的地方都换位\\d
,但是Jupyter notebook中的代码部分不用替换。
遇到这个问题,真是个偶然!!
Albert Sweigart. Automate the boring stuff with Python. No Starch Press, 2015. ↩︎