git_integration.md

Git との組み合わせ

laTeX 環境の構築 についてはこちらを参考のこと。

gitを用いてバージョン管理する。

TeXはいろいろな中間ファイルを吐き出すので、それを無視する.gitignoreファイルを作成する。
このファイルの名前を.gitignoreに変更し、リポジトリの最上階層に保存する。
その他、git管理したくないファイルがあれば、同様に.gitignoreファイルに記述しておくとよい。

git-latexdiff

laTexにはlatexdiffという差分を表示する仕組みがある。 それを簡単に使うためのスクリプトgit-latexdiffを用意した。

環境構築

latexdiffのインストール

latex ファイルの差分を抽出するlatexdiffを用いる。 PCにインストールされていない場合は、それをインストールしておく。

sudo apt-get install latexdiff

git-latexdiffの準備

このgit-latexdiffをlaTeX 環境の構築で用意したlatexmkrcと 同じパスに置く。

差分の表示

以下のようにすると、ディレクトリ内にdiff.pdfが作成される。 このdiff.pdfファイルには、修正前のものが小さな赤字で、修正後のものがボールドの青字で示されており、 変更点がわかりやすくなっている。

現在のファイルと直前のコミットとの差分を表示する。

ターミナルから./git-latexdiffを実行する。

Permission denied

と表示される場合は、chmod +x git-latexdiff などとして、ファイルの実行を許可する。

指定したブランチと現在のファイルの差分を表示する。

ターミナルから./git-latexdiff ブランチ名を実行する。
例えば、master ブランチ内のファイルとの差分を表示したければ、 ./git-latexdiff master を実行する。

指定したコミットと現在のファイルの差分を表示する。

ターミナルから./git-latexdiff {SHA-id}を実行する。
なお、SHA-id はコミットに紐付けられた id で各種ツールから確認できる。
例えば、0198fe0f というSHA-idを持つコミットとの差分を表示したければ
./git-latexdiff 0198fe0f
を実行する。

指定した２つのブランチ間の差分を表示する。

ターミナルから./git-latexdiff 新ブランチ名 旧ブランチ名を実行する。
同様に、ディレクトリ内にdiff.pdfが作成される。

なお前項と同様に、ブランチ名の代わりに 特定のコミットのSHA-idを指定してもよい。
その場合は、指定した2つのコミット間での差分を表示することになる。