benilton / yart Goto Github PK

It would be useful to have a RMarkdown template for typical (academic) reports such as class assignments and bachelor/master thesises. The LaTeX class "report" provides a suitable format for that. This package provides a simple wrapper around this class built on the standard pandoc template.

This package leans on earlier work by Aaron Wolen in his pandoc-letter repository, and extends it for use from R via the rmarkdown package. The structure of this package is heavily inspired by Dirk Eddelbuettel's nice template package linl.

The following screenshot shows on the left hand side the raw markdown file and on the right hand side the compiled pdf paper.

Being built on Pandoc, yart provides the typical features of Pandoc's Markdown, inculding citation, figures, tables and references thereto -- and basically, via a template, the fully featured LaTeX beauty. Being built on RMarkdown/knitr, R can be knitted into the text document.

The specific addon of this template is that it configurates a LaTeX template suitable for (academic) reports so that the user does not have to deal with the LaTeX peculiarities and can focus on writing/contents. There are a number of levers which can be adapted by the used in the yart template including author name, title, subtitle, address, date, referee's name, assignment name, school's name, due date.

Install via R from Github:

# install.packags("devtools", dependencies = TRUE)
devtools::install_github("sebastiansauer/yart")

Be careful with build_vignettes = TRUE as it may provoke errors. To build vignettes, I recommend the R function devtools::build_vignettes(). Per default, no vignettes are built by install_github(), malheuresement.

• R
• RStudio Desktop (not strictly necessary, but recommended)
• LaTeX
• packages: rmarkdown and its dependencies (to be installed via R)

Please use the most recent versions of each software.

The skeleton creates a very simple letter.

Several formatting defaults are in use. See help(yart) for a complete list and default values.

You can download the vignette here.

First, open as a Markdown template via RStudio via File > New File > RMarkdown > From Template > YART. The template list or Rmarkdown should feature the YART template upon the package installation:

Second, "knit" to document to pdf:

or use code such as

library(rmarkdown)
draft("my_report.Rmd", template="pdf", package="yart", edit=FALSE)
render("my_report.Rmd")

to create a first draft of a new my_report.Rmd.

Open the file yart-via-template.Rmd, it calls the yart TeX template without reliance of the R package yart. Just adopt the content of this boilerplate file to you need. See this file to check the PDF output.

Please report issues here along with a reproducible example if possible.

A number of R packages for RMarkdown templates for PDF documents are available including

• linl
• pinp
• rticles
• tint

Sebastian Sauer

GPL-3 for this package, the work in pandoc-letter, as well as underlying Pandoc template.