【2014年版】『MacTex 2013』と『Sublime Text 2』でpLaTeX環境をつくる

Mac版『Sublime Text 2』でpLaTeXをコンパイルできる環境を構築してみました。

この記事は理工学生、研究生、一部ユーザ向けです

この記事は「pLaTeXを『Sublime Text 2』でコンパイルしたい！」という人に向けて書いたものです。したがってpLaTeXについて全く知らない人は読んでも無駄です！何も面白くありません！

当サイトは、技術的な記事を執筆しないポリシーで運営していましたが、僕自身pLaTeXを『Sublime Text 2』で動かすのに苦労してしまったので、メモとしてこの記事を執筆しました。

1. 『MacTeX 2013』をダウンロード

『TeX Live』というTeXのディストリビューションをさらにMac向けのディストリビューションにしたものが『MacTeX』です。今回はこの『MacTeX』の最新版『MacTeX 2013』を導入します。

上記リンクからMacTeX.pkgのリンクをクリックして、パッケージファイルをダウンロードします。2.3GB ほどの容量があるので、ダウンロードには少し時間がかかります。時間を有効に使うため、ダウンロードを開始したら次のステップに進みましょう。

2. 『Homebrew』をインストール

「パッケージマネージャはやっぱり『Homebrew』に限る！」ってことで、サクッと『Homebrew』を導入します。

ruby -e "1(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

導入したあとはシステムチェックとアップデートをしておきましょう。

brew update
brew doctor

3. 『ImageMagick』と『Ghostscript』の導入

LaTeXには『ImageMagick』と『Ghostscript』が必要です。のちに導入する『MacTeX』にはこれらが同梱されていますが、同梱されているこれらのバージョンが古いことやその他の都合から、『MacTeX』とは別に、『Homebrew』経由で導入します。

brew install imagemagick
brew install ghostscript

ちなみにですが、『Ghostscript』のバージョンが古いと、日本語を含むTeXファイルを変換することができません。上記コマンドでは最新の『Ghostscript』が導入されます。

4. 『MacTeX 2013』をインストール

『MacTeX』がダウンロードされるまで待ちます。ダウンロードされた“mactex20130618.pkg”を実行し、“インストールの種類”のところまで進みます。

ウインドウ左下にカスタマイズというボタンがあるので、そのボタンを押します。

この中で先ほど『Homebrew』で導入した、GhostscriptとConvert-IM（ImageMagick）のチェックを外しておきます。
GUI-Applicationsにチェックを入れると、TeXを書くためのアプリが導入されます。「俺は『Sublime Text』を使うんだ！」と思ってチェックを外すと、あとで必要になる『TeX Live Utility』というアプリも導入されないので、ここではGUI-Applicationsにチェックを入れておきます。

5. 『TeX Live Utility』でアップデート

『MacTeX』のインストールが完了すると、アプリケーションディレクトリに“TeX”ディレクトリが作成され、その中に各種GUIアプリが導入されます。この中の『TeX Live Utility』を使って、TeXのパッケージを最新のものにアップデートします。

open /Applications/TeX/TeX\ Live\ Utility.app

『TeX Live Utility』を起動したら、メニューバーのTeX Live UtilityよりCheck For Updates...を選択し、『TeX Live Utility』自体をアップデートします。アップデート後、『TeX Live Utility』を再起動します。

次に『TeX Live Utility』より、各種パッケージをアップデートします。メニューバーのActionsよりUpdate All Packagesを選択します。『MacTeX』のダウンロードよりも時間がかかるので注意しましょう。アップデートを開始したら次へ。

6. 『Sublime Text 2』を導入

『Sublime Text 2』をインストールします。他のMac向けアプリと同様の手順で導入できるため、ここでは手順を割愛します。…というか、この記事を見ている人は『Sublime Text 2』は既に入手していますよね…。

『Sublime Text 2』に『Package Control』を導入します。『Sublime Text 2』を好んで使っている人のほとんどは『Package Control』について知っていると思うので、これについても割愛します。以下のページを参考に『Package Control』を導入してください。

7. 『LaTeXTools』の導入

『LaTeXTools』は『Sublime Text 2』でLaTeXを扱うための、『Sublime Text 2』向けのパッケージです。今回はこれを導入します、が…。

ここです、ここ。すべての悪夢はここからでした。

『Sublime Text 2』でLaTeXをコンパイルする方法は、検索で調べればたくさん情報が載っています。今まではそれらの情報を基に操作すれば簡単にコンパイルできたのですが、2014年3月12日の『LaTeXTools』のアップデートにより今までの操作ではLaTeXをコンパイルすることができなくなりました。

数時間検索してみてもなかなか情報が集まらず、ダメ元でTwitterにて検索を行ったところ、「sublimeでlatex動かない」というツイートがヒットするではありませんか！

今回ご協力いただいた@namaegaukabanaiさんと@nayumayuchanさん、本当に感謝デス！

というわけで続きです。『LaTeXTools』を『Sublime Text 2』からインストールします。Cmd + Shift + Pを押して“Command Palette”を表示し、

install

と打ち込みControl Package: Install Packageを選択します。その中で

latextools

と打ち込み、『LaTeXTools』を導入します。

8. 『LaTeXTools』の設定

『LaTeXTools』を設定してpLaTeXを使用できる状態にします。従来までは“LaTeX.sublime-build”ファイルを編集する形でしたが、2014年3月12日のアップデートにより編集するファイルが変わりました。

ちなみに、作業を楽にするため、コマンドラインから『Sublime Text 2』を扱えるようにもしておきます。（※スーパユーザ権限で実行する必要があります。）

sudo ln -s "/Applications/Sublime Text 2.app/Contents/SharedSupport/bin/subl" /usr/bin/subl
cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/LaTeXTools/builders/traditionalBuilder.py
subl traditionalBuilder.py

“traditionalBuilder.py”の18〜20行目を以下のように修正します。

DEFAULT_COMMAND_LATEXMK = ["latexmk", "-cd",
                    "-e", "$latex = 'platex -synctex=1 -src-specials -interaction=nonstopmode'",
                    "-e", "$biber = 'biber %O --bblencoding=utf8 -u -U --output_safechars %B'",
                    "-e", "$bibtex = 'pbibtex %O %B'",
                    "-e", "$makeindex = 'makeindex %O -o %D %S'",
                    "-e", "$dvipdf = 'dvipdfmx %O -o %D %S'",
                    "-e", "$pdf_mode = '3'",
                    "-e", "$pdf_update_method = '0'",
                    "-e", "$pdf_previewer = 'open -a preview.app'",
                    "-f", "-norc", "-gg", "-pdfdvi"]

9. 『Skim』の導入

『LaTeXTools』は『Sublime Text 2』でLaTeXをコンパイルできるようになるだけでなく、コンパイル後に生成されたPDFファイルを自動的に開いてくれる機能を持ちます。それも、ただ開いてくれるだけでなく、既にPDFファイルが開かれている場合、そのPDFの表示を更新してくれる機能もあります。

2014年3月12日の『LaTeXTools』のアップデートにより、Mac標準のPDF閲覧アプリ『Preview』でPDFを表示させることができなくなり、代わりに『Skim』という閲覧アプリを利用することになりました。

というわけで『Skim』を導入します。

The build command is fully customizable. In the near future, so will be the PDF previewer.

LaTeXTools - GitHub より抜粋

『LaTeXTools』のGitHubを見る限り、近いうちに任意のアプリで開くこともできるようになるそうです。「どうしても『Preview』で開きたい！」という人は“待ち”ですね。

10. 日本語フォントをLaTeXで使えるようにする

何も設定せずとも日本語出力ができるはずですが、念のため、生成されるPDFに使われる日本語フォントを定義しておきます。

sudo mkdir -p /usr/local/texlive/texmf-local/fonts/opentype/hiragino/
cd /usr/local/texlive/texmf-local/fonts/opentype/hiragino/
sudo ln -fs "/Library/Fonts/ヒラギノ明朝 Pro W3.otf" ./HiraMinPro-W3.otf
sudo ln -fs "/Library/Fonts/ヒラギノ明朝 Pro W6.otf" ./HiraMinPro-W6.otf
sudo ln -fs "/Library/Fonts/ヒラギノ丸ゴ Pro W4.otf" ./HiraMaruPro-W4.otf
sudo ln -fs "/Library/Fonts/ヒラギノ角ゴ Pro W3.otf" ./HiraKakuPro-W3.otf
sudo ln -fs "/Library/Fonts/ヒラギノ角ゴ Pro W6.otf" ./HiraKakuPro-W6.otf
sudo ln -fs "/Library/Fonts/ヒラギノ角ゴ Std W8.otf" ./HiraKakuStd-W8.otf
sudo mktexlsr
sudo updmap-sys --setoption kanjiEmbed hiragino

ちなみにですが、僕は見出しが極端に太くなるのは嫌いなので、以下のように設定しました。

sudo mkdir -p /usr/local/texlive/texmf-local/fonts/opentype/hiragino/
cd /usr/local/texlive/texmf-local/fonts/opentype/hiragino/
sudo ln -fs "/Library/Fonts/ヒラギノ明朝 Pro W3.otf" ./HiraMinPro-W3.otf
sudo ln -fs "/Library/Fonts/ヒラギノ明朝 Pro W3.otf" ./HiraMinPro-W6.otf
sudo ln -fs "/Library/Fonts/ヒラギノ丸ゴ Pro W4.otf" ./HiraMaruPro-W4.otf
sudo ln -fs "/Library/Fonts/ヒラギノ角ゴ Pro W3.otf" ./HiraKakuPro-W3.otf
sudo ln -fs "/Library/Fonts/ヒラギノ角ゴ Pro W3.otf" ./HiraKakuPro-W6.otf
sudo ln -fs "/Library/Fonts/ヒラギノ角ゴ Std W3.otf" ./HiraKakuStd-W8.otf
sudo mktexlsr
sudo updmap-sys --setoption kanjiEmbed hiragino

11. 『Sublime Text 2』の再起動と設定の適用

最後に『Sublime Text 2』を終了させ、再び起動します（再起動）。その後『Sublime Text 2』のCmd + Shift + Pを押して“Command Palette”を表示し、

recon

と打ち込みLaTeXTools: Reconfigure and migrate settingsを選択します。

これで.texファイルを『Sublime Text 2』でコンパイルし、PDFを生成、そしてPDF生成時に『Skim』でPDFを表示させることができます。

『MacTeX 2013』と最新『LaTeXTools』の注意点

今までの『LaTeXTools』＋『MacTeX 2012』の環境から、新しい『LaTeXTools』＋『MacTeX 2013』の環境へ移ったときの注意点をいくつか挙げておきます。

“dvipdfm”は使えない

『MacTeX』のベースともなっている『TeX Live』ですが、『TeX Live 2013』より“dvipdfm”が使えなくなりました。今まで図を貼り付けるために記述していたプリアンブルは以下の通りですが、

\documentclass[a4j]{jarticle}
\usepackage[dvipdfm]{graphicx}

これからは“dvipdfmx”を使う必要があるため

\documentclass[a4j]{jarticle}
\usepackage[dvipdfmx]{graphicx}

と記述する必要があります。

これに伴い、PDFやPNGファイルを貼り付けるため今まで作成していた.bbファイルは、これからは.xbbファイルとなるので注意が必要です。.xbbファイルの作成コマンドは以下の通り。

extractbb <ファイル名>

コンパイル時に『Skim』以外で閲覧できない

先述したとおり『LaTeXTools』のアップデートにより、コンパイル時のPDF閲覧アプリは『Skim』のみ対応する形になりました。ただし近い将来、PDF閲覧アプリを選択できるようになるとのこと。

以上で『Sublime Text 2』にてpLaTeXをコンパイルする最新の方法でした。「知らないうちにコンパイルできなくなった！」という人は参考にしてみてください。