photobook/Makefile

103 lines
2.3 KiB
Makefile
Raw Normal View History

#----------------------------------------------------------------------
ARGS :=
#TEX := lualatex $(ARGS)
TEX := latexmk -lualatex $(ARGS)
#----------------------------------------------------------------------
# Generate docs from latex package/class...
#
# - keep lines starting with \def\<module-name>@[A-Z]\+
# - keep lines starting with '%%'
# - %%%%% Text -> \subsection(Text)
# - %%%% Text -> \section(Text)
# - %% >> code -> \begin{verbatim}code\end{verbatim}
#
# NOTE: the idea of keeping latex docs in a latex file is far similar
# than all the stuff crammed into .dtx, at least for my needs:
# - keep the code readable
# - keep the docs readable
# in both the repo and in installed form.
# NOTE: this is evolving as need arises, when this gets too complicated
# we'll split it out into it's own script.
texToDoc = \
@echo "texToDoc: $1 -> $2"; \
cat $1 \
| egrep '(^%$3|^\\\\edef\\\\$*@[A-Z][A-Z]+)' \
| sed 's/^\(\\\\edef\\\\\)$*@/%$3\\1/'\
| sed 's/%$3%%%% \(.*\)/%$3\\\\subsubsection{\1}/' \
| sed 's/%$3%%% \(.*\)/%$3\\\\subsection{\1}/' \
| sed 's/%$3%% \(.*\)/%$3\\\\section{\1}/' \
| sed 's/%$3\s\+>>\s\+\(.*\)/%$3\\\\begin{verbatim} \1 \\\\end{verbatim}/' \
| cut -c 3- - > $2
#----------------------------------------------------------------------
%.pdf: %.tex
$(TEX) $< > /dev/null
# NOTE: .sty and .cls are essentially the same in terms of documentation
# generation...
%.tex: %.sty %-meta.tex
$(call texToDoc,$<,$@,%)
%.tex: %.cls %-meta.tex
$(call texToDoc,$<,$@,%)
# NOTE: this is a bit ugly, but allot less so than trying to push \verb
# into a LaTeX macro/env and then getting it out again in one pice...
%-meta.tex: %.sty
$(call texToDoc,$<,$@,M)
%-meta.tex: %.cls
$(call texToDoc,$<,$@,M)
#----------------------------------------------------------------------
.PHONY: doc
doc: photobook.pdf
.PHONY: all
all: doc sweep
# XXX
.PHONY: dist
dist: all
# XXX install... (see: ./tmp/Makefile)
# - local
# - root
.PHONY: install
install: dist
#----------------------------------------------------------------------
.PHONY: sweep
sweep:
rm -f *.{aux,fls,glo,gls,hd,idx,ilg,ind,ins,log,out,toc,fdb_latexmk}
.PHONY: clean
clean: sweep
rm -f *.pdf
#----------------------------------------------------------------------
# vim:set ts=4 sw=4 :