LaTeX::設定スタイルファイル自作・追加スタイルファイルについて

スタイルファイルは，LaTeX の機能や文書の体裁をまとめたファイルです．拡張子は .sty で，本文のプリアンブルに「\usepackage{ファイル名}」と書いて読み込みます．このとき，拡張子 .sty は付けません．

\usepackage{my_style}

一度しか使わないスタイルファイルであれば，LaTeX のソースファイル *.tex と同じディレクトリーに置くのが最も簡単です．何度も使う自作ファイルや，複数の文書で共有するファイルは，TeX が検索できる texmf ツリーに置くと，どの作業ディレクトリーからでも読み込めます．

クラスファイル *.cls，設定ファイル *.cfg，定義ファイル *.def なども，基本的には同じ考え方で配置します．ただし，TeX Live 本体が管理している texmf-dist の中を直接書き換えると，アップデートで上書きされることがあるため，自作ファイルは個人用またはローカル用の texmf ツリーに置きます．

TeX Live に含まれている公開パッケージは，通常は TeX Live の仕組みで管理します．ここで扱うのは，自分で作ったスタイルファイルや，配布物から取り出した少数のファイルを手作業で追加する場合です．

pLaTeX がスタイルファイルを探す場所は，次のコマンドで確認できます．

$ kpsewhich -var-value TEXINPUTS.platex

検索パスは，Linux ではコロン「:」，Windows ではセミコロン「;」で区切られて表示されます．末尾が「//」のパスは，その下のサブディレクトリーも再帰的に検索します．先頭に「!!」が付くパスは，ディスク上を直接探さず，ls-R というファイル名データベースだけを検索します．

個人で使う場合

自分だけで使うスタイルファイルは，ユーザー用 texmf ツリーに置くのが扱いやすい方法です．ユーザー用 texmf ツリーの場所は，次のコマンドで確認できます．

$ kpsewhich -var-value TEXMFHOME

一般的な TeX Live の設定では，Linux では ~/texmf，Windows では C:/Users/ユーザー名/texmf がユーザー用 texmf ツリーになります．スタイルファイルは，その下の tex/latex/パッケージ名 に置きます．たとえば my_style.sty を追加する場合は，次のようにします．

$ mkdir -p ~/texmf/tex/latex/my_style
$ cp my_style.sty ~/texmf/tex/latex/my_style/

ユーザー用 texmf ツリーは通常，ディスク上のファイルを直接検索するため，ファイルを置くだけで使えることが多いです．そのため，個人用の ~/texmf に置いた場合は，多くの環境で mktexlsr は不要です．

複数人で使う場合

複数人で共通に使うスタイルファイルや，システム全体で使うファイルは，ローカル用 texmf ツリーに置きます．ローカル用 texmf ツリーは，次のコマンドで確認できます．

$ kpsewhich -var-value TEXMFLOCAL

TeX Live では，典型的には /usr/local/texlive/texmf-local がローカル用 texmf ツリーです．ここに置く場合も，スタイルファイル本体は tex/latex/パッケージ名 の下に置きます．

$ sudo mkdir -p /usr/local/texlive/texmf-local/tex/latex/my_style
$ sudo cp my_style.sty /usr/local/texlive/texmf-local/tex/latex/my_style/
$ sudo mktexlsr

TEXMFLOCAL は検索パスの先頭に「!!」が付いていることが多いため，ファイルを追加した後に mktexlsr を実行し，ls-R を更新します．この更新を忘れると，ファイルを正しい場所に置いていても LaTeX が見つけられないことがあります．

確認方法

スタイルファイルを置いたら，LaTeX を実行する前に kpsewhich で検索できるか確認します．

$ kpsewhich my_style.sty
/home/yamamoto/texmf/tex/latex/my_style/my_style.sty

ファイルのパスが表示されれば，LaTeX から読み込めます．何も表示されない場合は，保存場所，ファイル名，大文字小文字，または mktexlsr の実行忘れを確認します．同じ名前のスタイルファイルが複数ある場合は，kpsewhich が表示したものが先に使われます．

参考資料

更新履歴