search

crsh / papaja

papaja (Preparing APA Journal Articles) is an R package that provides document formats to produce complete APA manuscripts from RMarkdown-files (PDF and Word documents) and helper functions that facilitate reporting statistics, tables, and plots.
https://frederikaust.com/papaja_man/
Other
648 stars 132 forks source link

Encourage use of CSL-JSON #387

Open mariusbarth opened 4 years ago

mariusbarth commented 4 years ago

As can be seen in this pull request, it is best to use CSL-JSON compared to BibTeX. Does this also apply to papaja, and should we also encourage usage of CSL-JSON in the documentation and the template? Better CSL-JSON is provided by the Better BibTeX Zotero Plugin

crsh commented 4 years ago

Yes, I fully agree. This is also an issue I have considered for citr. But due to limited time I haven't made any headway there because this will largely promoted by a major change to the internals of citr. Once that change is implemented, citr will default to JSON files anyway. In short, sure.

How do you want to encourage the use of JSON? It seems this would be an issue for the manual, no?

danieltomasz commented 4 years ago

For example by including an example "references.json" instead of "references.bib" in the template

mariusbarth commented 4 years ago

That's what I also had in mind. Unfortunately, it seems like the .bib file with references to R packages is created in a way that is not easily moved to .json, right?

crsh commented 4 years ago

Thanks for chiming in, Daniel. A quick thought: While CSL-JSON is preferred over BibTeX because it's not lossy, BibTeX is far more widely used and available. I fear that if we use CSL-JSON in the example, which is one of the first things a new user will look at, it may be off-putting. I know Zotero allows CSL-JSON export, but I think other commonly used reference managers (e.g., Citavi, Papers, Endnote) do/may not. But I would be happy to add a comment to the YAML that encourages use of JSON.

We should definitely mention this in the manual, though.

Marius, I think you are right. The references that we generate for the used R packages are only available in Bib(La)TeX-format, so we would need to convert them somehow.