jupyter notebook中安装LaTeX 引擎 xelatex
时间: 2025-05-18 10:54:10 浏览: 39
### 配置 XeLaTeX 引擎用于 Jupyter Notebook
为了在 Jupyter Notebook 中成功使用 `xelatex` LaTeX 引擎来导出 PDF 或其他文档格式,需要完成以下几个方面的配置:
#### 1. 安装必要的工具链
要使 `xelatex` 正常工作,必须先安装完整的 TeX 发行版以及 Pandoc 工具。以下是具体的操作指南。
- **macOS 用户**
可通过 MacPorts 或 Homebrew 来安装 TeX Live 和 Pandoc。例如,在终端运行以下命令即可完成安装[^2]:
```bash
brew install mactex pandoc
```
- **Windows 用户**
Windows 平台推荐安装 MiKTeX 或者 TeX Live,并确保将其路径添加到系统的环境变量中。可以通过以下步骤实现:
- 下载并安装 [MiKTeX](https://miktex.org/download)。
- 同样也需要安装 Pandoc,可以从其官网获取最新版本的二进制包[^4]。
- **Linux 用户**
大多数 Linux 发行版都提供了方便快捷的方式来进行软件管理,可以直接利用包管理器如 apt-get (Debian/Ubuntu), yum (CentOS/Fedora),或者 zypper(SUSE):
```bash
sudo apt update && sudo apt install texlive-xetex texlive-fonts-recommended texlive-generic-recommended pandoc
```
#### 2. 设置 Jupyter 的 Nbconvert 使用 XeLaTeX
一旦上述依赖项全部就绪,则需进一步调整 Jupyter 的 nbconvert 命令参数以便指定采用 `xelatex` 而不是默认的 pdflatex 进行渲染处理。这通常涉及到创建自定义模板或是修改现有的配置文件[^1]:
```python
from traitlets.config import Config
c = Config()
c.LaTeX.builder = 'xelatex'
with open('custom_config.py', 'w') as f:
f.write(c.to_string())
```
接着执行转换操作的时候记得带上刚刚生成的那个配置脚本作为输入之一:
```bash
jupyter nbconvert --to pdf --config=custom_config.py your_notebook.ipynb
```
#### 3. 解决中文显示问题
对于包含大量汉字字符的内容来说,默认情况下可能无法正确呈现出来。此时就需要引入额外的支持库来增强字体管理和排版能力[^3]。一种常见做法是在 .tex 文件头部追加如下几行代码片段:
```latex
\usepackage{fontspec}
\setmainfont{SimSun} % 替换为你本地可用的一种合适字体名称
\usepackage[UTF8]{ctex}
```
以上设置能够有效解决大部分场景下的编码混乱现象,从而保障最终输出物中的文字清晰可辨认。
---
###
阅读全文
相关推荐


















