跳转到主要内容
你可以通过新的 Dockerfile 扩展现有的 TeX Live 镜像,并配置应用程序使用新镜像。 以下是一些安装新宏包或字体的指导。 TeX Live 镜像的更新频率较低。我们建议在升级 Ayakaleaf Pro 时重新构建自定义镜像。
以下内容仅适用于沙盒编译(Sandboxed Compiles)。

安装和更新新宏包

你可以使用 tlmgr install、tlmgr update 等 tlmgr 命令管理 TeX Live 宏包,示例如下:

在旧版 TeX Live 镜像中使用 tlmgr

默认情况下,tlmgr 会从最新的 TeX Live 版本下载资源。为旧版 TeX Live 镜像打补丁时,需要将下载源切换到相应的归档。归档镜像列表请参见 https://www.tug.org/historic/。

安装新字体

在 TeX Live 发行版中安装新字体有多种方法,安装自定义字体可能需要多个步骤。查阅 TeX Live 官方文档中的TeX 字体安装说明或许是一个不错的起点。 下面的 Dockerfile 展示了在现有 TeX Live 2022 镜像上安装 TrueType 字体的示例:

配置 Ayakaleaf Pro 使用新镜像

使用名称 ghcr.io/ayaka-notes/texlive-full 和自定义标签构建新镜像,例如:
现在,我们可以通过更新 TEX_LIVE_DOCKER_IMAGE、ALL_TEX_LIVE_DOCKER_IMAGES 和 ALL_TEX_LIVE_DOCKER_IMAGE_NAMES 环境变量(名称是可选的,并与镜像的顺序一一对应),配置 Ayakaleaf Pro 使用新的 2023.1-custom 镜像:
在上面的示例中,新项目默认使用新的 2023.1-custom 镜像,而 2023.1 仍可在需要时使用。 自定义镜像只存在于你的宿主机上,因此 bin/up 无法拉取它。请在 config/overleaf.rc 中设置 SIBLING_CONTAINERS_PULL=false(其他镜像请自行使用 docker pull 拉取),然后运行 bin/up -d 以应用新设置。

问答

回答:使用 texlive-full 镜像时不需要。这些镜像包含 TeX Live 中文宏包(ctex、xeCJK)及 Fandol 字体,以及 Noto CJK 字体(例如 Noto Serif CJK SC)。在编辑器设置中将项目的编译器设置为 XeLaTeX,然后进行编译,例如:
要使用 Noto 代替 Fandol,请添加 \setCJKmainfont{Noto Serif CJK SC}。不需要 latexmkrc。如需使用其他字体,请按照安装新字体中的说明构建自定义镜像。
最后修改于 2026年11月2日