search

inbo / INBOmd

An R package with a collection of RMarkdown styles and templates. Elaborate examples are available at https://github.com/inbo/INBOmd_examples
https://inbo.github.io/INBOmd
GNU General Public License v3.0
11 stars 2 forks source link

Templates: request to not use 'bibliography: references.bib' by default #62

Open florisvdh opened 3 years ago

florisvdh commented 3 years ago

As discussed past week.

In order to stimulate the use of CSL-JSON and CSL-YAML, which work perfectly with INBOmd through the use of pandoc-citeproc + csl-stylefile, referring a default Bibtex formatted file should be avoided in the templates, including the prepared bib-file itself.

Best settle on json or yaml, and provide these by default (bib is still supported through pandoc-citeproc, but the processing is necessarily lossy because the bibtex format is less standardized than csl-json). CSL-JSON and CSL-YAML are the preferred formats to use with pandoc-citeproc (with csl-json being the official format). One way to create them from another file format, is by using RStudio in VME mode. Or by using pandoc-citeproc on the command line (file conversion).

Further considerations on YAML vs JSON (and combining them) are in https://github.com/inbo/tutorials/issues/207#issuecomment-726869149; YAML can be preferred over JSON because of best human-readability.

ThierryO commented 1 year ago

I would suggest to first write a tutorial on how to generate the bibliography.