copernicus_article: Copernicus journals format.

View source: R/copernicus_article.R

copernicus_articleR Documentation

Copernicus journals format.

Description

Format for creating submissions to Copernicus journals.

Usage

copernicus_article(
  ...,
  keep_tex = TRUE,
  highlight = NULL,
  citation_package = "natbib",
  md_extensions = c("-autolink_bare_uris", "-auto_identifiers")
)

copernicus_journal_abbreviations(journal_name = "*")

Arguments

...

Additional arguments to rmarkdown::pdf_document(). Note: extra_dependencies are not allowed as Copernicus does not support additional packages included via \usepackage{}.

keep_tex

Keep the intermediate tex file used in the conversion to PDF. Note that this argument does not control whether to keep the auxiliary files (e.g., ‘.aux’) generated by LaTeX when compiling ‘.tex’ to ‘.pdf’. To keep these files, you may set options(tinytex.clean = FALSE).

highlight

Syntax highlighting style passed to Pandoc.

Supported built-in styles include "default", "tango", "pygments", "kate", "monochrome", "espresso", "zenburn", "haddock", and "breezedark".

Two custom styles are also included, "arrow", an accessible color scheme, and "rstudio", which mimics the default IDE theme. Alternatively, supply a path to a ‘⁠.theme⁠’ file to use a custom Pandoc style. Note that custom theme requires Pandoc 2.0+.

Pass NULL to prevent syntax highlighting.

citation_package

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.

md_extensions

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

journal_name

A regular expression to filter the by the journal name, see pattern in base::grep(); defaults to *.

Details

This was adapted from https://publications.copernicus.org/for_authors/manuscript_preparation.html.

An number of required and optional manuscript sections, e.g. acknowledgements, competinginterests, or authorcontribution, must be declared using the respective properties of the R Markdown header - see skeleton file.

Version: Based on copernicus_package.zip in the version 7.8, 18 March 2024, using copernicus.cls in version 10.1.11, 03 January.

Copernicus journal abbreviations: You can use the function copernicus_journal_abbreviations() to get the journal abbreviation for all journals supported by the Copernicus article template.

Important note: The online guidelines by Copernicus are the official resource. Copernicus is not responsible for the community contributions made to support the template in this package. Copernicus converts all typeset TeX files into XML, the expressions and markups have to be highly standardized. Therefore, please keep the following in mind:

  • Please provide only one figure file for figures with several panels, and please do not use ⁠\subfloat⁠ or similar commands.

  • Please use only commands in which words, numbers, etc. are within braces (e.g. ⁠\textrm{TEXT}⁠ instead of ⁠\rm TEXT⁠).

  • For algorithms, please use the syntax given in template.tex or provide your algorithm as a figure.

  • Please do not define new commands.

  • Supported packages (⁠\usepackage{}⁠) are already integrated in the copernicus.cls. Please do not insert additional ones in your .tex file.

  • If you opt for syntax highlighting for your preprint or other reasons, please do not forget to use highlight = NULL for your final file upload once your manuscript was accepted for publication.

  • Spaces in labels (⁠\label{}⁠) are not allowed; please make sure that no label name is assigned more than once.

  • Please do not use ⁠\paragraph{}⁠; only ⁠\subsubsection{}⁠ is allowed.

  • It is not possible to add tables in colour.

Value

An R Markdown output format.

Note

If you use rmarkdown::pdf_document(), all internal references (i.e. tables and figures) must use ⁠\ref{}⁠ whereas with bookdown::pdf_document2(), you can additionally use ⁠\@ref()⁠.

References

Manuscript preparation guidelines for authors. https://publications.copernicus.org/for_authors/manuscript_preparation.html

Examples

names(copernicus_journal_abbreviations())
copernicus_journal_abbreviations(journal_name = "Science Data")
## Not run: 
library("rmarkdown")
draft("MyArticle.Rmd", template = "copernicus", package = "rticles")
render("MyArticle/MyArticle.Rmd")

## End(Not run)

rticles documentation built on May 29, 2024, 2:30 a.m.