はじめに
本ページでは、VScodeを使った環境構築について説明した備忘録である。主に「ゼロからVSCodeでTeX環境構築（Mac Big Sur）」を 参考にしており、基本的にはその流れに従うこととする。詳細については、そちらのページを参考にする形として、主に作業内容などについて記載する。
動作環境
- Mac mini M2 Pro(2023)
- macOS 13.2.1 (22D68)
- VScode 1.75.1 (Universal)
ターミナル
以下では、ターミナルで実行すべき操作について主に書いていく。
Homebrewのインストール
Homebrewのページに記載されている以下のコマンドをターミナルで実行する。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
少し時間がかかりますが、おとなしく待ちましょう。以下のような結果が出力されたら、その指示に従って、コマンドを実行しましょう。なお、以下のコマンドはその一例である。
==> Next steps:
- Run these two commands in your terminal to add Homebrew to your PATH:
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/[username]/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
コマンドを打ったのちに、Homebrewが動作していることを確認するために、以下のコマンドを打ってみましょう。
$ brew --version
Homebrew 4.0.1
上記のような結果が得られば、Homebrewのインストールは終了である。
MacTexのインストール
MacTexについて詳しいことは、「MacTex」を参照されたい。
GUI-Applications なしの場合
以下のコマンドをターミナルで実行する。
$ brew install --cask mactex-no-gui
１つ目のコマンドの実行後、
🍺 mactex-no-gui was successfully installed!
と出力されたら、インストールは終了である。
VScode
以下では、VScodeで行う操作について主に書いていく。
VSCodeで拡張機能（LaTeX Workshop）をインストールする
VScodeの拡張機能である(Latex Workshop)をインストールする。
setiing.jsonの編集
- VScodeを立ち上げ、左下の設定ボタン(歯車のマーク)をクリックし、設定を開く。
- 設定の右上、
ボタンをクリックし、setiing.jsonを開く。
ここで、必要なものを追加、編集していく。 - 追記が必要なのは以下の内容である。
{
"latex-workshop.latex.outDir": "./out",
"latex-workshop.latex.autoClean.run": "onBuilt",
"latex-workshop.latex.autoBuild.run": "onSave",
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.recipes": [
{
"name": "latexmk (lualatex)🧋",
"tools": [
"lualatexmk"
]
},
{
"name": "latexmk 🔃",
"tools": [
"latexmk"
]
},
{
"name": "latexmk (latexmkrc)",
"tools": [
"latexmk_rconly"
]
},
{
"name": "pdflatex ➞ bibtex ➞ pdflatex × 2",
"tools": [
"pdflatex",
"bibtex",
"pdflatex",
"pdflatex"
]
},
{
"name": "Compile Rnw files",
"tools": [
"rnw2tex",
"latexmk"
]
},
{
"name": "Compile Jnw files",
"tools": [
"jnw2tex",
"latexmk"
]
},
{
"name": "tectonic",
"tools": [
"tectonic"
]
}
],
"latex-workshop.latex.tools": [
{
"name": "lualatexmk",
"command": "latexmk",
"args": [
"-synctex=1",
"-file-line-error",
"-interaction=nonstopmode",
"-halt-on-error",
"-lualatex",
"-outdir=%OUTDIR%",
"%DOC%"
],
"env": {}
},
{
"name": "latexmk",
"command": "latexmk",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"-pdf",
"-outdir=%OUTDIR%",
"%DOC%"
],
"env": {}
},
{
"name": "latexmk_rconly",
"command": "latexmk",
"args": [
"%DOC%"
],
"env": {}
},
{
"name": "pdflatex",
"command": "pdflatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
],
"env": {}
},
{
"name": "bibtex",
"command": "bibtex",
"args": [
"%DOCFILE%"
],
"env": {}
},
{
"name": "rnw2tex",
"command": "Rscript",
"args": [
"-e",
"knitr::opts_knit$set(concordance = TRUE); knitr::knit('%DOCFILE_EXT%')"
],
"env": {}
},
{
"name": "jnw2tex",
"command": "julia",
"args": [
"-e",
"using Weave; weave(\"%DOC_EXT%\", doctype=\"tex\")"
],
"env": {}
},
{
"name": "jnw2texmintex",
"command": "julia",
"args": [
"-e",
"using Weave; weave(\"%DOC_EXT%\", doctype=\"texminted\")"
],
"env": {}
},
{
"name": "tectonic",
"command": "tectonic",
"args": [
"--synctex",
"--keep-logs",
"%DOC%.tex"
],
"env": {}
}
],
setting.jsonを編集した後に保存し、VScodeを再起動すると良い。
注意事項
- SyncTexについて
この設定では、表示しているpdfの必要な部分をcmdを押しながらクリックすることで、codeの該当部分に飛ぶ設定になっている。この機能は文書が長くなればなるほど寵愛する機能であるため、ぜひ慣れておくと良いだろう。
Sample
これらの設定を使った、Sampleを以下に示す。
\documentclass{ltjsarticle}
\begin{document}
これはSampleです。
\end{document}
これをコンパイル(cmd+s)して、pdfを表示(cmd+op+v)で以下の画像が表示されれば環境構築は完了である。
