raabf/latex-versions-arm

DockerTeX 与 DockerTeXstudio

![docker automated]([] ![maintained]([] ![Pipline]([] ![licence]([]

Docker Hub 镜像

当Debian或Ubuntu基础镜像更新时（平均每月一次），上述镜像会在Docker Hub自动重建。

ARM变体说明：Docker Hub不再提供免费的ARM构建服务，因此ARM变体目前无法构建。

目录

• 核心特性
• 支持的标签
• 使用方法
  • dockertex
  • dockertexstudio
• TeXstudio显示故障排除
• 安装指南
  • zsh插件管理器
    • zplug
  • 自动化脚本
  • 手动安装
• 持续集成（CI）
  • GitLab CI
• 贡献方式

核心特性

• 💯 唯一提供多种TeX Live版本的LaTeX Docker镜像（支持2012年及以后所有版本）
• 🐧 基于Debian和Ubuntu系统构建
• 🏙 包含完整TeX Live包（texlive-full），涵盖日常所需的所有LaTeX模块
• 📽 所有容器均可启动TeXstudio GUI
• 🏭 预安装LaTeX常用工具：biber、make、gnuplot、inkscape、pandoc、python-pygments
• ⬛ 简洁的Shell命令在容器内构建文档（见“使用方法”部分）
• 🎎 容器内创建或修改的文件保留宿主用户的所有权（用户ID和组ID）
• 👷 通过脚本或Shell插件管理器轻松安装
• 🗃 为所有已安装的TeX Live版本生成TeXstudio菜单条目
• 🖥 TexStudio GUI通过共享套接字直接运行在本地X服务器上（无需SSH X转发），问题解决见故障排除
• 📍 TexStudio的“跳转到PDF”和“跳转到源代码”功能正常工作，支持LanguageTool集成
• 🦫 支持使用Podman替代Docker CLI

支持的标签

可通过TeX Live版本（如texlive2012、texlive2013等）或发行版代号（如wheezy、trusty等）指定镜像版本。

¹ TeXstudio不再为该Linux发行版提供构建，容器使用最后可用的TeXstudio版本。
² 发行版已终止支持（EOL），不再提供更新，但Docker镜像仍可正常使用。

使用方法

运行容器需安装docker CLI或Podman。可选择dockertexstudio镜像（包含dockertex所有功能）或仅使用dockertex镜像（无需TeXstudio时）。本地安装dockertexstudio后，dockertex会自动使用该镜像，避免重复占用磁盘空间。dockertex和dockertexstudio会在需要时提示拉取镜像。

字体说明：镜像包含Debian的non-free仓库和Ubuntu的multiverse仓库，除默认LaTeX字体外，还安装了Liberation和MSCoreFonts。Liberation是MSCoreFonts的免费替代品，使用MSCoreFonts即表示接受其EULA。

dockertex

假设当前目录下有LaTeX文件document.tex，可运行：

bash
dockertex --tag texlive2016 pdftex document.tex

通用语法：

bash
dockertex [-t|--tag tagname] command

dockertex会启动指定标签的容器，将当前工作目录挂载为卷，并在该挂载点执行command。脚本确保所有修改或新建文件保留执行用户的所有权。

command可以是任意命令，例如使用Makefile：

bash
dockertex --tag jessie make all

默认标签：设置环境变量可省略--tag参数：

bash
export DOCKERTEX_DEFAULT_TAG="texlive2016"

引擎选择：默认优先使用已安装的podman，否则使用docker。可通过环境变量指定：

bash
export DOCKERTEX_ENGINE="podman"  # 或 "docker"

dockertexstudio

dockertexstudio用于在指定容器内启动TexStudio GUI，标签使用方式与dockertex相同：

bash
dockertexstudio [-t|--tag tagname] [-v|--volume mapping]* [texstudio options]

dockertexstudio默认将宿主的~目录挂载到容器中。如需额外挂载点，使用--volume（语法与docker run相同），例如：

bash
dockertexstudio --tag texlive2016 --volume /media/git/:/home/git/

容器内的TeXstudio配置在多次运行间保持一致。执行dockertexstudio --help可查看配置文件夹的本地路径。

菜单条目：安装过程中生成的菜单条目也使用dockertexstudio。文件管理器中可直接用容器内的TeXstudio打开.tex文件（需将.tex文件关联到相应菜单条目），前提是文件在容器内外的路径一致（默认挂载的主目录满足此条件）。

跳转功能：由于TeXstudio运行在容器内，通过synctex实现的“跳转到PDF”和“跳转到源代码”功能正常工作。

LanguageTool：LanguageTool是高级语法检查工具，通过HTTP API访问。dockertexstudio与宿主共享网络接口，因此在宿主本地启动LanguageTool（默认配置）后，容器内的TeXstudio可正常访问。

x11docker：镜像也可配合https://github.com/mviereck/x11docker%E4%BD%BF%E7%94%A8%EF%BC%8C%E4%BE%8B%E5%A6%82%EF%BC%9A

bash
x11docker --network=host --share $HOME raabf/texstudio-versions:texlive2019

TeXstudio显示故障排除

授权要求

使用docker时若出现：

Authorization required, but no authorization protocol specified

需在宿主执行：

bash
xhost local:root

问题原因：Docker默认以root用户运行容器，而root用户默认无权访问本地用户的X服务器，xhost命令可授权访问。

进一步认证

若仍需更多认证，可能需要将宿主xauth list生成的令牌传递给容器，使容器能连接宿主X服务器。具体方法见此处（未测试）。

DISPLAY变量

若提示找不到显示器，可尝试将dockertexstudio.sh脚本中的--env='DISPLAY'替换为-e DISPLAY=unix$DISPLAY（环境相关，具体条件未知）。

移除网络共享

有用户报告，删除dockertexstudio.sh中的--network=host行可解决问题，但此时TeXstudio无法访问网络资源（如LanguageTool）。

使用x11docker

可尝试用[x11docker](https://github.com/mviere