nopreserveroot/rubber-tlcontrib-sysfonts

TeXLive Docker镜像文档

镜像概述

本镜像基于上游TeXLive安装，集成了TLcontrib扩展仓库及所有Ubuntu开源字体（OSS fonts），默认使用rubber作为TeX文档编译工具。旨在提供一个开箱即用的TeX环境，满足各类TeX文档（如学术论文、技术报告、书籍等）的编译与排版需求。

核心功能和特性

• 完整TeXLive环境：包含上游TeXLive的完整安装，支持LaTeX、XeLaTeX、LuaLaTeX等多种TeX引擎
• TLcontrib扩展：集成TLcontrib仓库，提供额外的TeX宏包和工具
• 丰富字体支持：包含所有Ubuntu开源字体，确保文档排版时的字体兼容性
• 默认工具配置：默认使用rubber作为编译工具，简化TeX文档的编译流程

使用场景和适用范围

• 学术论文、期刊文章的LaTeX排版
• 技术文档、手册的TeX格式编写与编译
• 书籍、报告等长文档的排版处理
• 需要统一TeX环境的团队协作场景
• CI/CD流程中的TeX文档自动化编译

使用方法和配置说明

基本使用（docker run）

bash
# 编译当前目录下的TeX文件
docker run -v $(pwd):/workspace -w /workspace [镜像名称] rubber -d document.tex

常用命令说明

• rubber -d document.tex：编译指定的TeX文档，并生成PDF文件（-d参数表示生成PDF）
• rubber --clean document.tex：清理编译过程中生成的临时文件
• xelatex document.tex：直接使用XeLaTeX引擎编译文档（如需使用其他引擎）

持久化工作目录

为避免每次运行都重新挂载目录，可通过以下方式持久化工作空间：

bash
# 创建本地工作目录
mkdir -p ~/tex-projects

# 运行容器并挂载工作目录
docker run -v ~/tex-projects:/workspace -w /workspace --name tex-env [镜像名称]

自定义编译工具

若需使用其他编译工具（如pdflatex），可直接在容器中执行对应命令：

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

注意事项

• 确保本地TeX文件路径正确挂载到容器的/workspace目录
• 对于大型文档或复杂宏包，首次编译可能需要较长时间（需下载额外依赖）
• 如需中文字体支持，Ubuntu开源字体已包含常用中文字体（如Noto系列），可直接在TeX文档中调用

环境变量说明

目前本镜像暂未提供可配置的环境变量，所有功能通过默认工具链实现。如需自定义配置，可在容器启动后通过命令行修改相关配置文件。