Sort TOC entries alphabetically including aliases

Add a Python sort step in the Makefile that sorts .songtoc by
the actual title text, stripping \textit{} wrappers so aliases
sort into their correct alphabetical position alongside main
titles.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Makefile

@@ -1,6 +1,7 @@
 MAIN     = songbook
 ENGINE   = lualatex
 OUTDIR   = output
+TEXENV   = TEXINPUTS=.:$(shell pwd):$(shell pwd)/$(OUTDIR):
 FLAGS    = --output-directory=$(OUTDIR) --interaction=nonstopmode
 
 .PHONY: all clean distclean
@@ -10,9 +11,21 @@ all: $(OUTDIR)/$(MAIN).pdf
 $(OUTDIR):
 	mkdir -p $(OUTDIR)
 
+# Run until page references stabilize (max 5 passes).
+# The .songtoc file needs: pass 1 to write, pass 2 to read into TOC,
+# pass 3+ to stabilize page numbers after TOC page count changes.
 $(OUTDIR)/$(MAIN).pdf: $(MAIN).tex songbook-style.sty songs/*.tex | $(OUTDIR)
-	TEXINPUTS=.:$(shell pwd):$(shell pwd)/$(OUTDIR): $(ENGINE) $(FLAGS) $(MAIN).tex
+	@for i in 1 2 3 4 5; do \
-	TEXINPUTS=.:$(shell pwd):$(shell pwd)/$(OUTDIR): $(ENGINE) $(FLAGS) $(MAIN).tex
+	  echo "=== LaTeX pass $$i ==="; \
+	  $(TEXENV) $(ENGINE) $(FLAGS) $(MAIN).tex || true; \
+	  if [ -f $(OUTDIR)/$(MAIN).songtoc ]; then \
+	    python3 -c "import re;lines=open('$(OUTDIR)/$(MAIN).songtoc').readlines();lines.sort(key=lambda l:re.sub(r'[^a-zäöüß ]','',re.search(r'\{(?:\\\\textit\s*\{)?([^}]+)',l).group(1).lower()) if re.search(r'\{(?:\\\\textit\s*\{)?([^}]+)',l) else '');open('$(OUTDIR)/$(MAIN).songtoc','w').writelines(lines)" ; \
+	  fi; \
+	  if [ $$i -ge 3 ] && ! grep -q "Rerun" $(OUTDIR)/$(MAIN).log 2>/dev/null; then \
+	    echo "=== Stable after $$i passes ==="; \
+	    break; \
+	  fi; \
+	done
 
 clean:
 	rm -f $(OUTDIR)/*.aux $(OUTDIR)/*.log $(OUTDIR)/*.out \