nopreserveroot/latexmk

TeXLive Docker镜像

镜像概述

本镜像基于上游TeXLive官方发行版构建，提供完整的TeXLive环境，默认集成latexmk工具作为主要编译工具。TeXLive是一套完整的TeX排版系统，包含LaTeX、XeLaTeX、LuaLaTeX等多种排版引擎及丰富的宏包，适用于学术论文、技术文档、书籍等各类LaTeX文档的编译需求。

核心功能与特性

• 完整TeXLive环境：包含TeXLive官方发行版的全部宏包和工具，支持多种TeX引擎（pdfLaTeX、XeLaTeX、LuaLaTeX等）
• 默认latexmk集成：预置latexmk工具，可自动处理LaTeX文档的依赖关系，实现一键编译
• 轻量级设计：基于官方上游资源构建，保持环境纯净性的同时控制镜像体积
• 跨平台支持：兼容x86_64架构，可在主流Docker环境中运行

使用场景

• 学术论文、期刊文章的LaTeX编译
• 技术文档、手册的排版与生成
• 书籍、报告等长文档的批量处理
• CI/CD流程中集成LaTeX文档自动编译
• 本地开发环境中快速部署独立的TeXLive环境，避免系统环境冲突

使用方法

基本使用

通过挂载本地LaTeX项目目录到容器工作目录，执行latexmk命令编译文档：

bash
docker run --rm -v $(pwd):/workdir texlive-image latexmk -pdf document.tex

• --rm：容器运行结束后自动删除
• -v $(pwd):/workdir：将当前目录挂载到容器内的/workdir目录
• latexmk -pdf document.tex：使用latexmk以PDF格式编译document.tex文件

自定义编译参数

可根据需求指定不同的latexmk参数，例如：

bash
# 使用XeLaTeX引擎编译
docker run --rm -v $(pwd):/workdir texlive-image latexmk -xelatex document.tex

# 清理临时文件
docker run --rm -v $(pwd):/workdir texlive-image latexmk -c document.tex

# 强制重新编译
docker run --rm -v $(pwd):/workdir texlive-image latexmk -f document.tex

交互模式使用

如需在容器内进行多步操作，可启动交互式shell：

bash
docker run -it --rm -v $(pwd):/workdir texlive-image /bin/bash

进入容器后，可直接使用pdflatex、xelatex、bibtex等命令进行手动编译。

docker-compose配置示例

创建docker-compose.yml文件，简化编译流程：

yaml
version: '3'
services:
  texlive:
    image: texlive-image
    volumes:
      - ./:/workdir
    command: latexmk -pdf document.tex

运行命令：docker-compose up即可自动编译文档。

注意事项

• 确保本地LaTeX项目目录具有读写权限，避免挂载目录权限问题
• 大型项目编译可能需要较长时间，取决于文档复杂度和系统性能
• 如需使用特定版本的TeXLive，可通过指定镜像标签获取对应版本（如texlive-image:2023）