LoginSign Up
← Back to all sparks
P

pakret

INFRA · APIS
Velocity0.0

Cite 'R' Packages on the Fly in 'R Markdown' and 'Quarto'

github.com/arnaudgallou/pakret ↗

Package citation for R documents, quietly growing to meet Quarto.

reproducible-documentscitationsbibtexquartor-markdown
◆Current state
pakret inserts citations for R packages into R Markdown and Quarto documents, resolving each package to a BibTeX entry and writing the .bib file that backs it. Version 0.3.1 adds support for Quarto's inline syntax and separator control when citing several packages in one inline chunk, following 0.3.0, which made the package create missing .bib files, preserve capitalisation in reference titles, and treat the version placeholder in citation templates as optional. Cadence is a handful of small releases a year.
◆Where it's heading
Every release in this window removes a specific friction someone hit while writing a document. Bib files that had to exist beforehand now get created; single-letter package names like R and C stopped being lower-cased in titles; the package works when loaded after conflicted; citing many packages got faster; and version numbers became optional for documents where they are noise. The 0.3.1 Quarto support extends the same idea to the format its users are moving to. Nothing here is architectural, and nothing needs to be.
◆Prediction
Expect continued alignment with Quarto as more of its syntax surfaces become relevant, and further refinement of how multi-reference packages resolve to a single entry, which the BibTeX type priority work in 0.2.0 started. The entries give no indication of a 1.0.

◆Recent moves

  1. 4mo ago

    Quarto inline syntax supported; list separators configurable

    Adds support for Quarto's inline syntax, extending the package to the format much of its audience has moved to, and lets pkrt_set() control the separators used between packages when several are cited in one inline chunk. Small in code, but it is what keeps the package usable as the surrounding tooling shifts.

    View source ↗
  2. 8mo ago

    Missing .bib files created; capitalisation preserved

    Removes several setup requirements at once: bib files are created when absent, package names keep their capitalisation in reference titles including single letters such as R and C, the version placeholder becomes optional for non-technical documents, and citing multiple packages is substantially faster. Also fixes a conflict when loaded after the conflicted package.

    View source ↗
  3. 1y ago

    Multiple .bib files supported within one document

    Allows references to be written across several bib files in the same document, and fixes an edge case where redefining the target file could duplicate or drop entries. Useful for larger documents that keep bibliographies split by chapter or source.

    View source ↗
  4. 1y ago

    Citations with pre-written keys now supported

    Lets pakret cite references that already have a key rather than generating one, which matters for documents with an existing bibliography the author does not want rewritten. An alphabetical ordering fix accompanies it.

    View source ↗
  5. 1y ago

    book entries used when no manual entry exists

    Adds book as a second BibTeX type to prefer when resolving a package's reference, so packages documented by a book rather than a manual entry get a sensible citation instead of a fallback. A small correctness improvement in the part of the package users never see but always depend on.

    View source ↗