Jupyter Notebook导出包含中文的pdf

December 17, 2023
测试
测试
测试
测试
3 分钟阅读

本文763字,预计阅读需6分钟;

Jupyter Notebook是很好的数据科学创作环境。Jupyter提供导出的格式有 .py、.html、.md、.pdf等。目前用其导出包含中文的pdf会遇到很多坑,网上也有一些解决方案,大致分为两种方式,一是安装 pandoc并不断根据报错提示安装sty文件,不是很有效,另一种是安装MiKTeX并改LaTeX文件。本文主要讲第二种方式。

Jupyter Notebook支持的导出格式

从效果来看,网页中notebook的渲染是最好看的,导出的html对代码和超链接失真严重。在网页上点Download as -> PDF via LaTex的时候先是说缺少Pandoc库,于是pip install pandoc,之后不再说缺少这个库了,而是 nbconvert failed: pdflatex not found on PATH 或者 nbconvert failed: PDF creating failed, captured latex output。查了一些资料后改用命令行,要避免'xelatex' 不是内部或外部命令,也不是可运行的程序或批处理文件,需要先安装MiKTeX,在其官网下载(https://miktex.org/download) 后,Windows版一路next安装就行。安装过程还是耗费些时间的,下载安装完成之后的步骤是:

1, ipynb文件编译为tex

在命令行中定位到要转换的jupyter文件的路径下,输入jupyter nbconvert --to latex yourNotebookName.ipynb

编译ipynb文件为LaTeX文件

在文件目录下就可以看到一个叫yourNotebookName.tex的LaTeX文件了。

2, 手动编辑latex文件

为了能支持输出中文,需要改一下tex文件,在编辑器(我用的是Notepad++)打开刚才生成的LaTeX文件, 在\documentclass{article}(没有这一句就在\documentclass[11pt]{ctexart} 的后面插入下面的语句)后面插入

\usepackage{fontspec, xunicode, xltxtra}\setmainfont{Microsoft YaHei}

修改LaTex文件

需注意的是,目前(2019年9月)下载的MiKTeX 通过上面语句编译生成的tex会缺少一句\usepackage{ctex} , 所以如果在\setmainfont{Microsoft YaHei} 缺了对ctex的引用的话,就需要补上 \usepackage{ctex} 。

3, 转latex为pdf

随后在命令行下输入:(我演示文件用的是GeoCluster.tex)

xelatex yourNotebookName.tex

之前没有运行过xelatex,首次运行会安装一些依赖文件,会慢一些,最后运行完毕:

可以在文件夹下看到输出的文件:

最后文件夹下的结果

  • .ipynb 是我们的jupyter文件
  • .tex 是由jupyter notebook文件生成的
  • .pdf 是我们最后的目标文件由.tex文件生成
  • .log、.out、.aux是LaTex生成pdf的一些输出和日志

总结一下,从jupyter notebook生成pdf文件需要的依赖项还是比较多的,Windows下安装MiKTeX才能用xelatex命令。生成步骤是先把ipynb文件编译为LaTex,然后为了支持中文修改一下lex文件,最后转换为pdf文件。

最后效果如下,虽然还是比不上网页端.ipynb的直接渲染效果,但比起导出的html等格式,能更好地作为展示格式。

生成pdf的效果

另外从ipynb文件变成pdf文件还可以采用的方式有:

  • 打开ipynb文件后在浏览器直接选择打印;
  • 导出markdown在Typora软件中选择导出为PDF;

这三种方式生成的PDF效果对比如下图:

可看出,文中这种导出LaTeX再变成PDF是很实用的。

继续阅读

更多来自我们博客的帖子

如何安装 BuddyPress
由 测试 December 17, 2023
经过差不多一年的开发,BuddyPress 这个基于 WordPress Mu 的 SNS 插件正式版终于发布了。BuddyPress...
阅读更多
Filter如何工作
由 测试 December 17, 2023
在 web.xml...
阅读更多
如何理解CGAffineTransform
由 测试 December 17, 2023
CGAffineTransform A structure for holding an affine transformation matrix. ...
阅读更多