Docker + VSCodeで最強のLaTeX環境を構築する！！

最強のLaTeX環境を構築する！！

• macOS Catalina 10.15.4
• Docker 19.03.8

試していませんが、Linuxでも動くと思います。

できること

• ファイルを変更するだけで自動コンパイル
• ショートカットによる手動コンパイルも可能
• コンパイル時に生成される不要なファイルを自動で削除し、pdfファイルはbuildディレクトリに格納される
• Dockerを利用することにより、環境構築が非常に簡単+ローカル環境を汚さない

クイックスタート

1. https://github.com/moisutsu/latex-docker をcloneする

   $ git clone https://github.com/moisutsu/latex-docker
   

2. Dockerを使ったコミットまでチェックアウトする

   $ git checkout 2792334
   

3. Dockerイメージ paperist/alpine-texlive-ja をpullする

   $ docker pull paperist/alpine-texlive-ja
   

4. VSCodeの settings.json に以下を追加する。

   {
   "latex-workshop.latex.recipes": [
     {
       "name": "compile",
       "tools": [
         "ptex2pdf"
       ]
     }
   ],
   "latex-workshop.latex.tools": [
     {
       "name": "ptex2pdf",
       "command": "bash",
       "args": [
         "%DIR%compile.sh",
       ]
     }
   ],
   "latex-workshop.latex.autoBuild.run": "onFileChange",
   "latex-workshop.docker.enabled": true,
   }
   
   

5. VSCodeの keybindings.json に以下を追加する。

   [
   {
       "key": "ctrl+alt+b",
       "command": "latex-workshop.build",
       "when": "resourceLangId == latex"
   },
   ]
   
   

以上です！！

あとはリポジトリ内のTeXファイルを変更するだけで自動でビルドを行うことができます。
また手動のコンパイルは command + option + b or ctrl + alt + b で行うことができます。

環境について

構成としては、TeXファイルのビルドとファイルの整理を行うシェルスクリプトを用意して、ファイルが変更されたときと、ショートカットを入力したときにそのシェルスクリプトを実行されるようにしています。

またDockerイメージにはpaperist/alpine-texlive-jaを使わせていただきました。

最後に

DockerとVSCodeは最高です！！

参考

Docker+VSCodeで保存時に自動でコンパイルされるLatex環境を作る話
DockerでらくらくLaTeX環境構築