dotfiles/Makefile at main · codephilip/dotfiles · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# =========================================================
# Dotfiles
#
#   make install   symlink configs into place, report missing tools
#   make verify    dry-run of install; changes nothing
#   make tools     print the brew install lines for a new machine
#   make windows   install everything on Windows (scoop + MSYS2 zsh/tmux)
#   make serve     live-reload docs at http://127.0.0.1:8000
#   make docs      build the static site into ./site
#   make pdf       render the executive brief to PDF
#   make all       docs + pdf
# =========================================================

SHELL      := /bin/bash
BRIEF_SRC  := brief/executive-brief.html
BRIEF_PDF  := docs/assets/executive-brief.pdf
CHROME     := /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

.PHONY: all install verify tools windows serve docs pdf clean check help

help:
	@grep -E '^#   make' $(MAKEFILE_LIST) | sed 's/^#   //'

all: pdf docs

install:
	@./bootstrap

verify:
	@./bootstrap --check

# Prints the brew lines from bootstrap's own BREW_FORMULAE/BREW_CASKS,
# so there is nowhere for a second copy of the list to drift.
tools:
	@./bootstrap --tools

# bootstrap is Homebrew/macOS-only; this is the Windows equivalent.
windows:
	@./scripts/windows-setup

serve:
	mkdocs serve

docs: pdf
	mkdocs build --strict

# Chrome headless is the only PDF renderer on this machine. --no-pdf-header-footer
# drops the default URL/date chrome; the @media print block in the HTML handles
# page breaks and colour.
pdf: $(BRIEF_PDF)

$(BRIEF_PDF): $(BRIEF_SRC)
	@mkdir -p $(dir $@)
	@echo "→ rendering $< to $@"
	@"$(CHROME)" \
		--headless \
		--disable-gpu \
		--no-pdf-header-footer \
		--print-to-pdf-no-header \
		--print-to-pdf="$(CURDIR)/$@" \
		"file://$(CURDIR)/$<" 2>/dev/null || true
	@test -s $@ && echo "✓ $@ ($$(du -h $@ | cut -f1))" || (echo "✗ PDF render failed"; exit 1)

check:
	@command -v mkdocs >/dev/null || { echo "mkdocs missing: brew install mkdocs-material"; exit 1; }
	@test -x "$(CHROME)" || { echo "Google Chrome not found - needed for make pdf"; exit 1; }
	@echo "✓ toolchain ok"

clean:
	rm -rf site $(BRIEF_PDF)