Articles for the R Journal should be no more than 20 pages, on topics of interest to the R community. Articles must not be published or submitted for publication elsewhere.
We currently accept submissions in Rmarkdown or LaTeX. Rmarkdown using the rjtools package is preferred.
The rjtools package has a template to create the files needed for a submission in the form required by the R Journal.
Create your article using the create_article()
function. Knitting the Rmd will generate both an HTML and PDF format of your paper.
As far as possible, do not use specific HTML and LaTeX codes within your Rmd file. 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.
Creative uses of interactive content in HTML formatted articles is encouraged. This will require conditional evaluation of code chunks 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 tables should have alt-text in chunk specifications, to assist with accessibility.
Titles and abstract should be in plain text, with the abstract no more than 250 words.
The rticles::rjournal_article
output format has been deprecated in favour of rjtools
. Please use rjtools
instead of rticles
.
Articles can also be written using the 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. The rjtools
check functions described below can also be applied to check your files prior to submission.
LaTeX submissions must compile with pdflatex. Please use as few LaTeX packages as possible. The template already includes several commonly-used packages such as amsmath
, booktabs
, tikz
, etc. Do not use your own styles, fonts, or syntax colouring.
LaTeX submissions that do not follow these guidelines will be rejected without review.
The rjtools
package has a number of functions which can help you check that your article is ready to submit. These include:
initial_check_article()
does multiple checks on the files in your paper submission folder
check_wrappers()
that the files RJournal.tex and RJournal.pdf are presentcheck_filenames()
file names are consistent and as requestedcheck_unnecessary_files()
that there are no extra files than those necessary and requestedcheck_cover_letter()
there is a cover letter with the files to be submittedcheck_title()
that the title is in title casecheck_section()
that section headings are in sentence casecheck_spelling()
does a spell-checkcheck_proposed_pkg()
package is available on CRAN or bioconductorcheck_packages_available()
additionally referenced packaged are also available on CRA or BioconductorTo submit an article to the R Journal, you will need to complete this form.
Your files will need to be uploaded in a zip file that should contain:
.pdf
format..Rmd
, .tex
, .bib
, .sty
and figure files), it will be sent back to you._Rpackages.txt
with a list of packages, one per line.You may have problems submitting if the size of your submission zip file is more than 10Mb. If you have large data files, you can make them available on an alternative site and provide the links in the paper.
Please ensure that the submission can be reproduced in a timely manner, perhaps by reducing the example data size. If necessary, intermediate output files, can be provided to shorten the run time.
If you have problems, please contact the Editor-in-Chief at r-journal@r-project.org.
Re-submissions and revisions to articles should be submitted in the same way. 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.
Once you have submitted an article, the editorial board will go through the following steps.
Special issues may be created to cover topics of interest to the R community, or based on papers presented at an R conference.
Please contact the Editor-in-Chief at r-journal@r-project.org if you would like to propose a special issue.