gesistsa/bibcon

Fast BibTeX condenser for Quarto / RMarkdown documents

bibcon

The purpose of bibcon (BibTeX condenser) is to extract all references cited in Quarto / RMarkdown documents from a main BibTeX library to a "condensed" BibTeX file.

This is a fast (and functioning) reimplementation of condensebib by Andreas Beger.

Please pay attention that this software is called bibcon, not Bitcoin.

install

Please note that this software is still super experimental

## install cargo from here: https://doc.rust-lang.org/cargo/getting-started/installation.html
cargo install --git https://github.com/gesistsa/bibcon 

usage

weat.qmd contains 5 unique citations, whereas weat.bib contains 6 entries. The following generates BibTeX of only 5 entries.

bibcon tests/weat.qmd -b tests/weat.bib

r1.rmd and r2.rmd contain 4 unique citations, whereas main.bib contains 12 entries.

bibcon -b tests/main.bib tests/r1.rmd tests/r2.rmd

bibcon's Issues

Proper arg parsing

either clap or optparse

Turn it into an R package also?

Using
https://github.com/extendr/extendr

But is it useful?

parsing multiple *md files

Implement the function of the unmerged andybega/condensebib#2

The order of output is random

Due to the fact that Hashset is initialized by a random hash.

Envvar of the path of `bib`

For most people, it is consistent. So that it doesn't need to be specified.

An option to write the output to a file rather than directly to `STDOUT`

bibcon tests/weat.qmd -b tests/weat.bib > output.bib

works, but how about

bibcon tests/weat.qmd -b tests/weat.bib -o output.bib

Can't detect citekeys at the beginning

https://github.com/chainsawriot/bibcon/blob/8127a5569d7b1046962bc9806b4731610aa41368/tests/r1.rmd#L1-L5

bibcon -b tests/main.bib tests/r1.rmd

@book{eddelbuettel,
author = {Eddelbuettel, Dirk},
doi = {10.1007/978-1-4614-6868-4},
isbn = {9781461468684},
publisher = {Springer New York},
title = {{Seamless R and C++ Integration with Rcpp}},
url = {http://dx.doi.org/10.1007/978-1-4614-6868-4},
year = {2013},
}

@manual{rcore,
address = {Vienna, Austria},
author = {{R Core Team}},
organization = {R Foundation for Statistical Computing},
title = {R: A Language and Environment for Statistical Computing},
url = {https://www.R-project.org/},
year = {2021},
}

It can't detect @wickham2016. This regex

https://github.com/chainsawriot/bibcon/blob/8127a5569d7b1046962bc9806b4731610aa41368/src/lib.rs#L12

depends on the initial (?P<ini>^|[\[,; -]) thing to grab cite keys. But this thing are actually optional.

Better feedback when the main bibtex file can't be parsed

panic

• Missing files
• Missing Entries