nopreserveroot/rubber-sysfonts

镜像概述

本Docker镜像集成了上游TeXLive完整安装环境与所有Ubuntu开源字体，默认使用rubber工具作为LaTeX文档编译工具。该镜像旨在提供一个开箱即用的LaTeX工作环境，无需手动配置TeXLive和字体依赖，适用于各类LaTeX文档的编译与排版需求。

核心功能与特性

• 完整TeXLive环境：包含上游官方TeXLive发行版的全部包，支持各类LaTeX宏包和文档类型编译
• 丰富字体支持：集成所有Ubuntu开源字体，确保文档中各类字体（如中文字体、特殊符号字体等）正常显示
• 默认rubber工具：内置rubber自动化构建工具，可自动处理LaTeX文档依赖关系、解析引用并生成最终输出文件（如PDF）
• 轻量基础：基于Ubuntu系统构建，保持基础环境精简的同时提供完整功能

使用场景与适用范围

• 学术论文、技术报告、书籍等LaTeX文档的日常编译与排版
• 需要丰富字体支持的多语言LaTeX文档处理（如包含中文、日文等非英文内容的文档）
• CI/CD流程中集成LaTeX文档自动构建
• 开发环境中快速搭建LaTeX工作环境，避免本地TeXLive配置繁琐问题

使用方法与配置说明

基本使用流程

1. 准备LaTeX文件：将待编译的LaTeX文件（如document.tex）置于本地目录
2. 运行容器编译：通过docker run命令挂载本地目录并执行编译命令

常用命令示例

使用默认rubber工具编译PDF

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

• -v $(pwd):/workspace：将当前本地目录挂载到容器内的/workspace工作目录
• -w /workspace：设置容器工作目录为/workspace
• rubber -d document.tex：使用rubber编译document.tex，-d参数表示生成PDF并保留中间文件（如.aux、.log等）

使用pdflatex手动编译

若需直接使用pdflatex而非rubber，可执行：

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

处理带交叉引用的文档

对于包含交叉引用、目录等需要多次编译的文档，可使用rubber自动处理：

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

--pdf参数强制生成PDF输出，并自动处理多次编译需求。

注意事项

• 确保本地目录具有读写权限，以便容器能正常生成输出文件
• 对于大型LaTeX项目（如包含多个子文件或大量图片），建议将整个项目目录挂载到容器中
• 如需使用额外LaTeX宏包，可在容器内通过tlmgr命令安装（需以root权限运行容器：添加--user root参数）