Skip to content

Latest commit

 

History

History
93 lines (70 loc) · 2.84 KB

README.md

File metadata and controls

93 lines (70 loc) · 2.84 KB

dfeReports

R build status Codecov test coverage Lifecycle: experimental

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

---
title: "The title"
month: Month
date: Year
author: "Author1, Author2 and Author3"
affiliation: "Department for Education"
email: "[email protected]"
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:

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="*")