latexmk で楽々 TeX タイプセットの薦め（＆ biblatex+biberで先進的な参考文献処理） konn-san.com

OMake はもう古い！latexmk で快適 TeX コンパイルのススメ

TeX のタイプセットって面倒ですよね。数式番号をちゃんと出力するには二、三回タイプセットする必要がありますし、参考文献を自動処理しようとすると、latex と bibtex を交互に呼んだりしないといけなくなります。こういう手順を自動化できたら便利ですよね。あと、ファイルを保存する度にいちいち手動で一からコンパイル仕直すのも手間です。ファイルを変更したら自動的に PDF を生成してくれるような仕組みがあったら楽なんですけどねえ。

……というような用途だと、昔は OMake が有名で、OMake を使ったら 身長が5cm伸びて彼女が出来た というような記事までありました。すごいですね！

しかし、OMake は最近あまりメンテナンスされていなくて、bib ファイルや目次が変更された際にちゃんと正しい回数コンパイルしてくれず、正しい PDF が得られないという問題があります。また、TeXファイルごとに OMakefile を書かないといけないので面倒です。

どうしたものか……と悩んでいたのですが、 latexmk というツールを使えば、こうした悩みは全部一挙に解決してしまうことがわかりました！しかも、OMake と違い、latexmk は標準的な TeX ディストリビューション（TeXLive とか MacTeX）にはデフォルトで付いてくるので、何も準備せずに使うことが出来るのです！

以下では簡単に latexmk の使い方を紹介したいと思います。あと、折角なので biblatex と biber についても紹介します。

#!/usr/bin/env perl
$latex            = 'platex -synctex=1 -halt-on-error';
$latex_silent     = 'platex -synctex=1 -halt-on-error -interaction=batchmode';
$bibtex           = 'pbibtex';
$dvipdf           = 'dvipdfmx %O -o %D %S';
$makeindex        = 'mendex %O -o %D %S';
$max_repeat       = 5;
$pdf_mode	  = 3; # generates pdf via dvipdfmx

# Prevent latexmk from removing PDF after typeset.
# This enables Skim to chase the update in PDF automatically.
$pvc_view_file_via_temporary = 0;

# Use Skim as a previewer
$pdf_previewer    = "open -ga /Applications/Skim.app";

$ latexmk my-great-work.tex

$ latexmk -pvc my-great-work.tex

$ latexmk -xelatex -pvc my-great-work.tex

$pdf_update_command = "git commit -am'update'";

uplatex を使う

オマケとして upLaTeX と biber+biblatex の紹介を書いておきます。

upLaTex っていうのは、platexの内部をユニコードに対応させたヴァージョンで、詳細はZRさんの記事を参照。pLaTeX から upLaTeX に乗り換えるのは簡単で、jarticle とか jbook とかのドキュメントクラスを使っている場合は ujarticle や ujbook を代わりに使えば良いだけです。jsarticleなどのjs*系の場合は、

\documentclass[a4j,twocolumn,uplatex,dvipdfmx]{jsarticle}

みたいに、uplatexを引数に渡せばそのままコンパイルが通るようになります。latexmk でこいつを使うようにするには、-latex=uplatexなどとしてコマンドライン引数の形で指定するか、.latexmkrc をいじって

$latex            = 'uplatex -synctex=1';
$latex_silent     = 'uplatex -synctex=1 -interaction=batchmode';
$bibtex           = 'upbibtex';

などとしておけばよいです。upbibtex というのは pbibtex の内部ユニコード版です。

biber と biblatex

つぎに biblatex と biber の話をしましょう。biblatex というのは bibtex の後継で、より柔軟な運用が可能な文献管理・処理パッケージです。目で見て判りやすいところでは、例えばデフォルトで英字の書名は斜体、ユニコード文字の書名は太字で出力されるようになったりします²。MacTeX や TeXLive であれば、これらは最初から何もしなくとも勝手に入っています。 もちろん見た目だけではなくって、例えば文献一覧のソート順を柔軟に指定出来たり、様々な実用的なフィールドが追加されていたりします。詳しい仕様についてはbiblatex.pdf を参考にしてください。

実際に BibLaTeX の使い方を見てみましょう。例えば今まで pBibTeX なんかでは日本人の名前をちゃんとソートするのに Yomi フィールドを指定していましたが、BibLaTeX では次のように sortname フィールドを指定すれば、後はよしなにやってくれます：

@book{Takeuti:2001,
	Author = {竹内 外史},
	Keywords = {集合論, 数学, 数学基礎論, 数理論理学},
	Publisher = {講談社ブルーバックス},
	Title = {新装版 集合とはなにか},
	Year = {2001},
	Sortname = {Gaisi Takeuti}}

また、例えば次のようにして translator や Origlanguage によって訳者、元言語などを指定することも出来ます：

@book{Kunen:2008,
	Author = {Kenneth Kunen},
	Keywords = {集合論, 数学, 数理論理学, 数学基礎論, 強制法},
	Language = {Japanese},
	Note = {\cite{Kunen:1980} の邦訳},
	Origlanguage = {english},
	Publisher = {日本評論社},
	Title = {集合論―独立性証明への案内},
	Translator = {藤田博司},
	Year = {2008}}

biblatex を使うには、preamble に次のように書きます：

\usepackage[backend=bibtex, style=numeric]{biblatex}
\addbibresource{myreference.bib}
\addbibresource{biblio.bib}

ここでは、裏でファイル処理などを行ってくれるバックエンドとして今まで通り bibtex を使っています。今までは文献一覧を印字したいところに\bibliography{myreference.bib,biblio.bib}などと指定していましたが、BibLaTeX では preamble で \addbibresouce を使って一つずつ追加していきます。

本文で参考文献を表示したい時には次のようにします：

\printbibliography[title=参考文献]

今までは \bibliography{..} を使っていましたが、BibLaTeX では \printbibliography です。BibLaTeX はまだ日本語にローカライズされていないので、単に\printbibliography だけだと「参考文献」の代わりに「Bibliography」が節題になってしまいます。それを避けるために、[title=参考文献]として強制的に節題を指定している訳です。

biblatex にバックエンドとして bibtex と組み合わせて使う際には、一つ注意があります。どうした訳か upbibtex は biblatex の吐いた aux ファイルを処理しようとするとフリーズしてしまいます。ですので、latexmk での設定では

$bibtex = 'pbibtex';

と pbibtex を利用するように指定してやりましょう。そうすればちゃんと動きます。

さて。biblatex は、biber と組み合わせれば文献のソート順も変えることが出来ます。biber というのは（コマンドラインツールとしての）bibtex の代替で、biblatexのバックエンドとして使うことを想定して開発されているものです。

例えば preamble に次のように書いたとします：

\usepackage[backend=biber, style=numeric]{biblatex}
\DeclareSortingScheme{mysorting}{
  \sort{\citeorder}
  \sort{\field{sortname} \field{author} \field{translator} \field{editor}}
  \sort{year}
  \sort{title}
}
\ExecuteBibliographyOptions{sorting=mysorting}

すると、参考文献は次のようにソートされます：

1. まず本文での出現順にソート
2. 次に sortname、author、translator、editor フィールドを順に見て云って、存在したらその値を使ってソート。
3. 続いて発表年でソートして
4. 最後にタイトルでソート

こんな具合に、biber と biblatex を組み合わせると色々と柔軟な設定が出来るようになります。 ただ、単に backend を biber に指定しただけでは uplatex でちゃんと参考文献一覧を印字出来ません。latexmk の設定を次のように弄るひつようがあります：

$biber = 'biber --bblencoding=utf8 -u -U --output_safechars';

これは、「.bblファイルのエンコードは UTF-8、入出力も共に UTF-8 を使って、アクセント記号とかちょっとヤバめの記号は TeX にエンコードする」という意味の設定です。最後の「ヤバめ」云々というのがちょっと判りづらいですね。例えば biber はデフォルトのままだと bib ファイルで G{\"o}del のように書かれているものを、自動的に Gödel に変更して bbl に出力します。欧米では既にUTF-8をサポートしたTeXのエンジンが広く用いられているのでこれで問題がないのですが、upLaTeX はユニコード文字は全て和文だと判断して処理します。すると、上の文字はG ö delのように字間や書体が変な形で印字されてしまうのです。それを避けるために、アクセント記号をはじめとしたユニコード文字は LaTeX の命令を使ってエンコードした形で出力させる必要があります。それに必要なのが --output_safechars オプションという訳です。

こんな具合に、biber や biblatex を使えば従来の BibTeX では手のまわらなかった細かいところまで柔軟に設定することが出来ます。まだ日本語環境にローカライズされていなかったりしますが、それでも実用には耐え得るものになっていると云えると思います。