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>

.gitignore

@@ -26,3 +26,4 @@ Thumbs.db
 
 # Claude
 .claude/
+__pycache__/

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,14 +11,26 @@ 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): $(ENGINE) $(FLAGS) $(MAIN).tex
-	TEXINPUTS=.:$(shell pwd): $(ENGINE) $(FLAGS) $(MAIN).tex
+	@for i in 1 2 3 4 5; do \
+	  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 \
 	      $(OUTDIR)/*.toc $(OUTDIR)/*.fls $(OUTDIR)/*.fdb_latexmk \
-	      $(OUTDIR)/*.sxd $(OUTDIR)/*.sxc
+	      $(OUTDIR)/*.sxd $(OUTDIR)/*.sxc $(OUTDIR)/*.songtoc
 
 distclean: clean
 	rm -f $(OUTDIR)/$(MAIN).pdf

all-songs.tex

@@ -0,0 +1,298 @@
+% Auto-generated list of all songs (alphabetical order)
+% Generated by import-songs.py
+
+\input{songs/abends-gehn-die-liebespaare}
+\input{songs/abends-treten-elche}
+\input{songs/abends-wenn-das-tageslicht}
+\input{songs/ade-nun-zur-guten-nacht}
+\input{songs/alle-strassen}
+\input{songs/alle-die-mit-uns-auf-kaperfahrt}
+\input{songs/allzeit-bereit-bundeslied-der-cpd}
+\input{songs/almost-heaven}
+\input{songs/als-wir-nach-frankreich}
+\input{songs/als-wir-noch-knaben-waren}
+\input{songs/am-alten-hafen-piratenhafen}
+\input{songs/am-brunnen-vor-dem-tore}
+\input{songs/am-ural}
+\input{songs/am-westermanns-loenstief}
+\input{songs/an-de-eck}
+\input{songs/an-land}
+\input{songs/andre-die-das-land}
+\input{songs/auf-vielen-strassen}
+\input{songs/balkanlied}
+\input{songs/ballade-von-bergen}
+\input{songs/ballade-von-der-gemeinsamen-zeit-vorspiel-d-a-d-g}
+\input{songs/banner}
+\input{songs/bella-ciao}
+\input{songs/big-bomb-dolly-aus-dover}
+\input{songs/bin-ja-nur-ein-armer-zigeuner}
+\input{songs/birkenring}
+\input{songs/bis-in-die-roten-morgenstunden}
+\input{songs/brennt-die-sonne}
+\input{songs/bruder-nun-wird-es-abend}
+\input{songs/burschen-burschen}
+\input{songs/buendische-vaganten}
+\input{songs/buergerlied}
+\input{songs/come-by-the-hills}
+\input{songs/das-gotenlied}
+\input{songs/das-leben}
+\input{songs/das-lilienbanner}
+\input{songs/das-schiff-im-nebel}
+\input{songs/dat-du-min-leewsten-buest}
+\input{songs/dein-ist-dein-leben-vorspiel-e-c-g-d}
+\input{songs/der-da-vorn-so-laut}
+\input{songs/der-geist-der-fahrt}
+\input{songs/der-geist-ist-mued}
+\input{songs/der-holzschuhmann}
+\input{songs/der-kirchenmausrock}
+\input{songs/der-kleine-troll}
+\input{songs/der-lang-genug}
+\input{songs/der-mond-ist-aufgegangen}
+\input{songs/der-papagei-ein-vogel-ist}
+\input{songs/der-pfahl}
+\input{songs/der-rabe}
+\input{songs/der-tag-begann}
+\input{songs/der-tod-reit-auf}
+\input{songs/der-wagen}
+\input{songs/der-zug-faehrt-auf}
+\input{songs/die-affen-rasen}
+\input{songs/die-ballade-vom-roten-haar}
+\input{songs/die-blauen-dragoner}
+\input{songs/die-daemmerung-faellt}
+\input{songs/die-eisenfaust}
+\input{songs/die-freie-republik}
+\input{songs/die-gedanken}
+\input{songs/die-glocken}
+\input{songs/die-grauen-nebel}
+\input{songs/die-herren-waren-bei-laune}
+\input{songs/die-klampfen-erklingen}
+\input{songs/die-lappen-hoch}
+\input{songs/die-mazurka}
+\input{songs/die-nacht-ist-nicht-allein-zum-schlafen-da}
+\input{songs/die-roten-fahnen}
+\input{songs/die-sandbank}
+\input{songs/die-schluchten-des-balkan}
+\input{songs/die-sonne-geht}
+\input{songs/die-strasse-gleitet}
+\input{songs/die-trommel-her}
+\input{songs/die-weber}
+\input{songs/die-zunft-der-strassenbrueder}
+\input{songs/dort-an-dem-ueferchen}
+\input{songs/drei-rote-pfiffe}
+\input{songs/drei-tropfen-blut-chume-geselle}
+\input{songs/du-machst-kleinholz}
+\input{songs/durch-die-morgenroten-scheiben}
+\input{songs/daemmert-von-fern}
+\input{songs/edelweisspiraten}
+\input{songs/eh-die-sonne}
+\input{songs/ein-hase-sass-im-tiefen-tal}
+\input{songs/ein-hotdog-unten-am-hafen}
+\input{songs/ein-kleiner-matrose}
+\input{songs/ein-landsknecht}
+\input{songs/ein-neuer-tag-beginnt}
+\input{songs/ein-stolzes-schiff}
+\input{songs/eines-morgens-partisanenlied}
+\input{songs/eines-morgens-ging}
+\input{songs/einst-macht-ich}
+\input{songs/endlich-trocknet-der-landstrasse}
+\input{songs/endlos-lang}
+\input{songs/endlos-sind-jene-strassen}
+\input{songs/ensemble-on-est-mieux-intro-e-a-c-h7}
+\input{songs/erklingen-leise-lieder}
+\input{songs/es-dunkelt-schon}
+\input{songs/es-gibt-nur-wasser}
+\input{songs/es-ist-an-der-zeit}
+\input{songs/es-ist-ein-schnitter}
+\input{songs/es-liegen-drei-glaenzende-kugeln}
+\input{songs/es-liegt-etwas-auf-den-strassen}
+\input{songs/es-soll-sich-der-mensch}
+\input{songs/es-tropft-von-helm-und-saebel}
+\input{songs/es-war-an-einem-sommertag}
+\input{songs/es-war-ein-koenig}
+\input{songs/es-war-in-einer-regennacht}
+\input{songs/es-wollt-ein-maegdlein}
+\input{songs/falado}
+\input{songs/fields-of-athenry}
+\input{songs/finnlandlied}
+\input{songs/fordre-niemand}
+\input{songs/fresenhof}
+\input{songs/freunde-das-leben-seid-ihr}
+\input{songs/frueher-da-war-ich}
+\input{songs/fruehling-dringt-in-den-norden}
+\input{songs/geburtstagslied}
+\input{songs/gehe-nicht-o-gregor}
+\input{songs/gelbe-blaetter-fallen-im-wind}
+\input{songs/gestern-brueder}
+\input{songs/gospodar-dein-grossgut}
+\input{songs/griechischer-fruehling}
+\input{songs/grosser-gott-wir-loben-dich}
+\input{songs/graefin-anne}
+\input{songs/gut-wieder-hier-zu-sein}
+\input{songs/gute-nacht-kameraden}
+\input{songs/hans-spielmann}
+\input{songs/hell-strahlt-die-sonne}
+\input{songs/heulender-motor}
+\input{songs/heute-hier}
+\input{songs/hier-waechst-kein-ahorn}
+\input{songs/hoch-lebe-der-mann-mit-dem-hut}
+\input{songs/hochzeit}
+\input{songs/hohe-tannen}
+\input{songs/how-many-roads-blowin-in-the-wind}
+\input{songs/hymn-intro-e-esus4-e-esus4-e}
+\input{songs/hoerst-du-den-wind-bundeslied-der-esm}
+\input{songs/ich-kann-dich-sehen}
+\input{songs/ich-komme-schon}
+\input{songs/ich-komme-dir-zu-sagen-versprechenslied}
+\input{songs/ich-moecht-mit-einem-zirkus-ziehn}
+\input{songs/ich-reise-uebers-gruene-land}
+\input{songs/ich-und-ein-fass-voller-wein}
+\input{songs/ich-war-noch-so-jung-bettelvogt}
+\input{songs/ihr-huebschen-jungen-reiter}
+\input{songs/ihr-woelfe-kommt-und-schliesst-den-kreis}
+\input{songs/im-morgennebel}
+\input{songs/in-dem-dunklem-wald-von-paganovo}
+\input{songs/in-des-waldes-lola}
+\input{songs/in-die-sonne}
+\input{songs/in-junkers-kneipe}
+\input{songs/islandlied}
+\input{songs/jalava-lied}
+\input{songs/jasmin}
+\input{songs/jauchzende-jungen}
+\input{songs/jeden-abend-jerchenkow}
+\input{songs/jenseits-des-tales}
+\input{songs/jubilaeumslied-der-esm}
+\input{songs/joerg-von-frundsberg}
+\input{songs/kaffee-und-karin}
+\input{songs/kameraden-jagt-die-pferde}
+\input{songs/kameraden-wann-sehen-wir-uns-wieder}
+\input{songs/karl-der-kaefer}
+\input{songs/kein-schoener-land}
+\input{songs/klingt-ein-lied-durch-die-nacht-piratenlied}
+\input{songs/kommt-ihr-menschen}
+\input{songs/komodowaran-intro-ad7g-ad7g}
+\input{songs/land-der-dunklen-waelder}
+\input{songs/lasst-die-banner}
+\input{songs/leave-her-johnny}
+\input{songs/leut-die-leut}
+\input{songs/lord-of-the-dance}
+\input{songs/laender-fahrten-abenteuer}
+\input{songs/loewen-sind-jetzt-los}
+\input{songs/man-sagt}
+\input{songs/meersalz-seht}
+\input{songs/mein-ganzes-leben}
+\input{songs/mein-kleines-boot}
+\input{songs/meine-sonne-will-ich-fragen}
+\input{songs/michel-warum-weinest-du}
+\input{songs/miners-song}
+\input{songs/molly-malone}
+\input{songs/moorsoldaten}
+\input{songs/maedchen-maenner-meister}
+\input{songs/nacht-in-portugal}
+\input{songs/nachts-auf-dem-dorfplatz}
+\input{songs/nachts-steht-hunger}
+\input{songs/nehmt-abschied-brueder}
+\input{songs/nicht-nur-nebenbei}
+\input{songs/nichts-fuer-suesse-ziehharmonika}
+\input{songs/noch-lange-sassen-wir}
+\input{songs/nordwaerts}
+\input{songs/nun-greift-in-die-saiten}
+\input{songs/nun-lustig-lustig}
+\input{songs/oh-fischer}
+\input{songs/oh-bootsmann}
+\input{songs/originale-3-strophe}
+\input{songs/panama}
+\input{songs/papst-sultan}
+\input{songs/platoff}
+\input{songs/refrain-2x}
+\input{songs/rote-ritterscharen}
+\input{songs/roter-mond}
+\input{songs/roter-wein-im-becher}
+\input{songs/santiano}
+\input{songs/santiano-2}
+\input{songs/scarborough-fair}
+\input{songs/schilf-bleicht}
+\input{songs/schlaf-mein-bub}
+\input{songs/schliess-aug-und-ohr}
+\input{songs/sei-der-abend}
+\input{songs/she-hangs-her-head-sad-lisa}
+\input{songs/siehst-du-die-feuer}
+\input{songs/singt-freunde-lasst-die-klampfen}
+\input{songs/so-trolln-wir-uns}
+\input{songs/sonnenschein-und-wilde-feste}
+\input{songs/star-of-county-down}
+\input{songs/stiebt-vom-kasbek}
+\input{songs/stille-tage}
+\input{songs/strassen-auf-und-strassen-ab}
+\input{songs/sturm-bricht-los}
+\input{songs/sturm-und-drang}
+\input{songs/tief-im-busch}
+\input{songs/trinklied-vor-dem-abgang}
+\input{songs/trommeln-und-pfeifen}
+\input{songs/turm-um-uns}
+\input{songs/ty-morjak-deutscher-text}
+\input{songs/und-am-abend}
+\input{songs/und-der-herbst}
+\input{songs/und-die-morgenfruehe}
+\input{songs/unglueck-vor-mir}
+\input{songs/unser-stammesbus}
+\input{songs/unter-den-toren}
+\input{songs/vagabundenlied}
+\input{songs/verliebt-in-du-intro-c-g-a-a-2x}
+\input{songs/viva-la-feria}
+\input{songs/vom-barette}
+\input{songs/von-allen-blauen-huegeln}
+\input{songs/von-der-festung-droehnt}
+\input{songs/von-ueberall}
+\input{songs/wach-nun-auf}
+\input{songs/was-gehn-euch-meine}
+\input{songs/was-helfen-mir-tausend-dukaten}
+\input{songs/was-kann-ich-denn-dafuer}
+\input{songs/was-keiner-wagt}
+\input{songs/was-sollen-wir-trinken}
+\input{songs/weisser-sand}
+\input{songs/welle-wogte}
+\input{songs/wem-gott-will-rechte-gunst-erweisen}
+\input{songs/wenn-alle-bruennlein}
+\input{songs/wenn-der-abend-naht}
+\input{songs/wenn-der-fruehling-kommt}
+\input{songs/wenn-die-bunten-fahnen}
+\input{songs/wenn-die-zeit}
+\input{songs/wenn-hell-die-goldne-sonne}
+\input{songs/wenn-ich-des-morgens}
+\input{songs/weronika-mit-w}
+\input{songs/what-shall-we-do-drunken-sailor}
+\input{songs/whats-right-ye-jacobites}
+\input{songs/whiskey-in-the-jar}
+\input{songs/wie-ein-fest-nach-langer-trauer}
+\input{songs/wie-kommts-dass-du}
+\input{songs/wie-schoen-blueht}
+\input{songs/wild-rover}
+\input{songs/wilde-gesellen}
+\input{songs/wilde-reiter}
+\input{songs/wildgaense}
+\input{songs/wir-drei-wir-gehn-jetzt}
+\input{songs/wir-fahren-uebers-weite-meer}
+\input{songs/wir-haben-das-sehen}
+\input{songs/wir-kamen-einst}
+\input{songs/wir-lagen-vor-madagaskar}
+\input{songs/wir-lieben-die-stuerme}
+\input{songs/wir-rufen-zu-dir-michaelslied}
+\input{songs/wir-sassen-in-johnnys-spelunke}
+\input{songs/wir-sind-des-geyers}
+\input{songs/wir-sind-durch-deutschland-gefahren}
+\input{songs/wir-sind-eine-kleine}
+\input{songs/wir-sind-kameraden}
+\input{songs/wir-sind-wieder-da-st-goar-hymne}
+\input{songs/wir-sitzen-im-rostigen-haifsch}
+\input{songs/wir-sitzen-zu-pferde}
+\input{songs/wir-wollen-zu-land-ausfahren}
+\input{songs/wir-wolln-im-gruenen-wald}
+\input{songs/wo-schorle-der-apfelschorlen-blues}
+\input{songs/wohl-ueber-erde}
+\input{songs/wohlauf-die-luft}
+\input{songs/wollt-ihr-hoeren}
+\input{songs/wos-nur-felsen}
+\input{songs/zieh-meiner-strasse}
+\input{songs/zogen-einst}
+\input{songs/zogen-viele-strassen}
+\input{songs/ueber-meiner-heimat}