Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: 更新 minted 相关文档到 v3 #462

Merged
merged 1 commit into from
Dec 29, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 20 additions & 12 deletions wiki/guide/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,24 @@ Error: Style 'gb7714-2015' not found.

在论文中不可避免的要加入「代码块」。一般我们代码高亮使用的宏包都是 `minted`,如果你发现插入 `minted` 环境后,编译失败,你可以尝试如下的方法解决:

### 删除 `minted` 宏包的缓存文件夹

如果你出现了类似如下的编译报错:

```txt
! Undefined control sequence.
```

则可能是由于 `minted` 缓存导致。一般如果你编译过带有 `minted` 环境的 LaTeX 项目,根目录都会有一个名称为 `_minted` 或 `_minted-{jobname}` 的缓存文件夹。你可以尝试将这一文件夹删除,重新编译,排查问题。

![minted command cache folder](https://i.loli.net/2020/03/06/D4PQKoxmtgObBN2.png)

### 排查是否正确安装 Python 与 `pygments` 包

:::tip 仅限 minted v2
该问题只可能在 minted v2 上出现。如遇到此问题,也可考虑升级到 v3。
:::

如果你出现了类似如下的编译报错:

```txt
Expand All @@ -89,6 +105,10 @@ pygmentize -V

### 添加额外的编译参数

:::tip 仅限 minted v2
该问题只可能在 minted v2 上出现。如遇到此问题,也可考虑升级到 v3。
:::

如果你出现了类似如下的编译报错:

```txt
Expand Down Expand Up @@ -135,18 +155,6 @@ Package minted Error: You must invoke LaTeX with the -shell-escape flag.
},
```

### 删除 `minted` 宏包的缓存文件夹

如果你出现了类似如下的编译报错:

```txt
! Undefined control sequence.
```

则可能是由于 `minted` 缓存导致。一般如果你编译过带有 `minted` 环境的 LaTeX 项目,根目录都会有一个名称为 `_minted_doc` 的缓存文件夹。你可以尝试将这一文件夹删除,重新编译,排查问题。

![minted command cache folder](https://i.loli.net/2020/03/06/D4PQKoxmtgObBN2.png)

## 编译过慢,一次更改需要编译半分钟

如果你觉得模板中 `xelatex -> biber -> xelatex -> xelatex` 四步编译太慢,每次都全量编译,需要等待半分钟才能出结果,你可以尝试使用 `latexmk` 进行编译。`latexmk` 每次会根据你 LaTeX 文档的更改,增量编译,从而加快对原文档进行微小变化后(比如只修改一个字)的编译速度。
Expand Down
Loading