noether
be9c92f6d2
Make targets now resolve a repo-local, gitignored .tools/bin (Hugo extended 0.167.0, Node 22.11.0, lychee 0.24.2) via a recipe-scoped PATH, so machines with old/missing tools can no longer produce error-127 mysteries or version drift. System PATH is never touched. make bootstrap one-time idempotent install (sha256-verified Hugo) make tool-versions pinned vs PATH-first diagnostic table make preflight strict check, wired ahead of build/serve/serve-lan
96 lines
3.8 KiB
Makefile
96 lines
3.8 KiB
Makefile
HUGO := hugo
|
|
PAGEFIND := npx -y pagefind
|
|
LYCHEE := lychee
|
|
OUT := public
|
|
|
|
# --- Pinned toolchain (repo-local .tools/; gitignored) ---
|
|
# `make bootstrap` installs these exact versions into .tools/bin. The PATH
|
|
# prepend below applies to every recipe, so make targets always use the pinned
|
|
# tools; your system PATH is never modified. `make tool-versions` shows both.
|
|
HUGO_VERSION := 0.167.0
|
|
NODE_VERSION := 22.11.0
|
|
LYCHEE_VERSION := 0.24.2
|
|
TOOLS_BIN := $(CURDIR)/.tools/bin
|
|
export PATH := $(TOOLS_BIN):$(PATH)
|
|
|
|
.PHONY: all build index serve run link-check link-fix external-check external-fix external-fix-apply serve-lan clean bootstrap tool-versions preflight
|
|
|
|
all: index
|
|
|
|
# ONE-TIME per machine: install the pinned hugo/node/lychee into .tools/bin.
|
|
# Idempotent (present-at-pin tools are skipped); touches nothing outside .tools/.
|
|
bootstrap:
|
|
scripts/bootstrap.sh
|
|
|
|
# Diagnostic: pinned (.tools/bin) vs PATH-first (system) tool versions.
|
|
tool-versions:
|
|
scripts/tool_versions.sh
|
|
|
|
# Strict tool check; runs automatically before all/serve/serve-lan and
|
|
# fails with a `make bootstrap` hint instead of a bare "error 127".
|
|
preflight:
|
|
scripts/tool_versions.sh --strict
|
|
|
|
# Build Hugo content -> public/ (preflight first so a missing tool fails fast
|
|
# and in order even under `make -j`).
|
|
build: preflight
|
|
$(HUGO) --gc
|
|
|
|
# (Re)build the Pagefind search index from public/ -> public/pagefind/
|
|
index: build
|
|
$(PAGEFIND) --site $(OUT)
|
|
|
|
# Build content + index, then serve the built site WITH search on :1414 (dev preview).
|
|
# Uses pagefind's own server. Local only (binds 127.0.0.1) -- for LAN use `make serve-lan`.
|
|
serve: index
|
|
$(PAGEFIND) --site $(OUT) --serve
|
|
|
|
run: serve
|
|
|
|
# DEAD LINKS -- internal (offline, fast): scan the SOURCE markdown; internal links
|
|
# resolve to file:// under public/. External links are skipped by --scheme file.
|
|
# Output: linkcheck/internal.json (exit != 0 when dead links exist; that is fine).
|
|
link-check: build
|
|
mkdir -p linkcheck
|
|
$(LYCHEE) --root-dir $(OUT) --default-extension html --scheme file \
|
|
--format json --timeout 10 \
|
|
$(wildcard content/*.md) $(wildcard content/*/*.md) > linkcheck/internal.json
|
|
|
|
# Comment out confirmed dead INTERNAL page links, then rebuild content + index so they
|
|
# leave the live page AND the search index. (External failures -> manual_review.txt.)
|
|
link-fix:
|
|
python3 scripts/fix_dead_links.py --report linkcheck/internal.json --apply
|
|
$(HUGO) --gc
|
|
$(PAGEFIND) --site $(OUT)
|
|
|
|
# DEAD LINKS -- external (network): scan all http/https links in content. Report-only.
|
|
# Always exits 0; the report is the point. Also saves the full lychee JSON to
|
|
# linkcheck/external.json so external-fix can act without re-pinging the web.
|
|
external-check:
|
|
python3 scripts/check_external_links.py
|
|
|
|
# Preview which EXTERNAL links are truly dead (domain/DNS no longer exists) and
|
|
# would be commented out. Reports only; changes nothing. Run external-check first.
|
|
external-fix:
|
|
python3 scripts/fix_dead_external_links.py --report linkcheck/external.json
|
|
|
|
# Comment out the truly-dead EXTERNAL links (DNS failed / host unreachable), then
|
|
# rebuild content + index so they leave the live page AND the search index.
|
|
# 404s, SSL errors, 5xx, redirects, refused/reset connections are NOT auto-commented
|
|
# (domain is still alive / ambiguous) -- they go to linkcheck/manual_review_external.txt.
|
|
external-fix-apply:
|
|
python3 scripts/fix_dead_external_links.py --report linkcheck/external.json --apply
|
|
$(HUGO) --gc
|
|
$(PAGEFIND) --site $(OUT)
|
|
|
|
# Serve the BUILT site on all interfaces so another LAN machine can open it:
|
|
# http://<this-machine-LAN-IP>:8090/ (IP printed at startup; also `hostname -I | head -1`)
|
|
serve-lan: preflight
|
|
python3 scripts/serve_lan.py
|
|
|
|
# NOTE: clean does NOT remove .tools/ -- the pinned toolchain is expensive to
|
|
# reinstall and independent of build output. Remove it manually if ever needed.
|
|
|
|
clean:
|
|
rm -rf $(OUT) linkcheck
|