📈

HomebrewでMacにTeX環境を構築する方法

2024/12/23に公開

VS Code

LaTeX

TeX

tech

MacでTeX環境を構築する方法はいくつかありますが、ここではHomebrewを使った方法を解説します。Homebrewは、Macのパッケージマネージャーとして広く使われており、コマンド一つで必要なソフトウェアを簡単にインストールできます。

 前提条件この記事は、Homebrewが既にインストールされていることを前提としています。まだインストールしていない方は、以下の公式ページからインストールを行ってください。
Homebrew公式サイト

 TeX環境のインストール手順TeX Liveのインストール
Homebrewを使ってTeX Liveをインストールします。以下のコマンドをターミナルで実行してください。
brew install --cask mactex-no-gui
このコマンドでインストールされるのは、GUIなしのMacTeXです。必要最小限のパッケージでTeX環境を構築できるため、シンプルで効率的です。
パスの確認
インストール後、TeXのコマンドが正しく認識されるようにパスを確認します。以下のコマンドを実行して、/Library/TeX/texbinが含まれているかを確認してください。
echo $PATH
含まれていない場合は、次のようにパスを追加します。
echo 'export PATH="/Library/TeX/texbin:$PATH"' >> ~/.zshrc
source ~/.zshrc
動作確認
以下のコマンドを実行し、TeXが正常に動作するかを確認します。
pdflatex --version
バージョン情報が表示されれば、インストール成功です。
必要なパッケージのインストール（必須ではありません）
LaTeX文書を作成する際に追加のパッケージが必要になることがあります。その場合は、以下のコマンドでインストールできます。
sudo tlmgr install <パッケージ名>
例: geometryパッケージをインストールする場合
sudo tlmgr install geometry

 エディタの準備TeXの文書を編集するために、専用のエディタを準備しましょう。以下のエディタが人気です。

Visual Studio Code (VSCode)
拡張機能として"LaTeX Workshop"をインストールすることで、快適にTeX文書を作成できます。
LaTeX Workshopのインストール方法:
VSCodeの拡張機能マーケットで"LaTeX Workshop"を検索。
インストールボタンをクリック。





TeXShop
Mac向けの無料エディタ。MacTeXに含まれています。


 サンプルファイルで実行してみるsample.texというファイルを作成します。
サンプルコードはこちら
\documentclass[a4paper,11pt]{article}
\usepackage{luatexja}
\usepackage{graphicx}
\usepackage{amsmath}
\usepackage{siunitx}
\usepackage{float}

\title{単振り子の周期に関する実験}
\author{工学部物理学科 \\ 学籍番号：12345}
\date{\today}

\begin{document}
\maketitle

\section{実験目的}
単振り子の振動周期と糸の長さの関係を調べ、重力加速度を算出する。

\section{実験装置}
\begin{itemize}
    \item 糸（長さ可変）
    \item 重り（質量：\SI{100}{\gram}）
    \item ストップウォッチ
    \item 定規
\end{itemize}

\section{実験方法}
\begin{enumerate}
    \item 糸の長さを\SI{30}{\centi\metre}に設定
    \item 振幅約\SI{5}{\degree}で振動を開始
    \item 10周期の時間を測定
    \item 上記を3回繰り返し、平均値を算出
\end{enumerate}

\section{実験結果}
周期$T$と振り子の長さ$L$の関係は以下の式で表される：
\[T = 2\pi\sqrt{\frac{L}{g}}\]

\begin{table}[H]
\centering
\begin{tabular}{|c|c|c|}
\hline
長さ [\si{\centi\metre}] & 10周期 [\si{\second}] & 周期 [\si{\second}] \\
\hline
30 & 10.92 & 1.092 \\
\hline
\end{tabular}
\end{table}

\section{考察}
測定値から計算された重力加速度は\SI{9.81}{\metre\per\second\squared}となり、
理論値とよく一致している。

\end{document}


 トラブルシューティングフォント関連のエラーが出る場合

パッケージを更新することで解決する場合があります。
sudo tlmgr update --self --all
特定のパッケージが見つからない場合

必要なパッケージを手動でインストールしてください。
sudo tlmgr install <パッケージ名>

前提条件

TeX環境のインストール手順

エディタの準備

サンプルファイルで実行してみる

トラブルシューティング

Discussion