ACM CHI Proceedings R Markdown Template

UPDATE, 16 Aug 2022: Quarto, the successor to R Markdown, comes with an ACM template. Go and use this instead! :)

NOTE: This repo supplies the template that was used by CHI 2019. CHI 2020 has reverted back to the template used at CHI 2018 - find my R Markdown template for that here: https://github.com/ulyngs/chi20-papers-rmarkdown

This R package provides a template for writing ACM CHI Proceedings papers in R Markdown, and compiling to PDF via the LaTeX templates from the ACM Master LaTeX Template (v. 1.56).

How to cite

@misc{lyngsChiProcRmdTemplate2018,
  author = {Lyngs, Ulrik},
  title = {chi-proc-rmd-template},
  year = {2018},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/ulyngs/chi-proc-rmd-template}},
  doi = {10.5281/zenodo.3524920},
}

Overview

Using a tool like R Markdown to write scientific papers makes your work more transparent and reproducible, and reduces the risk of introducing errors by manually transfering results from statistical software to manuscript.

However, getting R Markdown to play nicely with the ACM LaTeX templates can be tricky.

This R package makes it easy, by providing a ready-made .Rmd template with YAML metadata and body text illustrations of what you need to know, which compiles to the latest CHI Proceedings (used for CHI'19 submissions) format via the ACM Master Article LaTeX template.

Installation

# The package isn't on CRAN - install the development version from GitHub:
# install.packages("devtools")
devtools::install_github("ulyngs/chi-proc-rmd-template")

Usage

The easiest way to use the template is with RStudio, via File -> New File -> R Markdown... In the dialog box, click 'From Template', then find the new 'ACM CHI Proceedings {CHIProceedings}' option, choose a name for your manuscript (e.g. 'Test'), then click OK:

A new folder named Test is created, and you see an open Test.Rmd file:

If you click 'Knit', it compiles to the example PDF output with the illustration content from Test.Rmd:

It also keeps the intermediary generated Test.tex file from which the PDF output was created:

Now go ahead and replace the content of Test.Rmd with your own fantastic work!

NOTE: include the initial setup_output code chunk at the top of your .Rmd file, as it creates custom chunk options that allow you to e.g. add image descriptions for visually impaired readers.