DHSC quarto templates

This repo provides custom quarto formats to produce DHSC, OHID or GOVUK themed documents.

Installing

To start a new project using the custom formats, enter the following in the terminal:

quarto use template DataS-DHSC/dhsc_quarto_template

This will create a new folder with example qmd files that you can use as the starting point of your document.

If you are working in RStudio, it is advisable to run the above command first and then create an RStudio project in the new folder.

Alternatively, to install the formats in an existing project, without the example qmd files, enter the following in the terminal:

quarto add DataS-DHSC/dhsc_quarto_template

Using

If installed using the quarto use template command, the project includes the following example qmd files. Rename and edit the relevant template and click the RStudio render button to produce a document.

template_DHSC_HTML.qmd A standalone HTML report document with DHSC branding.

template_OHID_HTML.qmd A standalone HTML report document with OHID branding.

template_DHSC_powerpoint.qmd A PowerPoint using the DHSC PowerPoint template.

template_OHID_powerpoint.qmd A PowerPoint using the OHID PowerPoint template.

template_GOVUK_HTML.qmd A HTML document with GovUK branding.

If you have installed the formats in an existing project using the quarto add command, you can manually download and add the template qmd files from this repo. Alternatively, create a blank qmd file and set the yaml to the relevant custom format: DHSC-html, DHSC-pptx, OHID-html, OHID-pptx, govuk-html

Do not edit any file in the _extensions folder.

Updating extensions

To update to use the latest version of the templates, the following command can be used in the terminal:

quarto update DataS-DHSC/dhsc_quarto_template

Further information on managing extensions can be found on the quarto website.

Accessibility

For guidance of making reports, charts and tables accessible, please see the analysis function website.

Developer Notes: Updating GOV.UK CSS

You can find the most up-to-date GOV.UK style on the GDS.