nopreserveroot/arara-tlcontrib-sysfonts

TeXLive Docker镜像文档

镜像概述

本镜像基于上游TeXLive发行版构建，集成了TLcontrib贡献仓库及所有Ubuntu开源字体，并默认配置arara作为文档自动化工具。旨在提供一个完整、开箱即用的TeX排版环境，满足复杂文档编译需求。

核心功能和特性

• 上游TeXLive安装：包含完整的TeXLive官方发行版，支持LaTeX、XeLaTeX、LuaLaTeX等多种排版引擎
• TLcontrib仓库支持：集成TeXLive贡献仓库，提供官方仓库外的扩展宏包
• 完整字体支持：包含所有Ubuntu开源字体，解决中文、日文等多语言排版的字体依赖问题
• 默认arara工具：预配置arara文档自动化工具，支持通过配置文件定义编译流程，简化复杂文档编译步骤

使用场景和适用范围

• 学术论文、期刊文章排版
• 技术文档、手册编写
• 书籍、报告等长文档制作
• 需要多语言（含中文、日文等）支持的TeX项目
• 自动化TeX编译流程的CI/CD环境集成

使用方法和配置说明

基本使用

通过以下命令运行容器并编译TeX文档：

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

参数说明：

• -v $(pwd):/workdir：将当前目录挂载到容器内的/workdir工作目录
• -w /workdir：设置工作目录为/workdir
• arara your-document.tex：使用arara编译指定的TeX文档

自定义arara配置

arara配置文件（.arara.yml或arara.yaml）需放置在文档目录中，示例配置：

yaml
!config
paths:
- /usr/local/texlive/2023/bin/x86_64-linux
directives:
- identifier: pdflatex
  name: PDFLaTeX
  command: pdflatex -synctex=1 -interaction=nonstopmode @{file}

安装额外宏包

如需安装TLcontrib仓库中的宏包，可在容器内执行：

bash
tlmgr install --repository http://contrib.texlive.info/current/ [宏包名称]

多引擎支持

支持直接调用不同TeX引擎：

bash
# 使用XeLaTeX编译
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] xelatex your-document.tex

# 使用LuaLaTeX编译
docker run --rm -v $(pwd):/workdir -w /workdir [镜像名称] lualatex your-document.tex

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  texlive:
    image: [镜像名称]
    volumes:
      - ./docs:/workdir
    working_dir: /workdir
    command: arara main.tex

运行：docker-compose up

注意事项

• 首次运行可能因字体缓存生成导致启动较慢
• 大型文档编译建议增加容器内存限制（--memory=4g）
• 如需持久化安装的宏包，建议将TeXLive目录挂载为卷