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

文章目录

  • 写在前面
  • [1. 使用jupyter notebook导出pdf](#1. 使用jupyter notebook导出pdf)
    • [1.1 安装`Pandoc`](#1.1 安装Pandoc)
    • [1.2 安装`MiKTex`](#1.2 安装MiKTex)
    • [1.3 示例导出pdf](#1.3 示例导出pdf)
  • [2. 中文显示问题](#2. 中文显示问题)
    • [2.1 显示中文问题示例](#2.1 显示中文问题示例)
    • [2.2 解决办法1:修改tex](#2.2 解决办法1:修改tex)
    • [2.3 解决办法2:修改内置文件](#2.3 解决办法2:修改内置文件)

写在前面

使用jupyter notebook导出pdf时,出现了一些问题:

1)会报错,缺少安装包;

2)没有报错并且生成了pdf,但是只显示英文,不显示中文。

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

1. 使用jupyter notebook导出pdf

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

出现报错没有Pandoc:

error 复制代码
jupyter notebook nbconvert failed: Pandoc wasn't found. Please check that pandoc is installed

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

1.1 安装Pandoc

Pandoc官网下载地址: https://pandoc.org/installing.html

下载安装包github地址:https://github.com/jgm/pandoc/releases/tag/3.1.6.2

gitcode的镜像也有:https://gitcode.net/mirrors/jgm/pandoc/-/releases/3.1.6.1?spm=1033.2243.3001.5876

下载pandoc后根据提示正常安装即可。

1.2 安装MiKTex

如果导出pdf通过LaTex,还需要下载MiKTex: https://miktex.org/download

下载MiKtex后根据提示正常安装即可。

两个包(Pandoc,MiKTex)都安装完成后,退出并重启jupyter notebook后才生效。并且,在重启后在导出pdf过程中,会自动安装一些依赖包,根据提示点击安装即可。

注:期间想通过HTML导出pdf,还安装过pip install nbconvert(不过,PDF via. HTML还是报错,先忽略)。

1.3 示例导出pdf

Jupyter编辑示例:

导出的pdf示例:

2. 中文显示问题

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

2.1 显示中文问题示例

Jupyter编辑内容包含中文示例:

包含中文导出pdf示例:只输出英文内容,忽略中文。

2.2 解决办法1:修改tex

需要以下三步:

  • (1)将.ipynb文件编译为.tex格式:

    shell 复制代码
    jupyter nbconvert --to latex ${ipynb_file}
    
    # 示例:
    jupyter nbconvert --to latex jupy2pdf-中文.ipynb

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

  • (2) 修改tex文件:

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

    tex 复制代码
    \usepackage{fontspec, xunicode, xltxtra}
    \setmainfont{Microsoft YaHei}
    \usepackage{ctex}
  • (3) 使用 MiKTeX 生成pdf:

    执行如下命令可生成pdf:

    shell 复制代码
    xelatex ${tex_file}
    # 示例:
    xelatex jupy2pdf-中文.tex 

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

    shell 复制代码
    /YourDir/MiKTeX/miktex/bin/x64/xelatex

    执行完成后,会生成相应的中间文件:

    shell 复制代码
    jupy2pdf-中文.ipynb  # 原文件
    jupy2pdf-中文.tex  # tex编辑文件
    jupy2pdf-中文.aux
    jupy2pdf-中文.log
    jupy2pdf-中文.out
    jupy2pdf-中文.pdf  # 目标pdf文件

    示例生成的目标pdf文件:jupy2pdf-中文.pdf

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

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

(1)先是参考了一篇博客,需要在Python安装包下:

shell 复制代码
Python\Lib\site-packages\nbconvert\templates\latex 

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

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

(2)其他地方找到了解决办法

参考: https://www.zhihu.com/question/427092422

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

shell 复制代码
Python\share\jupyter\nbconvert\templates\latex\index.tex.j2

就是把 block doclass下的 article 改成 ctexart:

示例:从jupyter导出pdf显示中文 (章节名称居中了?)

(3)章节名称居中问题调整

类似地,修改内置文件:

shell 复制代码
Python\share\jupyter\nbconvert\templates\latex\index.tex.j2

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

tex 复制代码
\CTEXsetup[format={\Large\bfseries}]{section}

修改前后:

调整后pdf导出示例:


<完>

相关推荐
pride.li3 分钟前
第03章 Python 教程-基础语法:注释与变量
服务器·前端·后端·python·算法·计算机视觉
databook6 分钟前
用 Pydantic AI 从零搭建一个能干活的 AI Agent
人工智能·python
康小旺26 分钟前
把 markitdown 做成 Windows 桌面版:拖进文档就出 Markdown,附 233MB→64MB 打包裁剪全过程
python
启观川1 小时前
数据结构与算法-第 3 章 常用算法-贪心算法
数据结构·笔记·python·算法·贪心算法
南笙北梦1 小时前
本地开源大模型多轮对话显存泄漏排查与修复实录
python
小羊没烦恼!2 小时前
如何在IIS6,7中部署ASP.NET网站?
数据库·后端·python·web安全·asp.net
钱栈up2 小时前
扫完 3.5 万文件后,我发现了 521 组散落的同名文件
爬虫·python·数据分析
黄权光2 小时前
AI智能体项目实战记录(01):开发环境搭建之conda的安装与配置
python
Wokoo72 小时前
Selenium 核心 API 解析(三)
python·功能测试·selenium
在世修行2 小时前
智学文枢:技术选型
python·技术选型