In vidonne/unhcrdown: UNHCR Branded Templates for R Markdown Documents

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)

unhcrdown

Streamline your document creation process with the {unhcrdown} R package. It provides a comprehensive set of templates designed to align your reports and presentations with UNHCR's brand guidelines. This package offers ready-to-use R Markdown templates for various document types, ensuring consistent UNHCR visual identity across your communications.

Features

• A collection of professional templates following UNHCR brand guidelines
• Ready-to-use formats for reports, presentations, and websites
• Easy-to-use functions that work seamlessly with R Markdown
• Consistent styling across all document types

Installation

Get started by installing the {unhcrdown} package from CRAN with:

install.packages("unhcrdown")

Or retrieve the development version from Github using the {pak} package:

# If pak is not yet installed, uncomment the following line:
# install.packages("pak")

pak::pkg_install("unhcr-dataviz/unhcrdown")

Usage

The {unhcrdown} templates are designed for R Markdown projects, any of the available format can simply be added to output parameter of the R Markdown yaml header. For example:

---
title: "UNHCR Branded Report"
author: "First Last Name"
date: "`r Sys.Date()`"
output: unhcrdown::paged_report
---

Available Formats

• PDF Reports: Two HTML to PDF options: {yaml} output: unhcrdown::paged_report # Full template with cover # or output: unhcrdown::paged_simple # Streamlined version

• Word Documents: Professional reports using officedown::rdocx_document {yaml} output: unhcrdown::docx_simple

• PowerPoint: Presentation slides {yaml} output: unhcrdown::pptx_slides

• HTML Slides: Web presentations {yaml} output: unhcrdown::html_slides

• HTML Page: Web based documents {yaml} output: unhcrdown::html_page

RStudio Integration

Create new documents directly from RStudio:

1. File → New File → R Markdown
2. Select "From Template"
3. Choose any {unhcrdown} template

Acknowledgements

We extend our gratitude to the creators of the pagedown package that influenced the development of unhcrdown.

Contribution and Code of Conduct

Contributions to {unhcrdown} are highly valued. To ensure a welcoming and inclusive community, we follow our Contributor Code of Conduct. If you have suggestions, uncover bugs, or envision new features, kindly submit an issue on GitHub.

License

This package is distributed under the MIT License.

vidonne/unhcrdown documentation built on June 1, 2025, 11:02 p.m.