In l-hodge/usefulR: Write Department For Education Research Reports In Rmarkdown

dfeReports

Overview

Write Department for Education (DfE) research reports in Rmarkdown, according to the template and style guide.

Installation

# install.packages("remotes")
remotes::install_github("l-hodge/dfeReports")

Functions

| Function | Description | |------------------------------------|------------------------------------| | dfe_colours() | Creates DfE colour palettes, typically monochrome sequential or spectral schemes | | dfe_table() | Wrapper for knitr::kable to produce tables in the DfE style |

Rmarkdown output formats

This package includes two Rmarkdown output formats to produce DfE research reports.

| Function | Description | |------------------------------------|------------------------------------| | basic_report() | A basic DfE research report based on rmarkdown::pdf_document() | | research_report() | A bookdown-style DfE research report |

Example yaml

```{yaml, echo = TRUE, eval = FALSE}

title: "The title" month: Month date: Year author: "Author1, Author2 and Author3" affiliation: "Department for Education" email: "[e-mail]" dferef: "xxxx" isbn: "xxxx" output: dfeReports::research_report: latex_engine: xelatex bibliography: biblio.bib

---

### Starting from a template

You can start a new report from a template using `rmarkdown::draft()` in the console:

```r
rmarkdown::draft("ReportName.Rmd", template = "dfe-report-pdf", package = "dfeReports")

or in RStudio navigate to R Markdown... > From Template > DfE Report Template > OK

TinyTeX

You will need to have tinytex installed to render these output formats. The following steps should help you get started:

# Install package
install.packages("tinytex") 
# Install TinyTeX
tinytex::install_tinytex()
# Set CTAN mirror - some of them don't work, this one does(!)
tinytex::tlmgr_repo("http://mirror.aut.ac.nz/CTAN/")
# This is required to get around the DfE proxy
Sys.setenv(no_proxy="*")

l-hodge/usefulR documentation built on Dec. 3, 2022, 8:35 a.m.