nopreserveroot/arara

镜像概述

该Docker镜像提供上游（upstream）TeXLive的完整安装环境，默认集成arara工具，用于LaTeX文档的编译、自动化处理及相关排版工作。镜像基于官方TeXLive发行版构建，确保与标准LaTeX包和工具的兼容性。

核心功能与特性

• 完整TeXLive环境：包含TeXLive的全部基础组件、宏包及工具，支持各类LaTeX文档编译需求
• 默认arara集成：预配置arara作为默认编译工具，支持通过arara规则文件（arara.yml）实现自动化编译流程
• 上游兼容性：基于官方TeXLive上游版本构建，确保与最新LaTeX标准和包的兼容性
• 轻量级设计：在保证功能完整的前提下优化镜像体积，适合本地开发和CI/CD流程集成

使用场景

• 学术论文、技术报告等LaTeX文档的本地编译与预览
• 自动化LaTeX文档构建流程（如结合CI/CD工具实现提交后自动编译）
• 多环境一致的LaTeX开发环境，避免因本地TeXLive版本差异导致的编译问题
• 快速验证LaTeX代码片段或测试新宏包功能

使用方法与配置说明

基本使用（docker run）

通过以下命令启动容器并编译当前目录下的LaTeX文件：

bash
docker run -v $(pwd):/workspace -w /workspace texlive-arara arara your-document.tex

参数说明：

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

docker-compose配置示例

创建docker-compose.yml文件，简化编译流程：

yaml
version: '3'
services:
  texlive:
    image: texlive-arara
    volumes:
      - ./:/workspace
    working_dir: /workspace
    command: arara main.tex

运行命令：docker-compose up，将自动编译./main.tex文件。

自定义arara规则

若需使用自定义arara规则，可将本地arara.yml文件挂载到容器内的规则目录：

bash
docker run -v $(pwd):/workspace -v $(pwd)/arara.yml:/etc/arara/arara.yml -w /workspace texlive-arara arara your-document.tex

环境变量配置

当前镜像暂未提供可配置的环境变量，所有编译行为通过arara规则文件或命令行参数控制。