User Tools

Site Tools


Sidebar

latex:vscodeによるlatex環境の基本設定

This is an old revision of the document!


概要

  • プログラミングから論文執筆まで全部一つのエディタで完結すると楽なので、VScodeでTeX環境を整えることにします。
  • VScode上でTeXファイルの作成からコンパイルとプレビューの表示まですべて行います。
  • 日本語のTeXを扱いたいので pLaTeX を使用します。英文のみであればVSCodeにLaTeX-Workshopを入れる以外は作業の必要がありません。
  • 事前に TeX Live と VS Code をインストールしてください。

設定手順

latexmkの設定

  • latexmkはLaTeXによる一連のビルド作業を自動で行ってくれます。
  • VS Codeでは、このlatexmkを呼び出してTeXファイルをビルドします。
  • 英語のTeXファイルであれば特に設定しなくてもPDFにできますが、日本語の場合はpLaTeXなど日本語環境に合わせたものに変更する必要があるために設定を行います。
  • すでにlatexmkを使用されている場合は、この項目を読む必要はありません

ホーム・ディレクトリ(ユーザー名がUSERNAMEの場合、Mac, Linuxの場合は /home/USERNAME/、Windowsの場合は C:\Users\USERNAME)に次の .latexmkrc というファイルを作成します。

.latexmkrc
#!/usr/bin/env perl
 
$latex = 'platex %O %S';
$bibtex = 'pbibtex %O %S';
$biber = 'biber --bblencoding=utf8 -u -U --output_safechars %O %S';
$makeindex = 'mendex %O -o %D %S';
$dvipdf = 'dvipdfmx %O -o %D %S';

VSCodeにLaTeX-Workshopを導入

  • VSCodeを開き、[View]→[Extensions](あるいはCtrl+Shift+x)から、“latex”で検索します。
  • LaTeX Workshopが一番上に表示されるはずなので、それを選んでインストールします
  • 左下の歯車のマークから[Settings]を選び(あるいは Ctrl+,)、“tools”で検索します
  • “Latex-workshop>Latex:Tools”という項目が見つかるはずなので、その下の説明文の下にある“Edit in settings.json”をクリックします。これでsettings.jsonにLateX-Workshop関係の設定が追加されます。
  • “-pdf”となっているところをコメントアウトもしくは“-pdfdvi”に変更します
  • デフォルトではエラーが出ても(ファイルがないなど続行が原理的に不可能でない限り)コンパイルが続きます。ここでは追加で-halt-on-error(エラーが出た時点でコンパイルを強制終了)をつけておきます。

変更前

settings.json
(略)
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOC%"
            ],
            "env": {}
        },
(略)

変更後

settings.json
(略)
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-halt-on-error",
                "-pdfdvi",
                "-outdir=%OUTDIR%",
                "%DOC%"
            ],
            "env": {}
        },
(略)

settings.json は Settings を開いて右上の書類の形をしたアイコン(カーソルを上にもっていくとOpen Settings (JSON) と表示される)をクリックすると編集できます。

使い方

  • TeXファイルは Ctrl+Alt+b でビルドできます
  • プレビューは Ctrl+Alt+v で開きます
  • プレビューをCtrlを押しながらクリックすれば、ソースコードの対応する部分に移動します
  • ソースコードで Ctrl+Shift+p をおしたあと synctex と入力することでPDFの該当箇所に移動します

参考にしたサイト

latex/vscodeによるlatex環境の基本設定.1591846989.txt.gz · Last modified: 2021/06/27 21:59 (external edit)