nopreserveroot/latexmk-tlcontrib-sysfonts

镜像概述

本Docker镜像基于上游TeXLive安装，整合了TLcontrib扩展仓库及所有Ubuntu开源字体，默认使用latexmk作为LaTeX文档编译工具。旨在提供一个开箱即用的LaTeX编译环境，满足各类文档（学术论文、技术报告、书籍等）的排版需求，尤其适合需要丰富字体支持和扩展宏包的场景。

核心功能和特性

• 完整TeXLive环境：包含上游TeXLive的完整安装，支持LaTeX、XeLaTeX、LuaLaTeX等多种编译引擎
• TLcontrib扩展：集成TLcontrib仓库，提供额外的LaTeX宏包和工具
• 丰富字体支持：预安装所有Ubuntu开源字体，满足多语言排版和特殊字体需求
• 默认编译工具：内置latexmk，支持自动检测文件依赖、多轮编译及输出格式转换（PDF等）

使用场景和适用范围

• 学术文档排版：论文、学位论文、期刊文章等需要复杂公式和参考文献管理的场景
• 技术文档编写：软件手册、技术报告等需要代码块、图表嵌入的文档
• 多语言文档处理：支持中文、日文等非拉丁文字符的排版需求
• CI/CD集成：可作为自动化流程中的LaTeX编译环节，实现文档自动构建

使用方法和配置说明

基本使用（docker run）

bash
# 编译当前目录下的LaTeX文件（默认使用latexmk）
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] latexmk -pdf main.tex

自定义编译引擎

如需使用其他编译引擎（如xelatex），可直接指定：

bash
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] xelatex main.tex

持久化工作目录

如需保留编译过程中的临时文件，可挂载本地目录作为工作区：

bash
docker run --rm -v /path/to/local/workdir:/workdir -w /workdir [镜像名称] latexmk -pdf main.tex

docker-compose配置示例

yaml
version: '3'
services:
  latex-compiler:
    image: docker.xuanyuan.run/[镜像名称]
    volumes:
      - ./latex-docs:/workdir
    working_dir: /workdir
    command: latexmk -pdf main.tex

注意事项

• 确保本地LaTeX文件路径正确挂载至容器内的/workdir目录
• 对于大型文档或复杂排版，建议增加容器内存限制（如--memory=4g）
• 如需安装额外宏包，可在容器内通过tlmgr install <package-name>命令扩展

通过本镜像，用户可快速搭建标准化的LaTeX编译环境，避免本地TeXLive配置繁琐及版本兼容性问题。