blang/latex

blang/latex Docker镜像说明

镜像概述

blang/latex是一个Latex编译环境的Docker容器，旨在帮助用户无需在本地安装所有Latex包即可快速编译Latex源码。该镜像支持多种TexLive发行版，满足不同场景下的编译需求，且操作方式与本地命令行工具一致，降低使用门槛。

核心功能

• 快速部署：下载镜像后即可立即开始编译，无需复杂配置
• 权限兼容：保留本地用户的UID和GID，确保编译结果文件的权限正确
• 命令行友好：通过脚本工具（如latexdockercmd.sh）可像使用本地命令一样调用容器内的Latex工具
• 多发行版支持：提供多个版本选择，包括Ubuntu稳定版（texlive-full）、CTAN基础版（scheme-basic）和CTAN完整版（scheme-full）

使用场景

• 需要编译Latex文档但不想在本地安装庞大TexLive套件的开发者或学生
• 需切换不同Latex版本环境的场景（如稳定版用于生产、最新版用于测试）
• 构建自定义Latex环境的基础镜像（如添加特定CTAN包）

配置说明

快速设置

1. 切换到Latex项目目录：

   bash
   cd my_latex_project
   

2. 下载命令行脚本并赋予执行权限：

   bash
   wget https://raw.githubusercontent.com/blang/latex-docker/master/latexdockercmd.sh
   chmod +x latexdockercmd.sh
   

3. 编译Latex文件（以pdflatex为例）：

   bash
   ./latexdockercmd.sh pdflatex main.tex
   

4. 推荐使用latexmk工具（支持自动多轮编译）：

   bash
   ./latexdockercmd.sh latexmk -cd -f -interaction=batchmode -pdf main.tex
   

守护进程设置

若需多次编译且避免重复启动容器，可使用守护进程模式：

1. 启动守护容器：

   bash
   cd my_latex_source
   latexdockerdaemon.sh
   

2. 在守护容器内执行编译命令：

   bash
   latexdockerdaemoncmd.sh pdflatex main.tex
   

3. 停止守护容器：

   bash
   docker stop latex_daemon
   

自定义镜像

若需要添加缺失的包，可扩展基础镜像：

1. 创建Dockerfile：

   dockerfile
   FROM blang/latex:ubuntu
   # 示例：安装minted和Pygments
   RUN tlmgr install minted
   

2. 构建自定义镜像：

   bash
   docker build -t mycustomlateximg .
   

3. 修改latexdockercmd.sh脚本，使用自定义镜像mycustomlateximg

Latex Make配置

使用latexmk进行清洁编译：

bash
mkdir compile
latexmk -cd -f -jobname=output -outdir=./compile -auxdir=./compile -interaction=batchmode -pdf ./main.tex

在项目根目录添加latexmkrc配置文件（示例：生成 glossaries）：

perl
add_cus_dep( 'glo', 'gls', 0, 'makeglo2gls' );
sub makeglo2gls {
    system("makeindex -s \"$_[0].ist\" -t \"$_[0].glg\" -o \"$_[0].gls\" \"$_[0].glo\"" );
}

CTAN包安装

可通过tlmgr安装额外CTAN包：

bash
RUN tlmgr install minted