docker 部署 LaTeX 环境

需求表述

想做一个项目,需要一个 LaTeX 的中文环境,由于习惯了在服务器上用 docker 部署环境,于是也决定如此。
关于 docker + LaTeX 的部署方式已经有很多成熟方案了,比如:

  • Overleaf
    Overleaf 项目可以方便的获得一个在线的 LaTeX 编辑环境,直接参考官方教程即可Overleaf/toolkit
  • texlive
    docker hub 有专门维护的 texlive/texlive 镜像,直接 pull 下来部署也可。

但是由于我的项目需要对 LaTeX 设置不少东西,于是决定干脆从 Ubuntu 的容器环境从新搭建好了,故笔记记录一下。

部署步骤

首先是部署一个 Ubuntu 的容器环境,具体过程见笔记DOCKER COMPOSE 部署交互模式的容器-以UBUNTU为例
上步搭建完成后,进入容器环境:
docker exec -it container_name bash
进入容器内部后,首先安装 Ubuntu 基础的一些工具(容器是 root 的,所以命令均不需要 sudo):

# LaTeX 环境仅需要前两步即可
apt update          #更新软件源
apt install vim     # vim 编辑器

# 常用 Ubuntu 工具软件
apt install iputils-ping    # ping tool
apt install net-tools       # ifconfig 等网络工具包
apt install openssh-client  # ssh 客户端
apt install openssh-server  # ssh 服务端
apt install vsftpd          # ftp 

完成基础 Ubuntu 部署后,安装 LaTeX 软件:

apt-get install texlive-full

注意此步中有可能在此处卡住,终端信息是:
Pregenerating ConTeXt MarkIV format. This may take some time...
此时多次敲击 Enter 就可以越过此步,不会有什么影响。

推荐使用 ctex 来实现中文排版,不要使用 CJK,后者太麻烦了┑( ̄Д  ̄)┍。如果只是用 ctex 那么这样就够了。
通过查看版本来检查安装是否成功:

tex -v
pdflatex -v
xelatex -v

环境补丁(解决 picins.sty 缺失问题)

由于我需要用一个包含 picins 包的模板,所以需要手动打这个补丁,步骤如下:

  • 下载补丁文件夹 picins。网上有很多地址,我github上放了一份
  • 将文件夹 picins 放置在文件夹 /usr/share/texlive/texmf-dist/tex/latex/下:
    docker cp /home/username/download_path/picins container_namef:/usr/share/texlive/texmf-dist/tex/latex/
    不同系统的位置可能不一样,比如 windows 就可能在 C:\...\texlive\2023\texmf-dist\tex\latex,关键是找到 texmf-dist 文件夹。
  • 运行命令刷新 texlive 文件数据库
    texhash

然后就可以在 LaTeX 环境中编译一些文件进行测试啦。

PS:其实这个包很老了,新的模板根本不需要,可以直接用这个包:
\usepackage{graphicx}