Skip to content

Commit

Permalink
docs: 更新 minted 相关文档到 v3 (#462)
Browse files Browse the repository at this point in the history
Resovles #461
  • Loading branch information
YDX-2147483647 authored Dec 29, 2024
1 parent f1027ba commit 83e4a0e
Showing 1 changed file with 20 additions and 12 deletions.
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

0 comments on commit 83e4a0e

Please sign in to comment.