joaquinbadillo/latex

joaquinbadillo/latex镜像说明

镜像概述

本镜像封装了MiKTeX（流行的LaTeX发行版），提供便捷的LaTeX文档编译与排版环境，适用于各类LaTeX文档的处理需求，无需本地安装复杂的LaTeX环境。

核心功能

1. 交互终端支持：通过-ti参数进入交互模式，直接执行LaTeX编译命令（如pdflatex）。
2. 数据持久化：挂载miktex:/var/lib/miktex卷，保存MiKTeX的配置、已安装包及缓存，避免重复下载。
3. 本地文件映射：将主机当前工作目录挂载到容器/miktex/work，直接处理本地LaTeX文件。
4. 权限适配：通过MIKTEX_UID环境变量设置容器内用户ID，与主机一致，解决文件读写权限问题。

使用场景

• 学术论文、学位论文的LaTeX编译与输出
• 技术文档、书籍的排版与格式调整
• 快速验证LaTeX代码片段的效果

配置说明

部署示例

Docker Run命令

bash
docker run -ti \
  -v miktex:/var/lib/miktex \
  -v $(pwd):/miktex/work \
  -e MIKTEX_UID=$(id -u) \
  docker.xuanyuan.run/joaquinbadillo/latex

Docker Compose配置（docker-compose.yml）

yaml
version: '3'
services:
  latex:
    image: docker.xuanyuan.run/joaquinbadillo/latex
    volumes:
      - miktex:/var/lib/miktex
      - ./:/miktex/work
    environment:
      - MIKTEX_UID=${UID}
    tty: true
    stdin_open: true
volumes:
  miktex:

进入容器后，可直接在/miktex/work目录下执行LaTeX编译命令，如：pdflatex your_document.tex，生成的PDF文件会保存在主机当前目录中。 ===FULL_DESC===