silkeh/latex

LaTeX Docker容器

镜像概述和主要用途

该镜像提供多个用于LaTeX排版的Docker容器，基于alpine:latest构建，包含CTAN的纯净安装（不含文档和源文件）。同时提供基于Debian和Ubuntu发行版的完整TeX Live安装，适用于在CI环境或本地环境中进行LaTeX文档的编译和排版。

核心功能和特性

基于Alpine的安装方案（按标签区分）

• basic (220 MB)
  基础TeX Live方案：包含排版纯TeX或LaTeX文档（PostScript或PDF格式）所需的最小文件集，使用Computer Modern字体，对应collection-basic和collection-latex。

• small (400 MB)
  小型TeX Live方案，对应MacTeX的BasicTeX变体。在basic基础上增加了XeTeX、MetaPost、多种断字规则和部分推荐包。

• context (500 MB)
  用于安装ConTeXt的TeX Live方案。

• medium (800 MB)
  中型TeX Live集合：包含纯TeX、LaTeX、大量推荐包以及大多数欧洲语言支持。

• tetex (1 GB)
  与Thomas Esser维护的teTeX发行版几乎等效的TeX Live方案。

• full (3 GB)
  完整TeX Live方案：安装所有可用组件。

• pandoc (3 GB)
  在full镜像基础上增加pandoc工具。

基于其他发行版的安装

• debian：基于Debian stable的完整TeX Live安装。
• debian-testing：基于Debian testing的完整TeX Live安装。
• ubuntu：基于最新Ubuntu的完整TeX Live安装。

使用场景和适用范围

• CI/CD环境中自动化LaTeX文档构建
• 需要轻量级LaTeX环境的开发或生产场景
• 对TeX Live组件有不同需求（基础、中型、完整等）的项目
• 需要跨平台一致排版结果的场景
• 需要结合pandoc进行文档格式转换的工作流

使用方法和配置说明

基本使用示例（以编译PDF为例）

在当前工作目录下编译LaTeX文档（假设文档名为document.tex）：

bash
# 使用basic标签
docker run --rm -v $(pwd):/workdir silkeh/latex:basic pdflatex document.tex

# 使用full标签（包含更多包）
docker run --rm -v $(pwd):/workdir silkeh/latex:full pdflatex document.tex

# 使用pandoc标签转换文档
docker run --rm -v $(pwd):/workdir silkeh/latex:pandoc pandoc document.md -o document.pdf

关键参数说明

• --rm：容器运行结束后自动删除
• -v $(pwd):/workdir：将当前目录挂载到容器内的/workdir，便于文件读写
• 镜像标签（如basic、full等）：根据需求选择不同的TeX Live安装方案

选择合适的标签

• 简单文档排版：优先选择basic或small（体积小，启动快）
• 复杂文档（含多语言、特殊包）：选择medium或full
• ConTeXt文档：选择context标签
• 需要pandoc：选择pandoc标签
• 需要与Debian/Ubuntu系统一致的环境：选择debian、debian-testing或ubuntu标签