https://github.com/calligross/ggthemeassist

A RStudio addin for ggplot2 theme tweaking
https://github.com/calligross/ggthemeassist

Last synced: 3 days ago
JSON representation

A RStudio addin for ggplot2 theme tweaking

• Host: GitHub
• URL: https://github.com/calligross/ggthemeassist
• Owner: calligross
• Created: 2016-02-20T09:57:16.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-06-15T06:28:14.000Z (over 5 years ago)
• Last Synced: 2023-11-20T16:01:34.390Z (12 months ago)
• Language: R
• Homepage:
• Size: 7.52 MB
• Stars: 476
• Watchers: 16
• Forks: 43
• Open Issues: 19
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
ggThemeAssist

==============

[![Build Status](https://travis-ci.org/calligross/ggthemeassist.svg?branch=master)](https://travis-ci.org/calligross/ggthemeassist)

[![CRAN](http://www.r-pkg.org/badges/version/ggThemeAssist)](http://cran.rstudio.com/package=ggThemeAssist) [![Downloads](http://cranlogs.r-pkg.org/badges/ggThemeAssist?color=brightgreen)](http://www.r-pkg.org/pkg/ggThemeAssist)

[![saythanks](https://img.shields.io/badge/say-thanks-ff69b4.svg)](https://saythanks.io/to/calligross)

**ggThemeAssist** is a RStudio-Addin that uses the [`rstudioapi`](https://github.com/rstudio/rstudioapi) package and provides a GUI for editing [`ggplot2`](https://github.com/hadley/ggplot2) themes. 

For a full list of features see [`NEWS`](./NEWS.md).

Installation

------------

Please be aware that you need the **most recent (stable) release of RStudio** (v0.99.878 or later). Additionally, **ggThemeAssist** depends on [`shiny`](https://github.com/rstudio/shiny) and [`miniUI`](https://github.com/rstudio/miniUI).

#### Install from Github

You can install the latest version of **ggThemeAssist** from Github using the [`devtools`](https://github.com/hadley/devtools) package:

```r

if (!requireNamespace("devtools", quietly = TRUE))

  install.packages("devtools")

devtools::install_github("calligross/ggthemeassist")

```

#### Install from CRAN

The stable version of **ggThemeAssist**, v0.1.4, is available on CRAN:

```r

install.packages("ggThemeAssist")

```

Usage

------------

After installing, **ggThemeAssist** is available in the Addins menu within RStudio.

To edit `ggplot2` themes, just highlight a `ggplot2` object in your current script and run the Addin from the Addins menu. **ggplot2** will analyze your current plot, update its defaults to your current specification and give you a preview. Use the input widgets to get your ideas into shape. After terminating **ggThemeAssist** a character string containing your desired changes in standard `ggplot2` notation is inserted in your script. Re-running your script now produces the plot you just configured using **ggThemeAssist**.

[Click to enlarge](https://raw.githubusercontent.com/calligross/ggthemeassist/master/examples/ggThemeAssist2.gif)

![Screenshot](examples/ggThemeAssist2.gif)