Steve's 3rd Article/Manuscript Template — article3 • stevetemplates

Another template for academic articles/manuscripts. Please note that xelatex is functionally required for this template/function. An (incomplete) primer on this tutorial is available on my website http://svmiller.com/blog/2023/05/a-third-rmarkdown-article-manuscript-template/.

Usage

article3(...)

templ_article3()

Arguments

...: Arguments to rmarkdown::pdf_document.

Details

If your version of TeX comes by way of Yihui Xie's tinytex, you'll want to additionally install the "xurl" library. Otherwise, you'll get a vague error about a missing LaTeX dependency. tinytex::tlmgr_install("xurl") should suffice. I thank Ian Adams and Cornelius Hennch for finding this issue and pointing to this solution.

About YAML header fields

This section documents some of the YAML fields to know for this template. Just about everything is carried over from the 2nd article template. The user will want to pay careful attention in the skeleton/example file about how the YAML is structured for author information.

Do note that Pandoc limitations preclude a more sophisticated "if-else" logic to formatting authors and their affiliations. This means (basically: strongly implies) that one of solo-author, two-author, or n-author is explicitly set to TRUE for this template to look like it makes sense. You do not need all three in your YAML. You just need one, and to set it to TRUE.

FIELD	DESCRIPTION
`author`	author information with support for subfields of name, email, author order, and affiliation code
`affils`	affiliation information corresponding with the authors. Sync code here with the information in the author field.
`thanks`	A place to thank people for their input, identify corresponding author, etc.
`abstract`	include an abstract of the paper here
`keywords`	some keywords for the manuscript
`anonymous`	logical, defaults to `FALSE`. If `TRUE`, scrubs all identifying author info for peer review
`removetitleabstract`	logical, defaults to `FALSE`. If `TRUE`, removes title/abstract for peer review (if you'd like)
`appendix`	optional, but specifies appendix figure/table prefices
`endnotes`	logical, defaults to `FALSE`. If `TRUE`, makes R Markdown footnotes as endnotes
`pandocparas`	logical, defaults to `FALSE`. If `TRUE`, keeps Pandoc's default paragraph format
`sansitup`	logical, defaults to `FALSE`. If `TRUE`, better mimics ACM's use of sans fonts for section headers
`mainfont`	optional (I think?), but it's the main font to use with `xelatex`. I use `cochineal` here.
`sansfont`	optional, only necessary if `sansitup: TRUE`. Specifies sans font. I recommend Linux Biolinum
`doublespacing`	optional, if anything is here to process, this will double-space the document.
`remove-emails`	optional, defaults to FALSE. If TRUE, removes author email information from document preamble.
`remove-paper-info`	optional, defaults to FALSE. If TRUE, removes optional paper information you may want to include.
`paper-info`	Additional information you may want to include about the paper.
`solo-author`	Is there only one author on this project? Then set as `TRUE`. Has implications for formatting.
`two-author`	Are there only two authors on this project? Then set as `TRUE`. Has implications for formatting.
`n-author`	Are there more than two authors on this project? Then set as `TRUE`. Has implications for formatting.
`alternate-layout`	If `TRUE`, adjusts the layout slightly (moving affiliations outside the abstract and to near the authors. Experiment with it and see if you like it.