unhcRstyle

Content

A package with all necessary elements to quickly implement UNHCR Brand style in your statistical products and data stories:

1. Adjusted ggplot2 themes for:

   • bar chart,
   • scatter plot,
   • histogram and
   • maps

2. A series of color palette for:

   • Discrete palette with either fixed or dynamically extended number of shades
   • Discrete palette with specific values for "good", "bad", and "neutral"
   • Continuous diverging color palette
   • Continuous color palette

3. Different Rmarkdown __template __ to quick-start any report or slides you need to prepare:

   • Paginated report built on the top of pagedown. You can see an example through the UNHCR R Cookbook
   • Analysis Repository contribution
   • Word with UNHCR style
   • Powerpoint with UNHCR style
   • html/bootstrap -scroll-able report
   • html/slide - slide-able report

Usage

install this package from Github:

remotes::install_github('edouard-legoupil/unhcr_pagedown')

Once the package installed, you should be able to create directly your report with the right template within Rstudio:

This package requires a recent version of Pandoc (>= 2.2.3). If you use RStudio, you are recommended to install the latest version (>= 1.2.1335), which has bundled Pandoc 2.x, otherwise you need to install Pandoc separately.

This package is part of unhcrverse, a set of packages to ease the production of statistical evidence and data stories. You can install them all with the following:

## Use UNHCR Open data
remotes::install_github('unhcr/unhcrdatapackage')

## Use API to connect to licensed / internal data source
remotes::install_github('unhcr-web/hcrdata')

## Perform High Frequency Check during data collection
remotes::install_github('unhcr-web/HighFrequencyChecks')

## Process data crunching for survey dataset
remotes::install_github('unhcr/koboloadeR')

## Use UNHCR template for reporting and writing stories
remotes::install_github('unhcr-web/unhcRstyle')

Building package documentation

devtools::document()

devtools::check(document = FALSE)

pkgdown::build_site()

If you encounter a clear bug, please file a minimal reproducible example on github.

References / Inspiration

• https://emilyriederer.netlify.app/post/rtistic/
• https://emilyriederer.netlify.app/talk/rmarkdown-driven-development/
• https://github.com/dr-harper/example-rmd-templates
• https://hneth.github.io/unikn/
• https://bbc.github.io/rcookbook/
• https://bookdown.org/yihui/rmarkdown-cookbook/