TeXlive Docker镜像（基础版）

这是为TeXlive打造的Docker镜像，旨在提供可用且具有普遍适用性的解决方案。其核心概念是提供小型基础镜像，可根据需要从CTAN（综合TeX存档网络）安装额外的软件包。

这些镜像旨在覆盖以下使用场景：

• 替代本地TeXlive安装。
• 在CI/CD流水线中构建LaTeX文档。
• 使用旧软件包版本构建遗留文档。

我们目前基于TeXlive安装程序建议的不同软件包集合发布以下镜像（从小到大）：

• reitzig/texlive-minimal（配置文件）
• reitzig/texlive-base（配置文件）
• reitzig/texlive-base-luatex（配置文件）

我们还提供概念验证（PoC）以展示可基于此处提供的基础镜像构建更复杂的应用：

• 提供静态预构建文档集。

使用方法

构建当前目录文档的最快方式（一次性）如下：

bash
docker run --rm \
    --volume `pwd`:/work/src:ro \
    --volume `pwd`/out:/work/out \
    reitzig/texlive-base-luatex \
    work lualatex hello_world.tex

注意：

• 此命令假设texlive-base-luatex镜像之外所需的所有TeXlive软件包均列在Texlivefile中。如果您不介意下载更大的镜像，也可使用reitzig/texlive-full镜像。
• 此命令可能会覆盖out目录中的文件。请选择当前未使用的文件夹名称。

有关其他使用方式，请参见examples目录中的脚本。

依赖项

在源目录中放置一个名为Texlivefile的文件，其中列出所需的CTAN软件包，每行一个名称。容器将在运行工作命令前安装该列表中的所有软件包。

⚠️ 当TeXlive发布新版本后，这种安装依赖项的方式将停止工作，并显示类似以下错误：

tlmgr: Local TeX Live (2023) is older than remote repository (2024).

如果您需要暂时继续使用旧镜像，可通过设置环境变量TEXLIVE_REPOSITORY覆盖仓库地址，例如：

[***]

此功能从2024.2版本开始可用；有关如何向后移植到旧镜像的提示，请参见reitzig/texlive-docker#18.2022953222。

⚠️ 请注意，大多数CTAN镜像不维护历史版本（参见tex.SE#460132），因此请记住，广泛使用此解决方法会给少数提供历史版本的镜像服务器带来压力。我们强烈建议尽快升级到最新的TeXlive版本！

ℹ️ 话虽如此，另一种方法是维护包含历史软件包版本的自定义Docker镜像。这种方法完全避免了在运行时执行tlmgr，因此仓库冻结不会影响您的构建。

参数

您可以通过设置环境变量调整主容器脚本的某些默认值：

• BUILDSCRIPT（默认值：build.sh）
  如果指定的脚本存在，则除非提供工作命令，否则将执行该脚本。
• TEXLIVEFILE（默认值：Texlivefile）
  用于读取依赖项的文件。
• OUTPUT（默认值：*.pdf *.log）
  用于指定应从工作目录复制到输出目录的所有文件的Shell模式。

调试

工作命令的所有输出都收集在一个文件夹中，可通过以下命令提取：

bash
docker cp $container:/work/tmp ./

构建

运行以下命令在本地构建镜像：

bash
docker build -t texlive-base-luatex --build-arg "profile=base-luatex" .

将base-luatex替换为profiles目录中的任何配置文件名称，即可从其他基线开始构建。

自定义

如果您反复需要完全相同的依赖项集甚至源文件，创建自己的TeXlive Docker镜像可能是合理的。有两种方法可以实现：

• 使用您自己的Dockerfile扩展现有镜像（参见示例）；安装额外的TeXlive（甚至Alpine）软件包、将源文件或额外脚本复制到适当的文件夹、修复工作命令等。

• 使用install-tl创建自己的TeXlive安装配置文件。确保：

  1. 选择平台x86_64-linuxmusl，并且
  2. 手动将配置文件中的行binary_x86_64-linux 1更改为binary_x86_64-linux 0。

  如果您希望跨不同TeXlive版本使用配置文件，请将所有TeXlive版本（例如2019）的出现替换为${tlversion}。

  将最终文件复制到profiles目录，然后运行常规构建命令。