Visual Studio CodeでTeX環境を構築 (TeX Live 2019)

# Visual Studio Code(VScode)でTeX環境を構築する
## 1. TeX Live 2019 & VScodeをインストールする (Windows)
必要となるソフトウェアを準備します．
下記リンクより，TeX Live 2019 & VScodeをダウンロードしましょう．

|[TeX Live](http://mirror.ctan.org/systems/texlive/tlnet/install-tl-windows.exe)|[ Visual Studio Code ](https://code.visualstudio.com/download)|
|:------------------------------------------------:|:------------------------------------------------:|:------------------------------------------------:|

【注意】 
TeX Liveのダウンロードには1時間ほど必要となります．
 時間のある時に行ってください．


## 2. VScode 拡張機能のインストール＆設定
### 2.1. 拡張機能のインストール
```Ctrl + Shift + X```  または左側アイコンからExtentionsを開きます．
検索タブから下記の拡張機能を検索，インストールしてください．

|VScode Extention||必須|
|:------------------------------------------------:|:------------------------------------------------:|:------------------------------------------------:|
|[ LaTeX Workshop ](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop)|<img width="250" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/e508f9f5-c63b-fa8d-dafa-75b5ee339253.png">|〇|

### 2.2. 拡張機能の設定
インストール後，LaTeX Workshopに関する設定をします．

```Ctrl + ,``` でVSCodeの設定を開き，```setting.json```をクリックします．
（```search settings```から```.json```と検索することで，素早く移動することができます．）
<img width="800" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/2bd117e6-6f8c-4b54-6431-b5becead6ef2.png">
```setting.json``` は下記の内容に書き換えましょう．
これにより，保存，不要な中間ファイルの削除などの自動化も行うことができます．

```setting.json
{
    "window.zoomLevel": 0,
    "files.autoSave": "afterDelay",
    "extensions.ignoreRecommendations": false,
    "extensions.autoUpdate": false,
    "latex-workshop.chktex.enabled": true,
    "latex-workshop.view.pdf.viewer": "tab",
    "editor.fontSize": 14,
    "latex-workshop.latex.autoClean.run": "onBuilt",
    "latex-workshop.latex.recipes": [
        {
            "name": "toolchain",
            "tools": [
                "pLaTeX",
                "pLaTeX",
                "dvipdfmx",
            ]
        }
    ],
    "latex-workshop.latex.tools": [
        {
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ],
            "name": "bibtex"
        },
        {
            "command": "pbibtex",
            "args": [
                "-kanji=utf8",
                "%DOCFILE%"
            ],
            "name": "pbibtex",
        },
        {
            "name": "ptex2pdf",
            "command": "ptex2pdf",
            "args": [
                "-l",
                "-ot",
                "-kanji=utf8 -synctex=1",
                "%DOC%"
            ]
        },
        {
            "command": "platex",
            "args": [
                "-synctex=1",
                "-jobname=\"%DOCFILE%\"",
                "-kanji=utf8",
                "-guess-input-enc",
                "%DOCFILE%.tex"
            ],
            "name": "pLaTeX"
        },
        {
            "command": "dvipdfmx",
            "args": [
                "%DOCFILE%"
            ],
            "name": "dvipdfmx"
        }
    ],
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux",
        "*.bbl",
        "*.blg",
        "*.idx",
        "*.ind",
        "*.lof",
        "*.lot",
        "*.out",
        "*.toc",
        "*.acn",
        "*.acr",
        "*.alg",
        "*.glg",
        "*.glo",
        "*.gls",
        "*.ist",
        "*.fls",
        "*.log",
        "*.fdb_latexmk",
        "*.log",
        "*.synctex(busy)",
        "*.dvi",
        "*.synctex.gz",
    ],
}
```

このように記述されればOKです．
<img width="800" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/1d4be63a-9549-44a9-f492-db7a3f2bad37.png">

## 3. VScodeでLaTeXを動作させる
### 3.1. texファイルを作成
```Ctrl + K``` → ```Ctrl + O```をすることで，texファイルを作りたいフォルダを選択しましょう．
下記画像，赤色で示した```New File```アイコンから新規ファイルを作成します．
<img width="800" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/620c6d50-6ff7-67f4-8545-aed099ffb003.png">
TeXファイルの拡張子は```.tex```です．
今回は```test.tex```というファイルを作り，下記の内容を記述します．

```test.tex
\documentclass{jsarticle}
\begin{document}
{
    Hello \LaTeX!
}
\end{document}
```

### 3.2. コンパイルを実行
```Ctrl + S```で保存することにより，コンパイルが実行されます．
画面左下を注目し，コンパイルが実行されているかを確認してください．

||状況|表示|
|:------------------------------------------------:|:------------------------------------------------:|:------------------------------------------------:|
|①|コンパイル完了|<img width="250" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/49e4705e-af49-0af1-4b07-d7e91e8dba31.png">|
|②|コンパイル実行中<br>or<br>コンパイル失敗|<img width="250" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/e66212cc-6628-34ab-ea69-1a87499293ec.png">|

②の表示が長時間続く場合，コンパイル失敗の可能性があります．
その場合は，下図のように```LaTeX Computer```を表示し，コンパイル状況・エラー文の確認をすることで修正してください．
<img width="800" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/1720ab72-f5e9-48e8-1eec-52cf14ad109d.png">
### 3.3. 完成したPDFファイルを確認
赤で示した右上のマークをクリックしましょう．
<img width="800" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/b00fdcee-8c9b-75f6-0a19-957d6dab7edc.png">
右側に生成されたPDFファイルが表示されます．
```Ctrl + S```でtexファイルを保存・コンパイルすることにより，右側のPDFファイルは随時更新されていきます．
<img width="800" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/166750/0ad4db1c-4a5f-d185-82ce-d6243ae1e406.png">