Makefile

# =============================================================================
# dls-tutorial Makefile
# - Builds the PDF from LaTeX sources and generated figures
# - Convenience targets for preview/help/clean
# =============================================================================

# Default target
.DEFAULT_GOAL := all

.PHONY: all
all: pdf ## Build all documentation

.PHONY: help
help: ## Show this help
	@awk 'BEGIN {FS = ":.*##"; printf "\nAvailable targets:\n\n"} \
        /^[a-zA-Z_-]+:.*##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 }' \
        $(MAKEFILE_LIST)


.PHONY: pdf
pdf: dls-tutorial.pdf ## Build pdf

dls-tutorial.pdf: main.ps
	ps2pdf $< $@

main.ps : main.dvi
	dvips $< -o $@


LATEX_CMD ?= latex -halt-on-error -interaction=nonstopmode
main.dvi: genpicts document_version.tex
# Compile three times to resolve longtable layout
	$(LATEX_CMD) main.tex
	$(LATEX_CMD) main.tex
	$(LATEX_CMD) main.tex


.PHONY: genpicts
genpicts:
	mkdir -p genpicts
	\cp -f picts/*.eps genpicts/
	for f in  picts/*.png ; do convert $$f  genpicts/`basename $$f .png`.eps ; done



# Get date of the last commit
COMMIT_LAST_DATE  := $(shell git log --max-count=1 --format=%cd --date=format:'%B %d, %Y' ./ )

.PHONY: document_version.tex
document_version.tex:
	echo "% AUTOMATICALLY GENERATED FILE - DO NOT EDIT" > $@
	echo '\\newcommand{\\builddate}{'"${COMMIT_LAST_DATE}"'}' >> $@




.PHONY: check-tools
check-tools: ## Verify required build tools are installed
	@set -e; \
	for tool in latex dvips ps2pdf convert; do \
		command -v $$tool >/dev/null 2>&1 || { echo "Missing tool: $$tool"; exit 1; }; \
	done; \
	echo "All required tools are available."



# cleaning

.PHONY: clean
clean: ## Clean temporary LaTeX files
	rm -f *.aux *.log *.out *.olg *.ind *.dvi *.idx *.toc *~
	rm -fr genpicts

.PHONY: distclean
distclean: clean ## Remove generated outputs
	rm -f *.pdf *.ps