Formats

BibTeX in Volpi.

Volpi reads BibTeX, keeps a references.bib file in every project, and exports .bib for LaTeX.

Bringing BibTeX in

There are two ways, and both end in the same reference library.

  1. Open References and choose Add references.
  2. Choose Paste BibTeX / RIS / CSL-JSON and paste the entries. Volpi works out which of the three formats it is.
  3. Choose Add to library.

NoteYou can also import a .bib file into the project like any other file. It opens as text, and Volpi can read it as a list of references and add them to the library.

Citation keys are kept

LaTeX documents cite by key, so the key of each imported entry is kept as it is. References that turn out to be the same work are merged, not added twice.

The references.bib in your project

The library of a project is saved as references.bib inside the project folder, and Volpi keeps that file up to date as the library changes.

If you edit references.bib in another program, Volpi notices and stops updating it, so your edits are safe. To let Volpi manage it again, export a fresh .bib or remove the file.

What an exported entry holds

Choose Export in References, then BibTeX (.bib). Each entry is written with these fields when the reference has them.

FieldNotes
authorFamily name first, joined with "and".
titleIn double braces, so capitals in acronyms and names survive.
journal, booktitle or organizationDepending on the kind of reference.
year, volume, number, pagesPage ranges use the double hyphen LaTeX expects.
publisher, school or institutionDepending on the kind of reference.
doi, urlAs stored.

NoteEntry types written: article, book, incollection, inproceedings, phdthesis, techreport, online and misc.

Limits in this version

  • Every thesis is exported as @phdthesis, including a master's thesis.
  • BibTeX that relies on @string abbreviations, LaTeX accent commands or month names may not read correctly, and an entry with an unclosed brace can hide the entries after it. A sturdier reader is being tested for the next version.
  • Abstracts, keywords and notes in a .bib file are not kept.

Describes Volpi 0.1.1.

Read next