Problem
After v0.2.6, vignettes/references.bib is regenerated by hand
(rbbt::bbt_update_bib(...)) whenever [@key] markers change in
either regional vignette. Easy to forget. Render failures from
unresolved cites show up later than they should.
Scope
Add a small helper to formalize the regen recipe — option 1 of the
three discussed (the conservative one; doesn't break CI):
- New
data-raw/regenerate_bib.R — single command that reads both
regional vignettes, detects the union of [@key] markers, and
writes vignettes/references.bib via rbbt::bbt_bib(). Documents
the prerequisites (Zotero running, BBT 9.x for Z8/9) inline.
- HTML comment block at the top of each regional vignette pointing
to the helper ("after editing cites, run Rscript data-raw/regenerate_bib.R"). HTML comments don't render.
- One-line note in CLAUDE.md (Vignettes section) referencing the
helper.
Out of scope
- Embedding the rbbt call in YAML at render time (option 2 from the
discussion) — would break CI which has no Zotero/BBT.
- Pre-commit hook (option 3) — more involved; deferred.
Done when
Problem
After v0.2.6,
vignettes/references.bibis regenerated by hand(
rbbt::bbt_update_bib(...)) whenever[@key]markers change ineither regional vignette. Easy to forget. Render failures from
unresolved cites show up later than they should.
Scope
Add a small helper to formalize the regen recipe — option 1 of the
three discussed (the conservative one; doesn't break CI):
data-raw/regenerate_bib.R— single command that reads bothregional vignettes, detects the union of
[@key]markers, andwrites
vignettes/references.bibviarbbt::bbt_bib(). Documentsthe prerequisites (Zotero running, BBT 9.x for Z8/9) inline.
to the helper ("after editing cites, run
Rscript data-raw/regenerate_bib.R"). HTML comments don't render.helper.
Out of scope
discussion) — would break CI which has no Zotero/BBT.
Done when
data-raw/regenerate_bib.Rexists, documented, runnable18-key parity post-v0.2.6)