インストール（Mac）

MacにLaTeXをインストールする方法を紹介します。

Macにおいては、MacOS上に直接TeX Liveをインストールしていきます。 MacTeXなるものがあるようですが、環境を汚す原因になるらしいので使いません。 本当は、Dockerなるものを使えば、環境を汚さずにTeXを導入できるのですが、Dockerは初心者には少し難し（く、私もあまり理解していな）いので、今回は使いません。 TUG（TeX Users Group）の公式サイトからTeX Liveをインストールしていきます。

Ghostscriptの導入

まずは、Ghostscriptを導入していきます。 私もよくわかっていないが、LaTeXはGhostscriptに依存しているらしい。

  1. Homebrewの公式サイト（https://brew.sh/ja/）を開き、「インストール」の下のコマンド（/bin/bashから始まる文字列）をコピーする。
  2. 次に、ターミナルを開き、先ほどのコマンドを貼り付け、Enterを押す。
  3. 途中「Xcode Command Line Tools」をインストールするという画面が出るのでEnterを押す。
  4. また、次のようなコマンドを打つように求められるので、コピーして貼り付けてEnterを押す。下は見本なので、ターミナルに出てきた文字列をコピーしてほしい。 
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/xxxx/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
  5. 次のコマンドを打って、Ghostscriptをインストールする。 
    brew install ghostscript

以上で、Ghostscriptの導入は終わりです。

TeX Liveの導入

次に、TeX Liveを導入していきます。

  1. TeX Liveの公式サイト（https://tug.org/texlive/acquire-netinstall.html）からインストーラー（install-tl-unx.tar.gz）をダウンロードします。以下の直リンクからダウンロードできます。 https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
  2. ダウンロードしたファイルを解凍してください。
  3. ターミナルを開き、「sudo （sudoの後に半角スペース）」と入力して、解凍したフォルダーの中にある「install-tl」をターミナルにドラッグ・アンド・ドロップしてEnterを押してください。TeX Liveのインストーラーが起動します。
  4. インストーラーが起動したら、「Enter command:」の後に「I（大文字のアイ）」入力してEnterを押し、インストールを開始してください。インストールにはかなり時間がかかります。1時間〜2時間ほどは見ておいた方がよいです。
  5. インストールが完了したら、パスを通します。ターミナルに以下のコマンドを入力してください。 
    sudo /usr/local/texlive/????/bin/*/tlmgr path add
  6. ターミナルに以下のコマンドを入力して、TeX Liveの動作確認を行います。バージョン情報が表示されれば成功です。 
    latex --version

これでTeX Liveの導入は完了です。

VS Codeの導入

次に、VS Codeを導入していきます。

  1. まず、VS Codeの公式サイト（https://code.visualstudio.com/）からVS Codeをダウンロードしてインストールします。
  2. インストールが完了したら、VS Codeを起動します。
  3. 次に、左側の「拡張機能アイコン」から「Japanese Language Pack for Visual Studio Code」を検索してインストールします。右下に「Change Language and Restart」というボタンが表示されるので、クリックして再起動してください。日本語になります。
  4. 同様に、「LaTeX Workshop」も検索してインストールします。インストールできたらVS Codeを再起動しましょう。

これでVS Codeの導入は終わりです。

LaTeX周りの初期設定

TeX LiveとVS Code（とその拡張機能）のインストールが終わったら、各種設定をしていきます。 設定は基本的にテキストファイルを編集する形で行われます。

.latexmkrcの作成

.latexmkrcファイルを作成し適切な内容を書き込みます。 これはVS CodeでLaTeX ドキュメントをコンパイルする際の設定ファイルです。 慣れてきたら自分で設定すればよいと思いますが、とりあえずは私の.latexmkrcを参考にしてください。 私のサイト（https://tex.unhium.com/config/latexmkrc）からファイルをダウンロードし、Macの場合はホームディレクトリに、Windowsの場合はWSLのホームディレクトリに配置してください。 サイトにあるコマンドをWindowsの場合はWSLのターミナルに、Macの場合はターミナルに貼り付けて実行することでもコピーできます。

settings.jsonの作成

settings.jsonファイルを作成し適切な内容を書き込みます。 これはVS Codeの設定ファイルで、VS Code全体の設定を行うことができます。 こちらも、とりあえずは私のsettings.jsonを参考にしてください。 私のサイト（https://tex.unhium.com/config/vscode-settings）からダウンロードできます。 VS Codeの左側の「設定アイコン」をクリックして設定を開き、右上の「設定（JSON）を開く」をクリックしてsettings.jsonを開いて、そこに上記の内容を貼り付けてください。

snippetの設定

ユーザースニペットは、特定の文字列を入力したときに、あらかじめ設定したコードが自動で挿入される機能です。 例えば、”eq”と入力してTabキーを押すと、\begin{環境}...\end{環境}のコードが挿入されるように設定できます。 これにより、頻繁に使用するコードを簡単に挿入できるようになります。 こちらも、とりあえずは私のものを参考にしてください。 私のサイト（https://tex.unhium.com/config/vscode-snippets）からダウンロードできます。

VS Codeの左側の「設定アイコン」をクリックして、「スニペット」をクリックします。 上のバーに「スニペットファイルの選択もしくはスニペットの作成」とあるので、「latex」と入力して「latex.json」を作成します。 私のスニペットの中身をこのファイルに貼り付けてください。

動作確認

最後に、動作の確認をしていきます。

  1. ターミナルを開き、次のように順に入力します。 
    mkdir latex
mkdir latex/sample
mkdir latex/sample/graphicx
  2. 次に次のコマンドを入力します。 
    curl -L https://tex.unhium.com/sample/main.tex -o ~/latex/sample/main.tex
curl -L https://tex.unhium.com/sample/image.pdf -o ~/latex/sample/graphicx/image.pdf
  3. VS Codeを起動し、左側の「ファイルアイコン」をクリックして、「フォルダーを開く」を押して、「(ユーザー名)/latex」というフォルダーを選択してください。
  4. さて、左側部分にsampleというフォルダーが表示されていると思います。これをクリックして展開し、「main.tex」をクリックして開いてください。
  5. 開いた「main.tex」の右上にある「プレビューアイコン（2分割された画面に虫眼鏡）」をクリックして、プレビュー画面を開きます。まだ何も表示されないと思います。
  6. 「main.tex」の右上にある「実行アイコン（三角形）」をクリックして、コンパイルを実行してください。
  7. すると、左側を見ると、main.texと同じディレクトリに「main.pdf」というファイルが他の雑多なファイルとともに生成されると思います。また、プレビュー画面では、main.texの内容がPDF形式で表示されると思います。そうなれば成功です。
  8. PDFにはいろいろ適当に書いているので、適宜読んでみてください。

うまくいけば動作確認は終了です。