oup_article: Oxford University Press.

View source: R/oup_article.R

oup_articleR Documentation

Oxford University Press.


Format for creating submissions to many Oxford University Press journals. Adapted from https://academic.oup.com/journals/pages/authors/preparing_your_manuscript and https://academic.oup.com/icesjms/pages/General_Instructions. and the oup-authoring-template available on CTAN at https://www.ctan.org/pkg/oup-authoring-template.


  oup_version = 0,
  journal = NULL,
  number_sections = FALSE,
  citation_package = ifelse(oup_version == 0, "default", "natbib"),
  papersize = c("large", "medium", "small"),
  document_style = c("contemporary", "modern", "traditional"),
  namedate = FALSE,
  onecolumn = FALSE,
  number_lines = FALSE,
  number_lines_options = NULL,
  keep_tex = TRUE,
  md_extensions = c("-autolink_bare_uris"),
  pandoc_args = NULL,



set to 0 (default) to use the 2009 OUP ouparticle.cls included or set to 1 to use the newer 2020 OUP package oup-authoring-template available on CTAN.


journal Title. (Only useful for oup_version > 0).


It will be passed to rmarkdown::pdf_document(). Set to TRUE by default when oup_version = 1 is used.


The LaTeX package to process citations, natbib or biblatex. Use default if neither package is to be used, which means citations will be processed via the command pandoc-citeproc.


one of "large" (default), "medium", or "small" setting output page size. (Only useful for oup_version > 0)


one of "contemporary" (default), "modern", or "traditional" setting overall style of document. (Only useful for oup_version > 0)


a logical variable indicating if natbib citations should be in name-date format. Defaults to FALSE. (Only useful for oup_version > 0)


a logical variable indicating if one column formatting should be used. Defaults to FALSE. (Only useful for oup_version > 0)

number_lines, number_lines_options

Control the usage of CTAN package lineno in the template. Use number_lines =TRUE to activate and set number_lines_options to change options. (Only useful for oup_version > 0)


Keep the intermediate tex file used in the conversion to PDF


Markdown extensions to be added or removed from the default definition of R Markdown. See the rmarkdown_format for additional details.


Additional command line options to pass to pandoc


Additional arguments to rmarkdown::pdf_document()


Note that for

  • oup_version=0, citation_package="default" by default,

  • oup_version=1, citation_package="natbib" by default and citation_package="biblatex" is not supported.

Pandoc requirement

oup_version = 1 requires a minimum version of 2.10.


## Not run: 
# Use old template based on `ouparticle.cls`
rmarkdown::draft("MyArticle.Rmd", template = "oup_v0", package = "rticles")
# Use new template based on `oup-authoring-template` CTAN package
rmarkdown::draft("MyArticle.Rmd", template = "oup_v1", package = "rticles")

## End(Not run)

rticles documentation built on March 18, 2022, 7:15 p.m.