Visual Studio CodeでTeXのコンパイルをできるようにする方法

Visual Studio CodeでTeXのコンパイルをできるようにする方法についてまとめます。

# 前提
* upLaTeXを使う場合とpLaTeXを使う場合がある
* pBibTeXを使う場合と使わない場合がある

# 必要なソフトウェアのインストール
1. [TeX Live - TeX Wikiのインストール](https://texwiki.texjp.org/?TeX%20Live#w628bee6)を参考に、TeX Liveをインストールします。
2. [Download Visual Studio Code - Mac, Linux, Windows](https://code.visualstudio.com/download)からVisual Studio Codeをダウンロード・インストールします。

# 拡張機能のインストール
1. Visual Studio Codeを起動します。
1. `Ctrl` + `Shift` + `X`を押下します。
2. 検索窓で『LaTeX Workshop』を検索します。
3. LaTeX Workshopをインストールします。

# コンパイル設定
4. `Ctrl` + `,`を押下します。
5. 右側のユーザ設定の部分に以下のように記述します。

    ```settings.json
    {
        "latex-workshop.latex.tools": [
            {
                "name": "latexmk",
                "command": "latexmk",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "-pdf",
                    "%DOC%"
                ]
            },
            {
                "name": "pdflatex",
                "command": "pdflatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOC%"
                ]
                },
            {
                "name": "bibtex",
                "command": "bibtex",
                "args": [
                    "%DOCFILE%"
                ]
            },
            {
                "name":"ptex2pdf",
                "command": "ptex2pdf",
                "args": [
                    "-l",
                    "-ot",
                    "-kanji=utf8 -synctex=1",
                    "%DOC%"
                ]
            },
            {
                "name":"ptex2pdf (uplatex)",
                "command": "ptex2pdf",
                "args": [
                    "-l",
                    "-u",
                    "-ot",
                    "-kanji=utf8 -synctex=1",
                    "%DOC%"
                ]
            },
            {
                "name": "pbibtex",
                "command": "pbibtex",
                "args": [
                    "-kanji=utf8",
                    "%DOCFILE%"
                ]
            }
        ],
        "latex-workshop.latex.recipes": [
            {
                "name": "latexmk",
                "tools": [
                    "latexmk"
                ]
            },
            {
                "name": "pdflatex*2",
                "tools": [
                    "pdflatex",
                    "pdflatex"
                ]
            },
            {
                "name": "pdflatex -> bibtex -> pdflatex*2",
                "tools": [
                    "pdflatex",
                    "bibtex",
                    "pdflatex",
                    "pdflatex"
                ]
            },
            {
                "name": "ptex2pdf*2",
                "tools": [
                    "ptex2pdf",
                    "ptex2pdf"
                ]
            },
            {
                "name": "ptex2pdf -> pbibtex -> ptex2pdf*2",
                "tools": [
                    "ptex2pdf",
                    "pbibtex",
                    "ptex2pdf",
                    "ptex2pdf"
                ]
            },
            {
                "name": "ptex2pdf (uplatex) *2",
                "tools": [
                    "ptex2pdf (uplatex)",
                    "ptex2pdf (uplatex)"
                ]
            },
            {
                "name": "ptex2pdf (uplatex) -> pbibtex -> ptex2pdf (uplatex) *2",
                "tools": [
                    "ptex2pdf (uplatex)",
                    "pbibtex",
                    "ptex2pdf (uplatex)",
                    "ptex2pdf (uplatex)"
                ]
            },
        ]
    }
   ```

# コンパイル用のキーショートカット設定
2. `Ctrl`+`Shift`+`P`を押下し、『Build with recipe』を検索・選択します。
3. 選択画面が出てきたら、操作をキャンセルします。
1. `Ctrl` + `K`を押下します。
1. `Ctrl` + `S`を押下します。
2. 検索窓で『Build with recipe』を検索します。
3. Build with recipeをダブルクリックします。
4. キーショートカットを設定します。

# コンパイル方法
1. 設定したコンパイル用のキーショートカットを押下します。
2. 以下の中から適切なレシピを選択します。
※コンパイルの進捗状況は左下に表示されます。

    |レシピ|内容|
    |:--:|:--:|
    |`latexmk`|LaTeXmkを用いてコンパイル|
    |`pdflatex*2`|pdfLaTeXを用いてコンパイル|
    |`pdflatex -> bibtex -> pdflatex*2`|pdfLaTeXとBibTeXを用いてコンパイル|
    |`ptex2pdf*2`|pLaTeXを用いてコンパイル|
    |`ptex2pdf -> pbibtex -> ptex2pdf*2`|pLaTeXとpBibTeXを用いてコンパイル|
    |`ptex2pdf (uplatex) *2`|upLaTeXを用いてコンパイル|
    |`ptex2pdf (uplatex) -> pbibtex -> ptex2pdf (uplatex) *2`|upLaTeXとpBibTeXを用いてコンパイル|

1. コンパイルが終了したら、`Ctrl` + `Alt` + `V`を押下し、コンパイルしたPDFを表示します。

# 参考文献
* [VS CodeでTeXを使う方法 - elechoのぶろぐ](http://elecho.hatenablog.com/entry/2017/04/27/175500)
* [VS Code の便利なショートカットキー - Qiita](https://qiita.com/12345/items/64f4372fbca041e949d0)
* [macOS High Sierra & Ubuntu 16.04 で 日本語TeX環境構築 with Visual Studio Code - Qiita](https://qiita.com/shinsumicco/items/aeca4d5f0464f401855a)
* [VScodeで快適LaTeX環境を構築する方法 - Qiita](https://qiita.com/ichigism/items/707e8a5def368a69e9a6)
* [Visual Studio Codeで簡単にショートカットキーを変更する方法 - Qiita](https://qiita.com/kinchiki/items/dabb5c890d9c57907503)