5.3 KiB

Raw Blame History

hrbragg

Typography-centric Themes, Theme Components, and Utilities for ‘ggplot2’ and ‘ragg’.

Description

The ‘ragg’, ‘systemfonts’, and ‘textshaping’ packages make it possible to create plot components and themes that make full use of the rich typography features in modern fonts. Fonts, themes, and utilities are provided to create ‘ggplot2’ plots intended for rendering on ‘ragg’ graphics devices.

What’s Inside The Tin

The following functions are implemented:

adaptive_color: Adaptive colors colors for hrbragg themes
elb: Shortcut for element_blank
ell: Shortcut for element_line
elr: Shortcut for element_rect
elt: Shortcut for element_text
feature_dict: OpenType feature description lookup table
install_inter: Install Inter
inter_pkg: Inter Font Variant
opentype_typographic_features: OpenType Typographic Features
reconfigure_font: Create an complete, alternate font family with the same customized features
theme_inter: ggplot2 Theme Based On The Inter Font Family

Installation

remotes::install_git("https://git.rud.is/hrbrmstr/hrbragg.git")
# or
remotes::install_gitlab("hrbrmstr/hrbragg")
# or
remotes::install_bitbucket("hrbrmstr/hrbragg")

NOTE: To use the ‘remotes’ install options you will need to have the {remotes} package installed.

Usage

library(hrbragg)
library(ggplot2)

# current version
packageVersion("hrbragg")
## [1] '0.1.0'

For the moment, you’ll need to install Inter:

install_inter()

str(inter_pkg, 1)
## List of 16
##  $ ultralight       : chr "hrbragg-pkg Inter Thin"
##  $ ultralight_italic: chr "hrbragg-pkg Inter Thin Italic"
##  $ light            : chr "hrbragg-pkg Inter Extra Light"
##  $ light_italic     : chr "hrbragg-pkg Inter Extra Light Italic"
##  $ normal_italic    : chr "hrbragg-pkg Inter Light Italic"
##  $ normal           : chr "hrbragg-pkg Inter Light"
##  $ medium_italic    : chr "hrbragg-pkg Inter Medium Italic"
##  $ medium           : chr "hrbragg-pkg Inter Medium"
##  $ semibold_italic  : chr "hrbragg-pkg Inter Semi Bold Italic"
##  $ semibold         : chr "hrbragg-pkg Inter Semi Bold"
##  $ bold             : chr "hrbragg-pkg Inter Bold"
##  $ bold_italic      : chr "hrbragg-pkg Inter Bold Italic"
##  $ ultrabold        : chr "hrbragg-pkg Inter Extra Bold"
##  $ ultrabold_italic : chr "hrbragg-pkg Inter Extra Bold Italic"
##  $ heavy            : chr "hrbragg-pkg Inter Black"
##  $ heavy_italic     : chr "hrbragg-pkg Inter Black Italic"
##  - attr(*, "family")= chr "Inter"

ggplot() +
  geom_point(
    data = mtcars,
    aes(mpg, wt, color = factor(cyl))
  ) +
  geom_label(
    aes(
      x = 15, y = 5.48,
      label = "<- A fairly useless annotation\n       that uses the custom Inter\n          variant by default."
    ),
    label.size = 0, hjust = 0, vjust = 1
  ) +
  labs(
    x = "Fuel efficiency (mpg)", y = "Weight (tons)",
    title = "Seminal ggplot2 scatterplot example",
    subtitle = "A plot that is only useful for demonstration purposes",
    caption = "Brought to you by the letter 'g'"
  ) -> gg1

gg1 + theme_inter(grid = "XY", mode = "dark")

gg1 + theme_inter(grid = "XY", mode = "light")

ggplot() +
  geom_point(
    data = mpg,
    aes(displ, hwy, color = trans)
  ) +
  facet_wrap(
    vars(cyl, drv), scales = "free", drop = TRUE
  ) +
  labs(
    x = "Displacement", y = "Highway",
    title = "Another seminal ggplot2 scatterplot example",
    subtitle = "A plot that is only useful for demonstration purposes",
    caption = "Brought to you by the letter 'g'"
  ) -> gg2

gg2 + theme_inter(grid = "XY", mode = "light")

gg2 + theme_inter(grid = "XY", mode = "dark")

hrbragg Metrics

Lang	# Files	(%)	LoC	(%)	Blank lines	(%)	# Lines	(%)
R	13	0.46	332	0.43	89	0.39	646	0.47
Rmd	1	0.04	50	0.07	26	0.11	46	0.03
SUM	14	0.50	382	0.50	115	0.50	692	0.50

clock Package Metrics for hrbragg

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

5.3 KiB Raw Blame History