https://github.com/john-harrold/onbrand

R package for creating templated reporting workflows in Word and PowerPoint
https://github.com/john-harrold/onbrand

Last synced: 4 months ago
JSON representation

R package for creating templated reporting workflows in Word and PowerPoint

• Host: GitHub
• URL: https://github.com/john-harrold/onbrand
• Owner: john-harrold
• License: other
• Created: 2021-06-02T00:45:47.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-24T01:53:27.000Z (7 months ago)
• Last Synced: 2024-12-01T02:51:28.516Z (5 months ago)
• Language: R
• Size: 20.1 MB
• Stars: 24
• Watchers: 4
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - john-harrold/onbrand - R package for creating templated reporting workflows in Word and PowerPoint (R)

README

        
---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# onbrand 

[![R-CMD-check](https://github.com/john-harrold/onbrand/workflows/R-CMD-check/badge.svg)](https://github.com/john-harrold/onbrand/actions)

[![CRAN checks](https://badges.cranchecks.info/worst/onbrand.svg)](https://cran.r-project.org/web/checks/check_results_onbrand.html)

[![version](https://www.r-pkg.org/badges/version/onbrand)](https://CRAN.R-project.org/package=onbrand)

![cranlogs](https://cranlogs.r-pkg.org/badges/onbrand) 

![Active](https://www.repostatus.org/badges/latest/active.svg)

The ``officer`` package provides extensive methods for accessing, creating, and modifying both Word and PowerPoint documents. These methods require obtaining document specific placeholder and style information. In order to switch between document templates, it is necessary to change these references within the reporting code.  The purpose of ``onbrand`` is to provide an abstraction layer where template details are mapped to human-readable names. 

These human-readable names combined with the mapping information - in a template-specific yaml file - provides a systematic method to script support for different Word of PowerPoint templates.  Which means, the same workflow will support multiple outputs.  Which makes your life easier and, thus, makes the world a little better place.

## Installation

You can install the released version of ``onbrand`` from [CRAN](https://cran.r-project.org/package=onbrand) with:

``` r

install.packages("onbrand")

```

And the development version from [GitHub](https://github.com/john-harrold/onbrand) with:

``` r

# Installing devtools if it's not already installed

if(system.file(package="devtools") == ""){

  install.packages("devtools") 

}

devtools::install_github("john-harrold/onbrand", dependencies=TRUE)

```

## Getting Started  

Browse through the [documentation](https://onbrand.ubiquity.tools/) and check out the vignettes: 

1. [Custom Templates](https://onbrand.ubiquity.tools/articles/Custom_Office_Templates.html)

2. [Templated Workflows](https://onbrand.ubiquity.tools/articles/Creating_Templated_Office_Workflows.html)

These vignettes contain everything you need to walk through the basics.