配置私有 Overleaf (LaTeX) 完美插入 SVG 矢量图片

2021年1月19日 12981点热度 13人点赞 0条评论

最近在生产环境中发生的灾难：
1. SVG 中的字体和字号显示异常，解决方法是在 AI 中以轮廓重新导出一遍 SVG 文件；
2. 部分特殊 SVG 文件会使编译无法停止，出现此情况，删除该文件引用，在容器中终止 Perl 进程（实际是 latexmk 的未知 Bug，明明 pdflatex 和 inkscape 都已经结束运行，且最终已经生成了 PDF 文件）
2021/1/26 凌晨更新

作者环境

Overleaf Docker Full 安装
完整服务器权限
本地 TeX Live 等环境理论上同理

操作流程

进入 Overleaf 运行的容器

docker ps
docker exec -it 523 /bin/bash # 其中523为 sharelatex 主容器对应的 CONTAINER ID

安装 Inkscape^[1]（容器中）

sudo add-apt-repository ppa:inkscape.dev/stable
sudo apt update
sudo apt install inkscape

输入 inkscape --version ，能打印版本号即可，作者为 Inkscape 1.0.2 (1.0.2+r75+1) Pango version: 1.40.14

另外 Overleaf 的容器实际上就是 Ubuntu，建议更换服务器所在IDC的镜像源，参考阿里云^[2]

在 LaTeX 中使用 SVG 宏包^[3]

因为该宏的运行将调用读取本地程序和文件，需要 --shell-escape 命令，这里给出最简方法

根目录新建 latexmkrc ，内容 $pdflatex = 'pdflatex --shell-escape'
主文件 .tex 加入 \usepackage{svg}，如果使用了模板可以找 \usepackage 扎堆的地方
SVG 矢量图片插入示例

\begin{figure}[!ht]
\centering
\includesvg[width=0.5\columnwidth]{svgFileName}
\end{figure}

保存为镜像（可选）

docker commit 523 sharelatex-full-zh-cn:svg-support # CONTAINER ID 同理
docker images
docker rmi sharelatex-full-zh-cn:latest # 删除原有的，毕竟完整安装的 Overleaf 超过 8 GB

最后更改 docker-compose.yml 使其指向新的镜像