A generic/base ggplot2 theme for the paleta package

This generic/base ggplot2 theme is the template from which all other themes in the paleta package is built on. This theme is inspired by Bob Rudis' hrbrthemes package drawing heavily on its typography-centric focus.

Usage

theme_paleta(
  base_family = set_paleta_font(),
  base_size = 11.5,
  plot_title_family = base_family,
  plot_title_size = 16,
  plot_title_face = "bold",
  plot_title_colour = NULL,
  plot_title_margin = 10,
  subtitle_family = base_family,
  subtitle_size = 12,
  subtitle_face = "plain",
  subtitle_colour = NULL,
  subtitle_margin = 15,
  strip_text_family = base_family,
  strip_text_size = 12,
  strip_text_face = "plain",
  caption_family = base_family,
  caption_size = 9,
  caption_face = "italic",
  caption_colour = NULL,
  caption_margin = 10,
  axis_text_size = base_size,
  axis_title_family = subtitle_family,
  axis_title_size = 9,
  axis_title_colour = NULL,
  axis_title_face = "plain",
  axis_title_just = "rt",
  legend_title_family = subtitle_family,
  legend_title_colour = NULL,
  legend_text_family = subtitle_family,
  legend_text_colour = NULL,
  plot_margin = ggplot2::margin(30, 30, 30, 30),
  plot_background_fill = NULL,
  grid_col = NULL,
  grid = TRUE,
  axis_col = NULL,
  axis = FALSE,
  ticks = FALSE
)

Arguments

base_family: Base font family using Africa CDC fonts. Default is set by what Africa CDC font is available in the system via set_paleta_font().
base_size: Base font size. Default is 11.5.
plot_title_family: Font family to use for the plot title. Default is base_family.
plot_title_size: Plot title text size in pts. Default is 16.
plot_title_face: Font face ("plain", "italic", "bold", "bold.italic") for plot title. Default is "bold".
plot_title_colour: Colour of the plot title text. Default is acdc_green.
plot_title_margin: Margin at the bottom of the plot title. Default set at 10.
subtitle_family: Font family to use for the plot subtitle. Default is base_family.
subtitle_size: Plot subtitle text size in pts. Default is 12.
subtitle_face: Font face ("plain", "italic", "bold", "bold.italic") for plot subtitle. Default is "plain".
subtitle_colour: Colour of the subtitle text. Default is NULL to use default ggplot2 colour.
subtitle_margin: Margin at the bottom of the plot subtitle. Default set at 15.
strip_text_family: Font family to use for the facet label. Default is base_family.
strip_text_size: Facet label text size in pts. Default is 12.
strip_text_face: Font face ("plain", "italic", "bold", "bold.italic") for facet label. Default is "plain".
caption_family: Font family to use for the caption text. Default is base_family.
caption_size: Caption text size in pts. Default is 9.
caption_face: Font face ("plain", "italic", "bold", "bold.italic") for caption text. Default is "plain".
caption_colour: Colour of the caption text. Default is NULL.
caption_margin: Margin at the top of the plot caption text. Default is set at 10.
axis_text_size: Axis text size in pts. Default is base_size.
axis_title_family: Font family to use for the axis title. Default is subtitle_family.
axis_title_size: Axis title text size in pts. Default is 9.
axis_title_colour: Colour of the axis title text. Default is NULL to use default ggplot2 colour.
axis_title_face: Font face ("plain", "italic", "bold", "bold.italic") for axis title. Default is "plain".
axis_title_just: Axis title font justification, one of "bl" (bottom-left), "m" (middle), "rt" (right-top). Default is "rt".
legend_title_family: Font family to use for the legend title. Default is subtitle_family.
legend_title_colour: Colour of the legend title text. Default is NULL.
legend_text_family: Font family to use for the legend text. Default is subtitle_family.
legend_text_colour: Colour of the legend text. Default is NULL.
plot_margin: Plot margins (specify with ggplot2::margin()).
plot_background_fill: Fill colour for the plot background. Default is NULL.
grid_col: Grid colour. Default to NULL.
grid: Panel grid. Either TRUE, FALSE, or a combination of X (major x grid), x (minor x grid), Y (major y grid), and/or y (minor y grid). Default is TRUE.
axis_col: Axis colours. Default to NULL.
axis: Add x or y axes? TRUE, FALSE, "xy". Default is FALSE.
ticks: Logical. Should ticks be added? Default is FALSE.

Value

A ggplot2 theme.

Details

This function uses either of three fonts - Roboto Condensed, Noto Sans, or Roboto (in this specific order) - depending on what is available in the user's system. Roboto Condensed, Noto Sans, and Roboto - all Google fonts - are freely downloadable and easily installed on any system. If any of these fonts is not available in your system, download and install either/all Roboto Condensed, Noto Sans and/or Roboto from Google Fonts.