brycewang-stanford Audit Citations and References
Cross-check all citation keys in the manuscript against references.bib and report mismatches.
Steps
Read
index.qmdand extract every citation key:- Narrative citations:
@key - Parenthetical citations:
[@key],[@key1; @key2] - Ignore email addresses and
@sec-,@fig-,@tbl-cross-references
- Narrative citations:
Read
references.biband extract every entry key (the identifier after@article{,@book{, etc.)Check for duplicate keys within
references.bib(same key defined more than once)Report three categories:
Errors — cited in manuscript but missing from
.bib:- List each missing key with the line number in
index.qmdwhere it appears - For each, suggest running
/project:cite <key>to add the entry
Orphaned — in
.bibbut never cited in manuscript:- List each unused key (informational, not necessarily a problem)
Duplicates — same key appears multiple times in
.bib:- List each duplicate with line numbers in
references.bib
- List each missing key with the line number in
Print a summary: total cited keys, total
.bibentries, errors, orphaned, duplicates
Error handling
- If
references.bibdoes not exist, report the error and stop. - If
index.qmdcontains no citations, report "No citations found" and stop.