nopreserveroot/latexmk-tlcontrib

TeXLive Docker镜像文档

镜像概述

本镜像基于上游TeXLive发行版构建，集成TLcontrib仓库，并默认配置latexmk作为编译工具。提供完整的LaTeX排版环境，无需本地安装TeXLive，即可通过容器化方式便捷处理各类LaTeX文档。

核心功能与特性

• 完整TeXLive环境：包含上游TeXLive的完整安装，支持标准LaTeX、XeLaTeX、LuaLaTeX等编译引擎
• TLcontrib扩展：集成TLcontrib仓库，提供官方仓库外的额外宏包和工具支持
• 默认latexmk支持：预装latexmk自动化编译工具，可自动处理LaTeX文档的依赖关系和多次编译需求
• 即开即用：无需复杂配置，拉取镜像后即可直接用于LaTeX文档编译

使用场景

• 学术论文、期刊文章的LaTeX排版与编译
• 技术文档、用户手册的LaTeX格式处理
• 书籍、报告等复杂LaTeX文档的批量编译
• CI/CD流程中集成LaTeX文档自动构建
• 多环境一致性保障，避免本地TeXLive版本差异导致的编译问题

使用方法

基本编译命令

将本地LaTeX项目目录挂载到容器，执行编译：

bash
docker run -v $(pwd):/workspace -w /workspace [镜像名称] latexmk -pdf your-document.tex

参数说明：

• -v $(pwd):/workspace：将当前目录挂载到容器内的/workspace目录
• -w /workspace：设置容器工作目录为/workspace
• latexmk -pdf your-document.tex：使用latexmk编译指定LaTeX文件，生成PDF

常用latexmk选项

• -pdf：生成PDF格式输出
• -xelatex：使用XeLaTeX引擎编译
• -lualatex：使用LuaLaTeX引擎编译
• -pvc：启动预览模式，监测文件变化并自动重新编译

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  latex-compiler:
    image: [镜像名称]
    volumes:
      - ./latex-project:/workspace
    working_dir: /workspace
    command: latexmk -pdf -xelatex main.tex

执行编译：

bash
docker-compose up

自定义编译流程

如需执行自定义编译命令，可直接在容器中运行：

bash
docker run -it -v $(pwd):/workspace -w /workspace [镜像名称] /bin/bash
# 在容器内执行自定义命令
latexmk -pdf -output-directory=out thesis.tex