やりたいこと

卒業前に弊高専にLaTeXを布教したいが為に書いてみた。
LaTeXの環境構築と、Visual Studio Codeで自分が普段使っているレポート作成用のスニペットの導入も備忘録代わりに書いてみる。
TeX Wikiの内容とtug.orgのマニュアルの簡略版的な内容

LaTeX環境の構築

TeX Live.exeのダウンロードとインストール

The TeX Users Groupが公開しているWindows用のネットワークインストーラーをここからダウンロードして、インストールしていく。
Administratorでインストーラーを実行すれば、全ユーザーにLaTeXを使うための環境がインストールされる。
軽く1, 2時間はかかるので、その間にVScodeでの環境準備とかしてください。
コマンドプロンプトでtexを叩いたときにバージョンの表示がされればインストール成功です。コマンドが見つからない場合は環境PATHが通ってないので、以下のパスを環境変数に追記してください。

%SystemRoot%\system32
%SystemRoot%

VSCodeの環境構築

VSCodeのインストール

ここからインストールするか、wingetを使っている人は以下のコマンドでインストールしてください。

winget install --id Microsoft.VisualStudioCode

LaTeX用の拡張機能のインストール

コマンドパレット(Ctrl+Shift+P)で以下のコマンドを実行するか、LaTex Workshop, LaTeX Utilitiesを検索窓から検索して入れてください。

ext install James-Yu.latex-workshop
ext install tecosaur.latex-utilities

upLaTeXの設定

VSCodeのユーザー設定setting.jsonに以下を記述して保存します。
これで、日本語対応なLaTeXになります。

"latex-workshop.latex.tools": [
{
    "name": "latexmk",
    "command": "latexmk",
    "args": [
     "-e",
     "$latex=q/uplatex %O -kanji=utf8 -no-guess-input-enc -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/",
     "-e",
     "$dvipdf=q/dvipdfmx %O -o %D %S/",
     "-norc",
     "-gg",
     "-pdfdvi",
     "%DOC%"
    ]
}
]

レポート作成に使ってるSnippetの設定

自分がレポート作成に使っているSnippetの設定をGitHubにあげておきます。
これをVSCodeのユーザースニペットにするっとまるっとコピペすればそのまま使えます。
ちなみに、ソースコードを貼り付ける予定のある人はjlisting.styパッケージのインストールを行ってください。

Todo Treeへ%を対応させる

VSCodeの拡張機能であるTodo TreeへLaTeXのコメントアウト記号%を対応させる正規表現をsetting.jsonに追記します。

"todo-tree.regex.regex": "((//|#|%|<!--|;|/\\*|^)\\s*($TAGS)|^\\s*- \\[ \\])",

ちなみに、Todo Treeのissueを覗いたらあったので、作成者のjoe4devに感謝です。

使い方

VSCodeで文章を書き終わったら、コマンドパレット(Ctrl+Shift+P)からLaTeX Workshop: Build LaTex projectを実行するか、サイドバーに表示されているLaTeX Workshopを選択し、一番上のBuild LaTeX projectをクリックすれば自動でpdfの作成がされます。