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}