タイプセットしたい(latexmk
)
$ latexmk [オプション] ファイル名 # .texはあってもなくてもよい
$ latexmk # ファイル名がなくてもよい(ときもある)
latexmk
はLaTeX版Makefileのようなもので、
文書のタイプセット(=コンパイル)を自動化できるコマンドです。
目次や参照が更新されたときに複数回コンパイルしたり、 変更のあったファイルのみを差分コンパイルしたり、 だんだん煩わしくなってくる作業を簡単化できます。 ファイル名を指定しない場合でも、よしなにやってくれます。
注釈
latexmk
は1990年代に開発され、2008年にTeX Liveに同梱されそうです。
2010年ころにエディターとの統合や設定例の普及により、
現在のように広く利用されるようになりました。
シェルエスケープしたい(-shell-escape
)
$ latexmk -shell-escape
コードをシンタックスハイライトするminted
パッケージなど、外部スクリプトを呼び出すパッケージを使う場合、-shell-escape
オプションが必要です。
エラーを無視したい
$ latexmk -f -interaction=nonstopmode
ライブプレビューしたい(-pvc
)
$ latexmk -pvc
-pvc
オプションでPDF出力をライブプレビューできます。
これで編集作業が捗ります。
設定ファイルを指定したい
1$ latexmk -r latexmkjarc
設定ファイルのデフォルトはlatexmkrc
もしくは.latexmkrc
ですが、-r
オプションで変更できます。
中間ファイルを削除したい(-c / -C
)
$ latexmk -c
$ latexmk -C # 中間ファイルをすべて削除する
コンパイルすると.aux
/ .fdb_latexmk
/ .fls
/ .log
/ .out
などの拡張子の中間ファイルが作成されます。
-c
オプションをつけると、コンパイル後にそれらの中間ファイルを削除できます。
-C
オプションでdvi
/ ps
/ pdf
も含めたすべての中間ファイルを削除できます。
ヘルプを確認したい
1$ latexmk -h
2$ latexmk --help
3$ texdoc latexmk
シェルでの実行オプションを確認したい場合は-h / --help
で十分です。
もっと詳細を確認したい場合はtexdoc
してPDFを確認するのが一番です。
バージョンを確認したい
1$ latexmk -v
2$ latexmk --version
3Latexmk, John Collins, 17 Mar. 2022. Version 4.77