How to submit your article

Articles for the R Journal are short to medium length, no more than 20 pages, on topics of interest to the R community. Articles must not be published or submitted for publication elsewhere. The submission needs to include:

Read the information below on the requirements for files and format and then CLICK HERE to submit an article, re-submission, or revision.

We are also keen to welcome new reviewers for the R Journal. If you would like to volunteer to review articles, please complete this form here. You should have at least completed an undergraduate degree, and be an active R user.

Creating your article

Rmarkdown to output html and pdf

The rjtools package has a template to create the files needed for a submission in the form required by the R Journal.

It is strongly recommended that you use the create_article() function. Knitting the Rmd will generate both an HTML and PDF format of your paper.

When writing your article you should aim to write without specific reference to HTML and LaTeX codes. If you do need to write code specific to the HTML or PDF output, you can use knitr::is_html_output() and knitr::is_latex_output() to conditionally produce a particular output.

The web articles for the R Journal are based on the distill framework, which provides several styling and arrangement options for your article contents. The distill R package documentation (generally also applicable to articles written for the R Journal) describes various article elements and Rmarkdown syntax: https://rstudio.github.io/distill/.

We are especially looking for creative uses of interactive content in HTML formatted articles. This will require that you make different code chunks evaluated conditionally using eval=knitr::is_html_output() or eval=knitr::is_latex_output() with appropriate re-captioning, and conditional inline reference links. Interactive plots should be produced with a manageable file size (aim for under 10Mb) which may require small data examples. Figures and tabes for the html format should have alt-text in the chunk specification, to further assist with accessibility.

Converting from rticles:rjournal_article Rmarkdown

If you currently use the rticles::rjournal_article output format for R Markdown, the change involves five steps: (1) change output formats to rjtools::rjournal_web_article to switch to the new style, (2) remove any latex specific functionality, (3) change figure, table references to \@ref() and (4) add the rjournal.csl and rjournal.css template files to your folder, updating YAML to utilise them, and (5) set the reference to the .bib in the YAML.

Traditional latex format

Articles can also be written using the traditional latex template. Using this style you will need to provide RJwrapper.tex, RJwrapper.pdf, RJournal.sty, your-article.tex (which contains the content of your paper), your-article.bib, your-article.R (to reproduce results in your paper), in addition to the motivation letter. You should avoid using any other specialist latex style files. The rjtools check functions described below can also be applied to check your files prior to submission.

Checking your article

The rjtools package has a number of functions which can help you check that your article is ready to submit. These include:

File format for submission

New submission

To submit a new article to the R Journal, you will need to complete. You will need to provide these details:

You may have problems submitting if size of your submission zip file is more than 10Mb. If you have large files, for example, data files, you can make them available on an alternative site and provide the links in the paper. If you have problems, please contact the Editor-in-Chief at .

Your paper will be checked for reproducibility by running the code provided. Please ensure that the examples can be run in a timely manner, perhaps by reducing the example data size. If necessary, intermediate output files, can be provided to shorten the run time.

Re-submission or revision

Re-submission and revisions to accepted articles are received through the same site where new submissions are received (link below). When providing a re-submission or revision, you will need to enter the identifier of the original submission in the last field of the submission form. This also needs to be done if your paper has previously been rejected, and you have made appropriate corrections for it to be considered again.

Note on special issue articles

A special issue article can be considered to be a refereed journal article and generally carries more weight than an unrefereed conference proceedings.

Conference committees will designate a “Conference Editor in Chief” (CEiC) who will be primarily responsible for putting the special issue together. For this pilot to be successful, it is important that putting together the special issue does not significantly increase the workload of the regular editors or the administrative team that helps to build the issues. It will be the responsibility of the CEiC to identify associate editors if needed, assign reviewers, accept and reject papers, and assemble the special issue. It will also be the responsibility of the CEiC to make sure that the issue reflects the diversity of the community, and that the R Consortium and R Community Code of Conduct is followed during the process.