Validate Bibliography

Cross-reference all citations in lecture files against bibliography entries.

Steps

1. Read the bibliography file and extract all citation keys

2. Scan all deck files for citation keys:

   • .qmd files: look for @key, [@key], [@key1; @key2]
   • Extract all unique citation keys used

3. Cross-reference:

   • Missing entries: Citations used in lectures but NOT in bibliography
   • Unused entries: Entries in bibliography not cited anywhere
   • Potential typos: Similar-but-not-matching keys

4. Check entry quality for each bib entry:

   • Required fields present (author, title, year, journal/booktitle)
   • Author field properly formatted
   • Year is reasonable
   • No malformed characters or encoding issues

5. Report findings:

   • List of missing bibliography entries (CRITICAL)
   • List of unused entries (informational)
   • List of potential typos in citation keys
   • List of quality issues

Files to scan:

Quarto/*/*.qmd                    # decks are one level down, under their genre
Quarto/lectures/_series/*/*.qmd   # shared include slides, rendered into series decks

(python3 scripts/deckpath.py --list names every deck.)

Bibliography location:

Bibliography_base.bib  (repo root)