Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
2 tasks
florisvdh opened this issue Sep 11, 2020 · 1 comment
Open
2 tasks

Comments

@florisvdh
Copy link
Member

florisvdh commented Sep 11, 2020

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).

  • templates: put bibliography: references.yaml in YAML header
  • templates: replace file references.bib by references.yaml

Further considerations on YAML vs JSON (and combining them) are in inbo/tutorials#207 (comment); YAML can be preferred over JSON because of best human-readability.

@ThierryO
Copy link
Collaborator

ThierryO commented Mar 9, 2023

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants