扩展 TeX Live

可以使用新的 Dockerfile 扩展现有的 TeX Live 镜像，并配置应用以使用新镜像。

在这里我们提供一些安装新包或字体的指导，但自定义镜像的配置不在我们的支持条款范围内。

TeX Live 镜像不经常更新。我们建议在升级 Server Pro 时重建自定义镜像。

以下章节适用于 Server Pro 以及 沙箱编译 仅。

安装和更新新包

您可以使用 tlmgr 诸如 以下 的命令 tlmgr 安装 和 tlmgr 更新 以如下示例管理 TeX Live 包：

来自 ghcr.io/ayaka-notes/texlive-full:2023.1

运行 tlmgr update --force ebproof

使用 tlmgr 在较旧的 TeX Live 镜像中

默认情况下 tlmgr 从最新的 TeX Live 发行版下载资源。在修补较旧的 TeX Live 镜像时，需要将下载切换到相应的归档。参见其中的列表 https://www.tug.org/historic/ 用于归档镜像。

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# 例如 RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

运行 tlmgr update --force ebproof

安装新字体

在 Tex Live 发行版中安装新字体有不同的步骤，安装自定义字体可能需要多个步骤。查看 安装 TeX 字体的说明 在官方 Tex Live 文档中可能是一个很好的起点。

以下 Dockerfile 展示了在已有的 Tex Live 2022 镜像上安装 TrueType 字体 的示例：

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# 重新生成字体信息缓存
RUN fc-cache

配置 Server Pro 以使用新镜像

使用名称 ghcr.io/ayaka-notes/texlive-full 以及自定义标签来构建新镜像，如：

docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom

我们现在可以配置 Server Pro 使用新的 2023.1-custom 镜像，更新 TEX_LIVE_DOCKER_IMAGE 和 ALL_TEX_LIVE_DOCKER_IMAGES 环境变量：

TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"

在上面的示例中，新项目默认设置为使用新的 2023.1-custom 镜像，而 2023.1 在需要时仍然可用。