reitzig/texlive-base

TeXlive Docker镜像（基础版）

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

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

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

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

• https://hub.docker.com/r/reitzig/texlive-minimal（https://github.com/reitzig/texlive-docker/blob/master/profiles/minimal.profile）
• https://hub.docker.com/r/reitzig/texlive-base（https://github.com/reitzig/texlive-docker/blob/master/profiles/base.profile）
• https://hub.docker.com/r/reitzig/texlive-base-luatex（https://github.com/reitzig/texlive-docker/blob/master/profiles/base-luatex.profile）

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

• https://github.com/reitzig/texlive-docker/blob/master/demo/static-document-server

使用方法

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

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

注意：

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

有关其他使用方式，请参见https://github.com/reitzig/texlive-docker/blob/master/examples目录中的脚本。

依赖项

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

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

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

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

https://ftp.math.utah.edu/pub/tex/historic/systems/texlive/2023/tlnet-final

此功能从2024.2版本开始可用；有关如何向后移植到旧镜像的提示，请参见https://github.com/reitzig/texlive-docker/issues/18#issuecomment-2022953222%E3%80%82

⚠️ 请注意，大多数CTAN镜像不维护历史版本（参见https://tex.stackexchange.com/questions/460132/historic-tex-live-distributions-https-sftp-mirror%EF%BC%89%EF%BC%8C%E5%9B%A0%E6%AD%A4%E8%AF%B7%E8%AE%B0%E4%BD%8F%EF%BC%8C%E5%B9%BF%E6%B3%9B%E4%BD%BF%E7%94%A8%E6%AD%A4%E8%A7%A3%E5%86%B3%E6%96%B9%E6%B3%95%E4%BC%9A%E7%BB%99%E5%B0%91%E6%95%B0%E6%8F%90%E4%BE%9B%E5%8E%86%E5%8F%B2%E7%89%88%E6%9C%AC%E7%9A%84%E9%95%9C%E5%83%8F%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%B8%A6%E6%9D%A5%E5%8E%8B%E5%8A%9B%E3%80%82%E6%88%91%E4%BB%AC%E5%BC%BA%E7%83%88%E5%BB%BA%E8%AE%AE%E5%B0%BD%E5%BF%AB%E5%8D%87%E7%BA%A7%E5%88%B0%E6%9C%80%E6%96%B0%E7%9A%84TeXlive%E7%89%88%E6%9C%AC%EF%BC%81

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

参数

您可以通过https://docs.docker.com/engine/reference/commandline/run/#set-environment-variables--e---env---env-file调整https://github.com/reitzig/texlive-docker/blob/master/entrypoint.sh的某些默认值：

• 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替换为https://github.com/reitzig/texlive-docker/blob/master/profiles目录中的任何配置文件名称，即可从其他基线开始构建。

自定义

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

• 使用您自己的Dockerfile扩展现有镜像（参见https://github.com/reitzig/texlive-docker/blob/master/examples/Dockerfile）；安装额外的TeXlive（甚至Alpine）软件包、将源文件或额外脚本复制到适当的文件夹、修复工作命令等。

• 使用https://www.tug.org/texlive/acquire-netinstall.html创建自己的TeXlive安装配置文件。确保：

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

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

  将最终文件复制到https://github.com/reitzig/texlive-docker/blob/master/profiles目录，然后运行常规构建命令。