TexをVSCodeで使うために

はじめに

これは, ISer Advent Calendar 2021 - Adventarの記事として書かれました.*1

n番煎じの記事です。有用なことを書く気力出ない.

環境

自分はWindows上でTeX LiveとOverleafというサイトを使っています.Macで行うと,Homebrewというパッケージマネージャから簡単に,Linux系だとaptでTeXエンジンを入れられるという噂を聞きました.

Windowsをお使いの方はTeX Liveをインストールすることになると思いますが,どうやらWSLでインストールすると爆速!!!!らしいことをうわさで聞きました.

Windowsに入れる!

TeX Liveでググって*2入れましょう.インストール用の空き容量を作らないと入れられないです!注意!

TeX Live/Windows - TeX Wiki を見ると,isoイメージかネットワークインストーラの選択肢を与えられますが,通信環境と時間の問題で前者がよさそうという気持ちです.

VSCodeで使う!

デフォルトのエディタであるTeXworks editorで記述し ても十分いいと思います.

しかし,私はコードの記述,すべてをVSCodeで行いたいがため,VSCodeTeXを記述するために苦労します.

ステップその1:LaTeX Workshopを入れる

LaTeX Workshop - Visual Studio Marketplace を入れてください.*3シンタックスハイライトやコンパイルの実行をいろいろやってくれます.

ステップその2:LaTeX Workshopの設定

おそらくこれを読んでいる人は日本語でTeXを使いたいと思っている方だと思います.TeXにはいろいろなエンジンが存在して,それぞれいろいろな特徴があります(あるそうです). 興味ある人は,https://oku.edu.mie-u.ac.jp/texconf10/presentations/yato.pdfがよさそうでした.

とりあえず,LuaLaTeXを使うことを目標にします.*4 リファレンスが読める人は Compile · James-Yu/LaTeX-Workshop Wiki · GitHub を読むといいと思います.

VSCodeのsettings.jsonを開きます. 次の設定を加えます.

以下は, Visual Studio Code/LaTeX - TeX Wiki を参考にしました.

    "latex-workshop.latex.autoBuild.run": "never", // これは保存したときに自動でビルドするかどうか
    "latex-workshop.latex.recipe.default": "lastUsed", // どのレシピ(コンパイルオプション)をデフォルトで使用するか
    "latex-workshop.latex.recipe.tools": [ // latex workshop内でのコマンドの定義 ほかのエンジンを使いたいならばここに追加しrecipeをいじる
        {
            "name": "lualatexmk",  // recipeで参照する名前
            "command": "latexmk", // 実際のコマンド
            "args": [ // コマンドオプション
                "-e",
                "$lualatex=q/lualatex %O -synctex=1 -interaction=nonstopmode -file-line-error %S/",
                "-e",
                "$bibtex=q/upbibtex %O %B/",
                "-e",
                "$biber=q/biber %O --bblencoding=utf8 -u -U --output_safechars %B/",
                "-e",
                "$makeindex=q/upmendex %O -o %D %S/",
                "-norc",
                "-gg",
                "-pdflua",
                "%DOC%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [  // toolsを組み合わせたコンパイルのコマンド
        {
            "name": "lualatex twice", // レシピの名前
            "tools": [
                "lualatexmk",
                "lualatexmk"
            ]
        },
        {
            "name": "lualatex",
            "tools": [
                "lualatexmk",
            ]
        },
    ],

latexmk*5を使って,いろいろしている感じです!!!*6 これで実際につかうことができるはずです.適当なtex拡張子を開いて,次を書き込んでください.

\documentclass[a4paper]{ltjsarticle}

\begin{document}
こんにちは! \LaTeX
\end{document}

ショートカットは,Ctrl+Alt+BでBuild,Ctrl+Alt+VでViewです!ほかのレシピを使いたい場合は,VSCodeLaTeX Workshopのタブを開いてポチポチすると使用できます. これでTeXを使う環境が整いました.

終わりに

TeXなんもわからない

*1:いけなーい!遅刻!遅刻!

*2:死語

*3:おい,TeX Workshopという似たやつを入れかけた

*4:upLaTeXやpLaTeXは,近い将来, 和文文字コードの問題で動かないみたいな話を聞きました.

*5:なんか便利機能らしいが難しいいいい!!!!

*6:なんもわからん