From 83e4a0efd2b7bb2dd0190b2ccda734a4b1ada611 Mon Sep 17 00:00:00 2001 From: "Y.D.X." <73375426+YDX-2147483647@users.noreply.github.com> Date: Sun, 29 Dec 2024 11:34:05 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20minted=20=E7=9B=B8?= =?UTF-8?q?=E5=85=B3=E6=96=87=E6=A1=A3=E5=88=B0=20v3=20(#462)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Resovles #461 --- wiki/guide/troubleshooting.md | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/wiki/guide/troubleshooting.md b/wiki/guide/troubleshooting.md index c0a307b..a9829d3 100644 --- a/wiki/guide/troubleshooting.md +++ b/wiki/guide/troubleshooting.md @@ -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 @@ -89,6 +105,10 @@ pygmentize -V ### 添加额外的编译参数 +:::tip 仅限 minted v2 +该问题只可能在 minted v2 上出现。如遇到此问题，也可考虑升级到 v3。 +::: + 如果你出现了类似如下的编译报错： ```txt @@ -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 文档的更改，增量编译，从而加快对原文档进行微小变化后（比如只修改一个字）的编译速度。