【python】jupyter notebook导出pdf和pdf不显示中文问题

本文介绍: 使用 jupyter notebook 导出 pdf时，出现了一些问题：1）会报错，缺少安装包；2）没有报错并且生成了pdf，但是只显示英文，不显示中文。下面是给出了一些网搜后适用自己的解决办法。

文章 目录

写在前面
1. 使用jupyter notebook导出pdf
2. 中文显示问题
3. 插入.svg图问题
- 3.1 报错描述
- 3.2 解决办法

写在前面

使用 jupyter note book 导出 pdf时，出现了一些问题：

1）会报错，缺少安装包；

2）没有报错并且生成了pdf，但是只显示英文，不显示中文；

3）插入 svg 图片问题；

下面是给出了一些网搜后适用自己的解决办法。

1. 使用 jupyter note book 导出 pdf

导出 pdf 步骤：File-> Download as -> PDF via LaTex(.pdf)：

在这里插入图片描述

出现报错没有Pandoc：

jupyter notebook nbconvert failed: Pandoc wasn't found. Please check that pandoc is installed

报错说明：转换失败，原因是没有找到Pandoc。

1.1 安装`Pandoc`

Pandoc 官网下载地址: https://pan d oc.org/install in g.html

下载安装包github 地址：https://github.com/jgm/pan d oc/release s/tag/3.1.6.2
在这里插入图片描述

git code的镜像也有：https://git code.net/mirrors/jgm/pan d oc/-/release s/3.1.6.1?spm=1033.2243.3001.5876
在这里插入图片描述
下载pan do c后根据提示正常安装即可。

1.2 安装`MiKTex`

如果导出 pdf 通过LaTex，还需要下载MiKTex: http s://m i ktex.org/download
在这里插入图片描述
下载MiKtex后根据提示正常安装即可。

两个包（Pand o c，MiKTex）都安装完成后，退出并重启 jupyter note book后才生效。并且，在重启后在导出 p df 过程中，会自动安装一些依赖包，根据提示点击安装即可。

注：期间想通过HTML导出 p df，还安装过pip install nbconvert（不过，PDF via. HTML还是报错，先忽略）。

1.3 示例 导出pdf

Jup yter 编辑示例：
在这里插入图片描述

导出的pdf 示例：
在这里插入图片描述

2. 中文 显示 问题

如果jupyter note book 编辑的内容都是英文，安装上面2个包并安装依赖包后直接导出是没有问题的。如果内容包含中文，则只显示英文忽略中文。

2.1 显示中文问题示例

Jup yter 编辑内容包含中文示例：
在这里插入图片描述

包含中文导出pdf示例：只输出英文内容，忽略中文。
在这里插入图片描述

2.2 解决办法1：修改tex

需要以下三步：

(1）将.ipynb文件编译为.tex格式：

jupyter nbconvert --to latex ${ipynb_file}

# 示例：
jupyter nbconvert --to latex jupy2pdf-中文.ipynb

执行完成后，会生成文件jupy2pdf-中文.tex 。

(2) 修改tex文件：

在tex文件的中加入加载包命令：

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

在这里插入图片描述

(3) 使用 MiKTeX 生成 pd f：

执行如下命令可生成 pd f：

xelatex ${tex_file}
# 示例：
xelatex jupy2pdf-中文.tex

其中，命令xelatex就是前面下载的MiKTex软件，对应下载路径：

/YourDir/MiKTeX/miktex/bin/x64/xelatex

执行完成后，会生成相应的中间文件：

jupy2pdf-中文.ipynb  # 原文件
jupy2pdf-中文.tex  # tex编辑文件
jupy2pdf-中文.aux
jupy2pdf-中文.log
jupy2pdf-中文.out
jupy2pdf-中文.pdf  # 目标pdf文件

示例生成的目标pdf文件：jupy2pdf-中文.pdf
在这里插入图片描述

2.3 解决办法2：修改 内置文件

“解决方法1：修改tex”虽然解决了中文显示问题，但是每次需要手动添加相应的中文包才能解决。

（1）先是参考了一篇博客，需要在Pyth on 安装包下：

PythonLibsite-packagesnbconverttemplateslatex

找到 base.tplx 文件并进行修改。

笔者有nbc overt安装目录，但是没有找到 latex 目录（更没有 base.tplx 文件），可能这种方法可以从根本上解决并直接导出pdf（而不需要每次手动在tex文件中手动添加）。

（2）其他地方找到了解决办法

参考: http s://www.zhihu.com/que st ion/427092422

与上面修改文件的路不同，修改的是jupyter 目录下的文件：

Pythonsharejupyternbconverttemplateslatexindex.tex.j2

就是把 block doclass下的 article 改成 ctexart：
在这里插入图片描述

示例：从jupyter导出pdf显示中文（章节名称居中了？）

在这里插入图片描述

（3）章节名称居中问题调整

类似地，修改内置文件：

Pythonsharejupyternbconverttemplateslatexindex.tex.j2

在index.tex.j2文件中增加如下命令：参考博客

CTEXsetup[format={Largebfseries}]{section}

修改前后：
在这里插入图片描述

调整后pdf导出示例：
在这里插入图片描述

3. 插入.svg图问题

3.1 报错描述

如果想在pdf中显示高清图，可用.pdf格式的图（可通过.tex插入），也可使用svg（网页即可打开）。

（比如在 https://www.drawio.com/ 这里画的流程图可导出多种格式）

而问题是，在jupyter note book 编辑时，无法插入一个pdf文件，所以想在ipynb插入图只能使用.svg格式的图了，插入方式同一般的图片插入：

![图命名](图路径)
# 比如：
![myfig](./abc.svg)

如果直接的ipynb页面执行 File-> Download as -> PDF via LaTex(.pdf)，是会报错的。(并没有明确指出报错的步骤）
在这里插入图片描述

使用命令行执行：

jupyter nbconvert --to latex ./yourfile.ipynb
xelatex yourfile.tex

也会报错：

! Undefined control sequence.
l.695 includesvg
                 {abc.svg}

总之，可能是MiKTex不支持.svg格式，或者缺少一些包导致。

3.2 解决办法

放弃在ipynb中使用高清图，使用png/jpg等图片格式，导出则不受影响。
为了在ipynb和导出pdf都可显示高清图，当前的解决办法是：

需要svg格式和pdf格式文件都有的情况下：（只有一种格式的话，可用格式转化工具将svg<>pdf转换）
- ipynb继续使用svg格式
- 但是用xelatex导出pdf文件时，按如下步骤执行：
```
# 1) 将ipynb 编译为.tex格式
jupyter nbconvert --to latex ./yourfile.ipynb

# 2) 修改 .tex文件
# 将：  includesvg{yourfig.svg}
# 改为: includegraphics{yourfig.pdf}

# 3) 再执行:
xelatex ./yourfile.tex 
# 生成 yourfile.pdf 文件
```
此时的麻烦程度可能真的想直接在网页ctrl+p另存为pdf算了。。。

但是，如果编辑的文字或脚本不过分长还好，如果比较长或者要用滚动条显示的，直接 ctrl+p得到的pdf显示的内容是不全的。