nopreserveroot/latexmk-sysfonts

TeXLive + Ubuntu OSS Fonts Docker镜像

镜像概述

本镜像基于上游TeXLive安装，并集成所有Ubuntu开源字体（OSS fonts），默认使用latexmk作为LaTeX文档编译工具。提供开箱即用的LaTeX编译环境，确保文档字体渲染的完整性和跨平台兼容性。

核心功能与特性

• 完整TeXLive环境：包含上游TeXLive标准安装，支持各类LaTeX包与工具
• 全面字体支持：集成所有Ubuntu开源字体，解决文档编译中的字体缺失问题
• 自动化编译流程：默认使用latexmk工具，自动处理交叉引用、 bibliography等多轮编译需求
• 轻量兼容性：基于Ubuntu基础镜像，平衡功能完整性与镜像体积

使用场景与适用范围

• 学术论文、期刊文章的LaTeX编译
• 技术文档、报告的PDF生成
• 需要确保字体一致性的跨平台文档编译
• 适合开发者、研究人员、学生等需快速构建LaTeX环境的用户

使用方法

Docker Run 基础示例

在本地LaTeX项目目录下执行以下命令编译文档：

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

参数说明：

• --rm：容器退出后自动清理
• -v $(pwd):/workdir：挂载当前目录至容器内工作目录
• -w /workdir：设置容器工作目录
• latexmk -pdf your_document.tex：使用latexmk生成PDF文档

自定义编译命令

可直接替换编译工具或参数：

bash
# 使用pdflatex直接编译
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] pdflatex your_document.tex

# 使用xelatex编译（支持更多字体）
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] xelatex your_document.tex

高级配置

latexmk自定义配置

通过项目目录中的latexmkrc文件自定义编译规则，例如：

perl
# 设置默认编译器为xelatex
$pdf_mode = 5;
$pdflatex = 'xelatex %O %S';
# 设置输出目录
$out_dir = 'output';

常用latexmk参数

• -pdf：生成PDF格式输出
• -pvc：实时预览模式，文件修改后自动重新编译
• -silent：静默模式，减少输出信息
• -outdir=dir：指定输出目录

示例：实时预览模式编译

bash
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] latexmk -pdf -pvc your_document.tex