テストの追加・整理
[makefiles.git] / latex_mk / latex.mk
index a0d4028..07625dc 100644 (file)
-.PHONY: clean-tex distclean-tex
+# latex.mk
+# LaTeX処理(コンパイル)を行う
+#
+# == 使い方 ==
+# 1. texソースファイルと同じディレクトリーに本ファイル(latex.mk)をコピーする
+# 2. Makefileに変数TEXTARGETS と「include latex.mk」を記述する
+# 3. texソースファイルと同じディレクトリーで、make コマンドを実行する
+#
+# == 機能 ==
+# - 読み込むべき中間ファイルがないことや相互参照未定義の警告がある場合、LaTeX処理を最大4回繰り返す
+# - \includegraphics命令がTeXファイルに含まれる場合、グラフィックファイルを挿入
+#   -- 挿入されたグラフィックファイルが更新されたときは、処理を開始
+#   -- 挿入されたグラフィックファイルがないときは、処理を中止
+#   -- 挿入されたグラフィックファイルに対するバウンディング情報ファイル(.xbb)を作成
+# - \include、\input命令がTeXファイルに含まれる場合、TeXファイルを挿入
+#   -- 挿入されたTeXファイルが更新されたときは、処理を開始
+#   -- 挿入されたTeXファイルがないときは、処理を中止
+# - \makeindex命令が含まれる場合、mendexで索引を作成
+# - \bibliography命令が含まれる場合、BiBTeXで文献一覧を作成
+#
+# == 擬似ターゲット ==
+# - tex-clean: TeX中間ファイル(auxなど)を削除。ターゲットに.dviが含まれていないときは.dviファイルを削除
+# - xbb-clean: バウンディング情報ファイル(.xbb)を削除
+# - tex-distclean: TeX中間ファイル、バウンディング情報ファイル、ターゲットファイル(PDF、.dvi)を削除
+#
+# === Makefile -- sample ===
+# TEXTARGETS := report.tex
+#
+# all: $(TEXTARGETS)
+#
+# include latex.mk
+.PHONY: warning tex-clean tex-distclean
 
 # シェルコマンド
+CAT := cat
+CMP := cmp -s
+CP := cp
 ECHO := echo
 GREP := grep
 SED := sed
 
+warning:
+       @$(ECHO) "check current directory, or set TARGET in Makefile."
+
 # LaTeXコマンド
-BIBTEX := pbibtex
+LATEX := platex
 DVIPDFMX := dvipdfmx
 EXTRACTBB := extractbb
-LATEX := platex
+BIBTEX := pbibtex
 MENDEX := mendex
 
+# TeX中間ファイルの拡張子
+#   .aux: 相互参照
+#   .fls: tex -recorderで生成されるファイルリスト
+#   .lof: 図リスト(\tableoffigures)
+#   .lot: 表リスト(\tableoftables)
+#   .out: hyperrefパッケージ
+#   .toc: 目次(\tableofcontents)
+#   .log: ログ
+TEX_INT := .aux .fls .lof .lot .out .toc .log
+# 索引中間ファイルの拡張子
+#   .idx: auxから作成
+#   .ind: idxから作成
+#   .ilg: 索引ログ
+IND_INT := .idx .ind .ilg
+# BiBTeX中間ファイルの拡張子
+#   .bbl: auxから作成
+#   .blg: BiBTeXログ
+BIB_INT := .bbl .blg
+
+.SECONDARY: $(wildcard $(addsuffix $(TEX_INT) $(IND_INT) $(BIB_INT) .d,*))
+
+# \tableofcontents命令
+toc = $(shell $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\tableofcontents/!s/.*\(\\tableofcontents\).*/\1/p' $<)
+
+# \listoffigures命令
+lof = $(shell $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\listoffigures/!s/.*\(\\listoffigures\).*/\1/p' $<)
+
+# \listoftables命令
+lot = $(shell $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\listoftables/!s/.*\(\\listoftables\).*/\1/p' $<)
+
+# \makeindex命令
+makeindex = $(shell $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\makeindex/!s/.*\(\\makeindex\).*/\1/p' $<)
+
+# \bibliography命令で読み込まれる文献データベースファイル
+bibdb = $(addsuffix .bib,$(basename $(strip $(shell \
+  $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\bibliography/!s/\\bibliography\(\[[^]]*\]\)\{0,1\}{\([^}]*\)}/&\n/p' $< $(intex) | \
+  $(SED) -e 's/.*{\([^}]*\)}.*/\1/' | \
+  $(SED) -e 's/,/ /g'))))
+
+# hyperrefパッケージ読み込み
+hyperref = $(shell $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\usepackage\(\[[^]]*\]\)\{0,1\}{hyperref}/!s/.*\(\\usepackage\)\(\[[^]]*\]\)\{0,1\}\({hyperref}\).*/\1\3/p' $<)
+
+# ファイル名から拡張子を除いた部分
+BASE = $(basename $<)
+
+# .texファイル
+TEXFILE = $(addsuffix .tex,$(BASE))
+
+# .auxファイル
+AUXFILE = $(addsuffix .aux,$(BASE))
+# .aux_prevファイル
+AUXFILE_PREV = $(addsuffix .aux_prev,$(BASE))
+
+# .dviファイル
+DVIFILE = $(addsuffix .dvi,$(BASE))
+
+# .dファイル
+DFILE = $(addsuffix .d,$(BASE))
+
+# .logファイル
+LOGFILE = $(addsuffix .log,$(BASE))
+
+# .tocファイル
+TOCFILE = $(addsuffix .toc,$(BASE))
+# .toc_prevファイル。.tocファイルのコピー
+TOCFILE_PREV = $(addsuffix .toc_prev,$(BASE))
+
+# .lofファイル
+LOFFILE = $(addsuffix .lof,$(BASE))
+# .lof_prevファイル。.lofファイルのコピー
+LOFFILE_PREV = $(addsuffix .lof_prev,$(BASE))
+
+# .lotファイル
+LOTFILE = $(addsuffix .lot,$(BASE))
+# .lot_prevファイル。.lotファイルのコピー
+LOTFILE_PREV = $(addsuffix .lot_prev,$(BASE))
+
+# .idxファイル
+IDXFILE = $(addsuffix .idx,$(BASE))
+# .idx_prevファイル。.idxファイルのコピー
+IDXFILE_PREV = $(addsuffix .idx_prev,$(BASE))
+
+# .indファイル
+INDFILE = $(addsuffix .ind,$(BASE))
+# .ind_prevファイル。.indファイルのコピー
+INDFILE_PREV = $(addsuffix .ind_prev,$(BASE))
+
+# .ilgファイル
+ILGFILE = $(addsuffix .ilg,$(BASE))
+
+# .bblファイル
+BBLFILE = $(addsuffix .bbl,$(BASE))
+# .bbl_prevファイル。.bblファイルのコピー
+BBLFILE_PREV = $(addsuffix .bbl_prev,$(BASE))
+
+# .blgファイル
+BLGFILE = $(addsuffix .blg,$(BASE))
+
+# .outファイル
+OUTFILE = $(addsuffix .out,$(BASE))
+# .out_prevファイル。.outファイルのコピー
+OUTFILE_PREV = $(addsuffix .out_prev,$(BASE))
+
+INTERFILES = $(strip \
+                $(if $(toc),$(TOCFILE)) \
+                $(if $(lof),$(LOFFILE)) \
+                $(if $(lot),$(LOTFILE)) \
+                $(if $(makeindex),$(INDFILE)) \
+                $(if $(bibdb),$(BBLFILE)) \
+                $(if $(hyperref),$(OUTFILE)) \
+              )
+
+INTERFILES_PREV = $(addsuffix _prev,$(INTERFILES))
+
 #LaTeXオプション
-BIBTEXFLAG ?=
+LATEXFLAG ?=
 DVIPDFMXFLAG ?=
 EXTRACTBBFLAGS ?=
-LATEXFLAG ?=
+BIBTEXFLAG ?=
 MENDEXFLAG ?=
 
-# LaTeXで処理
-COMPILE.tex = $(LATEX) -interaction=batchmode $(LATEXFLAG) $(addsuffix .tex,$(basename $<))
+# LaTeX処理(コンパイル)
+LATEXCMD = $(LATEX) -interaction=batchmode $(LATEXFLAG) $(TEXFILE)
+COMPILE.tex = $(ECHO) $(LATEXCMD); $(LATEXCMD) >/dev/null 2>&1 || ($(CAT) $(LOGFILE); exit 1)
+
+# 索引中間ファイル(.ind)作成
+MENDEXCMD = $(MENDEX) $(MENDEXFLAG) $(IDXFILE)
+COMPILE.idx = $(ECHO) $(MENDEXCMD); $(MENDEXCMD) >/dev/null 2>&1 || ($(CAT) $(ILGFILE); exit 1)
+
+# 文献リスト中間ファイル(.bbl)作成
+BIBTEXCMD = $(BIBTEX) $(BIBTEXFLAG) $(AUXFILE)
+COMPILE.bib = $(ECHO) $(BIBTEXCMD); $(BIBTEXCMD) >/dev/null 2>&1 || ($(CAT) $(BLGFILE); exit 1)
+
+# 相互参照未定義の警告
+WARN_UNDEFREF := 'There were undefined references\.'
+# 読み込むべき中間ファイルがないことの警告
+WARN_NOFILE = 'No file $(BASE)\.[a-zA-Z0-9]*\.'
+
+# LaTeX処理
+# ログファイルに警告がある場合、警告がなくなるまで最大4回処理する
+COMPILES.tex = \
+  @(for f in 1st 2nd 3rd final; do \
+      if test -s $@ -a -s $(LOGFILE); then \
+        $(GREP) -e $(WARN_UNDEFREF) $(LOGFILE) || exit 0; \
+      fi; \
+      $(COMPILE.tex); \
+    done)
 
-# logファイルに未定義参照の警告があるか確認
-REFWARN := 'LaTeX Warning: There were undefined references.'
+# ターゲットファイルと必須ファイルを比較し、内容が異なる場合はターゲットファイルの内容を必須ファイルに置き換える
+CMPPREV = $(CMP) $@ $< || $(CP) -v -p $< $@
 
-# \includeã\82³ã\83\9eã\83³ã\83\89で読み込まれるtexファイル
+# \includeã\80\81\inputå\91½ä»¤で読み込まれるtexファイル
 intex = $(addsuffix .tex,$(basename $(strip $(shell \
-  $(SED) -n -e 's/\\\(include\|input\)\(\[[^]]*\]\)\{0,1\}{[^}]*}/&\n/gp' $<  | \
+  $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\\(include\|input\)/!s/\\\(include\|input\)\(\[[^]]*\]\)\{0,1\}{[^}]*}/&\n/p' $< | \
   $(SED) -e 's/.*{\([^}]*\)}.*/\1/'))))
 
-# \includegraphicsコマンドで読み込まれるグラフィックファイル
+# \includegraphics命令で読み込まれるグラフィックファイル
 ingraphics = $(strip $(shell \
-  $(SED) -n -e 's/\\includegraphics\(\[[^]]*\]\)\{0,1\}\({[^}]*}\)/&\n/gp' $< $(intex) | \
+  $(SED) -n -e '/^.*[^\]\{0,1\}%.*\\includegraphics/!s/\\includegraphics\(\[[^]]*\]\)\{0,1\}\({[^}]*}\)/&\n/p' $< $(intex) | \
   $(SED) -e 's/.*{\([^}]*\)}.*/\1/'))
 
-# \bibliographyコマンドで読み込まれる文献データベースファイル
-bibdb = $(addsuffix .bib,$(basename $(strip $(shell \
-  $(SED) -n -e 's/\\bibliography\(\[[^]]*\]\)\{0,1\}{\([^}]*\)}/&\n/gp' $< $(intex) | \
-  $(SED) -e 's/.*{\([^}]*\)}.*/\1/' | \
-  $(SED) -e 's/,/ /g'))))
-
-# texファイルに索引作成の指定があるか確認
-MAKEINDEX := '\makeindex'
-GREP-makeindex = $(GREP) -F $(MAKEINDEX) $<
-
-# 依存関係を自動生成し、dファイルに格納
+# 依存関係を.dファイルに書き出す
 %.d: %.tex
        @$(ECHO) '$@ is created by scanning $^.'
-  # texファイルの依存関係
-       @($(ECHO) '$(subst .tex,.dvi,$<) $(subst .tex,.aux,$<) $(subst .tex,.d,$<): $<' >$@)
-  # Include/Inputファイルの依存関係
-       $(if $(intex),@( \
-      $(ECHO); \
-      $(ECHO) '# Include/Input Files - tex'; \
-      $(ECHO) '$(subst .tex,.dvi,$<) $(subst .tex,.aux,$<): $(intex)') >>$@)
-  # 画像ファイルの依存関係
+# TeX、.aux、.dvi、.dファイルの依存関係
+       @$(ECHO) '$(DFILE): $(TEXFILE)' >$@
+       $(if $(INTERFILES),@( \
+        $(ECHO); \
+        $(ECHO) '$(DVIFILE): $(TEXFILE)'; \
+        $(ECHO) '      @$$(MAKE) -s $(INTERFILES_PREV)'; \
+        $(ECHO) '      @$$(COMPILE.tex)'; \
+        $(ECHO) '      @$$(COMPILES.tex)'; \
+    )  >>$@)
+# 画像ファイルの依存関係
        $(if $(ingraphics),@( \
-      $(ECHO); \
-      $(ECHO) '# IncludeGraphic Files - pdf, jpeg/jpg, png & xbb'; \
-      $(ECHO) '$(subst .tex,.dvi,$<) $(subst .tex,.aux,$<): $(ingraphics)'; \
-      $(ECHO); \
-      $(ECHO) '$(subst .tex,.dvi,$<) $(subst .tex,.aux,$<): $(addsuffix .xbb,$(basename $(ingraphics)))') >>$@)
-  # 文献処理用ファイルの依存関係
+        $(ECHO); \
+        $(ECHO) '# IncludeGraphic Files - .pdf, .jpeg/.jpg, .png with .xbb'; \
+        $(ECHO) '$(DVIFILE) $(AUXFILE) $(INTERFILES): $(ingraphics)'; \
+        $(ECHO); \
+        $(ECHO) '$(strip $(DVIFILE) $(AUXFILE) $(INTERFILES)): $(addsuffix .xbb,$(basename $(filter-out %.eps,$(ingraphics))))'; \
+    ) >>$@)
+# \includeまたは\input命令で読み込まれるTeXファイルの依存関係
+       $(if $(intex),@( \
+        $(ECHO); \
+        $(ECHO) '# Files called from \include or \input - .tex'; \
+        $(ECHO) '$(strip $(DVIFILE) $(AUXFILE) $(INTERFILES)): $(intex)'; \
+    ) >>$@)
+# 文献処理用ファイルの依存関係
        $(if $(bibdb),@( \
-      $(ECHO); \
-      $(ECHO) '# Bibliography Files - bbl & bib'; \
-      $(ECHO) '$(subst .tex,.dvi,$<): $(subst .tex,.bbl,$<)'; \
-      $(ECHO); \
-      $(ECHO) '$(subst .tex,.bbl,$<): $(bibdb)') >>$@)
-  # 索引作成用ファイルの依存関係
-       $(if $(strip $(shell $(GREP-makeindex))),@( \
-      $(ECHO); \
-      $(ECHO) '# MakeIndex Files - ind'; \
-      $(ECHO) '$(subst .tex,.dvi,$<): $(subst .tex,.ind,$<)') >>$@)
-
-# 変数TARGETSで指定されたターゲットファイルに対応するdファイルをインクルード
-# .dファイルからヘッダファイルの依存関係を取得する
-# ターゲットに clean が含まれている場合は除く
-ifeq (,$(filter %clean,$(MAKECMDGOALS)))
-  -include $(addsuffix .d,$(basename $(TARGETS)))
+        $(ECHO); \
+        $(ECHO) '# Bibliography files: .aux, BIBDB -> .bbl -> .div'; \
+        $(ECHO) '$(BBLFILE): $(bibdb) $(AUXFILE)'; \
+        $(ECHO); \
+        $(ECHO) '$(BBLFILE_PREV): $(BBLFILE)'; \
+    ) >>$@)
+
+# 変数TEXTARGETSで指定されたターゲットファイルに対応する
+# .dファイルをインクルードし、依存関係を取得する
+# ターゲットに %clean、%.xbb、%.d が含まれている場合は除く
+ifeq (,$(filter %clean %.xbb %.tex %.d,$(MAKECMDGOALS)))
+  -include $(addsuffix .d,$(basename $(TEXTARGETS)))
 endif
 
-# 相互参照ファイル作成。dviファイルも同時に作成される
+# auxファイル作成
 %.aux: %.tex
-       $(COMPILE.tex)
+       @$(COMPILE.tex)
+
+%.dvi: %.tex
+       @$(COMPILE.tex)
+       @$(COMPILES.tex)
 
-# dviファイル作成
 %.dvi: %.aux
-  # logファイルに未定義参照の警告がある場合、LaTeXで処理
-       while $(GREP) -F $(REFWARN) $(addsuffix .log,$(basename $<)); do $(COMPILE.tex); done
+       $(if $(filter-out aux,$(NOFILES)),@$(COMPILE.tex))
+       @$(COMPILES.tex)
 
-# 文献処理用ファイル作成
-# BiBTeXで文献処理するときに使用される
-%.bbl: %.aux
-       $(BIBTEX) $(BIBTEXFLAG) $(addsuffix .aux,$(basename $<))
+# aux_prevファイル作成
+%.aux_prev: %.aux
+       @$(CMPPREV)
+
+# PDFファイル作成
+%.pdf: %.dvi
+       $(DVIPDFMX) $(DVIPDFMXFLAG) $<
 
 # バウンディング情報ファイル作成
-# dvipdfmxで図を挿入するときに使用される
 # pdf、jpeg/jpg、pngファイルに対応
 %.xbb: %.pdf
        $(EXTRACTBB) $(EXTRACTBBFLAGS) $<
@@ -111,21 +286,72 @@ endif
 %.xbb: %.png
        $(EXTRACTBB) $(EXTRACTBBFLAGS) $<
 
-# ç´¢å¼\95ファイル作成
-# 索引を作成するときに使用される
-%.idx: %.aux
+# ç\9b®æ¬¡ä¸­é\96\93ファイル作成
+%.toc: %.tex
+       @$(COMPILE.tex)
 
-%.ind: %.idx
-       $(MENDEX) $(MENDEXFLAG) $<
+%.toc_prev: %.toc
+       @$(CMPPREV)
 
-# PDFファイル作成
-%.pdf: %.dvi
-       $(DVIPDFMX) $(DVIPDFMXFLAG) $<
+# 図リスト中間ファイル作成
+%.lof: %.tex
+       @$(COMPILE.tex)
+
+%.lof_prev: %.lof
+       @$(CMPPREV)
+
+# 表リスト中間ファイル作成
+%.lot: %.tex
+       @$(COMPILE.tex)
+
+%.lot_prev: %.lot
+       @$(CMPPREV)
+
+# 索引中間ファイル作成
+%.idx: %.tex
+       @$(COMPILE.tex)
+
+%.idx_prev: %.idx
+       @$(CMPPREV)
+
+%.ind: %.idx_prev
+       @$(COMPILE.idx)
+
+%.ind_prev: %.ind
+       @$(CMPPREV)
+
+# BiBTeX中間ファイル作成
+%.bbl: %.tex
+       @$(COMPILE.bib)
+
+%.bbl_prev: %.bbl
+       @$(CMPPREV)
+
+# hyperref中間ファイル作成
+%.out: %.tex
+       @$(COMPILE.tex)
+
+%.out_prev: %.out
+       @$(CMPPREV)
 
 # tex-cleanターゲット
 tex-clean:
-       $(RM) *.aux *.bbl *.blg *.d *.idx *.ilg *.ind *.lof *.log *.lot *.out *.toc *.xbb
+       $(RM) $(addprefix *, \
+      $(TEX_INT) $(IND_INT) $(BIB_INT) .d \
+      .aux_prev .toc_prev .lof_prev .lot_prev \
+      .idx_prev .ind_prev .bbl_prev .out_prev \
+    )
+ifeq (,$(filter %.dvi,$(TEXTARGETS)))
+       $(RM) *.dvi
+endif
+
+# xbb-cleanターゲット
+xbb-clean:
+       $(RM) *.xbb
 
 # tex-distcleanターゲット
-tex-distclean: tex-clean
-       $(RM) $(addsuffix .dvi,$(basename $(TARGETS))) $(addsuffix .pdf,$(basename $(TARGETS)))
+tex-distclean: tex-clean xbb-clean
+ifneq (,$(filter %.dvi,$(TEXTARGETS)))
+       $(RM) *.dvi
+endif
+       $(RM) $(TEXTARGETS)