menzerath/latex Docker镜像文档

镜像概述

menzerath/latex是一个轻量级LaTeX Docker镜像，基于TeX Live构建，旨在提供便捷的LaTeX文档编译环境。该镜像解决了本地配置复杂TeX Live环境的问题，通过Docker容器化方式，让用户无需手动安装和维护LaTeX系统，即可快速编译LaTeX文档，适用于个人日常使用、自动化构建流程等场景。

核心功能与特性

• 轻量级设计：相比完整TeX Live本地安装，镜像体积更小，减少磁盘和内存资源占用
• 基础组件齐全：内置LaTeX基础文档类（如article、report、book）及常用宏包（amsmath、graphicx、hyperref等），满足多数日常文档编译需求
• 简单易用：通过简洁的Docker命令即可挂载本地文档并执行编译，无需复杂配置
• 跨平台兼容：支持所有Docker运行环境（Linux、macOS、Windows等），消除不同操作系统间的LaTeX环境差异
• 多引擎支持：包含pdflatex、xelatex、lualatex等常用LaTeX编译引擎，适应不同编码和字体需求

使用场景

• 个人日常文档编译：用于编译论文、报告、简历等个人LaTeX文档，无需本地安装TeX Live
• CI/CD流程集成：在自动化构建流程（如GitHub Actions、GitLab CI）中集成，实现文档的自动编译、生成和发布
• 临时LaTeX环境：在公共电脑、临时工作设备等场景下，快速搭建临时LaTeX环境，避免本地环境污染
• 教学与演示：作为教学工具，简化学生端LaTeX环境配置步骤，专注于文档内容编写

使用方法与配置说明

前提条件

• 已安装Docker Engine（参考Docker***安装指南）

基本使用命令

通过以下命令编译本地LaTeX文档：

bash
docker run --rm -v $(pwd):/workdir menzerath/latex <编译引擎> <LaTeX文件名>

参数说明

• --rm：容器运行结束后自动删除，避免残留容器占用系统资源
• -v $(pwd):/workdir：将当前本地目录（LaTeX源文件所在目录）挂载到容器内的/workdir目录，实现文件双向共享
• <编译引擎>：指定LaTeX编译引擎，可选值包括pdflatex、xelatex、lualatex等
• <LaTeX文件名>：需要编译的LaTeX源文件（如document.tex）

示例

1. 基础编译（pdflatex）

编译当前目录下的report.tex文件：

bash
docker run --rm -v $(pwd):/workdir menzerath/latex pdflatex report.tex

执行后，编译生成的PDF文件（report.pdf）将保存在本地当前目录中。

2. 使用xelatex引擎（支持中文等复杂字体）

编译包含中文字符的paper.tex文件：

bash
docker run --rm -v $(pwd):/workdir menzerath/latex xelatex paper.tex

3. 多轮编译（处理交叉引用、目录等）

对于包含交叉引用、目录的文档，需多次编译（以pdflatex为例）：

bash
docker run --rm -v $(pwd):/workdir menzerath/latex pdflatex document.tex
docker run --rm -v $(pwd):/workdir menzerath/latex bibtex document  # 若包含参考文献
docker run --rm -v $(pwd):/workdir menzerath/latex pdflatex document.tex
docker run --rm -v $(pwd):/workdir menzerath/latex pdflatex document.tex

扩展配置：安装额外宏包

若文档依赖镜像未包含的宏包，可通过tlmgr（TeX Live包管理器）安装。需以交互模式进入容器：

bash
docker run -it --rm -v $(pwd):/workdir menzerath/latex /bin/bash

在容器内执行以下命令安装宏包（以algorithm2e为例）：

bash
tlmgr install algorithm2e

安装完成后，即可使用该宏包编译文档。

注意事项

• 若文档包含图片、 bibliography等外部文件，需确保这些文件与LaTeX源文件在同一目录下（或通过相对路径正确引用），以便容器挂载后可访问
• 复杂文档建议使用latexmk工具自动化多轮编译（需先安装：tlmgr install latexmk），命令示例：docker run --rm -v $(pwd):/workdir menzerath/latex latexmk -pdf document.tex