adnrv/texlive Docker 镜像 - 轩辕镜像

Texlive Docker容器

这是一组基于TeXLive的容器，通过GitLab自动构建，并推送到公共Docker Hub仓库。

容器类型

所有容器版本均基于ubuntu:rolling（已发布版本列表见标签）。

Vanilla容器

这些容器是在Docker上安装TeXLive脚本的版本。

• 最小版（adnrv/texlive:minimal）：TeXLive的最小方案（可用于扩展自定义镜像）。
• 基础版（adnrv/texlive:basic）：TeXLive的基础方案（可用于扩展自定义镜像），基于minimal容器扩展。

自定义容器

用于撰写论文、提案和其他学术文档的容器需要TeXLive之外的更多专用工具以提高工作效率。以下是提供的镜像（适用于我和我的团队）：

• 自定义版（adnrv/texlive:custom）：基于minimal容器扩展，安装基础包及其他非基础包，介于基础版和完整版之间。
• 工具版（adnrv/texlive:tools）：基于custom容器扩展，提供构建和执行更复杂文档的有用工具。
• adnTools版（adnrv/texlive:adntools）：基于tools容器扩展，将所有(La)TeX库打包到单个容器中。
• adnAMC版（adnrv/texlive:adnamc）：基于adntools容器扩展，提供Auto Multiple Choice包及我的库，因体积较大单独提供。

容器使用

以下示例中的镜像adnrv/texlive可通过添加:tag指定标签（参见可用镜像）。

查看可用的tex二进制文件

shell
docker run --rm adnrv/texlive ls -lah /opt/texbin/

构建tex文档

使用

shell
docker run --rm -it -v "$(pwd)":/home adnrv/texlive pdflatex document.tex

或其他引擎（如xelatex或lualatex）。如需传递用户和组权限：

shell
docker run --rm -it --user="$(id -u):$(id -g)" -v "$(pwd)":/home adnrv/texlive pdflatex document.tex

构建镜像

如需构建镜像，执行：

shell
docker build -t texlive:tag -f tag.Dockerfile .

其中tag指要构建的镜像类型对应的Dockerfile。

扩展镜像

如需额外软件或包，可使用这些镜像作为基础来自定义镜像。

创建如下Dockerfile：

docker
FROM adnrv/texlive:tag

# Minted + Pygments
RUN tlmgr update --self && \
    tlmgr install minted

注意使用tlmgr时，为避免更新时崩溃，建议先执行update --self。