Takuya Miyashita

Gitを使用した文書の管理 †

基本 †

LaTeX文書をGitで管理して，Gitホスティングサービス(GitHub，Bitbucketなど)と Overleaf を使えば，研究室外で編集する時の煩わしさが減る．
GitHub と Overleaf の連携機能（有料）が便利だった．
やたらとコミットの数が増えてしまうが，論文原稿の場合はあまり気にする必要がないし，わかりにくくなったら節目の段階でタグをつければ良い．

.gitignore †

LaTeX文書に関するリポジトリでは，.gitignoreは大抵同じようなものになるはずなので，ここに示しておく．

*~
*.swp
*.aux
*.blg
*.dvi
*.lof
*.log
*.lot
*.out
*.pdf
*.toc
*.fdb_latexmk
*.fls
*-oldtmp-*.tex

Makefile †

本文が main.tex，bibtexがmain.bibの場合は，次の通りにMakefileを作成しておく．
命令の記述内のインデントについてはタブに変換することを忘れないように．

PLATEX := platex
PBIB := pbibtex
DVIPDF := dvipdfmx -p a4

.PHONY: all clean
all: main

main:
        $(eval FILE := main)
        $(PLATEX) $(FILE)
        $(PBIB) $(FILE)
        $(PLATEX) $(FILE)
        $(PLATEX) $(FILE)
        $(DVIPDF) $(FILE) 

clean:
        -rm -f *~ *.log *.dvi *.blg *.aux *.out *.bbl *.lot *.toc *.lof *.pdf

latexdiff-git †

現在のファイルの状況やコミット間での差分表示をするためのコマンド．
比較したい時点のコミットのハッシュを hogehoge とすると，

latexdiff-git --force -r hogehoge -e utf8 filename.tex

とすることで，差分を強調した tex ファイルが生成される．
hogehogeのようなコミットのハッシュではなく， HEAD や HEAD^^ 等でも可．

tex ファイルの中に input や include で挿入した箇所がある場合は

latexdiff-git --force --flatten -r hogehoge -e utf8 filename.tex

のように --flatten をつけると input をした内容も展開してくれる．
ただし，--flatten は bib も展開してしまい，文献の欄のdiffがうまく機能しない（自分だけ？）．

土木学会論文集の原稿の Makefile では，下記のように書いておいた(メインのファイルは ronbun-j.tex)．

diff:
	latexdiff-git --force -r hogehoge -e utf8 ronbun-j.tex # 1回目本原稿提出時のコミットのハッシュ(例:hogehoge)を置換する
	$(PLATEX) ronbun-j-diffhogehoge
	$(PBIB) ronbun-j-diffhogehoge.aux
	$(PLATEX) ronbun-j-diffhogehoge
	$(PLATEX) ronbun-j-diffhogehoge
	$(DVIPDF) ronbun-j-diffhogehoge