With advances in html delivery of research articles through the web,
the R Journal now has a new format of its website using a
version of the
distill package. This will allow
incorporation of interactive graphics directly into articles and easier
reading of the research online.
The Rmd template in
rjtools creates an article in the
format needed for the R Journal
distill web site.
rjtools package is provided to help authors meet these
requirements with an intention that it would help authors to write an
R Journal article, similar to the way that
devtools help developers build an R package. In this
vignette, I will walk you through how to use
create an R Journal article using the built-in template.
create_article() function will create the following
files and folders:
.sty files make sure all the
R Journal articles follow the same latex and reference style
and should not be modified unless there is a strong reason to do so.
name argument changes the name of the main R
Markdown document, for example, if you wish to use
quokka-bilby as the file name instead of
article, create the article with:
Please ensure that you stick to this folder structure when working with an R Journal paper. Any additional files should be organised within new folder(s) rather than being placed directly in the main directory. A uniform folder structure makes it easier to compile papers into issues during the editorial process.
To knit the
Rmd file, you can use either through the
knit button, or type the following command in the R
Before knitting, you may need to install the packages used in the
template file (
The R Journal uses
pandoc-citeproc to handle the
Citation Style Language (CSL) style. If you’re knitting the document
within RStudio (which we recommend), this is automatically handled.
However, if you’re using the command line, you’ll need to ensure the
pandoc-citeproc extension is installed properly on your
rjtools::rjournal_article output specified in the
article YAML will create the article in both html and pdf formats.
Additional files created during the knit are (assuming file name of
rticles package historically contained a template
for creating an R Journal article, which you might have used
before if you have been already working with R Markdown for writing
papers. This template is now synchronised with the template in
Now feel free to head to the vignette More details on the R Journal format for an example article and more detailed information on the template.
At this time the journal only takes
papers, which makes sense because the journal is focused on R, not other
languages. At some point in the future it may be able to accommodate
qmd formatted papers.