TeXlive Docker镜像（base-luatex）

![Dockerfile]([] ![GitHub issues]([] ![GitHub license]([***]

为TeXlive创建可用且普遍适用的Docker镜像的又一次尝试。

基本概念是提供轻量级基础镜像，在需要时从CTAN安装额外包。

这些镜像尝试覆盖以下用例：

替代本地TeXlive安装。
在CI/CD管道中构建LaTeX文档。
使用旧包版本构建遗留文档。

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

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

提供一组预构建的静态文档。

使用方法

最快的一次性构建当前文档的方法如下：

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并运行常规构建命令。