kjarosh/latex Docker 镜像 - 轩辕镜像

Docker中的LaTeX

![GitHub build status]([] ![GitHub release]([] ![DockerHub]([] ![GitHub Container Registry]([]

]([] ]([] ![Docker Image Size (full)]([***]

本仓库定义了一组可用于在容器中运行LaTeX的镜像（例如在CI/CD中）。它们有多种版本，对应不同的TeX Live方案（见下表）。默认方案为full，包含所有包。

如果缺少某些包，您始终可以使用tlmgr安装。镜像基于alpine，因此可使用apk安装系统包。

镜像设计为可复用层。例如，full版本会在medium版本的基础上添加不存在的包层，便于管理并节省空间。

使用方法

如果您正在编写CI/CD配置，请查看CI/CD示例！

假设您想快速将当前目录中名为main.tex的文件编译为PDF，并将输出放在./out中：

shell
docker run --rm -v "$PWD:/src" -w /src -u "$UID:$GID" kjarosh/latex:2025.1 latexmk -pdf -outdir=out -auxdir=out/aux main.tex

如果您想处理LaTeX项目并实时查看更改，可在命令末尾添加-pvc。这将在源文件更改时自动重新编译项目。

如果想使用不同的引擎，例如使用XeLaTeX可添加-xelatex，使用LuaLaTeX可添加-lualatex。

其他有用的选项包括-c、-g或-silent等。

详见latexmk文档了解详细用法和选项。

如果不想使用latexmk，您可以自由使用任何命令（latex、pdflatex、xelatex等），它们应该可以正常工作。对于更复杂的构建过程，建议使用make等构建工具。在这种情况下，您需要在容器中通过apk add make安装它。

版本

以下描述几种版本类型。

如果不确定使用哪个版本，建议使用最新稳定版本。

稳定版本

稳定版本格式为<major>.<minor>（例如2022.1）。主要版本对应TeX Live版本（即年份），次要版本是该年份内的镜像版本。

稳定版本提供镜像更新和修复，包含发布时特定TeX Live版本的包集合。

所有稳定版本可在发布页面查看。

开发版本

如果您想使用最新的TeX Live或访问过去的旧版本，可使用开发版本。

开发版本每天自动发布，有以下几种格式：

1. devel —— 使用主TL镜像的最新开发构建。强烈不建议使用此版本，尤其是在CI/CD中，因为当有新版本TeX Live发布时，tlmgr可能无法工作。

2. devel-<TL_VERSION>-<DATE> —— 包含特定<TL_VERSION>的TeX Live开发版本，基于<DATE>的历史镜像（确保tlmgr可工作）。通常这些镜像仅创建一次，未来不会更新。

3. devel-<TL_VERSION> —— 特定TeX Live版本的最新开发构建。当<TL_VERSION>是当前TeX Live版本时，此镜像通常比<TL_VERSION>的最新稳定版本更新。但当<TL_VERSION>不是当前TeX Live版本时，最新稳定版本通常包含维护修复和基础镜像更新。

4. devel-any-<DATE> —— 包含<DATE>的TeX Live开发版本。与devel-<TL_VERSION>-<DATE>相同，但不包含<TL_VERSION>，适用于想使用<DATE>的TeX Live而不知道<TL_VERSION>的场景。

CI/CD 示例

GitHub Actions

使用latexmk的示例：

yaml
name: 编译LaTeX
on: [ push ]
jobs:
  container:
    runs-on: ubuntu-latest
    container: kjarosh/latex:2024.4
    steps:
      - name: 检出代码
        uses: actions/checkout@v4

      - name: 使用latexmk构建
        run: latexmk -pdf -output-directory=out main.tex

      - name: 上传文档
        uses: actions/upload-artifact@v4
        with:
          name: 主文档
          path: out/index.pdf

GitLab CI/CD

使用latexmk的示例：

yaml
build:
  stage: build
  image: kjarosh/latex:2024.4
  script:
    - latexmk -pdf -output-directory=out main.tex
  artifacts:
    paths:
      - out/index.pdf