aergus/latex

镜像概述

该Docker镜像专为LaTeX项目构建设计，基于Debian testing系统，提供了完整的LaTeX编译环境。通过容器化方式消除了本地LaTeX环境配置的复杂性，确保项目在一致环境中编译，适用于各类LaTeX文档的构建需求。

Dockerfile源码托管于GitLab：aergus/dockerfiles

核心功能与特性

• 完整工具链：预安装TeX Live等LaTeX核心工具，包含pdflatex、xelatex、lualatex等主流编译引擎
• 系统基础：基于Debian testing，提供稳定的底层系统环境，包管理便捷
• 宏包支持：内置常用LaTeX宏包（如amsmath、graphicx、hyperref等），满足多数文档编译需求
• 轻量设计：仅包含必要组件，平衡功能完整性与镜像体积
• 跨平台兼容：支持Linux、macOS、Windows等主流操作系统的Docker环境

使用场景

• 学术论文、期刊投稿的LaTeX文档编译
• 技术手册、API文档等技术文档生成
• 书籍、报告等大型LaTeX项目构建
• CI/CD流程集成，实现文档自动编译与发布
• 多版本LaTeX项目并行开发与测试

使用方法

基本编译流程

1. 拉取镜像（如未本地缓存）：

   bash
   docker pull aergus/latex
   

2. 编译LaTeX项目： 将本地LaTeX项目目录挂载至容器工作目录，执行编译命令：

   bash
   docker run -v $(pwd):/workspace -w /workspace aergus/latex pdflatex your_document.tex
   

   • -v $(pwd):/workspace：将当前目录（本地项目路径）挂载至容器内/workspace目录
   • -w /workspace：设置容器工作目录为/workspace
   • pdflatex your_document.tex：指定使用pdflatex引擎编译目标文档

高级编译需求

多引擎支持

根据文档需求选择编译引擎：

• XeLaTeX编译（支持UTF-8和复杂字体）：

  bash
  docker run -v $(pwd):/workspace -w /workspace aergus/latex xelatex your_document.tex
  

• LuaLaTeX编译（支持Lua脚本扩展）：

  bash
  docker run -v $(pwd):/workspace -w /workspace aergus/latex lualatex your_document.tex
  

含参考文献编译

对于包含参考文献（BibTeX）的文档，需执行多步编译：

bash
docker run -v $(pwd):/workspace -w /workspace aergus/latex sh -c "pdflatex your_document.tex && bibtex your_document && pdflatex your_document.tex && pdflatex your_document.tex"

自定义配置

安装额外宏包

如需补充特定宏包，可在容器内临时安装（基于Debian apt包管理）：

bash
docker run -it -v $(pwd):/workspace -w /workspace aergus/latex bash
# 在容器内执行：
apt update && apt install -y texlive-science  # 示例：安装科学领域宏包

持久化配置

可基于此镜像构建自定义镜像，预装项目所需特定宏包，Dockerfile示例：

dockerfile
FROM aergus/latex
RUN apt update && apt install -y texlive-publishers  # 安装出版社宏包