From a94125692789e0a07ec8846548f7d03be0c0a59c Mon Sep 17 00:00:00 2001 From: Edward Visel Date: Fri, 11 Feb 2022 23:43:29 +0000 Subject: [PATCH] Spellcheck, fix docs for R CMD check, rebuild pkgdown --- DESCRIPTION | 2 +- R/econ-sans.R | 6 +- R/flush-ticks.R | 4 +- R/goldmansans.R | 6 +- R/inter.R | 8 +- R/ipsum.r | 2 +- R/plexsans.R | 6 +- R/public-sans.R | 6 +- R/roboto-condensed.r | 6 +- R/scales.r | 4 +- R/tinyhand.R | 4 +- R/titillium-web.R | 6 +- README.Rmd | 4 +- README.md | 2 +- _pkgdown.yml | 1 + docs/404.html | 115 ++++ docs/CONDUCT.html | 108 +--- docs/LICENSE-text.html | 106 +--- docs/articles/index.html | 109 +--- docs/articles/why_hrbrthemes.html | 116 ++-- .../figure-html/unnamed-chunk-1-1.png | Bin 112507 -> 68961 bytes docs/authors.html | 220 +++---- docs/bootstrap-toc.css | 60 ++ docs/bootstrap-toc.js | 159 +++++ docs/index.html | 576 ++++++++++-------- docs/news/index.html | 239 +++----- docs/pkgdown.css | 250 ++++++-- docs/pkgdown.js | 28 +- docs/pkgdown.yml | 8 +- docs/reference/ArialNarrow.html | 130 +--- docs/reference/EconSansCondensed.html | 114 ++++ docs/reference/GoldmanSans.html | 97 +++ docs/reference/Inter.html | 127 ++++ docs/reference/PlexSans.html | 143 ++--- docs/reference/PublicSans.html | 117 ++++ docs/reference/RobotoCondensed.html | 143 ++--- docs/reference/Rplot001.png | Bin 0 -> 1011 bytes docs/reference/TinyHand.html | 97 +++ docs/reference/TitilliumWeb.html | 148 ++--- docs/reference/figures/README-an-1.png | Bin 0 -> 26372 bytes docs/reference/figures/README-ax1-1.png | Bin 0 -> 28127 bytes docs/reference/figures/README-ax2-1.png | Bin 0 -> 43223 bytes docs/reference/figures/README-ax3-1.png | Bin 0 -> 32405 bytes docs/reference/figures/README-ft-1.png | Bin 0 -> 24118 bytes docs/reference/figures/README-ps-1.png | Bin 0 -> 60724 bytes docs/reference/figures/README-rc-1.png | Bin 0 -> 24800 bytes docs/reference/figures/README-sc-1.png | Bin 0 -> 26647 bytes docs/reference/figures/README-sp-1.png | Bin 0 -> 17581 bytes docs/reference/figures/README-tw-1.png | Bin 0 -> 60486 bytes docs/reference/flush_ticks.html | 184 ++---- docs/reference/ft_cols.html | 143 ++--- docs/reference/ft_geom_defaults.html | 122 +--- docs/reference/ft_pal-1.png | Bin 59290 -> 35458 bytes docs/reference/ft_pal.html | 134 ++-- docs/reference/gg_check-1.png | Bin 67262 -> 43790 bytes docs/reference/gg_check.html | 208 +++---- docs/reference/hrbrthemes-exports.html | 120 +--- docs/reference/hrbrthemes.html | 140 ++--- docs/reference/import_econ_sans.html | 107 ++++ docs/reference/import_goldman_sans.html | 109 ++++ docs/reference/import_inter.html | 109 ++++ docs/reference/import_plex_sans.html | 140 ++--- docs/reference/import_public_sans.html | 109 ++++ docs/reference/import_roboto_condensed.html | 140 ++--- docs/reference/import_tinyhand.html | 107 ++++ docs/reference/import_titillium_web.html | 140 ++--- docs/reference/index.html | 299 ++++----- docs/reference/ipsum.html | 291 ++++----- docs/reference/ipsum_pal-1.png | Bin 62203 -> 40708 bytes docs/reference/ipsum_pal.html | 134 ++-- docs/reference/ipsum_pdf.html | 147 ++--- docs/reference/modern_geom_defaults.html | 122 +--- docs/reference/scale_ft.html | 228 +++---- docs/reference/scale_ipsum.html | 228 +++---- docs/reference/scale_x_percent.html | 364 ++++++----- docs/reference/theme_ipsum.html | 352 +++++------ docs/reference/theme_ipsum_es.html | 209 +++++++ docs/reference/theme_ipsum_gs.html | 204 +++++++ docs/reference/theme_ipsum_inter.html | 204 +++++++ docs/reference/theme_ipsum_ps.html | 355 +++++------ docs/reference/theme_ipsum_pub.html | 206 +++++++ docs/reference/theme_ipsum_rc.html | 451 ++++++-------- docs/reference/theme_ipsum_tw.html | 358 +++++------ docs/reference/theme_tinyhand.html | 171 ++++++ docs/reference/update_geom_font_defaults.html | 143 ++--- docs/sitemap.xml | 153 +++++ man/flush_ticks.Rd | 4 +- man/ipsum.Rd | 7 +- man/scale_ft.Rd | 9 +- man/scale_ipsum.Rd | 9 +- man/scale_x_percent.Rd | 4 +- man/theme_ipsum_es.Rd | 6 +- man/theme_ipsum_gs.Rd | 6 +- man/theme_ipsum_inter.Rd | 8 +- man/theme_ipsum_ps.Rd | 6 +- man/theme_ipsum_pub.Rd | 6 +- man/theme_ipsum_rc.Rd | 6 +- man/theme_ipsum_tw.Rd | 6 +- man/theme_tinyhand.Rd | 4 +- vignettes/why_hrbrthemes.R | 17 + vignettes/why_hrbrthemes.Rmd | 4 +- vignettes/why_hrbrthemes.html | 341 +++++++++++ 102 files changed, 5790 insertions(+), 4561 deletions(-) create mode 100644 _pkgdown.yml create mode 100644 docs/404.html create mode 100644 docs/bootstrap-toc.css create mode 100644 docs/bootstrap-toc.js create mode 100644 docs/reference/EconSansCondensed.html create mode 100644 docs/reference/GoldmanSans.html create mode 100644 docs/reference/Inter.html create mode 100644 docs/reference/PublicSans.html create mode 100644 docs/reference/Rplot001.png create mode 100644 docs/reference/TinyHand.html create mode 100644 docs/reference/figures/README-an-1.png create mode 100644 docs/reference/figures/README-ax1-1.png create mode 100644 docs/reference/figures/README-ax2-1.png create mode 100644 docs/reference/figures/README-ax3-1.png create mode 100644 docs/reference/figures/README-ft-1.png create mode 100644 docs/reference/figures/README-ps-1.png create mode 100644 docs/reference/figures/README-rc-1.png create mode 100644 docs/reference/figures/README-sc-1.png create mode 100644 docs/reference/figures/README-sp-1.png create mode 100644 docs/reference/figures/README-tw-1.png create mode 100644 docs/reference/import_econ_sans.html create mode 100644 docs/reference/import_goldman_sans.html create mode 100644 docs/reference/import_inter.html create mode 100644 docs/reference/import_public_sans.html create mode 100644 docs/reference/import_tinyhand.html create mode 100644 docs/reference/theme_ipsum_es.html create mode 100644 docs/reference/theme_ipsum_gs.html create mode 100644 docs/reference/theme_ipsum_inter.html create mode 100644 docs/reference/theme_ipsum_pub.html create mode 100644 docs/reference/theme_tinyhand.html create mode 100644 docs/sitemap.xml create mode 100644 vignettes/why_hrbrthemes.R create mode 100644 vignettes/why_hrbrthemes.html diff --git a/DESCRIPTION b/DESCRIPTION index 42eb2bc..8622172 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -58,5 +58,5 @@ Imports: tools, magrittr, gdtools -RoxygenNote: 7.1.1 +RoxygenNote: 7.1.2 VignetteBuilder: knitr diff --git a/R/econ-sans.R b/R/econ-sans.R index 81f21e5..b291aaf 100644 --- a/R/econ-sans.R +++ b/R/econ-sans.R @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_econ_sans()] first and also install the fonts on your #' system before trying to use this theme. @@ -15,13 +15,13 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param panel_spacing panel spacing (use `unit()`) diff --git a/R/flush-ticks.R b/R/flush-ticks.R index f33f489..f52adee 100644 --- a/R/flush-ticks.R +++ b/R/flush-ticks.R @@ -1,11 +1,11 @@ #' Makes axis text labels flush on the ends #' -#' A covenience function intended for basic, fixed-scale plots only (i.e. does not handle +#' A convenience function intended for basic, fixed-scale plots only (i.e. does not handle #' free scales in facets).\cr #' \cr #' You need to pass in a ggplot2 object to this function. It can't be `+`'d in a chain #' of geoms, coords, scales, themes, etc. It also builds the plot (but does not display -#' it) so if the plt takes a while (i.e. has lots of data or transforms) this will also +#' it) so if the plot takes a while (i.e. has lots of data or transforms) this will also #' take a while. #' #' @md diff --git a/R/goldmansans.R b/R/goldmansans.R index 3a06772..7f7ef12 100644 --- a/R/goldmansans.R +++ b/R/goldmansans.R @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_goldman_sans()] first and also install the fonts on your #' system before trying to use this theme. @@ -14,13 +14,13 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param grid_col grid color diff --git a/R/inter.R b/R/inter.R index 5cb309c..dbaa944 100644 --- a/R/inter.R +++ b/R/inter.R @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_inter()] first and also install the fonts on your #' system before trying to use this theme. @@ -14,14 +14,14 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin +#' @param axis_text_family,axis_text_face,axis_text_size axis text font family, face, and size #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` -#' @param axis_text_size font size of axis text +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param grid_col grid color #' @param grid panel grid (`TRUE`, `FALSE`, or a combination of `X`, `x`, `Y`, `y`) diff --git a/R/ipsum.r b/R/ipsum.r index af5fa52..5867fbe 100644 --- a/R/ipsum.r +++ b/R/ipsum.r @@ -6,6 +6,7 @@ #' @param toc,toc_depth TOC params #' @param extra_dependencies,... Additional function arguments to pass to the #' base R Markdown HTML output formatter +#' @param smart Deprecated #' @export ipsum <- function(number_sections = FALSE, fig_width = 7, @@ -90,7 +91,6 @@ ipsum <- function(number_sections = FALSE, clean_supporting = self_contained, pre_processor = pre_processor, base_format = rmarkdown::html_document_base( - smart = smart, theme = theme, self_contained = self_contained, lib_dir = lib_dir, diff --git a/R/plexsans.R b/R/plexsans.R index 860b7c7..8aee0f8 100644 --- a/R/plexsans.R +++ b/R/plexsans.R @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_plex_sans()] first and also install the fonts on your #' system before trying to use this theme. @@ -15,13 +15,13 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param grid_col grid color diff --git a/R/public-sans.R b/R/public-sans.R index d854b23..a7a94e0 100644 --- a/R/public-sans.R +++ b/R/public-sans.R @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_public_sans()] first and also install the fonts on your #' system before trying to use this theme. @@ -15,13 +15,13 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param grid_col grid color diff --git a/R/roboto-condensed.r b/R/roboto-condensed.r index 14ae83d..f3686a8 100644 --- a/R/roboto-condensed.r +++ b/R/roboto-condensed.r @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_roboto_condensed()] first and also install the fonts on your #' system before trying to use this theme. @@ -15,13 +15,13 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param panel_spacing panel spacing (use `unit()`) diff --git a/R/scales.r b/R/scales.r index 5cd399f..b22b281 100644 --- a/R/scales.r +++ b/R/scales.r @@ -3,11 +3,11 @@ is.waive <- function (x) { inherits(x, "waiver") } is.sec_axis <- function (x) { inherits(x, "AxisSecondary") } is.formula <- function (x) { inherits(x, "formula") } -#' X & Y scales with opinionated pre-sets for percent & comma label formats +#' X & Y scales with opinionated presets for percent & comma label formats #' #' The `_comma` ones set comma format for axis text and `expand=c(0,0)` (you need to set limits). #' -#' The `_percent` ones set precent format for axis text and `expand=c(0,0)` (you need to set limits). +#' The `_percent` ones set percent format for axis text and `expand=c(0,0)` (you need to set limits). #' #' @md #' @param name The name of the scale. Used as axis or legend title. If diff --git a/R/tinyhand.R b/R/tinyhand.R index 546e5d1..08dab22 100644 --- a/R/tinyhand.R +++ b/R/tinyhand.R @@ -24,13 +24,13 @@ font_th <- "BFTinyHand-Regular" #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param grid_col grid color diff --git a/R/titillium-web.R b/R/titillium-web.R index b4db023..cc09aae 100644 --- a/R/titillium-web.R +++ b/R/titillium-web.R @@ -1,4 +1,4 @@ -#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typoghraphy +#' A precise & pristine [ggplot2] theme with opinionated defaults and an emphasis on typography #' #' You should [import_titillium_web()] first and also install the fonts on your #' system before trying to use this theme. @@ -15,13 +15,13 @@ #' #' @md #' @param base_family,base_size base font family and size -#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot tilte family, face, size and margin +#' @param plot_title_family,plot_title_face,plot_title_size,plot_title_margin plot title family, face, size and margin #' @param subtitle_family,subtitle_face,subtitle_size plot subtitle family, face and size #' @param subtitle_margin plot subtitle margin bottom (single numeric value) #' @param strip_text_family,strip_text_face,strip_text_size facet label font family, face and size #' @param caption_family,caption_face,caption_size,caption_margin plot caption family, face, size and margin #' @param axis_title_family,axis_title_face,axis_title_size axis title font family, face and size -#' @param axis_title_just axis title font justificationk one of `[blmcrt]` +#' @param axis_title_just axis title font justification; one of `[blmcrt]` #' @param axis_text_size font size of axis text #' @param plot_margin plot margin (specify with [ggplot2::margin]) #' @param grid_col grid color diff --git a/README.Rmd b/README.Rmd index 99e86f9..16ac3a2 100644 --- a/README.Rmd +++ b/README.Rmd @@ -34,7 +34,7 @@ Themes: - `theme_ipsum_rc`: Roboto Condensed - `theme_ipsum_ps`: IBM Plex Sans font - `theme_ipsum_pub`: Public Sans -- `theme_ipsum_tw`: Titilium Web +- `theme_ipsum_tw`: Titillium Web - `theme_modern_rc`: Roboto Condensed dark theme - `theme_ft_rc`: Dark theme based on FT's dark theme (Roboto Condensed) @@ -273,4 +273,4 @@ cloc::cloc_pkg_md() ### 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. \ No newline at end of file +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. diff --git a/README.md b/README.md index 69004ae..6f31337 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ Themes: - `theme_ipsum_rc`: Roboto Condensed - `theme_ipsum_ps`: IBM Plex Sans font - `theme_ipsum_pub`: Public Sans - - `theme_ipsum_tw`: Titilium Web + - `theme_ipsum_tw`: Titillium Web - `theme_modern_rc`: Roboto Condensed dark theme - `theme_ft_rc`: Dark theme based on FT’s dark theme (Roboto Condensed) diff --git a/_pkgdown.yml b/_pkgdown.yml new file mode 100644 index 0000000..ed67985 --- /dev/null +++ b/_pkgdown.yml @@ -0,0 +1 @@ +url: https://cinc.rud.is/web/packages/hrbrthemes diff --git a/docs/404.html b/docs/404.html new file mode 100644 index 0000000..ce75fbf --- /dev/null +++ b/docs/404.html @@ -0,0 +1,115 @@ + + + + + + + +Page not found (404) • hrbrthemes + + + + + + + + + + + +
+
+ + + + +
+
+
+

Page not found (404)

+
+ +Content not found. Please use links in the navbar. + +
+ + + +
+ + + +
+

+

Developed by Bob Rudis.

+
+ +
+

+

Site built with pkgdown 2.0.2.9000.

+
+ +
+
+ + + + + + + + diff --git a/docs/CONDUCT.html b/docs/CONDUCT.html index b4149fa..a2279d5 100644 --- a/docs/CONDUCT.html +++ b/docs/CONDUCT.html @@ -1,55 +1,12 @@ - - - - - - - -Contributor Code of Conduct • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Contributor Code of Conduct • hrbrthemes - + + - - -
-
- -
-
+

Contributor Code of Conduct

@@ -121,27 +63,33 @@

Contributor Code of Conduct

Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.

-

This Code of Conduct is adapted from the Contributor Covenant (http:contributor-covenant.org), version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/

+

This Code of Conduct is adapted from the Contributor Covenant (http:contributor-covenant.org), version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/

+ +
-
-
-

Developed by Bob Rudis.

+ +
+

Developed by Bob Rudis.

-

Site built with pkgdown 1.2.0.

+

Site built with pkgdown 2.0.2.9000.

-
-
+ +
+ + + - - + diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html index 533b95e..ab74552 100644 --- a/docs/LICENSE-text.html +++ b/docs/LICENSE-text.html @@ -1,55 +1,12 @@ - - - - - - - -License • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -License • hrbrthemes - + + - - -
-
- -
-
+

License

@@ -120,22 +62,28 @@

License

+ +
-
-
-

Developed by Bob Rudis.

+ +
+

Developed by Bob Rudis.

-

Site built with pkgdown 1.2.0.

+

Site built with pkgdown 2.0.2.9000.

-
-
+ +
+ + + - - + diff --git a/docs/articles/index.html b/docs/articles/index.html index 647bb69..bac5bd2 100644 --- a/docs/articles/index.html +++ b/docs/articles/index.html @@ -1,55 +1,12 @@ - - - - - - - -Articles • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Articles • hrbrthemes - + + - - -
-
- -
-
+

Articles

@@ -118,26 +60,27 @@

Articles

All vignettes

- -
+
Why hrbrthemes?
+
+
-
-
-

Developed by Bob Rudis.

+ +
+

Developed by Bob Rudis.

-

Site built with pkgdown 1.2.0.

+

Site built with pkgdown 2.0.2.9000.

-
-
+ +
+ + + - - + diff --git a/docs/articles/why_hrbrthemes.html b/docs/articles/why_hrbrthemes.html index e112614..47fb5e1 100644 --- a/docs/articles/why_hrbrthemes.html +++ b/docs/articles/why_hrbrthemes.html @@ -6,18 +6,21 @@ Why hrbrthemes? • hrbrthemes - - - + + + + + - - + - + + +
-

Why hrbrthemes?

-

Bob Rudis

+

Why hrbrthemes?

+

Bob Rudis

-

2019-02-07

+

2022-02-11

- Source: vignettes/why_hrbrthemes.Rmd + Source: vignettes/why_hrbrthemes.Rmd
@@ -94,9 +92,9 @@

2019-02-07

The hrbrthemes package has two goals. First, it provides a base theme that focuses on typographic elements, including where various labels are placed as well as the fonts that are used. The second goal centers around productivity for a production workflow. In fact, this “production workflow” is the context for where the elements of hrbrthemes should be used.

A “production workflow” is when you intend for the output of your work to be put into a publication of some kind, whether it be a blog post, academic paper, presentation, internal report or industry publication. When you’re cranking through an analysis, the visual elements don’t need to be perfect. They are there to validate/support your work and are more of a starting point for the finished product than anything else. The level of attention to detail on the final graphical products can be a great motivator for your audience to either dive deep into your analysis text or relegate it to the TLDR pile.

-
-

-Font Fundamentals

+
+

Font Fundamentals +

There are nigh countless tomes written about the colors you should consider using in charts as well as how to produce “minimal” charts (i.e. eliminate “chart junk”). One area that is rarely discussed is the use of fonts in charts (i.e. chart typography). The hrbrthemes package is very opinionated about chart typography:

  • The font family used should be sans-serif typeface
    • @@ -107,26 +105,26 @@

  • Ideally, the font family used will have 100, 300, 500, 700 and 900 weights vs regular, bold, italic and bold italic
  • Because we’re working in ggplot2-land, the font family used should also be a TrueType font (TTF)

-
-

-Why sans-serif?

+
+

Why sans-serif? +

To use a gross oversimplification, there are two basic font types: Serif and Sans-serif (that’s a lie of convenience, there are more than two). hrbrthemes suggests using sans-serif fonts since they have a more “modern” feel to them, you’re not producing long-form text and labels on charts may need to scale down to small sizes. Typography nerds on either side of the serif vs sans-serif debate can point to 100+ years of research-based evidence supporting their particular “side”.

You can compare the typography in the two (non-hrbrthemes) charts below to see if you prefer sans-serif over serif:

If you work in a company, your communications department likely has a set of core brand fonts and said font groups likely contain both serif and sans-serif and you should strive to keep with the brand image and use whatever font(s) work best or work with your comms team to pick a standard, complementary font for the charts you produce.

-
-

-Kern-what?

-

Kerning is nothing more than a fancy word for spaces between letters and fonts have built-in tables for how various pairs of letters should be placed next to each other. Great fonts have kerning tables that typography nerds immediately recognize and adore. Fonts with poor kerning tables are easily recognized as such by even the least font-aware viewer.

+
+

Kern-what? +

+

Kerning is nothing more than a fancy word for spaces between letters and fonts have built-in tables for how various pairs of letters should be placed next to each other. Great fonts have kerning tables that typography nerds immediately recognize and adore. Fonts with poor kerning tables are easily recognized as such by even the least font-aware viewer.

-


https://www.xkcd.com/1015/

+


https://www.xkcd.com/1015/

Bad kerning will be a distraction from the chart contents. Great kerning will be a subconscious reinforcement of just how awesome your visualizations are.

-
-

-Tabula Figura

+
+

Tabula Figura +

Tabular digits line up when placed on top of each other. Proportional ones do not. This is best explained visually:

@@ -134,16 +132,16 @@

Can you spot the proportional digits from the tabular ones? (Hint: there are two of each.)

Proportional digits stand out (in a “yes, I just spilled sriracha on my white shirt” way) when used on the Y axis of a chart and the numeric labels contain numbers of varying widths (like Hind and Encode Sans Condensed in the example above). Using proportional digits will be one further, subtle, subliminal message to viewers that there is something not-quite-awesome about your creation.

-
-

-Clean and compact

-

The figure used in the previous section provided an example of condensed/narrow fonts and regular. Chart space is at a premium and it’s important to label and annotate your creations (sparingly but sufficiently). Choosing a font that is too wide will reduce your available space and also make it harder to read the text. Choosing a font that is too narrow/compressed/condensed will create different legiibility problems.

+
+

Clean and compact +

+

The figure used in the previous section provided an example of condensed/narrow fonts and regular. Chart space is at a premium and it’s important to label and annotate your creations (sparingly but sufficiently). Choosing a font that is too wide will reduce your available space and also make it harder to read the text. Choosing a font that is too narrow/compressed/condensed will create different legibility problems.

NOTE: It’s really hard to find a free condensed/narrow font with great kerning pairs and tabular digits. Such is the way of things.

(As an aside, the default line-height for Hind and M+ 1c is also sub-optimal and would require tweaking in ggplot2 calls to correct.)

-
-

-Weight. What?

+
+

Weight. What? +

Most fonts (and, more importantly, most free fonts) come in regular, italic, bold and bold italic (which I can’t bring myself to code in here). You really want to avoid italic and bold italic, especially at very small or very large sizes. Bold should be used sparingly as it draws the eye to that text.

Ideally, you’d use a font with a broad diversity of weights. The term weight can be though of as a numeric scale (the one used here was introduced by TrueType) between 100 and 900 (usually at 100 or 200 increments) or with names ranging from “hairline” through “ultra-black”.

Take Open Sans, for example:

@@ -152,46 +150,48 @@

There is plenty of room to work with in Open Sans. You can embolden the title, but mute the other labels and choose appropriate label fonts to both enhance style as well as reduce importance. Lighter weights are great for captions and even some direct annotations. Heaver weights should be used sparingly and for emphasis.

-
-

-TTF. Meh.

-

I’ll use another over-simplification and state that there two main font types: OTF and TTF (it’s another lie of convenience). OTF (OpenType) is more modern and flexible. TTF (TrueType) has been around longer and was a precursor to OTF. If you make PDFs or PostScript files from R you pretty much need to use TTF fonts due to the underlying tooling that it relies on. If you are making PNGs or SVGs you can likely use OTF but most communciations teams and publications want PDFs.

+
+

TTF. Meh. +

+

I’ll use another over-simplification and state that there two main font types: OTF and TTF (it’s another lie of convenience). OTF (OpenType) is more modern and flexible. TTF (TrueType) has been around longer and was a precursor to OTF. If you make PDFs or PostScript files from R you pretty much need to use TTF fonts due to the underlying tooling that it relies on. If you are making PNGs or SVGs you can likely use OTF but most communications teams and publications want PDFs.

-
-

-Spacing Out

+
+

Spacing Out +

Label/title placement is also important, as is the distance between those elements. Put text bits too close to each other or too far apart from each other will send negative subliminal messages. Centering vs left- or right-justification will also convey other messages (old-school vs modern, to put it somewhat bluntly).

hrbrthemes makes opinionated choices over the spacing between title elements and all labels. For some elements, it makes very new choices (such as the justification of the axis labels).

The font choices you make may cause you to adjust the hrbrthemes defaults, especially if you choose a font with a wonky line-height.

- +
-

Developed by Bob Rudis.

+

+

Developed by Bob Rudis.

-

Site built with pkgdown 1.2.0.

+

+

Site built with pkgdown 2.0.2.9000.

+
+ + + diff --git a/docs/articles/why_hrbrthemes_files/figure-html/unnamed-chunk-1-1.png b/docs/articles/why_hrbrthemes_files/figure-html/unnamed-chunk-1-1.png index 58989a70ffb17e589e8653a3832ed5b609697b7a..64dbcecc2eeb1dbe1bd66d0ce09d9be157c97946 100644 GIT binary patch literal 68961 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 SDDNLzY0tP?wb8AREa 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 literal 112507 zcmeFZhgXx^xBeTdpcEBpB3(gx2?EmDDu@J75TqA@0MdI8RZyx3gkD67^eVkcBnSi$ zkluvQTj(tW?weii?|%0^_nbfAo-s0_8G+<|=UQv7IiKgVc>i2oneyuGs~`}FQswDm zO%R9__%D$e8U7!3m=hQTB4)IC^yseT5;a(*Rm6P>-I&S@*ZWpj@YM~#(VBk@d7&-`nZ}+3p`wPs!B?C0@NZ`HStoT+K8DpOnE8wfA%x-@*F3)(%suMx zHJKQhxyUN5Q(~rNb7p;Az5M0cyI6vq0_|Q80-v)uR{3>(mZR6Jbs`Gig?#Gg&BqX~ za6~oA*51GN&hIIBTHFnJ(ht+Kspa`MFpmvO zrmhsVX62TCjbMkZgo^L;F9^IFkXY%_`Ziu%6yKTt&EtFB1O2@{Y2xqLxiZZD|>2!8xbWgvt$vd>=~P^F-k_{FM9w{aGvnSJ@VI?^SuT#vN)MO3uLq(H;^ z#_5aBetN$wzqjJWK>@9l)#N1ilZC@uuBz!0-LSZ?KsrY^Ze18cMJjr$^cG`;$tNg1 z(@ML{o>War-?!F|go__POhQiU`)hbD!sUYLs&1dhl+X=Z?iRl_G^de=@kOVC(-8dIL;yZtn`#WIq)oz_jmp-bg z3WC_Q({=UKzHLv6rrQ}z>3rYGyzjib_=;Ky2JcQ;DL*ih(Q_1}QYuLzIeT-e!>Atp zxa1(@AiRdZh1>r=4%yP@-{ars-|zp;h%ipNHv`=|FX+VTYJxm^vwvHE&X>-cq0VXz zZd>w*ny9;vETR&`Umn-L+W*9nsIjDJb6rbXi>9#hmm+m|b-qWo zJt6j-d8E*xN^^b4eAb^(Z&=DboxtVLu=-)>`3{_WDdD znAwBagEY}5Y8nGU<#a4Xd#n8JCRT7ErUnGR6ByLR>A*11b7hu9azAvkYU&$v+*7}6 zzkeNX9<`l`dcknN)~3I^maGT_ewC2UXq&^hjmjxp7K5y!0|>IS{IrP-uVFwS1(3>P z#g|?Ln;GQOPafeeyYzE5L#?Y59#q}+eFEpGqP2WA`gkE}M@auA*$en%jvKU9s_@M` zew(<`9Dd8boBfyA%(Kkp%$0O(y6-^Cal?SW+`f|Nl0`)Gf9BiSR@ z$!1}UXEbqtY$dnv56H8YH7uv@pjj^^r=1X#^Kb))HOVL`>hleg%d7I(iGdF9l??iR z`O9-%7LReWaH&{zA9>!(_zPNIqQ3{|CkPPI* zv{kz^5O4wJvWt5{M-F`5<<31#o+7p1^lc|kymr1_`FuI@%0w0=jcNXxwe<^akjQiNzM^q2*8u}lO5X{SLQ#yJ*sz09f<;z-IMwZsi-frDXEPqV$ z=*?lk!h7y8X3y!$G&b%LFc67#cb>|BBJqkaN>6;kB3_1yI8Icv$C+ZOd(yU?S+MPV zFS!;SBQ3aD)hqZYMg3k8OVDxKC2l_Wn&7)kp_YT8cI;Nt)SKec4o0i=8zJ)NI|#(A zFJ`9vOPG}5$fr***=Olw5Ea5y0%39!>}}hU8z+cHKj8MR9Z$PzWJV&Wr1>|i2jos2 zGawW}ubLNV&AyS)qe?UAjJ@XHtGs({&t7r9*Lx*Fggf2ok8#`bmW37=3Z?s|Fs}oD zAx^+_2^XlFuF8w4y=(nA;LCaJYNU4UzvkR+8ZY4PbIek&gzk>l48M8nurhdXzg3NV z{q)6MHj?(cu;O72d4I3trnwmoLqpFQcW&nxCB8L!V=ptwt(xJ5n+jy1OI(?O8WL6> zQGB2;$}Ju&TwrG%1N*OVsmYD{um{bJOIa$`o^$@5raldZ{)7uUS&4oT|IggmE_}ml zy|91~e0SRH2hW%^;lh+O{Hl!`*@5xi11USMC+f?owqU6Sy=v8%iSVup3G2pUtdyN2<0y`DeAQ)10io zYD>isRIKJijs`rJ1K!~v7-6R+zHvRsj1#!!ik3L4VKf|hF)lU?K^I5?m->tCC#Dcy z6h9&q)WSd|wVJ&H)bC}J@!L`CY!2ohR)hb^_zKkI&0F@48)nv5pAqM?5R7~(Jnm04 zzro-^sBd96KKEgWn~>w@E5e&Uk7*q(e+S?;Oc2Xyjx5GLYkAM)8%5xO_0g6&eE-Um zf4v+b79+||jo!XRcD|o=Nx`2n6y14X9xF??obK8$^S$kSNyu!wVTH<$PJbyg;No-# z6L2Yw67A*JHhxy#cCrxpNfJyLJ0OR(OSZ{Rd6u;sd3iS0)=_MH$a^_ajRp_M&_FZ2 zmuu%MU#K;T^~Gz*FXRk!?<3r&8euLQ3^gp*32xvYLF8QR5?J8tuC<+wly~6Q ztwS5`X#CO$h!{}->%~qu+Uv8CXnFlY#7>v|g@}({0Pc`Tm7x__8}p0t8dOO}9(vPV zYe4eznI0}?pz`nCC~uQPYTRb1`{`(6mEqojWO9_*PF?^OE?LxjCz<_xi54Ct4#9dM z>=Y{}i)K4gnFKPXdFGJV`LaYC`Ixbnt$*no3%vQC-*Zz9%r=tpOz_>~Hwwxct2`qmE9EiP~M(KU~LFw~_w zpm%exq`LpA{N?EY`r*9fR$$kzDE0x5w)1&%bBoonLunUCIZ$)}8#fSO0ncn@) z^wXQvYG_-{fOw0Snc_V0+U~1G#bsB4rTwb)J6sudzT4I1BZi;=hcbJNe-rX_&xM@- zz9LUHX6UMBdcO1X5j6=s?}<{y`0L2Gv3`r3^Z3kaIgZdgYO*oE@~!S>y2HEn3YrQf zHHVutk~{50U_SHHEO#FtI1`r5N}0vm0-8~ZlA}u@-vHBOTaCu`me8cm_+nb@(PzL2 z#`*83&7n$$lkMwfJO(is*m2W|j7_Hh(FAy-rY_VhxXBK9BNAqZ7)43Fp6IwHl)hEj z#WI18m7iUZz$xn64-caFBdQZ$89!`uKbo+z0`?CZ@j1W!&WaMwWW6rYwt@Hlfz`3F zgU=~EcR9Kw+D`jY{N1LIV>cB#sW)n@!tb~|Rq|41^>-^2V)|lHd*ppk4Qwt-@}thZ zqXv#G=NTQpOC9}fJuXgHlES_{$<%Z1q~+9N+O!Y{{U`}ZcXr6whOem09{xgwmW#A4 zrnCY3L|NwmxBO|h-RV-2<8Jk^y7bqRT~@@8%o@EexhcmsoG23rTJGIv`x<6i1#EWE zgh%BP2?HKwHnJzb3gi;I+<`P*8_8>X^OeM5sr~B<-|G0P#IRS|7npiRP?@#weqFwGq`TRaeO>fnJ8Ay}DU;oYZv{PSj~TaXN;l~1c)1z{ z|8DqOIGlhvwd~K{ilvr2F-2#e#*|g{@CwZ5`(NwtJGqaYJ#HNn7d-2^NGER*rSXX+ z9}Ar^?=X$B2yQ&rqejG5_lX-o30qJJORI$)X+Qa%fQk|fGddyKYe0g4r{R!z;~y}mKu zIqdA_T0vGnaMj04Fu|4s&4A{m@mML#wCURKaTlvk{ANby#F({L)Os!SVM9{ilcoHX zJ6(~YYSSv*83`#jUQS7(Bza?EAvUjWYo{K)=f%#{R^pZou0rUan0~x&y8om>1(I!Y z6%>kfE4q=scjFTR$x7%O+U56Ub0a(@ z1dI0dGn`JT6$cj|QYfC>OEUbJGAe`Zpl|))DSTtWRlwcN;RRJL>qFvqWZ371*RKRW zk($q>iz)MBa}+mVn+@nSn7t`IwoT36tVdHY811WmWupQ?71;r$4mW>65XhE%qA99`Q zhoj!NpO@u2jE@)CfP42){Kh#Q5sC$R7M)WR&*k=01}wyfIR?gnk|#}W(q%T6#Y@4R z7Bqt#vG?CU_$uw8U%Q@gndaE~@bkGZE|=Eb%5AZPf&S2*sm&0cD#{Pww-q?kCM? zl$!c>k0g*gH3FyZYg#u4+O`tLVYACp9e&nusqGlY4ck@t$T^hd{? zODQ8CnP4Z!&IjS<^0Xkt5$uN~u6u!Dj4=wQqetZxwXF z(t?vqYbW3AHmXtf2?XK`dZcotgYxsfEBUMSE2ocsB=r+ltl2RJR{}dO-!a0DMCxa5 zZ+>*=?~3*IH%Nq8;7-8haR6h7iPTUnvGPH9KpIsNRvIXzBfD*|O!vq~DcW#bj^ zXg*%h^@K?`G@WXITz_u3y4a-GkcF0M7X@jB($fsSn-$jurG_+a_uOLC?eaYBNl^Z;*ES!QhEd7Y09-y~uKs_kE!UAO`QHaME2bs0IF&XeupgQy_ z47i|*kz9DU`*G;#qH&{)3DF^1vT7~V%(=N0jZJwcI&E*TVzYfuf?7-Y&$58v#wvG^ zF)zq21wr?TJ4}v&Ok|%%IqMSWb-HWkVA$p?#Q+5SfT!;@uY!f&Z+{wMDC^}(*Jm^8 z>bEl@)#Es}FGyW-GxmNs28A!>t;c`EB=g}|7OJk7Kb8sIpdjI5Ms|jPs6tHyEoRus zLg`3NVkTiiGbv6byz%;uzff*v90>IKbv)!Sx@lXlkmVvTz1K) z0C*!ljwu3qAF+z>)^>9*&I&<5szN}fUXq6l&H|fOnh1*pMfb_?>=3FRyS3r;G%)g~ zpgXPvm{urb09pDJ7p>^>R&D0cja;CJsp#V?JN-^r_|!XmQK zv9!$BLU*2o@3qUnaig%0Zk@iyOk=JKx43lG;deay2{S-UC_yTahzE{fX1hLRP{OTphOA>*E9nW~i+T`DP z^^hMbW1@XE(0C+73V8mmUDv8D!eeZ8)vwMnvI5C>S;&^glQ|o8A_|dFn`$(6<|FwO`A;Kvg|Ou%sA4+nc)sGkvZUeiDs?U?Yi*WJ;h{IL z!d*k?^_K#yu7@M9R-8Hg1a2>RNv);{V<(2+$HfjPxy#?tVrPPhSZ9|%chf!e(S@D& zd$wvF&;?*xj%OR@Ea7_jzcex;Z6=Xgpbz;uin_PEfbKoH;Jvf?o0`zU_!V+?54{Un zex$@xqSc9>7B6>EP^Y|?j}x;TSB)>kQ$*e6m5x$;A-A5!t5D* z18YL5& zF&!Um9mq06r#Kj8MEj}~ON;-gQVhRD#oAHWrJkKjFqxl1Ek_mKkCpC{LyZy~kxQBL zuUQZ4852x44xN+7FM&p%jEgK*PmI9LQm3y~@vs?_;ENYKKrcrq*I4nR41|R^n2eUD3uVgcs3by)i@~HV+T`?D}_}NTwjR zYxr)e)9C)w+m zO*=`neMtW)QE4d~B4AEaK6JUWtG!UV^sB@!q%SnaJQvP%gcx;pY_JI4X_w4LO=y;$ zE^(ogWj@^IwnN!sGquk`3(4=I{gKg8defEORnl6ZgylI*nwieDZgSt-zMe55>P1Ni zCY&Ss)lR$g zo;PoXihs}Gi9N45ko;0LhY_z8b8Wm&s1?;-qs8CWvn@$HE-;&+M{{DcCPG_viEmrn zlr)pB*7Y^Ywv4zqFp+f4L1%8-jVi9qX~6d4&ly9T^VtUiJY6&&Jbj9&_y3FO8G*O!5r^Lk!6?RDs7}Y@A`tjY$N+~fSHo@|ltPrIUl4#Qwug8B0}%y~Wv-2VeZ zt5FN|JAs-ZZJ%SLioBZ2+rrmy;~xdQWh?Yp%n+0kc4^1B<2iY@?*gv4GObQYETc)& znE^z(X)ZnwLbtEL+ypdZ=&aJ@=gl*FX|>-n`rv!RL+I=tSliV25Na)l3?f1}tWkN+ z+l0Pek2{)jW!(xr^6JRRqRJ2uqRDCi%G;3Awk&xQWsvo-%;!US>Ot=sO27S;sSLKo zud+mw-aIWU)x^&nFOE4vNIWwoE@k7CNu_G*6d=K+Sccf#k^FYjDI)d@s0Z<=k~mI+ z3Zkia{5U_O{>r!6D;^YoECb49S@m?UkFYU^5ACarGjU`6A#4c0LCaID%swifn{_@= zz=ZZW#dYyfX#K8Ky*G%KTdl`QezMWnsrW~cVB}w#PW#UrPDBhhp|+i4&rFK$p5QP6 zb4Mwjt@{~yU~=#K{-f|)_BVdKB1!G%RWFU`J&(2W>P(JoB`(XDt8ol`QYs+(Yb3dl zKU#ZC6R8dJBLyAXm%75)V@m8NGQa$G`pkz6LB%}r4kmb6bn@k@@Aa`M5$+4cR#xQn z_NYk!u19nO_WY_yS=YO=)ia|4(*GQXc4-z37y`wJe3}J_8)P5}ZPrZAfj_AC7mTVqVD67yzgcC;mhqjNiC_i-MRR;boyVs3imwUESap?1WF9$Jt)pmqXnT*p;uIUUOT<^ z6?~j|pO1n5VpUl_B7p2NWw2LNyw*fVL3qjm>83s1QZEO=bWwi$@oL6xexPfUCl)qV zC??qdA9KF8mxzzhl;KAdXi8Z6QgtfVW1!%89WIh-GbDc46s@+O>v|)(h&UINT;$k# zch0R|GpNo!{U)8BMcmD-%ccZg&}xnQ`p|<0Bd;kNhK!Re6k)a7`=kY5GXb?Di3&<5 z^c5B^3ia_wg@Si_CJ)7quo z6XJnGzVwRNIRliKLK^?=@QL>a*dpTbH3;(jQ$)NO_F_z=`P+y0jE$}QoP^JAfh6G- zm6Q;46f|oK$Ot^sd7m5 zs7V0YsDxSQ;hy3&zIy}7Ab*-GIAr10-};>cxeUK1h{Xa`2_EM z-~}hi%kzD7es^ajyZNY)|C(wL?p9gb#o6R2hQ-Rq?K68D{PwrguLqL+m@A!cV|SmL z%(&$(N%W0nZ~V$etL{&(oo4r16s+-`wE?0^4u5;1-L&%fz+O8lMxh_!();6@?nk?L zHE|x&7iUcljC}s}A(1wWTgpsRikges#7c05!?MquX_l7!_nd~+B;L}#G8Dncy+eIwF4PsOW{dXfxC|Yz0I}uDsPAqf%y&G#y2Scj1_o_>@;^9lMu@FV1 z_O%}YvXoVJi7g?GHkQnKp_ddz6So{0-d--|vDzEaIJlqoWc}SfQ(Pk;*43<)1O;Tdo_P z3*nE?$QL*qkPO%;t?RcMH~kuLwpMWEXtaK#tSLux3opKodra9sn$hF5ISG+`#UxGE z6JcIN15DbhNuZKk&k4&UxI0$Qd~hbkDl^4Vd}%B~x$c?ryNT{ICl)HLLmgeSw}|Lm*)K;4vZG$XCcDgNu4g%lqdvja-)Xuk4NV9n+jPxVhg7{H>Sa*gjl+x7~Jmq5onUxUq(|mrkiBCEg22 z39sXcp$DwY-i~!ZA6oAXnWI;dcI|sGRzD#8C}RnNZwb3nTC#APR{K^kK>t@JQG|VR z5;e{$l@#Qak^3b-?9+a>?QWQu!$!&Hue{Y^r&&PCY|`ZC=31_jvdPujI8ZU$CPewx z`Cgm+`8;*F8~MB#e}Xk)`4^IEis^-qQe5CIQ2cpmzE-nTUk`iuotp&#rA^z7r=RgH zFaj_HXadX`zv)kEQ}tSprU1nb(yvK<9B@=VC@cE8Z5NGNP6ICAf)oa?yIerHxz`d@ zZc*XfY);m^wbQrG)BX0k=XbkUsoj!~=K?O_Y}W(fi9~WIfaB-7O;O#~_@Xil_ocDO`ElypfousNoSYhyNpIC?_1~xE zFBou%c^+SBTl8JUN)gR%lzId>bW56fs$G&^&nWqMS#N)2D!h&Zl=(L)dH~i1Evg?h z-o5x|;`d{W;oVZZhaDRFS0?ykehI)83e0A=V#+*Z>F?WN$3XfnP;u z-Azev|N1v!)lSpIRDHI6Y$%QT4{1y6X0^sNe=)`Id+tmIA;%CYmZ+o8Be>DwGuKI3Qvvc|_mXBek(#M4iciUJ zdT;4>COG6eV72>0As-U>{sGb~oS6;~NF%CQuRB!r2c+yD43pn?fG2uT2sWQX<6cx0qCEc|-1$>0WQP$d{0#&(MUkA}y^THbv zSNT-s{V`hV5AU^o?U&kETxr%g*?F}INctb+0c%#|QhRzF?v9vwAy;&V&^ZBIxRJOE zxeaaW*Loyb(mG{-^6XEm_$8O+Pxm)JceSC-ebKk9a|YYc_jLE?l7Sf{C)G z?Nk9kf|_s}R!hQ4T#Fi-PJ5sTNVL^Y0!A6Exa#e8l~0bGQ6)qlCnjA4j?cS*IhxUB zZaZuxZZzr`{V?^qI9_6RxwOeVpU$7Q935oc=cmW3T5v1CpPGx=wd$CGOPZR2DUm1O zPiCsR;y`JUwJVqms=8P9V9c;uOmIVZ#W`i<8FVAb3h$Rei6T*5H3H3g1srmwF0K~~30&E!yT#v-3?uhxzd=ZhYLJk6Z&i4!>HaTHIs zd2cm7p7xOgoTsDOsP;5{LhQ$83&!6OO4PpDPDE|jFz{eI<$3)*N41S0$_tmw9UNdX zjo*ZweYP>o_*Ex1TeQz*S*(6qS6EPK=Yy-wYp=pvHjK(zXWI8{QSOt9J@w%TXTabY zuzS?Fi8o}Rwm+b?zw}^pP^1OaY)I3DR4**8*1csxoHSSPZ*ox~i!2==Fit&_F*SOe zR{1C8xTK@8K81VKkuZl!%(9+vNHAP(9Ed-=x`o=T_f73I--R$bcUs7Qp~(4t z9|P*$0OD(OIC$!J6@%eX=5aIk@uTsr^w?gqVW`n5+w;-!Qjc#x=>`orSq__tt$+z}QlnhLl_eI1kaUa@N^Y3A! zWXplHec&M@F>i&eZ$}?+qRVnr87Zc)A|VAb)Codb9<=eS0i4%NQQN1BUfuVSYEGEl zGS)5qGJeg$A$6yN#iA+jtSYI4?=%_~QS-Q&X@DWI*BrTkZzaZsKbon?`}B-e*c^d6 zy4Q=lS;zP@dN(cK|AS>)lD(Y}pibuk>a+^EDLIcsH`yKE&B_VDm3+8tzRen|9s{*E zN%5_g8Mtmp!$K%NWeTpor?c=tj^C2dh7b$b#xoq}M+ZM|RL?Aft3f=`G(iuJ`>H-K zeSTc7!!WO2+)LaBQ1Wnn>P>aKA*<>3ti&w_qvg#`sn z=FXI^V0GSi(dw}GigEO5R7{x97Os{Pj}zw|CL0q}%IovY)(!veNY0*Qe*x`a+-Eom z4LlEeSNG4V$r9Fjch!_D?5cIa)%~$b54NvdY9mQ9u3ler^{qcJ!&3^IR`OWAFjGeM z55D(kB=b1D^OEef-_aqSN1e$5&bZYt@=3WVWzK5K zKyVuKb+l?P(cvQC-lM#Pwufq{H3<~XTkOnzJI5MU?-Ryn;L9K!B^4Xa&3f(e&%)p6 zpyw?m@xO|5$3>ZUIS*zqFbNMfExtJ8P7(h3TeP6uYx8V$e8P20=965sI)aOf8Ejt5 z57Q4`{j19_xVO_N=|PuT^8D&?nP}*DXA_ z#o0Lm8uB}P2(}Z6+MTOCuo3wZG*)OlGOxaYNsfADxcVdo(yO7z%<(3Q57%-MH_3z{i3Pq;s-$hZKtXrIy8)36{PcBF0}c^$?1EeZ#~r zbB@We*;$V1ZbqRrBP~d{{UkDxpl2_F@GT=_!kF9XuqX-0jIvSvkfYUMUC6r>oeJ;X zUB7PAP8PcaA3h!{B@EnoPWW=_d5GU2GNvY_BCciKz4(Kpj}W1*NJ zd4q+#a>lAWF`~4-s=*3@>KkYSJXnM0z|a`mMVdSHRf7etaZ!aJN;UFu`3{kJ=m^@pjD{4`1s8um zkd`gOU-g5-{9Ntm8W%rh?X>0e)0EEwo{V;SeWt2CzZNo=1OBXS^1Mr3XE#Lk=(wH7 zS$h>{LoVI9MAUL7Hr9gB2T~duIb&d#(Pm=pu_rqV5z_5LIv^!9uR3N=n2<9 zhYx<<2(pph6Bq#ED0|OTYiDm~X#YItpK|a&r_|pyVzw$U_uRM*@Z(%&g z04t;UTPORQC;Cg3_~+UB8E{GY#D~pfZi<0lR~-QV+iBK&Wl5uYc?pl#;JL-~)c^jA z4G1TRvJG5()QN9j9}l?15ix0LH{cuU%~tHTcAdM?zcEj)(7+>5^7YM#mw&(0$i+sY zFt&P-{hxvPGdvIh{F*8~E}j01n1jFok@$lD{+0ijWB(l62w~d+N-UvffPE4v0!(Dz z>o0hz{s}-3DIOprkdfv6C(i%;+P^*v@k}8NM7@#rqVZp_;J;sH6Ag=U zUI*?u7i106i2V=V@c;ew?G^Y#FuHS5L-+oN;7|f?{ZCLP3+?~##b)>LC}AsOp6w!@ z`n>>D@L0pvginK<*;P_Ln3oU#%PUV#CC<-EoyeSSxB%p2+E(lgCZ_v4u!}OwoqVH? zX_(#az;k-)Km#jcjOYF;CZK824RR2A0F#>Q6zd1x#S^Gx;6AZo;d?^)O8^B!m1F_~ zbO>OJVE{0`6|+INAdVSgDU(7UbPJs+NUk|dZO#lu+&iwJ1lnksd(irKzH3;e%-j1e+?ktSP@Kf zC&&$qW~=Y>DfA9 zCes6U0VWjOFUgr*^UX|eMre$h1xHqGa{8)%hK9jSZ%Z!EN0az*HV*+bhZ$I<^QS9W zvCnLHK&dxJ_W#eN{x!per-^Hbe>$~g4gF$YH348P1i+c??!4FV<2c?QQWbj386(MY zDLYHvvHCeyuCbFzCkSAsjPOjOK^ZkV7T>1w^5Pl4inH}%YNMNTr~RH`G#WA@>7KLR zL@EaIUI(10p!Vl?nQ!2)?Y{FKKY)2^5rR>|k4_f3`4AhbC$$- z4&0g|M3EvusO{V(rLM>JK0i(`Cd!-ZvoGLu?fF6S4?atJT;QI1%GV3`ABx$MkHVV2 z4qnq*vOJhAbh%52cx=khs;UX1(0aehA>imUoTi^Cb-Eaj0HDxOm(uksszbu&Aojqf z*IqDxhFC}c4FfbqAYOTz*Dm)N5#|!fFYJ$sy29ec<~M)M#5y4ywzI0794%THj(wJ` zu4n%-5D)@|WOl#Ps0FXCRU_b;nNam0HE+VL9tqV;fHw^o+>_U8O&|*-qX+|mldJ%I z^c*v89$U&RLbMFbH^~6F6VS7c@2=^x{}ut zMz&tEdN0PA0g3xsB!AV@%r_k$Hw1##3NGiK84N?feaY>W&nAHF0D+*Ems!pfeAmuK z9`#BmEqCdBf8bB^SGxAh_NG;nRk(oc)=-fz$4?%DM2!0T?lxd^XCudxk6)OXdvE1b zBrvHHZmM=|I$vbLqXznPfu|?*yCpYDs^6TZQDiOy_EN>q zKdyDQb$^(Zvaz5*WV)P-7<^^|;>(}1Q37zTqYfYQtR81u5&OK*@PQ|P4E(_CEep+3 zc?eLp+hjGx8$g)PvTR&DPlvT0{b35I;^dC7{WJvLD68iYraTdB+SE*G1pH54JmY)~ z<1^Ou$Ba!JpaBNFygdy7oM!nc(5rZD)pTp;b-_BoN>Tzvi~L@_2|yZm6*d{307CF> ze5P7DmeezQOWR>3OEyR zs4Ac=PSy%2=L=u+;QG8J0G~JyV2+fzwlZUp%`ZC@StbHcfggt+>;X-htj5ZQ@p0qM z1eJH)yXTuf>1W#p@`@=t6IkKZ#!eM>e=kM?X=2mJ=y>6(CkjrfX6~70wgxLBF~! zG?GVJRynkuE`wZqz605XS##s~^*Mjy1N<2Z%doxuNRx98x$4O`#a|OlW;cN3a*MG# zbO^7@T5oPN;=^q|TAN{CJE4Enkj>xT&%B!p_CA+7j24CXBpJGN>jr#j%4p;|46ND* z_(lntixaenen(EL2Cyqs!U}Bg8$aO|1=i=c?rh}og<8rpX0YE*Y#We*AD{q1Xl)Db%D*buu=r88z-wE;(OWfr>4~2G zO0pWU(5>e02xE~1`BA@e7a1a}4m@f8S%Ub-{dam*LBc&y!THK5H@e}WV$nGp>Bm@4 zz;i>UIOV?oHn5ar!g6ss5D-QwKF)>$6#UNI+H)2QKivH}zgOk0XX_OgXB%~ky#a2+ zwP)3M?EaksW03c93ilDg8eax58fE}(Be)MYK}+xB>FkSq6O}f5(I)&!i5>2-XW6WV z49dG(2{eCg%|T{t!nfw`Z3K3!y(R=g;s7NaP7VQ3T&n8G6RVy;R47f}LvWC$-*U~c zdgL+SHuar9q=6^lF-JcxIdkS3ROniY8fC9t%TAORg#G7U6nR!vtpBFDcQOF9JHjqM zg|qauUg9uTTt9m-bHG`fQ-3Wgi!01-&!N6IzGDGDxV$>+e33hayaDY<^VpIry$2GQ zF>xE2LSDCUi1EkxdNaUY_p)2oet%Jmylra%>`Jj(-rJ*)#<)mkLEAKcU=mnlT$)uJPX4%ZpBzQYwkxcaIEGA>w`Q6Xz(vMHb1!s!VV{$IhsCN zwk~AFqupQ{{W=-*;NDGOK%Jtj(9sh8_st7AWq(oDPeQXM@T6+WYpzy$gRTeQdG~c$ z`EuUknNcDdVJO#TKX7uQHT}K4FiUR(&))0i{2xDnqXgxaT-GtL`@{J^P>_>!dGyw8 z`|e1g*5raQjrCd$_aU?yoLTL9+-{6L(GlvF&aUkI09^Fl;g8{NXFyVpP;5{2H0>>3 zI{ie+J1P-NJ({4bRR*n%QdPoQ6Mj75Km6L0LMS+DKiP~wg#})E9To3oW_xuWH5xhq zIZcbBo_yRxa>~}iMb-}qx-qAg8Vgi2bq5AR_ENn=bCIGZb<8(L?w6f+gc9+0clYY z)40TR&(^gbmRe8LchVU|HN5hef5#a^W^%qjkASAx!-XD%zLj9Yyq>Tn9I}Af9&`0 zl}C+k+c2!1USKh-r4LhHZ;r0&Hkz;5XN>)_UGlE;E~F4{s07G)l8XwzE-4@ER-I$z zRZ$W}(@8MAUa}3$Xy)Bc~s@e@ACn*Eyz(DAIR)U(ORa=O%Mcw*fe|QDzn^ zd-N{dYrq|`D4XSsWE@-{X9P=s3mtXVG8dOJGk@c$I}KapWPNW-0o!)XicG2$MslQz z9s(x~Xz8o!|M^=0^<&Pl8DW+YMUo-Gdh}eN$azG<1694^z6AO~eHfr&Mjqb}*CoR4 zL4+@W0~stEx6(d|#FIcvR3k~4=9Af^Ta~q>o^T~N_k88~zR+|>LTfq5|6y`f6v@Li z^L(n6LhxHvVN0F*-@(@w-1^)|DL2-K=$;FuoGyTw#{E3=5_PTuIK8!So<2Vq#s3A} zSbD|omnUE}5<~B#D99*1NgdK7(?yvt^_P&R^9Tj==ymwc?q@16nnAng!&zBy72zQ8 z6-XcxZm&H4s8HQ!FHluI`OqwQ5M(~dcJd;8!uPF9|0X@n<`pfv&Z<9H?t@X{IVh3H zP?-vXCLWT7&7gysstYbmmgo~{tDcX^S7(`)fYTn-6sRL%5@Xf%`W-xo!NCTd*q*QIApvhAmAV>|Kr5RsI{AOOVl0&2K5*M>qC#B z@$c#yqHu>Hz|eQ=>+aO!ITS@iPczcC^%ck;auy+HTf0usvEr*_5|Z-q;Lp@Z^EmSfh&c33$4zBMbVkC%jy&p~DsHG3-JF0wFBlY& z)&ZAAkD1z%x;sM@yv@1pVIorcFkW5K(+01)^3C=Itd@CBUn{YmvYS|f!(@Y+19}K> z+Q?Z+q1(2N>^*!CAX2v|yS<2my8tVdld_T*ckMi_J zWjw8J5{pf6Mxvwmp31vNV;JqT#sXMFu=}0n!!oxJ8L@+8V~1~?edXx*WuY)sTdcKDv2%qU}>rEW}CfdHOvSK{e~jWL{r{ zkYB8uo30R**{=8bj+K&W-gX%?HUFI13%Fy+a3%3QDlK9!r`>Tu$VQ-YF|JC~{Exx& znQ=BQYMNe)g@*uUvTqBkI$ch)8dcfPLbFIyMmA3kiJEtOjrGgaF@WYT!F*zU+9}|_ zL?SzS+2-j>b0E(dFloQNArB!49%(B$shNS*mjgZiW;KGry)WcP3wBgc)Q6)SaOaEk zPm1+;rGEFQ-ty~|kLe#f>GAGV$nU)*S@#s~=zhxWPw+|+(56M0hLN|;xDU&XsKkbw zcpU6S-)rNE&~G+1v(MO1)>%)aY&6)84=8s;y?(|_cWInig3g-lv7>(LHE_#XVC-~$ zP2{asuPhVDver-2FJ>jOU+R&!pZJ#_B{WkDol=NhxoTg{F?*?D;hz2`p8c7cN8h)= zg?1m9tn_o&zBSIxg-}uq890;P!L-DCl&kpRc;{;B7Ax&Y6@YYbjSctb8N!={azyQ+ zvAax|YLk>W?WN>yRPx)}Hvr_>i~4=nF|8NC{nMga+v?^zIp>VQ_wPsdClKvE%+fYm z?-m^5<}{?a_0>zIG(07)?|5W5CLrrjd9HU@JH4=vfA|;>+)n+ESCpYssezyF%}U8b z<}<=4VkE%vvVu_J{4zUI5ZGoWV0RUbGInBT=F;u8+NMP>NSGVb(B-N0qmnr^vKXJ& zOz*QEM5c%s&~c#!wK|%{M3liSJ;^ObNBm<9T7%r1$Oq(Ut*kgz8aa4=bftS-V!>c9 zx4$wnRU4Dcm@BDez2ra3ab+rA_^c2c>s%53LR=k!Fl!DoS?4pK{v|^9%#w*EpEae> zJ|gBI&MOl>lCznkf_>ik;lNAQOsA}1Ai-dQ9-s{T-h$ft<96>_e(rfOi}K1l(4!7- z{A0$ctHinOm5eC3woG+nDo&XtCB^Ku9H|N-&u+q{!dcv9vMd*tEYKf8Ygv{iLx=ce zr`a|v`LLi*JkLySKeg&(qgZS{TeoguN0(n`1;cPX1s`R|zVYHG2Cg<=?eIo>df(0h zdV2zi11hdRkT0CNHX*6O4wr+I0w(y3M+`MkB1n)SeE0 zl&xvd#hIxXk9{h9Vr!@BS|hWt>vSWs!}wvz!|6EIvCP+%zimTYSye|psJ0mO9r>NK z!nu-Ct|68oUtXr(t&94DFXr$jRWAvRWL?RNnV2hZM8(rmFImydY9yCFx0yhCqlZ~l zkQiN;t_7{pS!PAMQa8l}3Lj}EH;=8O-cS4k!Bs(wY2%Hk3)5lFE&axfMyyK;6y7DO^ zz}JR0vd(@L+Wql1e(Fw67VNT&ccn%|l0P3p{_`V+*nzGQdh_!g zb$Q&uIc)f-kXP25_#U^z6C_r!HcvOk)bj1;(r*!h?g`v=tsVOO?lR#^*K~qd!sm{w zv`0scfj=uSXt0|RFHxs}cwM%dT=|JCxcRg@)}hBwV(a<~ z-&r18E+-q6=#{j{&Sq+To%N86?df9wR&HRVgn zjSJrJCzAdaOom-@qB^a$e)^{36$b927oR9E@#iRLAsS_A6;k>vK9d{75uKuFehfy0 z=!0Vp`45*!OQ@JRqiyh4DaE51YA`tiQLevv32%cARBwWkUi91Si%pfqYMNCc(T&m2 zpQkLYQQkb93FVD3DgPIHUl~^A*0sApQcyq;L{gEG?k=UfJ4H%bS#%15lF}VYiF9`> z9TL*r-JNHyy|=aB?>*oDbDcknwP5i)^Oc@+wVzkmpML!g%02(Yp)1UI z$Uw)$_i?3KvP`(1xa>UvX5D5cL(atRKsGMbtHAS>8~g6Dr!qQC%<;#8Y}{^!#uc}l zpqg?qmlmBXEgI}k*>5Yt%Z zQ>2(M80}%3a^eVP?$Xs%Z&h*#)o_e&$bpQ#*xLobKk_JQ;~>oB?O3sC0*zazR8>}c zF}`rvj*eQ5fj5m4$v@=u9^4=a{M&gpl*>R#pQ&4VM4KVn zS?*y{^*~4$)e*;~LOg~}%AWf|O9NCt4x#p5YBieg>K)!#e>UWJ?C7tW$7_-p>{$Ov zWLdWwAENH%QZWRXuN^cX-?#!UxWK+{nqyYgS46NpZ@dOmZxSCeq(LK-#HPwb!XA`$ zP^V|n+RUBFgdX3sG-Xbd-SmiXe0NTipJT6up%~y|{2-F+2!S-8-ISr4sPshrY$ns< z=*ihP$4#ZggS6SZy|bd+1;kXZ)ZJ{8p-Y_!+hhheii*bRh6{8XKKJGBT6&JXOeVR~ zmG?k+(T-0Wzn8~;m#u^rDV74MyW&<82i07Q1=LB&nAEcuBO+Y?UijZ z12%1oTg=6%6n*6*Ii5)*SyG1;Oiec@O%>vEK-#&($;m7$IqoqgiQTg7-u7xOZYfj+mDk<4 z2~&5CO3UojisOc-O^k}MlzFDmm)Iu$f%pP{7G45+w>>-Hti@ zH5|YVNLM) z;`RVk-MOydAaC9f<*A1>Lmm}YX9#y;Sk(wSRZ5Q-X zW1awyl!1M zl<<;9X-$mAmNujC3|NQ0u9hAA_|+V&p_U9iUqgEvTT!CLxY%JU)ULA`s7`nRe&5t8)Vj4W`i707ie!B>=qt0f!HMBygedF%?AQEcgTAvlh= ze3$>i^N`t6dadTx!hIH$PXr>Z(zXtlR>-3SbaXUne)#HJRBBzu$J{N@u@2UtuX_WJ zLR?*96y6wyAU=mzx5x~Ryc5%|G|Z%w&Pi-C^lrQKZP&X|vn=y4Kh^|Lmk0eMQLP@8 zBzt;Lb<0qc!_biBb!WI3fsy~hg@bLGSpBpdvF&V{#JC>Hi;3jxaM_@B6=DiBxB*kK z#>cDag@%TTge12z8qZjZ91E8O?(4@>V@AI(gd%!tOqJM0eUffoYNL!tIj7K)Ml9mH zGlx`acjnuD81Nwe``igiESrd2QFluWCq{L+;A%oYwNVFcaMoM97yUiZ$(=Rd?~iIX z`}^B@*1zPpwkz{BDk1qJ8Qfqh3ac(azThjf{kh;NU=w zn~PFZ>Bn&i4&goAyHLfYbCvw;ey)`hULtITy7jW$BvB&RNp=c0ylZQ>CI`P_2IQoY zZq|zt(s~Cv&xL@867E{rzwV)Viv7Z6Em^V?b%A2Aa(W@#0)CEmFRi( zq7SsPXJg=q0ne?XDo0N!Xh*>eYw) zlA&KEMwtaII@&9+#60@$VqDmNAnsKn{!A!kIlAHJ7;kSpLMYXqCZ&+E`gCMNDn|ZD z(Qg;YlGH!^qyG4%6G7W{N%!t~E%(C{F)L*|UHXci%ej}C+H#jC9G>eH6i#VZ&P1Z^ zo(86|sfo7uBBO5gEqmfBQj(dXMO0&o!;dh`I8~M>hdyL%K4apW+*ySZwCt&w#U8U3 zS;Rya3)PdzJ>4Bi+hp)%o3f^cw2-k%Y>y9?@-CKXi)+*LW-OGN>b}C5PaqY}3^mT> z9H&hcQR3-I#deQBTv8{A$M|U8AB*Z`kGpxwSXqSh8E^F!nts#EfXIy5GiiA4GW9`+ zHFXb+MYtj9g?L#Ma~&7In(&=9pT$+WyyZy=UhG-C*?KKk1Bu2~{B@7KbX=~q?qU0d z1Pv0E+f!4861nuBFOJWg!(VP0(QS^fTPDY)We!{1d$em+s9kg`BlWIyq7Xlk{1}(k zO{&{(<#CzRMbri3Ej#%SOD4D26QPbkhH7;k#&3U@kXtkPwu^Nv9JS4DY2G2W{Fkjm zg~Qt@wsI)+SdxT0+fr#NV5M(*vZJsutiR*^h9oLk{rl}EgF!`Ow{iNd!LZoFj?s7| zG!=wTTPWfDd>+k%4!Z|I4jaCm0EtcHE%GV;=+fV|u>4*NQ`sZS-JzIilu(_M)u=T? z-pgZn-1#lnC?wIlx)i{4F+b>gF~W|}efI{hVJGJohp!f|VIrmLcaJ0uzU|orO1&$4 z!E)A$-}Gw5!`kFvfqu7hMS(p12F%bxDIGukBxt2AN<}~umo;8RFZX0tar*N)IUMc- zzih(G7kcAUQApW)>;}Uca&?JX&)$*GSsFjh?6_-ua{#I6T4IfAeF6LH$6}f7<9Psv z_p>v&3y!~>4$6FXv`-U!HhmO4cnm zfc7)494jp>)W?@x5{piz;y|Dhx3UEIb1v=@jfrea_d7mo6f`la36^CdEKzW!EuhlZ zj6k~`aOJz}FowF|-PYR6A!bk+@iBcvc=>}~;%P~9mvWDNa8`=ZV%CZDnSnz>wdbPN8#!#7%XB(J)dO6QhOWt;X6KB7D>9(=${Nbm)eR4ZJcGCjI> zt70kUpej~hCyk-u=BBM{4AW}Gx!j2l=7d*DaCkT$0(WVy*fR>jXboei&@GXZ>Bq+I zYxb~E7RJ{Bm9j51crz4I)6#QWirxuf;tHa7$)Am$`DG2aEX(w3Q0`R$@5yFh-w!0} zX>77kD~G~jHHZrX!}DOJID$m*D4(_ElWrcZWS;DiblK;eCmNH6z)uVv2N4uLbTnEb z9r{!jq9pdZje9kJZyrfZ<+w9%Kk;Z3?Vx#75Gx(2iIAPmh{bUFq-5i?-6mIwUVZdD zEF{pVCWo~<8_gfJ_2~4SRC_^!^k{Mj!ESsHv5AvXvO;f6n8vHXTKwLE=aHM)5xx4e zqq5rN1}=3gJOv9P8txbOJML)5WwHjT51q$6tkvapkUEjJX<0!bHMA!8NYL@d{Kr8OUos2NI&j+hwUB+2 z^w3X*6shzeTT3l-^>GphHP7TipAlA?x5m>=?Zks>1$hn5JP1wo@^DqVw*b#nVLbQ3 zCbEIUIDN+Inr}$v2auw;^tCs#sBswVJq~{<*;{RSKESw^AO$Dy*N=HF#Mm3>Pp>Q! zzP6rVd+UQq)t2TO!*^o5H}%6h4m$LVB2_p5XtazU9VRDb&T{a{nSixZ z;=)QQ;-?CReqXP0U;0Ytip782Jc>kXyCXPKcB-IVmqknLSfDMQ=!L6vq+K1P*vQUG zjmE4=Qj8F(^_J1mfI@Oj-67m=_8WgD$;zPKZcTWBYmgnclQc5TD|A*1rJ)f6`f5G< zTspnzcFCY=P!DV$7NRSmy_O!#07Drk9EV@!=AeT?zgyY(_+M|{dWt4^+UXJ&Kc zY>Etv`6|m~=g_1WPk)ceC^V#tif3A#Y}VGDO-pXfuRISmHO6s-S{so`2$4V3fQ_8h zfCdK6yFx221&GKTYgrkbofMZNv&5T18!ktYbLpXGP4S4@L!WP2_ z0UV{0(tA7TO-|?E*DK-{m{g*6HqDm(T}&cQH=i5JowdD%LTdOC1$c1k)G(yGF1KYoPQjK5uu1DVIVzjr>x)OeP%qJB?SNE=LdR^1c_8Q$#&fiaCsogePXH6`Ktf=^i0cW;vy6233Qg%YY8|{U9N2UTrZ7S@+A6x_=|i(9JRtz;O^F`;|&@afP;6- zaFnfo9SiRoFTXReZ0NfRE9f2JFn;#{K@UnB7hr(ran4b(F|Keh-fi7Ng~GSG{Q<>5 zLJ+~3zD>W&=iv=6lYAZSo)xt#Zi!cq)AkGHDSOpUWe`8zla@bPySRHys=q`xPth?9 zFi?0LZlaL&sC+7Pl==z{bCs(8^+})2(sIaQ2NGx3OAzp1q=<4w_(obk|BdL<)GjN|l>C~d7ZNkiBD zcPoB2FjyY0M_H7kF$wq+e@?7MjB%N&i*eI_*U+QhrDTsQ$6oH$SPib{Wp&0^7q+cL z(SGK*G_lYy=Hj~E97Pl3?)d5Aj-*%$0hSL^u0uK6doE?~as6qzn^uFB~g^}UM!qxQMIy7D*7|XSo!S>Fv;+3{_;ATO=B}pJn*k3NHh-g;`7UGkF&%$>Awp)LY;I(Tf5EnQN7#SfPc$yYn+t6-rBq>q*CwrH7boEcdmE*sOQH`!?H9*)`c~r zW6t;nJ5v^nY!nH*9WTlc8+^{VkO|sa>|fh2faC100T_emvilLJyW&k=NVNCdI|D_1 zT*ti<<*>9>iLmmCffCJr35?$7O|^#cddSjo=NNwR^MK=SNop3MS63IrE*qf&Vv|07 zpgJ-#_PeZcN8$zXrjaJG%xL^{YHbD|yHr~j4t!xZdjR-};Kb|x5{5SH1>B*s?py+K z{hZ(-#+QbxWlV?#K|zX9UA+Cx%4t+%*ndaq|<$&H`d6ev-Y4B21Gh%ky<}cC7gGf>Q+x% zOgiqX=;dIB%2Ya%BwE|^v^u`wx8UAl6f#R9VbSa$k*nW5$aUWA`p8?HZqAIo@a05i zcd(dh?9HYddk2TxC#!^LxwYq!sn%;oUI!6eN==LIEd=Eee7!M)^C?sF(w~U(nMCPd z84u!Y510`5#tJDNnET$U9JV(qH9Hr4w7G`5_;ugBX_!~Wh_X#_Cm^sn5ub3em!(WZ zRC!5SBl5g>l!i{X>x8l1q&QS_>-%ZwQ2Cr=cXFoQ`Y9{o8$BzoG1{Yv5PZs|WLI53#vPRTSG!BeiCX;4I+5v!qA;v>X~($@V%;Mh98WdUBq#}B3c#B*lFVl?A!VX>@O?MUq6 zeIhKm%v{^pSR;2|`7YLzShEvD$|+;w=O{52Pm{H0x>d&F4QWC9RtqDi`qNBxli#r z4S2|dTlMVIWO47>8C_Mhw0>ph^zXpcy1^VpUaalEh>WNe`f9RBawKu+Mp9$nyH`$P48D7kB#~-73=U%J{)}HO>x|DA+(g~?~1~E5g{vQJ!v?}JT1ZVoTZ<6N+XV= zE-{It4x1WpOgw@vD@_0W?qQYdKo4#wsT+d2%jimmW$wA`q8x&-{);=G6d{7m#=0%+ zqsBBQu41)rWw#`?^dF!cxMab579tL>8oKZd?WJ6%OnZmkyfPgQ2(GL2OFSx6@+ix5 z+45t}%uC#1JY0rXotx8oO=cNbdoOh)XLQh|lgkZZ+hcGO;|}B!xi`N1p(W~oN5ido zxMLIC0(TnX)$`L@AwW;kd56L6a8CUzHVPhxYazM7<;x8;mpCOMG{a|S>Jwxa_C3bU zUyqxrg&5zZ67CR?q2Z{j&>OW>dB;#bQT>{X6-fQnkK=D^$;6bIoSp$cu9f6%lYC&R;w}ZX*j> z@QrPIJ)r}ruAP!T`)r>W)yxr6#>1zW5ocj19ozd0w4iR~4+E@=)6TKZ@rVR$Zyc7P zTrrtPs7fu4^xZdfh#65Ze@d>pDv4RL9vrs1?+v^Qhfl%QR2pG`H;aF)K315aG(U81 z^w#3BuBf5^&@d5^Onm>c!1+tNbYv1c?xM0-F;UI93im}sVw8h#ytkW}Duh@PZq~+s z2}nmJdQ5w&B&5M4?Ln!X2`8K)=~qP{6-i<6!Si7*I=v-o;4@~wJ&x_q1KiCiA+CE0 z5AuyvuP2|EjXMigHh<3fMeqchE<_Z)UW<9cN0H%q#PE&aG<#3HYSzH+SWO{Q7q zK1*K*nH8mYK^{cU-0NgC?SeLulh@2CE1z*7{O`p~HQ0!S+Si{Xg4wyx-c<21)q4FV zLep-Y|M|Sj;;aM94aisi-c*bHm#*u4w~f&p<`{kFG;+K_8mK@GadW2XnV4a2U2+jSLb`nl_1}U?biCwRLL(a znQxHZz3&h%)^c8kV9_OjlxxKNphbNPS+-Uc!rJ{bb31K-djaZQqZZlt**>)7JN1nd zDXuh@M=-HL+U5XfCjE9$r4|&t;XH6u-*5j}V*EN;ef>HbK82s=^lu`V6>P7M@F{YA zf!YNqvz8tKfs0cuuhi{X%%x<1u)b}@xg*?97l+FT)NnGuP746Zr zuy(zWqAT3>o5?r*nnWMeh;HaZqP~)fX{5j9hU4?fr_UVG6YT{``~fbakL!A&&l3NW zDOnTd^F1-%UUWeYDj|sE#61+pshxp$@Sd?oyv-y{MiGqs)gKb&+2}mz9VyT~hPGK= zjWnCs+r6l0R`j*H?A_?M8~yrN2yK=*zTt>CV0Mo%Dmkkf6#vfWpoic!-*mWFcPcG} zbK`65<9o;>q7A1TE1${Dd20?vSS@JJ__}GohZjAuasPrPwy=$Fq-Ez$Jc)LH@{LGQ^()CQJIR)X#P49>%u8`b&vbxP2?~+P5~9VqC2tfccxtH zOL@q_!;l=G8T3!pU80%V`iv$n(hJZeYlJK3T*!(D@#m9ho$V6X3GcglS^NgQ$EI?3 zArl0`1fskEz^PlCY!Br#iYPOY8F$}P9+rTUkB+$b8^d)FLZmgREz=F3eQMR#o7DQHYQ*AeEK)G zo0(&~Ztk$!(rRvH%&H~o!N>{wANY8A4!&`_5WUxv10Rx!jVSn-@NhZS?X7vo8%BA1 z()R}iPW2mf$Yk{`{o)HuP?guX$A$zV%S|>-2K8`J;ZGP>;7#(1eT@5db6SI*_{QF) z#d|AHtzxV|kCkRW7w6L*CQM7YX!bO#Sy6;a!BviHi;1Q&npJXOY4O!P97tMc^zp;) z8tkK;7t8W3X^XFo8b6)WX2lK}Mct$8DX|2glQN97%D+~0wNAH&rA4d;!y|K03+J_n z-^;E`o9AT+rw6V|xG`9=PBZ+&)HJl+8}uqTbAG!bI?+Sr?o<$QF^0Xj@T|GhC6uey zI8W<(p8&Gl+K#7_4zKHF*X6_Q3uW<1Wj1jj-lomsPh;Ud*K4T^H`kmys8k@B4&i0V z%j?|KkhQQdfxj?;UUgVD*+lG+uxv318r$|pNO=i{cfg!)+2ONLhJR3lrlJjR#=pvV z@(tQ$;SJHzzf!pgxhV27sH%D6L4Xxypzv0OJF1}W3+8dawD1M##V+)S4;`TjnZ(sb zx#XOC9+;5#$T@@h zAeaIZ7aGBUsuPo+1$Tsu`tG2U>qfeAnYIXz5SqbU8>KG}v8uDM9x zzmx097v={pDvqm%6b6QD!Hr^tgy9qjb0~=g>~yc1Ga%v|R*QVYwj0f5fL12DPN@T< z*ry}vrg!aI;hh74^u|ZWH*ESL(%N z2bsb1>SY~t6T9J$weY1*HgLBJlb`&xI@A#7P_aGlMS;WdV@4l*N!~Ri+XA@6g)6J?@Gv_20UgXnE3 zPt>(WJF~O2{O=8j1Lp1_pz}Nkg)yVzz_+IIi}v!xX(zwZXchUvK&4mhVc{YyLf+P z9oZvl^zkql(lD_kyoBW)ET)+PA8rqVpy zEyj*tu7Wi-I3xw!=>#PZJ{uXkgVlav^$NP>eSs!I_v`Esk^;O zb#WCL2IE~ZF_e2oETZ1IP$KC9{QcoaI^l~N@pPE$Oo#6rUKESYC2M@==y)=4^dTo{ zq@T4BCyYra1A@YiMq0U%hM8S(v)TQIKda{lWB#0EznJH5XgU5YirO3L`zVPnY* z)9qqORO8b-7H94o8yQ4Jb>z?PAX}{8L)K#895L4S5|UW!Dk8Ti8#OinD4O8c?+=oC z{soMsh!Tv2*MFwO>Rd?nt%dQXiByt^h>-?;_Ze>&z)sjomjaxbPrloxxzUuJ3<3q6 z*LBu8g(Yr;&EFQFT@pgWszt_@VAn4}r%|x#*SFR^L~U7_N0N(BP*Mza@ylQmC#mGP{OB*>W?XOzTYGJzhQR$NZcJKjv;qoh)(_M_b~7gJx}Kp zW*MrBentbVc>_JDJ8vi|dHIm>1%mQtvCW{z0)IQN|MAs!V4o(h;$aTRSK7XEJo;cL z+5jL^*wIMOiWfl^mI?s0$Um$a_chVM|L;I*(Xa-PrXV18JLrokhe4eRw1c!gP)RT9 zVOX^r7`&K&0sH3sX?#WSbXXrFoe>m2!Si|t0~deUQ``6-NBHZP-|*ly;Xg5`-~IGI zK+FFj#Q6&hElmrM+!Rsu&+z^iSaTiV8BAeNUq?Ix$hPnMRC>Q|_Lsl^_s4G!yjFP* z1Qu(j0SI#zZ53tH_6%EYPZ zIvI_Ct%Vm&TI&>4(X~z+Gx>g^%&C+3C7^)T~dxl%9KfBKSx8aAwhQA7f zBBt}3fF4l=088Tg6|n1fT>_jq3uq~nk3vgS0vHFy-ZX+{H!Lm5|1l$i*zf?C@eI~E z=|*t`42{GHFBye?9UXN%@tHu?@``z70#m??GwgU_t0pe)U>z8FA2@eaVY{!em;`*%1&Go)rPC3rBLVbuGn zlNJtNP)tUaQ_ysiZdeaAf!XrJB#{jM_G!?PXeA;*9E{J%Td$2L@@<+=kI_CWbULWGQ#nMu1B_yY9i0&s zTTq`aSXr)85^|F_SVJM`myR3IFS*ouho9AC-kp7;52xzLBI}BZ@90@aK{pjJV2+#w z)I!@-b_>;GxrV-r%GVSQowB__#9ps@xF}r#RbU9d767lO7WR2#@ZW=ZAVD7K>Q_yu zls>Q?CQeJ0^#Gss#o8e<@*2>t0Wk@(;9T0ch_wzzRDk!@~$N zPN9E{FOb+P%W`V+>-m@0#(-2A9fq@12jRUT3e^o*LzS`*xiHjkgpw?(wafVUN0HNZ z%H)ZmdaHl)I|%Z?=bT<249Km%E|DQ=X)q-blb<^8B+#*=13x1Q;xX7 z(5x%Iq>e=~Cu{PCm#GKcQJ{C!5W)53qLc=1bk`XSVeKZZisJz_)@<&AM{v*6!>5*Sq64$!DbgT2<&%q{hu6KpfKeS7IHiCd za@m&RFi?FAAUS~H=Ls<%+E>#vH=Vk34b_UldA=_nKRBeZ^uCSv;0;ECdT%`3kg|OQ z+ECt>34o-#Qsd=8Qi7$S#C8e#@P1kJ5mJ%9O10YZ(F$)#H*f>4H!$F^cTsFnMa~2t z<3*rwVVR10#@2RpIx6O>_DlXNacwbKrBx?2 zYzf@$?w1tfb3S+vk9hM0l!9T@lJup~op9T&=x-U7+#Ls;01QLiCHBw9%PieGcah)_ zFa;s7mxe@m1V|IFmGf>6n`KKd5kWylTGer%Ca25MM(Bg5z6cA;H-63lY%VZ^1-s+e zM9g>05!1<~qT2QrJG<{aAG6G2(~ad{DQ`i)$Efd#!=O7+-rf>K(0Q^uZ`9<2x^%S! z*oZ=(ef2+G8h1+V6v;;PM54b<#Qlhgi79F8sO9Ci`Hz#4zAR<_iH7TgHDld*!KL$1 zKezLv)2c$5&Ew&$))A}9gJaq1w85>Ogb6mk$;+a6z3RR1g_W#}ozcDflZ-DqIf&|I z^>k&=EEKPkhdezjEOMf$yS9DY3w&V|TdllSB0 z3D!54JJ;u7_$x8tfe#3r2$)8u3%*YZc*>$pQ#TFatT#`sJji~5^dbG<`$43~#z zT%jlGE|&=fJ$`{3f)LVOjpQ%OFTQ_n2O%|804^OfUQg+Z@63HoR+CjaxDOsHroCN( zXwszVbmGLcFe~e1ws8KHn&qeBRgZOGPja2bt`6L8i$OcWG1? zW<4a;yTpDh3rxhv;en8{cIIf7K3*wW?nw;qj^~JX(#+NySZEIysXlcAT^YNVzg$0h z^r)>0y59BNJobyzN#KwBk$os>qsd##i8B{+F? z!sl}?!N;tS|L{by@}&{WI`Bg*9?RYFlr*Y21x4}oCOrwEV4ec5ay3goD}Pp|*5@br zM-9O>CnyE+1h;sMBkuiir}v^k_uC_=l^*f)>pCBcQ6Jc+IevcWL&(>Hcy6eK?PU6${3*A36_#J4VBV*jzI` z$M|)7U<$n9xp%fdDWpFC@)m0klq9w%aJ_=Zk&LFN18Nv~pY6p-hPhh0oWNzt$_NBR zMjl2-8>34`M&F{~fm;oPDSg}*yV^XPnj=-VUJ}J78{v}B^`4BkB zF)@#1@XzIfS?YUUBO~g4(TNcP9`1!L2nEH2PQS!&f~4|S^SLcs<`WN*25JHChD-;eOa{!78z!7ZexCVCw~fzrMNr0VU!X5S#b zTBm=(sJ}5%Xzc#v$rGe8b9=-;cFn_Ho}wtfP~fbeZ*rG$(uM-q#^;hkxg&VHZkJVesBRum0L|dUmwa19YbFi z`f>ZPyQGl!v=}UjR4EvTn~$nbH*?}^{+M0CXI^09B@WlVFM?eey5ookSeAhxv&hFP z&w;4F!<%RM;R`WsfnC6&G#Yi zGnrei*||5iYL9g_s_iXj(D{G*ax7f%{08!>cy2J=7#n*#c~Pb+Yy8KOHOT1?eo`oM zzjUsrZk&FRG6Mo_bpG(H9}ght1LQ#%CG2}zBFsTsT6S5vYtc~t9PnSFGegN}*8iwp zuD$;ImSid0FMIwr3P`JId(qS<)DqLaCiJAc9Z3E-)DMBR#2}|}`rS-Gyb2I{k_8yR z3g31jf|=Bllau%R;aES!qksk|N8Y{D0Uc70tBXCbzwlKK?n@Pus&hSk(ji6h$77Ka zdV$DmO!oq;U|F=mk822$Duem`AQ{@L0KYj_8ooQM-&ya~v*^m8G zw}drevZq*PG5TIDp6it{wOXEb+iCmHFO7ip*H;U?2*z6JPY*Do9|!)v5>VWvD`zP# zSp(rWnyiBMSH3c7jfi~xyS4&V+faT|1@8NFYif|dd4v2PDS+KEO|9(=Q(OwpZAHLh zq@ZNt(fE@;WFQRZ+f7NplasVDQOVNI%l%Y~4g;V0(eHZEbTRQ*Sm&m zG#pxWdE>5_2e!7h5^)P{p-(Af;vRkftRlsX!SZ8Kyu?v3A#Z&iuK!ZWzu(PVBOWwf z^`}dvyBu$Y0c)5n1twG^jO-(iVCW$BQX8IRBZBv|1oUB^)LJKV|)4T>T#9`Z1QT#uD zn_-2kg1j8V`oR0IFaP#YSP&Q%1WXOYA4>O|`TOV6vcPi8l#o67Q$l}A(O>q$6O0Ol zwCLs^a`(p?B~So~H52pM`+e2_oCQocn7#`>zx&(x{`GB68Bd7kKrqVUPmA+og?^5Q z6dpuP4?Wu+|Hof`j>jerIJHb7tPbx#2k_go3nIW&9TKYYuL1n_5lk;UM3(1a1oF>& z|GdLLV&a7Y6C23G?0<{RuP-*3f#D|D3sYhI_Z7gx1hxxKSk>#l4%c%443~5BtvvC6 zUxA0DAfAPPn*;w}hYOd93ZjYsO<+jP5r!JU?2<}*?JxIs0@*h@-kMZQ6UWNZt*rtI zMAlVW^g~{Mn=jbxI%;_0LUj4hHe9OE5_lYBebMnB0=;{Ac{mIMXwbo8Ya!38%kxfP zjRtB1aehtIAMYlpfixwy1}U0AyaqDmq{1m=7J#vi@bU5Sq+9H!DG-39J8M&m_x&(Kk?5Z9#fG^>jx}} zkBg1FCGDY|QFP&8Th#_qp|KWqC2?8H-f_bF7gE`7s3tr^4#LA9mJx_OE{&geL{JlI z4l}G@$FCmlH*v?fiqT)nsuQ1`&mO*NKC5RX^s^W(dN=H0o%71S9*j}21o7ZH4-pNw z4Q%VkfoWAt6}?5RRc2Ab(Rubyd`0>MCf*3KQQ3XS((lXz#SG8=Fi3)1Ug%W!cq3zo z=4_0YTSpffw)&RT#j==m0G>TMjwwe&@zc~q36crZb;N#hFQrV`cXi@V%p-*t1d@226c0qI9@)%&LG8nnXsU{O7Zempt5MYOmvzT9f~z&b2O+`6WHpDr6!72S z;IdEiK(5Pk)%AybFT(_Aib4gtYyEB$F)s^G)i^!XdGvH?Kr>q`gqZC-ip4~> zJ)Ba`ccNF`LGlLan57Cx4)E!bsoi*^+WEosO4iTWqMs+(-XLQ-bfWTArh`I1^c*Y( z+6P=sm;O$P8>BBj*5hZ%gq~e zxA?OpSbOW`JHwJrbC7E^k@zTUwhR#44|wLT6D4{LBXq})w!^-xFTa7Jp9E{KDfaGt zYp5FTy_J18c9xAmy||ae?M2Rr4L%FjDAVoFW?6i$S2>edIL@Vc>8L2b=4yRG(GLR z$Q2*wdp9w3l8dPqJ$)A6X#JII9xK>;YMk@b!51R9;4Yw!4gUZQrojs}aSG<&!hSQM zHUXYx{`(%7_(3nt*OmLp;Vd=M^Ti+WS;5XR#IySicL14H8)!&PtaxQ=((lJH%iHkI z{~X>P>OYH{`$MoyiK-LsyQQipKiN~K^nY}-#j#O z^;-L$Jw7H;eQKGT(Dj?*3ah7peJhskyk7PIa?O}gmOVLc7H*YC?j+wfEizr9Jp*2r z6?ZhP#=~m+&71ghV8i}iP0x*O;i9kO(>#NjNVYhaaCSnUZa#lQKkkFLXV0E}tmP8R z*CW{@=CPMPIBsiadzBhw%C%x&a;};0&|7Ie%};p6i#I3~UY54+d|Wz~Ug$2@RB3N} zW{nO9c~!NK0dGe0ElmRZ6_fGh3`IHAQWV&n>V+akjNeSG7^?6qTBd9*j7i_<8;~e( zVn;VmZ0da?9{UmQXb>yhDYP6Pv-#L{wnH9v`dxYhd!gjm(oHnGo zfBt_Qis^BxYWJ!@%s4FRT+!gt^bKyuTsD^qT_wW#Vl71wmwJ1gsyk)dc71 zUMGXmd`nOmjT(KHLaHzC!MCUVDMB|gaUx&-8r8sPqW47zu}Az!(j9WXKE z-!GW{`-}0QD?AXd9g&Hj{@RiM`!P@+ zf=~eEX86B<|HF(UVA@oJ5UHF*sN>%O^REy@5EH~dLh>;_zkcLSWn0d%(k}kv`hN=!7z+Xxh}96@{F(pz zW5{5YA)ezQq>Fzf(f$|<>01y_lTu0lxy|`~wHh|TVE@0U{5~Z>tp48<71Hc+2hTk* z-5C(m?Ctjobo$;RSU6Z6P|T3VhqXr~XJ=<04I<)qRj<1|(s~yX5}l(_EVdrVKpO3m>Y6aTcyzYBZc-4wKxm9wfBn;>?J0%=yA zqa8hmxsB0cW{VLJ-Z#-6P5>jG4t?P?HLR^6UTlN+# zwwDb;Fd^5&^W$y2-1j&ys%&OogLqU8q=1Om9xgonVOg~4fXVpo$MEvabfKXitlsG( z-k0`tSUmjg!&5g6{<9S_CvYC`mK^Rp08$hhHIBB5#j$_pIMb+7=z@_kh-o<{Y`j5Y zR2@VNX&~{u_w6Z0J4lX%X}g1o>i?`l(;m-}Z&Ypi-@R7Tm(6tCwvwmT4!V+hJctLJZ82*p%!AvVJHKX%^sYbD}jQ@FFZXDE=ndWeHfHI8<9uV9k$8tkI zm)`UE;mEwuK~9*onXqHWK25*zb(w0)=_Y+Ro4G338HD6+zW?LOm@%woift%kd+Nx@ zx<$|5<>=OOFD%-*vix+N@B0vnj7y08kFIDnOWFp}M?ol$Z}C|+kvk(ci+|#F6wn6K zxQG`@-$6Vj2~uR~uBUsAMH%a?lOeYV*nO0dCe?`SXg~t)4gmoT$p73jz`~f#`&s@*PohG$8_46)Sd`=^)zWTzGgnPjbyz zdJW`{w$}OZrW02w>7Opq9^t^NZu06BtUu{lQTWDEd9l?$u^{kZtK^t9W6sWzEsf)o z<<`lt^BNyi>@S};Nk~YniFbOF__T;!cZ8Ihr^gU2t+-z2;i*+hL?>=i3EEaQxTR zpxM4?K>WLnN|S||yNs6Vsnmt;cs0Nsf3p&FaSF5a%EtI!s&~0LUM|)5Q6wGY%))@a z4c;a7molSyW+}2MP+=_@Ukyx^<#s2iPz&#W5&JWMsgMOh!dpLS+T|xFC`j*u>i00ziIIO35_0b%r-O6i#vSpAr0{&h?Muu8}8c?*GVbly7z&u*+ zO|H-3yk8K*Y~*j&r{6sog$a5R<=SnGD1f>n0`r#*)8Kfp9rWbE`d7e;i4R9qbCg>? z6$Y{v$TyziMqzzy6@*O9@Qh#w9Z|g0`N>I5VHl1|k z;=t^#<|*G|w;aRi=U-tL{}G1>ieiJXV-Cv_q*uQs!0b0T?THy5+qNk}_5?>_C79X{49hBYq0tlc3JaIeX_1rCL%`vR7XyW?Wj z3ivNT62#&)>8qtKCOG)oci-auIwEP}8w5cNJOHg9`90BtuQCH%6bD@(^twbPUsZ7o z?8Cc~1*UmV+~?j=KA)(t&EQe&)Cbujn4#iw+(|K`md{qDQ-U*Xe2r+#rDHr&U{GfM zO=~@*Wt!jZEXD_D(*J%W;C@j7+XE~SFN0)OWD=jtS(L;!hi2#taNN@WNr4P|21S*)*5P!<8v|aG z*EGQ57K-U`x&(P{MEZQm>OGU6Q7~yLNTi4_VttRJ zlM@N6hetA~Cq-neeswAdJ0kfkaf1+?eZCtq)-Ke&&U-JLz&U#w4`16pxK9?hoJ=4a zSZvaJ=AX4)yJc`G`^kIQI^hx- z@Avcj>vtT#f4=`bM^8C!@B4aR*Lj`iYn*3v5wPpmqjBQJah*Z~K+i=K-5yyZI?`r) zx7c~gid}rHaNq8-Fp*NCvfMP5XZq}{IxM`G*WzWY=O!x3^j?0ZrCX`+!M~m^cOX9b z=&xu;lbUU!=xjuPYHKNg=SBjhrDv+cU* z{+5ytA+70wVwJ3a2lv#24eN(I2^H2%?hMyPU4Mp)G|*yLqva!6n$_3G8^vElc=<=l zsq{IDz7&nceT`1mLmZ{VIeH9w>5;y=D=N*@QbNjiSvW8Q;(bapn>BWMEl%pIOom#b zefA_82NpdJ7HWK5O&alKaUxmrh`6=Hw<`LxV8DUFi-Rk#E#GV_v5WBc0c_T z<#h#A#qhzZIPvmSwwHP4Fl)k=H@@xj!^6_Vec5ObO-P4Qk;shPK|=_gjJxrFzepC-%U zduqLneQn$Ffup@oD7`VwbKZURqaMXm=eH)JlMjYxa(z|&v5D|eHU}a!0t&IUG%LP~ z^o@oseE~`ABxWXev4+jG@7G92ga;OJLHL+eEHgzh#1{Iu%*%&ia!>D75f!mKzyF)qJa=A-?5K&Urqvx@l%9l4&Fi6ghlxuy5Hu_-rqDe|~R&bn~LY_(K>a?N&;avZXw_e6R13 zLU|NuzShEFqjD2ZxI`d-Lq*f!gTgxH`~TMF&dO6@oVYsygImH8Ks$GzZPpP;cjk;h zAN%1t?}44`Wg7^{;*4KDy0v_a7kWm6a_fP!ZfCKRb+cg{`PN&x_s)v!x>V27NR{P= z6l~oSB>h5S=-WhW++Oz_wp=agmTY%WRh+u^eY}|Mtie(45>Ql6S43Y=%oL z?JAWae(ah@3b_$EwUxrwCx43L3O0G^J;yx+A^WV!h0!jbrhDEi#T)7W_Sh_t)X$h$ zW@ZvLTbhdyJG5SQdqjCY-q^ZLN6uR{hTob6Ap(Ge)D5jO7EKVq3C3#yR^`b_gyxz3 zb7^jWD-sEe_4)BjCf4yap98v~?|~ZBL-XfUzY#Q;iAJhqcrZ*zT)Bvc{cQeom+Qu? zA;?W*>5ckWDPgxZe6USvEy`Maw@sYq^zSRNA?rv=P*HH>a2< z-Jr-}pkvP-vX4R;qWoMd-e|sMVenc>NNvpYy$0n_4PVT7TY8LLgE3Cia=r$rkRHCG zRgAsm(ZnzeTfhCK`BqErg^&}MzT$d$Tids2 zNV%=I+TLobKyk_i#LQFBG8k$-wVduQO8HU&i7qE-?XJ^o?b4HofCft$WC%%5GDv(< z`uIvI$<0kjrbtI2=Q_uULIMg`d};4Dod?}!e=1m{);&T1bH=Dw7u$`8KxTi0-aie# zc-iS(idkU#0|K>EdbV`(R`c}ZAkl0*d%>Zlv&0k6}8^k*SG;KELl zh(b>z^!%?MmUZ5q9ZEtM?W1_iC%G>Fjm|O3`TQ?(sAc-jCqYZwYN(t^EFM0Z$g_n@ z5f=L@2rbfS=yZIESyf`g;I?`gc%UKIQr)sCNiL+zoaoOh1}P4Jfg?Is)c%6HDp-R- zM?k}G6^7smppF)XDm~CHwv5fNIG5&I8axYLbDngLv%(u6JXo}56>P1MHnkiqoWMflpj6ZDe?XnJXZi#7TH467UWpYTf_-6ZQcJo=eA8{okJjdjL=Zfvn0$|KkaEmJ_Rwyuu;bE6TfT{-1xk z2~i=-M_TJY|9;Oc0pN25r_3XV-NpUSbuqaFi+$j1_J9A0erg2I6;y*sF8}p69S4Z? zrpZ&P|NavN@UZqZPZOW-e8d0w)qeo@Zh{|>_TPV^P#PXqKk&%V-y*EtFAPlMeOUeD zI%a=MTL1b9P6W?&NIJv%-#5blZI%D|dKmw2tNd>}^Z&NW|F2uc%t=9l?M8eBTxDoh zso7>IX=^)olqLPqFW$W|{T5g?+W68OBqE0x7`UN8dxid3K3i(q8`r15&+Wm zdt{yfv}xIMY2dghLklxf${VE5Jb0#AzfWXqt*$bRE%Z3~)t2hfe>5hN!@>?@E+6L_ z`Y1Bvj4ah=V!GBPo+R|gYu2TfUIQQ=KDK4l~@tBwNr+NF5VirHyXfv)v)IC*RRniu|U|in9Ecb z9R?pD5YdL#*Dqh>K(x*5GTlw%(d>Ns1gvvtq z(_=Apd`3i5@;-G$4n!|JYh0}Fy=hU6&-newjy|i6D(%U6P9%}`>=NY8N^Nyyy!<4I zeFrnevl>v9ph~Jc+1^LS|J$Jn^&t8Pn;LWL{x$D|oG7)rZ+A(O9%6e{q$aeQt(3w6 zgx&8lb!)WYq#Jn02f<5p1gG_?I1|xiv&P*~TPS6zk?5P4N%U5@{$e;U30Gh-VN0jH zR_0+;PSot-<~f!Z5s`U(!9O&7PV)e-3#?X$!$GV`eOmJ%XD^H@aM(@Il1$O& zNfH!ZD2pd9Zv#d^5%dTaJy)BAPRe6q7i-7AlWqO=Z9o$X+A&Ji-^xF6>69orab^^iu%m7z7IduB)&NYugVQ*I) zM(YWGwXLpH@}ATS-pwC@A4z0AXVb~2&w(3%n|X8SkJQ*z8*&bppwd@MC5~fF`D-lg z9~8-soatv{a;Dy!?lj4m%n#S)3#4&A|HDXw>J4lqS55^@5au#e0-t!lgaImr{es*y zf8~$BwdGQH3(FDX?egjgNX;kxP=rR(1Z*xR4;)JI{Qy+Nxl5D0!hfj~zaK3G*{==N z92him!sB*?JpG1{w)KiG#dgiZeyJ|J^($nG^b7!(bKv`tPgP468TmxMm*<2YAV9XamO% zmM)NByEb#GetATNaIUhpyNj}Y0XH6X9egS?2=(n;i@Hh`gc7bU1jaK5c|W2rs~JB3 zr|6cI2PQ&|N3nhueOf;3KY(Wx9xDkl-qZmofJ&(BuIh2IGBZDLUTp?t$yoC%3d3-r zpNv+3C;nm-}iT~qAlz=t<|Kd}Q5nNO%>NvJ@5)cr;%*+Rl(e{$RcbRzxxRI=+bm9iyZw8g&sDDr`Yp^FH}Y9zx&FRJBjTC`x+iHE{Vlc%YB-Ups_(n|SxScSQZDKu_(yJb z=E}9D>6%8jKjY9=&M29aZ;a;ugL7~5*o-0Qwb?R&SLWccSGDv3lS$RijP1TNUx%>& zY+yZeqXJqQ$t!@S=F7wA8`$&B7e*Ts z!-I31t^mc9e9502{wG91hzJ`V&1ZS7*Gd5!=e1VV-EKkIkMJSjsh0%f?&+M~+9=B` zo2cJM|7YxH3BOZDK@VT6jtx zCg_By8L+H!oL?RH6p)hC_DW>fd-n*&x(YIjF1AIVYkjL70ijAB;3R45Wyr<)N*wE5 zW_mdxRSS6`>{1;_FKh;IJL18p2CncdEMbIRo|WHzsmpslm=c2_%>9Z3hC(TB^XarL z9}COZmW`Rd^76;D{PMs>5en^jHCM?BPXU&D6?UlEiAn1NF+hgN`k)CVd)=mP-v%=2 zdT<8f`~)z42xhA9b93YQ`~17B9Gud4t-76hB$m>&{UJda`w!xMBSrzUe*>5rER5_i zwqEN}LKs6ZsJEABrRki6^AKL@u`CZ7zNw5y|1VmnLdl9oJk(T|G4XHD)uD)Fr5J&O zc#v#lpVi62Ao&2y7k&b-kM-1q`RV_yO!?>UF3Q2jU?qHsqV#Z2-B;{BfS*rW47P6( zT=zquyAAu?nzHsQXJ!Cr9INJd|W&|h7UoSVt(zPl!^pWJ%B8rd4`eyZzz)bvp=nX|y9*a(90BB}RvbrIagVfmk} z{(W@DbV8n2i$qMNr9dIpKqHKUW3Aa@1RtpzuJ?hm`_5rV+tG)h+Hr}P`}}cIC!yBIO4g>H`I{x%%+tVSp{jkU=bKw2Z0+6 z=P|D)FnsoqB+0J=v`Ryr)|uf*n+HT2nQHhxAJS$iA?L|608pz0oXR?|lj>(zAoc+yIQp?$q5!iuVGroC&~e8o`WqaKU|w|;SD08FM;C$ zNxoOqdDHul1%7EMCQqJdUg$8*kG?{fqWpq(;U~0}8DBA{Ez~P@&jVe_H*e~hf44=2 zG&;dJJ>`?~6B^#jaJkk!%cB{9hE6;VEw4S#lT=y(Yg~63N{}-kHIaA1%P1aaM=ng=Ex3o37u|Iz zeOgG)8kZS3o-I`k&8Oax#$Y`N>3Rqo;O10JKW3x%mSQzjzSAy&JS$v72nhW#J9XcE zofNG5d@RT;0;q(mY`ughSazukj2VIRbho8el4*!v47JQ_Nfbvo5)50a4-ux&=xQ2W(Q9y#7Y`wezpTP^r|l}KS{bCGlnQnEGRM7Lcx@> zWO#2cYrpQwjuCHJ4A~P@c+kMbhk~LmI@}N%g;ZrMz$Ne$BqwsfyM)$iLmc8&(Z6d{ z;(EU7PA!J93EjCF_9Bc)hFrL#YA1@4AGUXNa!t1kZu+zd`s*awH@;SuWN3PlAJZ#% zY#Gn@gOs%p4z!frxMZr~{Bk+YkWW^6Hx;nYz<^03+5YE8=wiMU5NiO=Xk&+*IuUF7 zwOM0*_8Wkpe=)DbVwefuXr)_O^E=OX=?O;dM5S?L4dUyrf@bc>!FwS0sR7Q9DVs~{ zE=C^hj{nN{bF#+!%Oloewkv9f%*A#t$KWlrmN`g3sQnBh!G`@Q?H3eA!+Pg#DruR> zVDz&_FH$F@3>J4CaH8Ll1Ntn$H%0Y>tKr&W4h?xDfHH{D8`OLsbq~~>GEsk$g5<~d`;AjOzZZ+mApm;mI%zJPw5)0M+_rKmR0Efa97$4M1w!?6 zR3(S;sW!mRgk_)KDdFhOLNvfYiv+1e=Q^NxrF^${vo8gqbj<^_(|F7I53KZ+#kWVk zCvJWiH{ML+G(ZTegDx?ie-@f23F|cF43eC&AMaio6xyHETo;6<0UaRF(iKSNQc=&t zqn2bO#5*7Y*RK+ob-`NGW&2)5yT@t|9!q)9{@2PQ;yeUR7=(bD zuO(z&eFRB-b%!5uWCVlkrBg4qmPAS(j=)bu^url(1e74;>%77Zdqy^PCZo~C)+>lxF=iwIb-rtRi$Q6~Oh2gk8>g%EO z>HdLGcFi}HaM!3Cyl_6AluiV~)RCIEJz0a0uq{VjfVYGJ?UZ0pp3_`M&W)iT?@W0h z^BrqR4K@2dIr@#zQt8XmKcUG!9izn>Q3C3x6qb(#eO}fl24JK8%7648x{ateuOZ4b zE#Gv%s@(<#$ipxnI-{5STJibCE71Zr?5xVqgCTQ_S?=t4T?QB*6UY$PwfjI|2#zml zNc@?|sLztc;vt zc{X6X41m1+{s|WrAGwR>>GaW2J2W3N?d+mhdxi+%+PCxK614YUX9 zpDuGJLh@@vr2hn@#)7wpE7uk$JTbKU;{|+!eD^Sopvh0cJUn!IFjPhCyyuEFBjy{I zf~^P^J}Amo)5!HFVe#g^=GZSg`4t|48|uP$ox4?f)xf#T-LJmdtC4 z8pZeiBO!%HP(D~W8Fu%cS|Bv6iI&JGBB!%hTda?{Fk>EIITei{eUNN_`-H1;j70Xy z_N)2N|MXMgY3HJ5#gDno4L<$gOB@s7Oq}aBf4!sd*2^PjR56ZcQJzJoEg2Hv2;EY+ z#r79T#C+(Y`@-uY*2dpe&?qLtf{S5yQ7L7O@!APc5Z{>(vnU3GY`ArQv=elhl7(Ze zh}(h`Nsjjm?C(ouYvUY9RxxtZJCzG|q(>4eP zscoy{$ZZI2aqSf18;p?nU6AkrMtm(rX1)%RUN$HoQ;~Xf;X|2NOB^u67P|Mz>1lHX z%E`4vZVh~{dE^BBRcB{$JX9=uR<-}84+ukLAutTV5q_T*uUGX7_U#;$<<+17Wd2Zm zw)AEKiSmz9kAg9tMF76lptx*&q$a0%v8e%8xdvd{#1p6$C}juX6f7@Jq^6^wzY*j5($wJt z1RE>Afer-|;Lu{kM0IQ@b2elELxHw*M)qepODNb78!-reG1#4SBp7 zv|5EX@*^T{PkfoCLhf`(X;W|;5RqeSo!@9@PKUP9@t`3JqhjBue=h6Yx-Vp%*>ps#rlhOx`TikCZ2GGs}dk-k}e1*WB1!wc9_dfV}Wd z-f-Tb5ZotkPD?N-59YNS@p48k=7`;EZ^LU;q_uz&O79sQ+W_1T{7%nQXVW+7Au~lI zC)lne-eY?dcq1hhw0wwiJ92qr*K!_wo{&e_tsr;!F%jP7pc9;16u5LAXxGxVzw)h; zwv&CYMRH-`MN0@y4Xyf~R(eO9wNjt~57G@vnwY!o89sC$IiF{ntH88390BBo&^Kk0 z0LgSM_u`ZQ|5ZB8_#)q`l^v&h&^yyK1S<5VG;RIkE8-jN57YGvo<&9;Yvl4qaPq#T zywkocQ)Lf!Z`$B@kRGEeiqExnvdbkSm>EEzNVt?Ue>lDXmsiwcAN0(_>uSU+Uq~o7 z3Z77i>9JC+ASGa)<~n2YlTwUM*!k=|gVdU9i-hh_GhoXk)e8h%xRWm^XdwwUasfw1 zX|}xHY`w+lIQhgP*82*_9Rlr}o-&T%01f{x@sB+my&xRIrp_|o`xduCkunPOL@fTA z$)lOd$GNJe22C<}_=XsR9Fr><~&>Zaf>p=Y{#D-nxz( z*}1X^lmqf)zN+=p>9vUxXr(QR_4I0WTE0ktMaJ|rGdI)E6Wk>{JUJbdp)#YN_%zL$ z8?31uqdMePX)~o><<~T|=8AoB%ip0z7XND@*P;RJP<%PnTJOXNAvwE!YWB0m_KA^u zUfc@>ymZ7C9mt67tH1BX;Q)x%^#SBIz*#U%qsb!>pv?zFb^=0o5NZ9E zzb4A;r#;5_a`g($P}9LLKQnptahbyf10gaO$!Ssc4i1he%+H0pnoO%zt&`tMDamV2xVI{DHNHL8>s5!!1p zHe(N{?I(BD;Dh@Yg|9i`AF1oJEYJa8*AEfd>L}h<`j6KA=)p8oe5?wgUA_mAZUf(1RJZ&v^+EY`&kueEB`L@(e{0ilduUh_nBcw=gs5r|69 z{9jq;?VjVd1f?YR^b<)sbw_(gw*E&hXo+@D*Re+oOKx}`&X6`ugk z_)Tw3e19Vs`%gHRutra`J8mAp~1Uw;UJFl#}V&8#@P9& zLO$AVW92u`)sF-Sx(!WDITH=DQ&=p&U@h`c4b{iorxKPQ7?mw$(Jicu;<$|{3azF0 zmrlC>j1DEWA9p{H621zJ@MLm>o({!#H9k6Hl=(O@ujE#tV`d5*feY~5 zLrLX_*SxJRJ0t0<3T89Nz_{wPr^OVm|8!Bw&+jn;HqomTKx$;9>V=c*r5&{}@-B>J z7oq-B;6d5pQ$qkw@KfBS3n2i+SJ%D;50|Cq&DMV}xEr%W<>4BYGMz#c|F!w0B8 z4AQ(;LMX~Q#<aF$Dz7PR0sl|JVy^!t=7uixg@zj#}ce!(LV;WbCg z-ukk5QV%W8OX8z08o0N;@o^UwF9C^ggNDbYs!H+<5>%uyoBzg3-&Lz+Q9XT@TTOZb zozF#!@IE-w*f{7zvhq1#{x6S}0b@Lc8nnv^Gm~2^!!$!J5L)-jEmy#+aG3}?<~~6T z8z~;?0B_61iFqagEMDy1B{yS^unW*k@6ZAE;D7NTU_81x`&UpE2QGA*6fZRfsJ^cY zCMgZzl3V%Y1`lu{K0fLW#4q(?g#@1Wb+82e|B72vawNJ`%Fj;Ef z2Y7+sFrA1arY)mAtZ)&NRie1dnAzuJf8nEG;@~}vbUpsoM*!|?SBp(pLUy=b8J*%Fg_!M-J4|^k+l{?+90@`#vTkGSg zUBJ6gA3@ZSyBZ)3rc)cUpD13ri>~z>alc-aC>Qv3;92goI>-<$uTudOi`1vv9SrF& zzJ>bi`niWlF7ticUBI@_VyXlr3(yX5rAJmSVD+B@M#{K9P6w!9>Vmk0=Oe-Wb~dLk)KTVl^a8LdE>;2wE_W>@=!j)I`gM|_{iYB z(YXI&MvX;4qEV^)Ln2;ZCvNI$_o|(b|GAIv<`30{p|Ax2BO?<(fBP0d#2TUix?Y|h z>ef_s8NSi@b{fc~1!fk7F1_cE7WXc*P?aEVZ*@b89mYtk*hoY5Q@w-P;QxajPg^D( zk=w4leoCKOayFTUYj?m)3aRVI`1wiY7Jp02D90l<2TUw%=uT|CN*3vogxnk2WRyU& zM+}0T^nLQ~VX}GD2kCGT^gORUQ2c&5r0L(v7Vt8tB(H1T20*=8Pgnme>ta*qX7qxX z^!qJHBcHg5do10AE|`z+EHughn4M4J3b4!|tdzj&D$^BEut)E;A_f_k;G1WGM3{vPONo($@V};d%n}j@sNe5s3gcl#oR+l2M4# z#9?eC&RZaFIYlKd)<9r~PQelr01B?#7|{bZS7kTgyruLBEl&Hw@;!3af0Leq*u`9& z2Ep7;K>~0{<9@yjJQ-Y49LR%^{y8D=9iq-tZjSup7iHWego?@)kaTk((GZNGF~eyx z1rVPoygPZ^HpqMK*Vyjy1KqAQZ`bcD)8rxt;EO!n0i%RR|*Y-I-Rfsn*p9-V7sv z<$I8ZbzXg$HzTP89OOPctm?bUe{dD({+3HL34rdY+n@6cFx$`DNrdd^j@;AM4;i0p+og)uo?q$+fsTuCWJ&P zf^r~}GkI&m)p07wqc@tAE3TOVX#U*e;HLy7*e2M1H{Hs|4cq|!lbS+g2+CrrkZl?Jout?VY2TH3k_3tc2n|6eeNn z<~r9Q9%Y0oC|PXNKQ!K7R?zLBPswF+XyZt1!dsDpGsdb4*m@NtRh5JdH~0Zbq!1MU zM>Uhk4YwCoTmqsB()TGFaQ|j>f9k7Pq!~*!w4OKR`n);M;)R0(gE{syQe{@0M+-U( zZa1k(nzJA~<2j1?vqneH0KE@RYt8HRu{Oo*^l;uS7>(Z(G}&U|oG`(Xhaw&0kSZU> z24sL9@7xqwH8mhV&~pp{O!NwD>F1)M_v;Y{qkqWZq$k+7XcV;^gx6Z%Z1B+5z!(M& zglG=~+6ByIXWZ3Xed3Q<6zjfffta7Y%Vk-*lpu9 zey%lyX5DsH(0MYF zhGY}2$!zyUt41$>8r7QL{z2$}sC$#I=mx#4@{PFw1R^%_nBp(`{q^{hT9Evhcjj7N zf6i+oF$;YKPa+57qESDvmls62EVOI24V}XG*;@IX_MAqVDnKuTcVkf>ehW+DAvhof zso4V*7I&*z3lA_Go;q7V7_M7&K)2h=(0pwm?#VI|^nVfNmMcxor9p@ZNRSOdZ}o&h(l>rRu|;H8#@y9u2#zr*1odsUXS zkOvj-YcUqDi}aF9(|LEQ;u6Ec1)I(mk(G9dfogfy!n+q;4g-cz<>&cNM9cxzn~16+-YFKDQ1D8@&^xj=3YM#w*{j<)=#WWm_+TsvIrF0q*g(Nheb+1|1A(2 zhXbriykddd0yr%UShgA}ZG(g7>T#a{m`*mU3fT&E-6aB$$NWKk(PjF1Z4|Ez(w}V= zx_}@8qy0Mm-x`Th!6w9FZg#@T+7H?1XR| zi{W%Z@cMee-ADQFSEI&+kfBIxXCS0B0lsI*B29nn2y+YM;OHWXzK_Su@I?M}nS&F` zx=mMPrGZDE8=In*EZ$rz{<5S6QUb=v_)ZmqZL(Y_OSZ?dE!6+6108sAAk8+39+>{| z?h*nsLZ~E*tp7WCXUs#dWr+h6AKH59HP|J?mM-1)XT4CSLrupog0UhPs<^v&4MzC^4s zQ9JQ@`z0Ph3exq)mXv(BWwMH_BeLVfy?Y4`fbt^p&5$k$a)$o-DEO1A4`7X{aQvmt zKceQOZCreZq%}MLyn!TX(9u=l4a3$%;Pt8yX#^FvD_wks^V;qEvHjy&r)Phd20?eh zf3FJUQ3|Dzas>EKc?dzLuDRhhao>7hROs^Kyy+IS?e?f& zjh$JI9Vx02?8~#$XgYat&(rUIkL^Dll3>i>KtV`7%>N0}7b#B8Lw|3_y+6;`OE~xK zHWA#hw(CF@nTAL!bvi*w)&=*9X^7avy|ODz?;+R8ci(P8F?3%1HDcg}a9tWX<4?cK zObmMZ6lS0bM-v0OS2n#t8LUx%j}*7QIB^5OvuwDYr1)(P?G~F5iAvbwiR2-Z&j(Pu zV+*)}*9=LdTX5@Ifbt|89*k>zER+!<@jn3uGq>-v6Cu*2%m$h%q$FUWx8m{eoE#u8 zCqQkM4pwHvLYdQ74(%0q`iO9!1EVho;MGW{1LxTf#9a_1u0ns$`nFquwsjfZ`7NzI znt2xoG)=>IX!!@jWNNa*xsLDQ;~0^zrb-0DO`DN>Kje)tjH>54 z;O7qMPKX$t1N3SAjz4y`*!H4_sQ1_M);SO}}OS1JtZ6F3m;b^;AN1@Ec=HXI8pkIa+p5RLqYQq!j} zmf(kQ6O1uwhkw0Jd&mMBKDU*)-FA6;r{#)F6tt5|EQ0&j$g!DH9HLep$c+lAf#7$#BB@>M2Z$ug0obFV)C8>tum91;iPcu;<(#G;BXG^%2tM!!Y4#@@0l`Fr3C z;#i$lS!S~uDu=vqxd43S!Z3N_XsakxF1?O%09sITKnK+~P9=Xn4lX!h^geac-j^~I z7mfrMcfCojgMNnLbM z@>!VJmHfVMZO;eYb}m?EUf{+~%PbTCa=AZL(>Do%SSR680~0W)@@vvk?tUlA2l<$f z8mQ3KQ7C*8Ql%N`1l+He(M2M z6-N)yKLRkzB-pm@iLH_Yx^!Mk(&hROn;2AnJWFNv3 z2OY!;fK4sDZJ_t^BvHRzS5Az1A;>* zDm2ZPt8U-PUf=i%Gbkg+0uhb&1jwdRZs~0Maw)~(H-4@!Vq_&*p zN6xns-W#`!Z#@j-MURKS1H+TCum`j)vVk~XHgIT{>6iO*QB=H+?Dh`_tH>5 zKv8voUZ@2TApU@BE?C%MlFG;6$VJ#ZoWPDU^g+xSxn|qpq~`-#+$6)WpA*p6SOoxWQSkLmlUtBAI0v<`eAAV{Hzu{nnMMV4=9Q7P4bDBR8#2sk;P?Le9y4{V>eZUDjq->F6jiHh6Z8Aqmv(TF$wEV z5_X5o!Ydn+woZ^K+gQ~ZfL|lxCzM}5pzco7&NND?MlDt&2kO_lNhLk{3Z?2LYRx<5 z&YW*!Hz2Ln`h5BPl}d6s0!k!PoP@!A)sAGI^^K}*>Zi1jBX;X_@XQP~JMjR!%#~^c zZnQjVVDDq8wFXKb9q73>nU?cizUWv`ldS`1lukZl=X;k-=ndAIca2nNpK6BBXNzwD ztevkDOo*>eVf;1y?To_J(AM=kkQFb%yNhNg0uj9}>kG#aX%Dp&0Q}yQE!1)ie!6}x zh_j_`1MY_IE2-w{klN(jxwls034`-eX3i$NHAoP5u)TVI4IrZ$hiJjlgtDM~yFOd+ z%J4c7Di0$FV^_I%In!*Hrx3S?$durp7a$i5I?4V2a`a!8Ij{;TdnUoOxzpFCZxYrUy>taTJU z<77BqA5t!V=jGq|xXtSqC%vF6(UzH+jZ{)v;(&+?{6e1ot1Hd7f5pBy_h zHJ>uGFB8k#I5)lAz4CBG@C;Yn!P``37dL+OmwG2I8vaav;YLoQ4If%GwJ#B# zzBa3u{O#0CvD_8uM|#6w#s|()uLep-TcsyccamDw#k}D5)fwb|)!cGJ<>-_Ze{ih? zXK!nWlmur?XepteUR>%|gWJbHuRpnw)>i<>SC(zEfe@2TOtm%2o2d1$icX{d=OS&> zvUK+H1J#pv71_b7FjU~@74&NrEnGwV^}d@CragS799MP#N)8}io{hT#S35<^Zt2=w zVsDdReVVG|%c)T#+2ylVQ!i@UPsI8@cIu<9Yg>4C(e9nHdO7EsXT{YU)i=0>MZ--! z%N$O5dX9{%v>R33>7iUR{K+3!w-4vqSX-!8l=iwL^p`w zC6uB>d_Z+n_{axn=uRX7yAkV_Qow$a!BlX604+nM#=7kA#O-jlV4lOC5(p4KgOcM=BJb_!H_x2e!U zVr#E0pD%#5qR1S2fM>xsrNexd zZ|>eNMvT256|emo`SDZW%)h_k!}LE7;R;tHgx&Znb=!jX)+p{K)DzB zX5_h%wN5;w)I~+LEXvPi2{GT}B$xgS(is%=xtES=h-x^tNINVOdYy18C4pwDH2B5& z*b=_Ksv4icBdTOLWQepoVSACH6-GT>c9+pEP8+a zo>aLq1oKe~_1ymBz9mQwb+lM@Tb5`UvY@6)8Tq@uVdOwtg@L&$Q6pwt?9!*uSf@5! zAC}UkVOsg&-*40<=61^hMt$@?UA*{bI3V?mpON8Cr(_`V2c@-#A=!)5S55c6BH4o% zpUM*$ej`cd3guIFC(7H;z{eK zbbZ^RFYqqHZRyGWs^xqv_U)(P`AoG{4?PNy6bjsqAmQ?ozpf)Rjv(y2+ z(etZxT6-Q3UVtvuvGdpNb>)J@Kmfd$kbgwc->yAB7UBWy`4kjHS?bDyU(%bil7W+w zD|S7*xAfIRer49RFQms|1c@Qo^|Zk3rpO8HC~P4*<-$3x1Q$+}rNMT3wEMy(5Mj+V zq+N2C8MsxQVMMJS7%6!aCFfDE`}<7b*F~QH6!8t{2=#%~0qoA^{O75q6p#j~Y;r^OGq|NUkc8U4hXav(vwm-EOXTdw zk@9zXe824Of5QEBYH}TDNM2a7gC{8exNYHwFNn8ce~Y=BzIPM`e1k$97%>CWQ0|hgL1%Q2l{k&<7S&b>-4w z4d;@LRE8kMmwv1Q;buj}~%tafD>lilnT zF>Typ@ep3wQ^I`P9xKGP*$UkYdvFYQWi;sIHyA(%d)} zm#lGiH()$R9L$q2^7>Z2=4>Wf?tu84%kqE-7L<9e7t7SiwdGlB>*rcL4G@M>4Wf^V+K5e4Z85t8>h`zx^X$E+m_J$lvkoC@j0qel$FE46J4gYtYBxBVS~{J`%M?58Xg$rN>!_1}FH zoKR7^+-nVV%D4tJdm3(IuUUj+|GbkP5ijRwlyCrNV?L z&FREnEtGZOHa)V;Cb)Xt)EJ%vOW||JJ1EYjLZ;+iP&TNj+cnSqq+li{$M`*BC&|!x zmpJk4IsW^{U4}55?t|lpR8>$raj3>)x`+9NX^smzBpqN7>()NRZed(@rzo@V-J>M= zasb$pCsO;TRC;ESa&N}Gg`u@ccAojn>p2O-Ak%|hn~T~oe7jlk)4qFTfFuKcV{}9Z0M{M>zX7F<1B|UkF_Vf<8+-qJ>uhrIbkhvWNo#a(o{mwO*fP^E z!85jJGvzi1Pd~fGS8%_tnx`)HX-qh(n7jn2eZ>Q>J`x_td_$yJ92lfo`EcS26_e#f zmL8e=9BOaWUj>!|d!8cKbeq?;-K2Q9VYZ=)wq%{3zC5EwbKi?viTT<7*?PJ+Ya8Py z#5ywN9K93k<&2zVqeEynNdT^4EWvVp-ym`-e*sFYzR@c|%P@GLu#L~?q;(;Ew{w?` zGhA8z`r+ql9N)dEs^w+hX!o%o$puj62O!yph6^hZ_zupfn<3^lo25k@Zs+_;Ms;*4PpU6ii08deC-$mFi(a z>ugR)QSKd8oycXBIOD*gtwvp$z17nVfsCBybssFqISPe!ku z%8&A}uXF+uaMVwRfU**UIV^xEt!dJf%2y&y1Lexk5kCXN_k{+dLr#(=2gVMY#S%W@ zOtbw=Oz)`5$Z%>$E4M(%cPH*X>O+bx6!bI$G&)3M`!W3#k2bGe zEeG%0B*fnWFmn5g`bAf08WL$<#Q-Zei-wFlVJ0IA3|Z?mrKXe~&c8$ld*vh9 z=($X z!??p_(C6W%m;c$;QcYWk$tQ%q15UImFZm=IL{d{6T>tcazs4FIOod_}Ek>pXfd6g! zR0TynprV#mg8#g5gmQxsY<-#pBJ;JpO8_B7-tSI@UNnFN^&n}I?hAEO0I}c_Jc0nY z3NN7`N%^=6GTeLhibM*CpY{F9KmY=bR5N}p575N+0)FXzbYt@-WPB+PU-OYC7k9r| ze8gqKPb^tNsHs;53LvifsG)S|q?{s2yi@TE24ZPhMvLVV07+belqiyY9&jQ`QJ+iX zf}cIVBjaz|&s4>fr$N0o?Y;#qj`BcAWoGFgt)M`)A5q(-W=k-UjGj0t8)Pu$3R%|@ zWVY|uAIs7p28S^rF+S+${&nb5INh5D)zjC2T}uOMGojI8bJaY;@H!NBap{0ET{CKN zeGB@^gTD@LM=i#D^y*fb$zpq$K>jMp^J3Cdn%Ijb6{rbFpHsRrLD}xUG-(OLA2d^b z>#PQ0N#*!0bwMB8<0r%O-r}QW9a92ao*<}?YBtL$KDO8#t#p0O9qA3*12ZNvcqD2{ z;vEqaNCDSNxsuYtgrGNJ4ffJec|w*gub*y$MV;TS@SKe}R3`5SLlizb*R{JmU>D_E z2#kyWy>!90do*$UD<+)v9m$))NdRx}A10|*3O@;^`GEh2t?!QKy8Zq~l#vqQ4vFj$ zB_oxPviIJSLbj}I3Xz1gjEwA^&D+c$=W$ z&htE<&(pBrnObJ@=~!QdYeD%m@qHf8MF!uq83?-CyDyvreI~r|tAaYnr(vMQp<S1q&W$i5<#vwV>G_}c+jgmPpQb6mLPssaVByi zY-BIl<=m^euF2R(irR3!j?R-NxF0oenEvHdnQZJ$Stw75=at(ckoyxfF$M{{kj$x` zPFe7WT+9!*CvH4>8NeO9tbo*l@&w~ygL9)vb` zS$H-wKMT@*0e!=wnkV($B0K>eMe~z<3ELE&iYxgN*T3S%YkrRE&^n_VVvuuc{Niu5 z*Sgu;kS!-Jy<#B3CnG!?uX!H%ia-M|IU!iDh0X2*0X4o%8>!POz&KI5TL6Kx{wTIE zxIbUi)eD0+RVnwXfwQ?_dNomI3v4SaP>oG#lurI-oSNqOG!!;Pu>8r*L9CbB{awPM zeI0||Lu|xeD*5M>0nq8P&?cG|hAnuTEB>KAWt(}vQSOrH6#b7|5(Mk0Yn^;DK-*6+19w{*dI zcG%P(4!EGo^3?6pnDel=&F}ZN@XHwn@yYX#)W8il5bCKczgtRvmZbI2Pa`HboE^&q zGjTVZitUB+6Yi4_(yO6p_ton%*E3)S0$j-ku+X*ri7B&y37zvJ^mPus)Ay_7~uUoX#Q-MIF`ud&?a9Q<|6^vftR z+b7i*PbD4k(e29|R!)ky>;wFB@EHt6l2&QY?(%%H=a`*kxf!8&nPb528gP$FxN=I* z4ipblnWyD}+QU!prG<{7QRvrbp>H9@@vh4191cKPO0`UT$@xh5S8e&>#3MDLBE>hA znq3@1g6!juh)rp!@U7uUi%jWHegCxVP&B1As};hQLv)vqwpgNQi>CP-?dyxrjt6Hk zhNa?z7;=950skwr)`cQj{W`+r)03j}iURwO<7&OFH=+H7=@by3WR))erd_e&Cfsn= zy6tbm;v5n5)rE8Legd53NXqcsGc9-SUcLZc9%ZXtEoOg-;-r?u(p5&8C-5G+r9s2kG4}O4M_-x0pH;k~{6P(hMEq3tr#wge4e4 ziOdK6fB?LGEn{nSvfQSa#`0qCFc3+JUnET&Q+6@>J6JRP)cOhKhx0j4Xn9Qq%sznL zpMr@CN^|${JHnJj0(S!dM*0;(!#)U9;o7fCuT;*`9DaF#3W#aqlNaNOWm|RJtg~&^ z9)-thJcUd8HmQ?O{2?ae<2yWt#)it3Opkv^8@>#9QHfc|YTVTyUe+C8BNenOUTFzY z%X#ASC7|)jupfmy`grK)sQkrjzVJcYFMg{Vq~^4E8kO;XIu7_);FI)mxQ;deHME<3 z(bEPL9^~-UX88GSBj>36_b>OxPh0Td{_{b}Zitx#@#+?`-=!cGoia0Iw6>egE>Xn| zJNt!UqhCxm|j3w@GnG8nt#%mJy1r+VjpG;oybl(y?!p(cuEU4dz0 zB?Hh;bZ%mK%{(V_c9f9$T@CnH%z@~6^QBWmh{hCjSnu7>hWVX0`foxFj%X2oUw|kq z5mL6&U59&t#9(aOHSD4EP!KtcZRb0w%=H_NQ7t$(L>kAmQbvt3Q6-4^;t4`|N(;DH z?wHBT<3?B5uv%WR>mCvyP*$R-)55yF>0#(YzmQv26XCMWZAAL{$H&Ka@O&NN~cELKpBDUwW zYgZ8J0o?l*IFPjPKjw6_h24^3pI?BykxGDD`K@YarCC0rY^_Z$8#1cMkH&xIvY#Si z9wQTr>R5#|zlhJrX2AMyFMzwB-{@{u!9SP?S&!QgD|eh8>1@dNxiEjt6_{B2gjWGm zMCo6oZb=g9?=ObXx(1b4?%m55414GES1>@J-GK9=D>>?7@hl9n=zviD>g8C^;lDpa zqcXyYbQVsB8NbVdT-=HXW{mdp$GoRu@+W~x-tpY(nFl|8?J^UKQ3fOk=>XLFX5IWw zXOQ(lH+VGG<(M%Zl!#u~Fb+C`S>luHj|QNCaEUqP^tioM4B#xm7NYl1@n?d$>>272 zsG3gVJASwf6e_J&Q3PQ^h@Ky+9^xNNb|aj+koqv-5VVOSGVNMhZ$JT_hp0S?BJ1jw zfc7ZfeYE=r4;7=QMrSJhL_M^6?tv+-OC6cTgEr{m_8_)D7=jhSz26I?R3ksJT)K)s zq8AVRu??t?`rx`m$klmIXC$-vMCb7It@}cmupob0050N#AQ;sy6s!WAB6bBWIvP>u zJ`?h74~gej(2eO^N(}+c2M`<`V3Da3?=x}aYUkD7L>2{71Y*qGolInha19DG#$|1e ztkYm1T^%s8ne^ZNyWkomSC;c875NQCaCGcr5`cbEXPXcOz7J}TyD-MC={=i6={(wA z->J>PvSXUJ~ zvcuI2A{`Hf_+Nl7e*I3T-v>|zIjz3*&zThd4+{I83WaH>*BX{yEd*gYtzn{*Z(U-8 z-w{88fPA@ND(k;77m2R zbtxy)5Szo{v5D?7bZ-$^`PWkl$5)#Wg`D#?FdGA z+Tn<816NVL4m)-aY25$;EUr6tegHEmkE<#Ye1e^H30vK&I(~({boVc!0WHs0c^3|i|bBG4K0Zo?DtEfwX zz*AIQr)=N)6P*v9nfX}_&cLpoiBkYOZ=^ zoNHqq=ol=4Fu&Yb1)kapvw3MOOahG@ImMcq@EB2LgdU4SwKfkuszQK`?)();`S0Qc zv5|FA;vkmWfH{a`Z){F2XDC-gFduBDbEgxsiK&F_O0&>hr4O`aw3(}LF!T38y#P@v z&2g0!2H`azS`upSl;i%IEBJ=G-p<4R)V<&g9BZ;=D)sO0f?D?qE@doeWttJyvj_Ij z9F)P1-T*e+UGaoyWMEv)iF3UU32QYn)QJpUBu`o_B|X7!38tbUrs6h-9zxz*$P}j+ zH27VjI61GobF)`*p0}x7?^Gv!f4zO|-{>NCo2Y)B4Bf#FQTKT7&{Q;>{vm-O2n4^R*K zPs0>q!-#4;#AGa{K*Q^54C%u{y6)Ixsy!j|)*1o3%K!yer0IC+1E6ooa#>>)#K$XPyArUZk6N>O4_)ES^PDQtdvJpgPb(%m${kCa4CtVZRvMeMocl#J{JJ z+=wB^9Y;Qjzlkzy_N<`wCAgOjEKgD9XX;s2d2F>w+UHg>`uyIQr**Cz^0z2jg|VkP zpdIUHoguIrbe)XkIE17#KhA^Zz8sth4Y(3oov!|O#<6cb zrLqKz0{#v(<4X@qaNa_0In%LY@9T~^c!P^ijDh3#n>oJ9{Lj=Sh!Ie{kIRC$& z^S%nA`=e718b}B2SdikiYv9lUHO#o{F%OLPD)y)P`Z#BGbq6AV-8u7$+Wl7Rj#?>7 zoF}6MMYV9~LO5(^j?vM)2>95kZVNm@syDj(|D@X}R5L6Rro9)T$=+rPGC%4)pvInd zv)b+SMb(jU;DTzi-7w)P5M z_(2~Dn+N~-;zaEq3?7$i!PzK)?`=P-|kcCFsl%D6!tbIJKJBUsRL zFv~Qj?H1sRjFu1nodXjVh?gE6$lQGbdAZinWeUhoy%(E#MjQOzW9$BFE0jq*?|KtO zj7d924Y%1SmHTpSLr|goIhWg%z(wVKy#_t#{s!-?jR?YNH>%IGkhVV`ln@Gr?dc>G z6=b(}`=wM!>a0I7`u3K{{5;d(nRUG{X7&A>DK0sX za*q=aR&+J}O55}sr0v;y`hr`BZ@Sv{`En)2@lRQ0H5HOqX=c>?$BAiFCn2$FQl%2G zx0|ZK6({Ea=S;-)2^lzJbH$)JqsAx!;Dv?n?gJq0eILiPj;GuYpk_Bfz6JdzIub{x z3+RJ?8YJ5G7IMs8sJ|Vz{3c~GzG8ZlWsOFFewB9iYSW=3a!zlTp$q&mN+hR!^BU8A z>51)=-^AJE#;;zQ8bCWV*9SHdy(V9M$P0{+-ef-Q5(KJ z&u=5kxi_7!F+rQQ1URfa(SLm-Yh?6=IG*|Jb;o&%?I z@$=k#j7h?F*QGs-5ORGL06ARtZ)j5vBzCcL@K^eEDIrtkprHk)tF}KsQjjJduNK<)u6wty&*1pTo>{MgXgKKuPH4@!})5mkda2d*@hUg%bu z@K!86bj@yaGz6-q2}(HpkA0%dyy_NrB02Z7Xin zQE1n2_0(4C&5&zM!~j=X^M|od@r_0NP>wc(Ks78~6(4_7|{< z0!R_sbH1)vu8S!vcmcfKmYg8-h;nU$h`NFp#{mD1Kz)9V${DZ9EdllLEMFMVJsx(p+U-fSf;@mh*?@*5dGk)fdwk zp2YZCC;vJ1j)r{3a4qo!%hfw**&TBnNvY%u~`R>r300iibxuH5=e-ey049P7Q z0RfdW0G|HAWoFr8so zv%Hg2H~cNJ&wHW*GT*D*@l=X5yjRXxoApb*Il3=Goe4Cs^i`u^Q;k+)vZ|E2>^@APAJ3laBU< zx4=Us$0>lA1CX(wNcq834CBWHgB#X_Rv&C@W2ZK+&JWoeQocTiQ4e(-USm2 z>%^eq4ucz&$2ux)fgpp@%B0@lfEOwxrXh7Q!BOh`6=Do(zMyHni@D~Q%(=azN#$qr z$>HxRiXjsZLv0SCyAV3zHe|%!g~MU3OY>E^j?zL}f|PoM^!O{m*rBeO-Lzc}eUS3- zv`7zh3D`alc+?su4mFHI2^VQ*+H&3TD|7FY&WK(;eT;;RkSYEfQZ3YG5miqCMToHa zVe&yrUoVYqxn^r*&kA@Mni_-agfrkYrR+2|sgTG<-u&h`0A66$P!QNu)3}+}_~3GQ z!);pyYuseO>>d>3GU%G47l*+Oc-E3eB~0`9V&d?lih0)?IKCZtzmFa!f=;MRbm`v( z1Qf&pKfj;%iyFE<46Z%JC=&BOanDH*t%%?D17?#uZ^2qAq&Dq-aZ>cINsyVhXwg{s zCB+gFTLjH1P-S$@i0nd2J)8a(TCxk_-atPrtAT{!VrZCY_BFGFxN`nX*MmuWVjTqJ z_mAOlqzTwXuqw!pE?Zv1F<8sE1y_T&kW(d^Xail%dmOg_UQ=+TUkmbz|M5=poMVRt zo4&GKG*IGL?rMM*W6(6~BTgMwRNu z19E;ZzcKB9bdPt~&)=>mEXjcu@CLAFbRkcyQ&h}!e+|iU8dL3Z@JB_ujL?(O?DhN#O#6 zf@8S&dqxcX^*#ThnJPP##Q>8lZ*GVF+YF|4=2I--;U5V24`*}!+By6&Yn|)n z)j!*{@mUQj0HIUoEc29Jr1vYdXXPW*X5A@wGKG9N4}sfeI=2>1+Hl0f1>d&8Bgrj( zU01}L!FYO%h6Tw=ZP?>ME%M_gK-XzSwnKvg?`6wHa!&vaMGRy-sPmb!b#ce9709C_ z6v$x*iya`e>p3FIrL>LRz=SngzQ6S0EuOLafgB5wl8W!e&<40fl z@qNb)U6_R7oUO$_7pnU+ZDSYedl!jCzmEt$V@~mz=w14l*)m6{KD<$L==dEff2V&A zNe4d6J$n0GGmMciQ$2m87^_m)C|ka<)w(1OwvWk6qC$!|+g~W~G6KP`%&Xo+7)UMo z0++?>Pm^KW!8pF>@raCY$=u{Y^($NUK;cTqS0J;}(7c?419J<{fa$@~3-E5J&_fFewSbWsyj*`Bt-h_6@z&{S0k<5`f|rTR?ZAcEXLtKq3} zI|vLZP1S!I7-NNE*N@|##J2>?N#|N3HvAqxhyY|}c)+GCg2D+J9;0(G7BmkjNa#ltzPp0)rI!eou$UFf=_D0HpZ+XhCglz#VL5LBTRUvX8^p zn6OYz4@_bx+rRa*Q$rQ#C}A{P%I`vg7QZn=tg4#i!Ld6|quRD5K1qTw3`sD*)VWwFP5lm&<|Wz7Nrlkd zjbc|e27iPFJPip#{8PUf_y=O#avadGT2#4Xn#i3THtH#q-f$kur%}&a0^|R(7AJ}~ zbK(>(vlrh5Ek75w8mbzoaDB4o$ru4yp33VWPA4M5F-l+LLkN6=>0?sWk5M*n=`lvS zI(iySp`VB7S_1Q#O9PJ5*cyqvELiOuO@1pM3gotYqd50tmp5J4qxc)Qb-Ro)*II(R zCd5y#%&e!eUePixC2p!C7@$TBamCBi%q6|$hua0Dt_rPvw|(SA%@-wgeQ_Eg^&0p6 zt}IA51FNl}-O080#Kp7Lab2C6H4b{Ok7;wB|IB(t>f0SguD4mAS83sud#fw78 z!jwcMnhC1$kMK7y{UVMsx>oOSQkGLJfDH7C#B-&h=OJVl_UV6uc zbY8Q-8kYU``l+fG*gQsIbshfknbHz; zZ_71sn@-MYa84@CLa*8Mxx@M;#5j*i}oFae+FR!{+Q4S zCIDU|5tIOKui+M7OxJbQZG9l$!{mLiEgcRR^BYM+56z9WEUGH`4H=*ncyCsXPMX#e zQLz5v>DUKGguFx%bX9SD@KjH5!BKgI6NO0kZFV5?7%kEy1%QUe=s+ zC_cz{)b*$ZZ}n9q0a#{_r^gY0IFiZDJ}9C2Y!*}#!JBnwA(w#|X+Lo2CqQp`kY99z zto&7uBoY&J7F+8L#Q@m2j(A?sS;!}TAVKj(ejAnnmD?oa1+3N>D#_&q|D{t@ymx;=o=cbzvyIvtm@yl6#~1$BpJ*t;ZfS> zcs>~(ZZT{9CG5;F2R0`ox(qpwaZt-D8#Ku&7rtMw13tGIv_P_H-Of6?ntl_&)j|@* z0}U#}Gyy`?#W4w-UT2{*ew0S^#L-5qC`fFB0Nn6wKo#mtv_AE{jz-94E>;u_DK|j& zcIVy^8remNWnbEgt&o2*bFdiT0&@_HHl0dmT$4{Q!EDT*TwXSkZT1QfU$m$?E)_#R z>yLn&kTP(V7$+nmows&pt6)gQ7<3-a&_EBMzjC12X~XJ#A>dw8Q_7T107^UR8+9>p zsrL69=6Y~eL+3E$4dw1cqwgQ`fbKtt&h2%{4Ne@y;)I5dV((OyA^3iW5#t!C-arIV zswpsR8UVMFVlWU0JPL+EC6ICJwGKO-Wu<#W7?pb;#LUIua2S|w1o|sY5LE;&2cqAS zMA_)oC8}i7WpwK^<@UW*J_JUHYx{9Goiw$T4?7} z@Ouewy%4)u3)>Y7fbH<6YO2GneHPob)dQ&~ax*!h6l385gS%{Ja^wzv54RostZ1Ga zwlH2DoR^F+q{l>e>|DY#WO^w$*sH-2jE}Sj83#J*bX@?|%seVblJq{|9Xu_w-DrqV zFQf(Y=Yjt7`r*6UXaFvgDvqrr0sJNYjshij(z@8pWmxtIDa{z?q3eumZ#^Kpi0t(L z%6N)~%`ol^7*#Bk0&j3m@&n;%jCA!0)Y|k0+GSvu1OqV7$tLma4RBlYOr+FYdXZxZ z08$apRQ=Tt)^>^{jcf-Ft;0(k0ATO?(_qq&HR?PJd@BUUshi%Z!eQ@pH}*k_P=LHk zkUC7ru;3#hU=3yIdiG&W;|>hvb6DLL!&iKM8IRJS5j2g(Oqk^gI^2UNl@s4WcrCxa z*ZT0jt?N5_rw|%}Ir!X8m019@%OS2D(mp&B-Fx6t5#**nMhk~c0>SM!z-jLaWS+4K z&|gp|Os)phyc>;*pcI?$&a3Ov?p(IN+(-bY77PktL%p88P1Aem7J%I-8R$m#fnA5t z_>krB9-p$-7ICnT?Ki4X2*SDsgpJ`@_?LkgNKNVP?yCpll@lH1^4UrNO_|$XII!(d zIoWz?D~jI};^wrf0npwNq=;H(-B34E6{BOJpFmcmY zm;w}IjMctl2M1c`A-_t%ZUMMli}Do22UO;>B#4BbgTqv~BN;shUuX}N1;_yH*C|6{3#F(lAUI~i>OA1s+>jEh%R&-jD}X-ek-HADY~!5YmTn*Wb5Y`W0Ra39>#(Gyunv zPd@)SPb*Kwz_iL>@s7fc9)RpKp~*pcPPYRR`uS%n5`t-z7GcVevT=b8WSBxABJ?u9 zt${6OhO*Gy(JG)l>ochug$H57n6H?=77m(fkQ1<(miX*Gb?@K}9!x7e-yP}r_C#0w z14oHS67#?~=qQ-cPw#iRnM_?=$m8WX07u4feUZZqY91qtL6FcVT|ri@$$C`xKEUvt z{`c){28oj5VsvL4t3#llW&nVB5TU9 zFg$3&AAhlkt`)^QXe)fcAHf{)A%2C3sxUD_x*_AjuG4ZhjX|||M7=pXBbMw0eibwr z25E4UknXKNnCT95Kw@BIWN>%A*_V68od-&sa&BPMC8C?5o8`6sZNRV03e>n7ws+g^F0cF9$c)3w$Ief*_W?*l{urdoL`7ifzbsny~j| zXmBAL2=$Gc^OP#a%;1^TIEt4VbN|UAQ%BNcz!%p~$Nk~@k7@XV$#)+(PGo^z%XOVh zmg>>Vm$EgSnZm_iHxLtV1tX@viE|0*SBi?GZh@3gmqP>>zK*jFVqhOJ z#h!6$M%oUAxN9P}^|9UYCLX()W-K)iJznq{Q-mVV44{8 zu;nStr$ez@9==S_Fd|jb26U_Hu%n8}j^Kf5Q6B2Qf$PlNM2J;uyzg5$pPKJ)#qusZ zIpmp-q6X-BhXQ9Tu7Iz&dqnY}tu6z@ln-KEE z3o{7_Z^Qdiv-UuC8jyld1z5-xJ)}lk`#CXELIVqf>DY9lu{RIcBWdBrGjgqU0auAx zq=ilpy&wVHkn|p43nEIG8VgeDy8rY&l4Uzog_KjNx}QkUYk`BB@1y$?G-cm+T|aH1 zt~{|%!Pm>py(PAb=O$2TD8?X(ha`@`*E29y+lRHA2O`pYl|;!N(BPdBJVt^o%g7tg zd^@rYE+`0`kf$(7FH!)I(bLT3%bN=+OrMJ)N71fk@y!X6y^671LDMMzsf^ zW>xC;+H~EW*#!0jtX}%^e?yIo%N*T#^qJc65D7lOe?P(X6sWNf%OfEeYcs~2jKWPf z5Q6|oZK4zdVbq|4Sb9NH=Po#ek+|0?0v|=|Ui?d`(@rlGVB`?;Hi6{i7;W4^&*-bJ`J^z{`VNN@d_Z(e>3yZ^A_5|o7L-6YWdU?lB5MD;*v)H< zzW{02dAWAp%i!r2a{5ZAqA+-kbLk-48Rl^GY^|>BD5br+4{eF$m{-6o#0<0Z?-gR4 zrfq@H31+c$C=ZprDk41hzAg)<)2F{WFxq0sN8=aHO8wsd3$CN3gSrd-+>9CsmD!*$ zS+IqZrgQBmr7Vm#?%YKbG9AUoq}caDq3jwqaeJATUwjErkw4lWQ2C5h;fYaq!xRA} z{~<`!++j|~!0W1jU&6q8>Sxxc*+>OP&GeC(2IMDabLv17&qwtOX2V$lVc?V$jE@4p z-B)iPhVeHoACOCZOR@68bA}b&yXj=2`mLoM$X5uU*#Ny3Xlpo%NmM-FgF;J6y z<&P0j{mlK=kdDe%*wg#dC>~zQ9@GA5wYnk=m@(cecwh>JeeLMWL&7Y>%3flswV_u< zkdda8X`-7%jE|(=lRzvfB9V7b+Gwv(IwYwPWnTf=|{n1E^|+m{&_a+DZb4ZKP>qTs6~A+8gp?>L&py8wcpQ_ZlK4>C1$=!fJ31+ z@uP(IlRq@6sI)PT>45EVE9av!4-A9wdjlE|*7FZd&Bw@>E%rezq)$rK-?M=myaB;V z4`lNmwi17SD13Gw*4EF8$|Rj&P;ACVRE+YV=aN6c2)v+r?|1X&az;rFP*ta{Tsxp$ zV;>dmf_OY28Iu%3?9;!k6M6nptKz{06zH=bsdj%F8CF_?jyMklZGJ5uAiK2!uLN}S z`Wxgf7(Y2+RR(gOhv3~9e*Jbwmd?d7%0I{S&%*dlk?a8I<4aD8HT*(1C%HVs0vFC$ z88p;4Ux#NCZ^13Cr|StjK^PP zE=TX|I*EF&p@{O{qmRd5Tnayk7k@uUH394{%0|Y2tiGhrqrKSr-dKVb29v<_flp6P za*)5#y4YYT9SogI{-t8lN|r_r-AhZ&G5~J+Mgr0k_}QXJEiq)qyu*kRuiGWWXJHs z^1yHM4v#V{LpfARs8bgy37*OCL}2RGAJTZ36)I1QtpmXudk^K3OqK8zyfY3BK3KZ}S5;{J zIz3zo_jno$hY>juK;(gAFs8XM^8sptF~jUfpxUrMG543_DPz`^2}ceNVW|Wicb$Qx z*$K|UdLZ1-FoDU*afpLvV_poId9v ziW*&sJUJWTUn)7S9x;Xy6{77QX{+ohF1;Hhxs-IxH*be7Wl-&FB?i1evY^AT0VPQv zbeqrstpdak*C^cpuPijSb490hTU`7YCN#*Y8%gA$(82m-0Jzv^hHycUw&X!Ui(7me%DEop;eCc-S4l0JxgIJ& z=LYV$-{0Fp&7qk%5Nh_t`2`MkyqL=FyDHfV z70b*5LNeg?Y@@sD9_O%QNimKwZiPchh0bf}?Qu^^sAay{Gqe0x`U*59(%#Bo-)% zge{p7QvscMgN7TWCSBTJqUgBW-X9$yC0Q>moXKrp=@&0 zfFkYeg-F_|2gmMfj^8)5elfD?nG|q@hMu*DmaFN5Wf&UrUG3q@7fWNDmhhZrqCS7v zhvpa{W_$*V(}ihBi|qM(I#qa&ex2^c8BZlV{Bm^Rv3MopNyqQ#_DkAmB}nFR6Yv(xvaJ>14tHa@b8>Ar z+2%vkP9=2oPTdUdS%I4&so$<)#r?AB5wdYVFsEF+#?<7+ltZ=1nWowbMp{EwX;R_x z{4z$G5?R%j`BA*Z5;(rz1RZK@njdECbE4<5w39LJ$J$Y!X7nX58cG^?oT1_`u_?JeCw%Om%c#fX4#Vg@DKiV8tkY_VGgk1RJ17I#fB7a z5;Ud9xA@;1>+cK5H;KCSeSo-xW-$@w_z1eM62K+Y&ti!V8yIZ}Dz+}|n4Sk|)inA4 zCK_RgvZt^b{);rqrv#j2{`3U`pMX8*LA?*LOq+xbkVs$W6Z~HB^+EqL)K-Q!9&ZBy3{$N_w|Z^Z_oMj{pVH(URq*n1RWWsNMiv;T=Epv zz}QoGNq}I#gIJDTLpFTCCe47=lP3V^`oIDtl%`-pM6}61eMcJ>T$qKdEL2r--0zQs zhfEwfcVX$;m>xwiNB|TfD&Jps5Nl4+doMNl4;1m|v0=kd;6dSAgtP@=y{5;FH^TYVyJVgWtj_ZheupsZ2m8NY{HVLZ>KAk?z2N;%dkqgr zQw+ugX*kl|YEmEnzfaZ}RRj3!T|fYmkQ0?AIENys7mP^m2b1YLfE0e#eP;zpvppLe z)&95SeAx6WjG6#yW@GeHpyf~+JcFzkkOwL99DqLLWP`-SoB!EgiUf|{U`#+wd;XRW zm}&B|yatAU0VK|P@Ji<)Q&rOW3ieLY`o0f?qMhy^SmTP_Cgg@<%0Qo2ub5jS0Mw~m z?QyyTXlAzsNRKQ;c>nu5kbp=3eiI9_T#%2T2Sp)NAI&@!OSST&c~GH^==sp&EPHx^ z+bG&w4@q{QfbWFnf}Gy3Gj7^2j@oX(3UowNm^Y{p`S&#gfeB54a0g|BXELB5WJrON zTZ-C7zfQu|xb}^t3@e6#78&rcQo-w-Z{$0gAqbFp)t@fWzd!JfRE_O$^+ul8u3Pj4 z6G><1PsMOLnqdcxtq|Qp!$`okMe7y}dqSzw_O%++DSak~%8q}x1h~=7_|h?hukCqh z$C0x>Vll9J$jsRM=CHqL?6fcRqI#fo@Hi9ZMvP3+Ts#h}iT`;JaRO+@k(o#Qozw@G zK}fs6W_kqs1WlapAz7<=Tm?n34zM$CD}FhK zeaPn;@qm$PrYSQHJvKsn3PAin$mqWx;vsR2=SEMJ5C^!FA~#Iz1B&gS&*44kM~Afy z8#{pzVx7saZ#~bn0On`2wYu6q_rLxt3}o8z5Lr^(kBbfimo^{v;;$fCU;+iI;mV#G zS*s5_hnCK_g3%62sI3`-_|Ff)?T*Ekj$aB3gZ=%g?awVC00*$ai!Gxtu5=E{f^YoC zxZo7+!6^#F`g5aqK&~ARL0S-G9$^1=D?myGcu4Nxj0jb-+o_KSvFo3;B0J{`8@~?% z^c|oaM=y9gMOz5NHU^js&gqv`$sFuCC71pQ?S=x-Z1xec#f0&6 zAtPE(04b`Or1);Am6~^}#k^zSeNTqY*q}5|O6HT~>g^2(yRT zJJi#C!7o2hZZYJNKvG|;frpBF!2b}gQNZ-hgy9`M$g~*vMDj(k2y^`BUHXV|<0A{~iL|y#S<_+o@g;C= z_5tlHLWjTeV8_0LAAkQuoB>KxqHd)_M0{1eB&u$@&|l{KnIp9ugdo?cSFxGPKgT&R zs0NyH){s0^wN-&$#2OC&-=^lk8A!uvbalWwVeTiAc1-u!#Q`ZkWp%q9bsH8K2Mw z%i)iyy0O-LgG99d^NQ0507!WLeakFLG_kfh(iNO=Y|f673U=3QfKfspAW_Kwtr)c7 zeQ37*SJfUUu*lf2;?m#{FJ2rCJRue@jo({rZ5g?im9CW=TLg8_;#V)|!wTLXlNO3x zhI-u=?kIceE+Ao)AOmq%mkK(v|1J?T^(BB*pPL2hg15X@bID;JU@i4)tYw~H5JVV0 z5{q^NR&uiZ3A!-ERM6VLIK#yTSG7L_f*AS$a&NoVfn?O+e-Yul_qp*BNP5u-k~xTS zMX1SmveO*cIEYSx?403moY4@2&zDYa{7+oeA)f-*+4<`IJq|fAf(8gQme1&}=`U#M z&O@)7-$`Beg=VfHw*S=x;{Y=@jT)bEI9xwEyJ(zbzf4~ubZ zhIYbs3LMg;{&gTB%)?x1v(FxPP<$pf@Hy;reIH-g3*L)4?s`}?ysQB~^&rI?#t-RT z$4&?tYrMOvk+%cBKnh&W6M&Xj1N9*LiNu|_{~mW`McZW=z^4;cIr?W=N1u)PFF=3h*J3yFtP__Wn~x6&D;L%1<>|YNfI_+JQ;yG4tu>) zh>0YQ?>q8K(@7ClbKQA7`igTwh(-egC&OF-RZtutOp2xllz$sYW^FBs*U-`UJNs)q zgsbs;)@vO4A@5=3TGT)6!FNUFEJELC^y;PBw#Q3Q;oapwj*RW*07~LCAY4Q@-&u+@ zl{=Gl(`cI$aI|J>@gj6TSX>xp7YLn=2Y9nHLE>@6)iVa{nP%P?86hJ0qaw)flgo+z zXO<#EC_W6Cw~6|cmC+6d&4z+a(Q!32yL zY#Mi$3TVY&JS~c5G&C0Bkm8h4rFftddB`_Ju(xroaWm=Heq_puRmAkQ#{Zea)xZ%? zyawdx9yAm8yTenCJ2TLK?Z=?QsF4AFJf&R0FlkoLalD$i{j$Ql z3b24H5C1vdi%W|h@gCuMJO)zceDvOo$sd5`Q=Yo^yT}I2XE}nVDi3(??}B;6Yi#$^ z^Y>aF#3R0QQIJ&hf!Z@pb8y8}H824(HFU^iDVO2oVuEVWT*7u{BZxp8MX^E$`~75e z4N#xV5QWzG0{PoM=&3*d`YrMN8NU?iq)*VoOtbP0=D{?=Mhi(Qe=Fi%j8IfiF0%t6 ze^P!Gmsu{_x;PS9F*N0?KN!%^GPny@$nCcKC&{Hl@G+sw6zA9me1NUwBNl+ik8_9c zRm+^k{P-u4=yxw5W>Hf91+&j+1ES1p2cJJDZ@-zvNq~m)adrrt(#}uPPOv!Ncvm;? zwm+J$!0&ziUDBllFcOMG;sMta<^136^AB!R-zS7=-}it&Sg0V_!)$!WXF=km^Yuzo zie!k}T|8xD&u@S;9$e_^Q9fQ>Hs$lhg&V1sdkFT;$-4y|H6a1wdO1C-Jbz1epoEH7 z{Ls>b}o#~ZVv<&(r#RP=7>WV4~=B~h|O6`Xo^TQc2IYFhSHe(Oj zS~Tl-X7nPr&c+)TrM`96Z5#C2)7IF^rQankiO6Cs0BGD9q%N#kK1<^oYdZE9BQ*B5 zSHQC>qR^|{(<}C%Xk+L11x%TDoH3J6;pM(Xs}VS6j$DJ$7*Y9jd}wpLWL$zvC3-=l zO<~49mn_BNsPaHF1UGBYhuAa9Q?gEhHJyFLvKKh-@O+uZJwkU2cq&36e<`{w_&7eh z3r$Ki^dKeT$GD7uD#QH4Mg$$yqwRN?`9~k(hyP{$+qlzP3<&OuZ3_H1=Ap~M6(J>} zaY|J$z#sBaWq&-R-{_WL-FUyYojN4g@Y4#+FMvYn8oq_=F_>N4``HFF&DsZTa(!+^ z{}Gi$-+JTtywhZHcdPC`_wX8UpAuR?Lx7#+SEhk;;&}Q6N@A)TMMB{M3Gq-p z@)fe%cO96Oiset?3&oKWN+tR$==H#UTsqzApTC#bZJrp?X5pzxNJ=`adQ;76&XQD! z3Ht__&x5G_>9J3fi@-3h1iu#G3EuA_F{<{2-hbJw(<;dCOJ%avFAPTn^jJLeMNT&W zqD)Y~-qyMBRG>!-BSYO80h~d3yxItl=Aa&(eW2*6IDt#RHTjQl-livx z1}-q_)#Jy|Kmzop2J*Z`*0mq(sgBP_4u6s(#&raB-6uT_)5zKk5r96OA-=!TdA)!~ zy8NSpGow(NZTc#j`=+S5a*&@YzrgdtuhB7kdzUzw`fZ1@7dSseUN^e&>C3aP5nnA| zM$aBo1|JXkN#*O|QV!x%CpP>frfq9rIICviyZnIGk-u0%6``crzK9b6P3Ht#uQ7Gn&g19kt6 znC3H9`)49}VmsXECr%oi$av2({cMk2^WtK7^P&-B_g3|Z)3bmMYVuPn1IscWjpG3y z$H5n8B!EL~)n(w~G`ZluG;4c|; z^r*+@E(Q;Jcke5%^<<8iL13QtAboN^dSMf+%)2THoUcV~?jY_s0&i%u?Zv%|@&Wkt!9 zkm@uvrtG`amcM#~wTv@ZLp11(zv8I!X60z#S^nI~jx%6%k8k8gg4~ZOAn3pT*cXHL zC^(y$<1`YR^jtqlBXK+qjSYfKYF2*Vw;wL6;ugWaZqsP%2`#g=tY}k>!tu+HJ9BoG zgF`aKu9<-{Te$xtjd7Q|9{c%rX)jg%I5*yLZF1gC74C2Hr#3W4S5^6zQeiYeroCWI zq>=JEa?vS8@|%3y(^DW5ecQG;UDRc0Np0Y$Qac!s!Ce6hgDkEn2aPUIei~|ulWo`# zdj8ccjysfwbe%!RfA84Ex9Z2i`tO&V*uIf%(GN`+TY`k6o1i}!9q{ZM0^H`Aq)gSP&ckBh)Pn)3Sx(yF$6`(9wCBy_Lj@1*}kncZpw_f#+byP~-;&|Dy z6dy=wtXPH1I(O`vdK^vYMQgguxy4Y)Z7#akGa4ppKwOxIizx5V@vG;ZHF_6+l*U&_ zc(_P!`;FYWgD*z+LjRoVRiTESj-?#nWDU^+(qSui27P|0jhQ}vpISb z>OXG9?{ojymaJC#{8~npx87Q%r+Q`{|;CilJMNhd!OSHZJ ziE`OY4@PcG=_*m)iTY#(xKMh20b=K}|Ap&x^)dwOc>p67UB6gd6^1%pb%N;-a1Atn zLYL?M%k3)Ti_W$%>8BVn?=oTBO^CMLKPvX)pz?XSqoJ%sSHwOYp!+g#{B0oLYszQW z3=25fKf8Op{1R0#aC6g3lYol!ELV&;Pqnx3_W1(s_nc*(hkR_F2mg?mECR=(lozXq zn%0Eg$qJKJ{xE^Q4o8W`VN&;&VuVN8x~V%qd3G;$-XUYoq3PpZM|;|veaSWf)x>v&ARZ%oo>5Cn$Mv8 z9`DJ1u4O+Iy=+#2tJOL)#!3i8dm`{P{3p+GHlp&>}F-N{?g@uSdm6 zaYQJevL`V?es*DIcosXzjm;o*_`&0p-%$Xb->ALzsksiilxcLnh_?q}Cc5)$#|QD@ zK$&Hz%L5mmwF}*>UO*xBpmUa1pMEc!0Ixbf2|oLhQllBY|J4%f1a>uecvdCHz$pJ01q|btl(F9 zaHb(?5A;$~!dk}0#8B6JP+tPFoIZOzRPVh|ZH`@!E$H#=&6C&0AmSI8JQM!NI|A1i@r`(p19id`rj{5t!Pai+&!N#Rxc+1pBxd^E zB-z-^w}Jcp_$$3AdPu|?m2gE}oiI|Vb}31}AZxC7k-_j^){MEm_37hB_2b?OREZ?_ z6wVj)*_4;b^0e^h$gJ~JuBlQxT%1%-cMfj!(WvAhk01dWB#;hQxdI2gjZ z@E|^ZoBGAq5~nhJ2SAb-BJ*R%20}q})f)?xQ?*bn5f9b7-N<|ylG9kDdc?y;NiBo& zG+v}(a28OmUV1(C&zGRV;ro^Jid*M)l&2eDEaBPE1u-Qy$!q2**9M@Ve+60-IzSl5 zIt3m#(02h1J&mB1ISpU#IyT$1!i$m*29R)zEB?gg$RznyGgU!XK=pR;pvJx+@;n*B zYBy-p?nP}%EbskDm)Yb7&Q1v&Cf2?ePJf=tM=Y5T#CF%5VUT%JCGR*}19jt^BCpq} z1RV@q@=@1yr^30@pUa6DdjFngLx{bBzc--j&#nI%11J_ROTaH0Ui&*K`Y*o!*WP=_ zbKSmgz=$#`5-IKMts)|;ke!iaOUcMi_N-(jJK1|ATgeuYRkm!hH`!!-p7YZFe((GD zdj5P~&+B{tbAROR^Iq3=Ugve3$9Wu4>14p!*TjCHwQwJ2cuvmz4$2^mamf}8!PO;^ zem@dxbQPQGE9Rwoe*eAnOZ+>`(ef)yvXe` zcy(?H6^Db^zQR)34UC3y%1P20^@wyRar^0U*6nhcr2qbse3^C%Qqbc#z(|N>sM_lg zjQqAHfNsnnI1m~zM#vhyXF=7nrR!T_m~l2Z+9d`BOZ|G9CHQ*sO%aw|48|j+&*WAa zCdDu5H^ONMwIyl41zVp7Q@j@ABvyPx7&0wftbSaW)i9{= zk;>YBp7B$tn?)ihV+6EseImfg2|4<5iQB&1TLc73#)Emlxi$h230Vr$UfTW1$)d-s zisrY+CEAj-E;@lSoj9=xR3%uK76HqazMtp|!NUNL-qI{)1>ip>{!PDUo)w`ji@B^l+FFQb+DUAS*pl9gI4EJixXQ zx7~uPn6enDjdsGmG8NVqW9kN!=s^PhYB)~Y>er*H!~=2X+k|xfGV*k^uJ}BV1+~=3 zoPhX;i!DOl_$V+R>$LMZuG>2lXcsaZ%vzOz|Bda9Pl{!0&^xvE_7a5INPI+!K-jQq zvF#h+n0~yGdh-^DkunEiY!=o{5C1qF$UcCG&AF~|U^-UQ3xoh-;bKo7jeSZ};K(x~ zbceFo%g=3~@1&Xk8(>UaGevix-M5w;wf1v@VTid^ZQoCj)8!aGC@-+Z$)Eob1|Zdv zgT1Xp#a$&hpWtEKa}n%JEt|L4hmZYP&puU%gW9Z;-@#nH&b@OD5@gZX(WF_OP)0gM zvK!l#u!fpNv*c31^zh%+^>c?hfQWa#i?(I+2)PW}kVccjnvg7PXbHF!{$rtNC^#L7 zxC;UZjNu=DK4TPjoCQy1f-b)bDBw0{Cj-!rnDhE0GzZ~#zH<;Bhd1ad<`H;+N1F-y z!^)5cw(w8x+RuGz=NZ7W`GxJ)GMU1fmBd-v1TWqgT7FpPj60BYL^TtX6&5CkzG$KG zTTTHz7`f{9^OgD$V!)u71}eH36I;mdFG5Fo;)5VXCm`3lKx2HWDutMHs3#7|S)_%f^uqhXNXn&S8RfOr21Hn#muFl(defyn$Nk5voc$`XALyUukSt9E3a}VHBi( zhg#f@mi0h#%?p~1X{hSlb6f}AwIVCv|3OZ;$996W{f@^ffYMzk9HY+DN}0Vy5R*F~ z71mcTuwW<&7<>BXjhxEBgC#;|*Y3ThK1KYp`*$A4Lr9{O1>^B|rgJuq0q%}HC}w*O zV+ac~qLH`wc0r?VC+wVVSnhiMJ^G*k_xsZwMHo`4=JJPkUScY06f=T|0YHh}AFt%+ zrMMg;VkaA{^O!xI4R;o z5r=$o8pVZQBjc}6a4n5kzPGhJ|1Qb>c}z4TY$}rpAFTW4809+=owk4rnZE^-=i06Gys@}x~PN*1cV67VH9cgX2#f~Z8*#hateY+rK^C)w`vRAnkIo#;2Yj-;9U2&FgA1v3iuepRpm#t& zEJYps0q`83ALIY?+sPij13<|TT2B;I+;~9h4J5LKRcva|l3W4RJ`$$#ozdzNd+-Gm zbC8rLL&Fp--)|wsP55|q_g`Zu`V0<`56((&h8f!ejiu$21gb1W2f}Ph;I`iJZIpeA zgJvbele;_6b1DiyhVJ|wQaFN~@Q4t~-;a!- zQ~Vk<5K=u*FZsC|W7sV?h_0i*$G3*@QH1;5XGVkpDCO^;HoSuSKVtHJ_n&|3ELeb( z(l`e#MJk3=X&V(n^`jJ^!h%HPf7Z8u4QAh$&Wy{D!y312Nu*eS zmX8Y1QxtS=^TFkkD8b0jV`kpDae7)8&_YOb;6beJ3GMKo+0^$d8uZW?>q@g7etLfI4<%}K;>(M#;X=urWxgS-nFbaaJ2)9s)s3wWXS#;Bs;OJ{50G< zH@|NEPGij%C!Av2<#T*uzwh+tC&4Tt65-Sifm`)|^FDuFCG5=tVJUvRaCFR$#TxI$mVsqMqM%6$s)pEu+UD$F!qJk$L|$F?^;*ZT?i+_rdQO1(UJT45WR;iRjFwYF&2Q2O%) z{g^e%q@ee%{L-_UnOrsH1&E6V+MXQcN-1(rA0~Q*w?9F^X6v~B$LDOC``=@55tqRB zG2g(~b}m8k{>>Yk6LJUkaAFPLkHtO}B@jVfl?!CJ2((jjT48rFNZ zMYpGeCis>%4y?>Q0X$gsrTY~q1z*P44V5Z@^Fjs=q+|7+F%zM;p?with$U5_!`M7G z%AT!*cbt0)WOV_qu3f!SKQYe&HuFoEUHgf8`NA@hoVmiHJ)2r_sA5b~e;j*%lHTi9 z;DYs5wL$X>@-ZlJvbe}s0`3_{_uobQ!}eiH@pfSHhlh^Y4H!_j_KTn8g#~}Eznr@& zDQpy22N&x@r&(izieBrAsNhHjU+fQ=EOLOQDyG|#J!U!D@) z_-HA~nX#BjeqLSb8N#;g5;V^`5OY)fIdrPiU_j+Be-fWC$p7qZlJ3uF^+2KTwZ6hD zIjSDb1Ix?{#l>Nq_YO^-5dBtyn%f-c%KKi425pyQtG+KP?|XDPD8zsrwJ42Wtzm}1 z-#o+^T-uWVZL7gD9|lw0go$u5>HF~3unM=AjdLO;#KfPLbrbrm&*?YCisW07kG|+1 z5xsro&uhX@5X`%0MYKlMFe0nuq>whIHk(AU7UxD#duIB?w~u#7E%#u!9#%y;RrX!! zC&GMd;2hZIns%bwZW-fxFR`Wm)oCgU<1@Zd*6)sC8bCF&-?OMXLU6fWXq(GEvF23vijTTmQS;a z{Fz?(Rbc&^bU{#+$Iu zN^`<&uRs-1aoiAjph4>W23m7Fz%=|$;dHjw8$g0B`yH%68c^P~mUY-$AB%qYn$PWj z+X@p3A`7h7$fkL?CP4D|4AhqIQi(pzg!JPLX~tpG$o zMTqqVu*cPv5jo_zdG%>%UhO6fmd5@w$jBbUK_Zy< zU3v=;oE!2GjiU&*Ee2*c?|j8U)Q+4U6VqCI#tCZfeopVgfBIQIRuZHrhbn$*F-VLg zkRZCvR7X}EA{XR>RPS?@;Mt?gDfu8lIs?_T^UEC`G9d4n4fLk|^nyvoR~ix6Njv-2 zU$5@eQydC4Qz4ZkKE#y+v}?Lql1-Ya^qe|q>>;JBz;)oDS;70MGX%Cb!{Q-@-Luu6 z6D`APKNm|E41u0JOJ&Q`w9Qq)e)~ml1Tw7vIcZ(w2w#+WEkpW4f!qa6*YR={iUGQC z)61ed{(mjlp4YwrHz^lEk243+CcdTq)zgMci&9T>8(25BTE5Vf+rZ)Yl+A2I)*=%Sv*k7siQ*HuHU9y?~2U=5}a&z=P5!w}O&Y zQc!~~CA*gMz9Z)(U{lk;5n-3sXaYTnZvCW)=5Lp2nF4;-gU-1Cy3f)%d2R~A*y_1DQWhW> zx)_yitsuV?VPy%H_OHFrP8F!~;V8VYNau2MhSs0-H~O|XfhLXFQjDW&_8kwS*G;09 zz=#pC-FTG>ux^d(F59nVdyIg6;^FySE&@GbUq3;_Hvk(%%j3ixW+p}Pwk?RGoTAi_ z+E74wNW*T1llP1BE;Z}-);iGn^cl3abqsLvRcocr8}gXdTS0z~^!Jbvmp(G13P0w= zVhf1JG~fdq%jL*ov z#7x|XXQvefn%_$ZSF0Qj*&_#S@FS0%r06%}F;C+PAla>I!WDF&$H(Z+jD#Z&^~3gdHDRj6pj} zvS0+JbMH48k9pTifU41W0xIax&5_3k>qo-p`QJuz&ymK08ncPC`7%VV=M0wM|8u{c z8h|F&9M%Xt18&(PP_4@;yx`d<%4dY!dkW#fcoWU)9nqljb-=EiX*acsvY<*k{nf*t z5-SiD1@oMuDDk2j6Oc$`L~w04R`f;OO>e8%+YEE&{YNA>s_!NU+4v--Up6lh(Ur=iF~*K-wBm3clLlQx)qXsk`~M!ivjff&go86a69 zsgl0i87Q=FyPd5Ccc@1wP^A(i(|Ovi2fs~nO4%is`Uw_rf$yY=Nc^<}ST&Sb_BS(y z4=#<=y!=(CgP5xi^#$ME@`=iam~Vc$AgA`px<=D*!+w4t9^!Ck_I2gjVvWtTjxy_^WyEuGX-zDFnLA>szN`SU$B6eOfk~uu|yv@Z9v~&}%%kgrOVzc0YD= zki3zzL>`7XX=HrqXYuEB10OJ|F|wBdJ7}Muz)*N=6D}_2TannHCBQN9C4YwYO(Z$p zGS1<83;(|VBTRQo|E(7R>17tZav2)Mvi(WcdmJd13e)?&*y*+es!c|t9yoqG0s4YY zRJUZlMKl7Ug1Os_<@?BF4d7<=mmaK_I8M9z(|%^W*6cL8U0!^tJE?Hr`*I1%f%zmi zV~$PfTlz7kB`r>*w!R-Na)iD~MxS#`!gQ%_mkgT3FX_g4N%Dy~^;!g0#lB#xuNx}6 zfPd%A7hZ<6n^|WD?v}WugT(;BV!X=0)dTUhN|DP3Qi{8rS7HeJGim3d7nKqsiF?WJ z68AnD`l_V+C{uOZR;^v#9RL1Rn%<=KscT!_$y6dQ0!k=Sf{6+rnJ~BZi*`6MwT8$= zy!Pyjv3-FVzyDx%+l^Ds=SY9or0U512ggt;{pSh`pM;6@PLL$r8E~*S-16kW5}pfa z|NUDD=U0>A`?^$^DDjYeHMMC~)QO6J zuPm!ml7hq4MV(?=Ir+IzPbrQtwlR6XAz5N+0Z*wzj?`KrwamjtI;R6*a6I0^3|-#d zyttA=p$8qlyzW3E`@nZt9kUJ60LHz*sy)I*j1;$iWJ!cq5oTeJ@*4AmZ(&;<>TA25 zL0PRLU1Gz5m5JCM??l#sgd3f#2;06hbrFbDrH?sq-AuF}D|)wIrrjE$$(HxyV)=SE zsmAv6fNCBY#~j=i{kV^AxgD1h?=V1uJe1>w2Q2q&dHa$i6S@GAvh4}+Nn>C>Wg)L1 z+Au@;Np=VWV~%exK&@u+c$kFF7ew{>k>m&wzy@N^$@bkx4Zlb%^XbAvW^!k2#v)Or zo%?+sXjWgxq0D*Ej3;j*^!6*e&^9xsF&>#u|5Q$ zw}?Fjlos;0z(7bUJmHsBY&3ZH?hkX%AJ^e4vQy&i$81||KtXKUo$48TZ>e5<^J9X8 zJv~@xuLV080WZ6F`d@h};51seg8PTbiHo3Ya{-~oV_9yOQ)po?}Qoj~xVQe`k61*+FA zwAbW>#+Gcg3|N^jAV%&quv@IA+DxMf&b4*l1tmD|;gOvl*I!c&>ZLFQvmyCas!ac* z3@k{4VlH+z;|v&qu&;{go_EDTLO6yH(9m8tI~0rh&+qxvg|kkDVoW(3W3Su^@_ zHmgH29&?qN?l-@x&bPmHQOd&Ebg1woo3p!&MLwrn7xEu9mERBW@y%!z_MSNEim`^5 z{|8hUhy&Z0TA!eRU-|MM7qW9n_=WITZ((+uZvW#GMQ0R2g(Nx0)NrzYd#r+}kc7X% z<-GWB_y`HT1S(i9+#ZSl&nx)#WXchRqoWi%e5V5cUvCZ#&ObX(|M_}JP+_cmd*7GM zzvA7WZ@^O?MoH}E&5I0wzLsB?0oUh}3CstQ6%(wneR}S;LDpw{AnI(=a|vW`G|L+^2B1{;lcUDfR%ggn+&@D)vBNxsI*rS5 zFjGFwb6=*7XdL5>a`#e}MKx%$bv$32Ojd;hk8$Y!F!PVc82t_x<>6DQIWjKCIo)>F zW7#&G^LIaHqFwSKR<)axvf%l73%d2Pk2@?iZDQml64&~Z%fYg`;VlHLARa{VD)8(> z)=7*jVgrZr;A*E~Bboy+609BN84qXqmN4((DALF+*y!E^8%*)?ymMZ*zOFQxkeRSjvYRCyTH94@E?SR_10f1yX#yv1^??P5B>gj(|of#)(QvjZkA#e&%QLP)`u3m>) zaAz?A)e&>P5-<{_K)90UNZ>^ubNnLcA)4jSJr!%U%+!JC@6I3Sl|8H7Q7l874& z>C}^&RTO4c4%Ic^sV1kwZGg(Q8)>m!lFQ0bNu<&g!5-nKAu=nZdvX zwL$=>dIt%G4~yP|>zfs*M>ZlzAe6%HP4WTm{MWdx-KxcDV)*nWiHx_9zA7@eVen$1i#XYn@$&fM=xVPlyKYPnzq*P!C z}7;boSN%cv3F^OXAnTgY4xXi8}H{tUEH0}xy( z-eVHSK_RwQxEL;sQ9- z!0h)i!&B4|d5^M2hA_kVBsPRi?$TXPvGB*n>Xqq8WJh{I9Y^VI8fzvm!X%pMjVa*| zC*{c5^tD-*)07H;ZvlACsrU`>Xs?YRVKI>+ zwHO1~Q)(z!)4Mv$JM3X7!T|^>g4d?agyB-h$B^^VtC_$RSOUBF7ae2{$gD`C<7{q z$j{Tk`zA01D^d=E$Dq041X7$pNt`2RgUFe8)bB(Vgv=@P$s2uQo;0mYwX?nD zja@3DXe3cl7k)`60%Y2r`INI?0CB9@xIKoI!xk-iN^x@XZrF#i>5W4Q9+bxyAozEq z=4Q{PRQ7#8vie%4=z4L)vqB82#9F821pvV@(j!hbLSA}>;4+lgSDZ4eKu2D=dSiMH zMN9X3e+6;s=tfqq9@9relD1`d6x6jJ7JLaf3_BW)!53rIJ$-X^FUY{gGE6T+j5u>k zYKte*>x%OMtjhU|=7%nl$r8^&(_t5CsNdm)QoZ|KIuSeXdqs=^OgoMfm2KJlw;{NSM%+-9*vQ-gH- zeE3ye9p#$w?<%e_?xWa!ZSF%pKhD?ze2kK!(d|;@7R&)jHQ?%`j&#zrrwxLfPt@fjm?#EtE_mr8`N#MBq z@i3R%YvX$I1=q*#U_-2pwnDB%6kTXxD!91QMFJ~Ey7M51CRin=mn-e71?t<+E-tamU6$eLe-!j7=Uu?T_P-yA^+XSTr)M1Pv zvb`GAxuxt!K)+o|`{ag$2;>-pkr5bHb~h=t$cLIxq$zWH94?rSi)ibxlDh< zn`{poF10bxs~N@SVSo|$wsh+gl7>P4@F}r3HHC2|Ggkmi?|{bP+b}BiL(VJE=L4{i zH$q7u$jFZ}^ttmRPqR;f9)&^SXy`q)V4E-esc8zTkicC^)G`CY)7>6 zJxz{c3}JGtOi(^$NQ&>9&|rxHXZvr^PDZu3eEwQx&dhNG}PCH6Z14=RTb5u=yU_{uq$P+H-w^gqkRcaS2P|LwO{&6@t!Vn?d91^4J4nWPM}MXk~7u z#A(Cvy@uu@h0DJ_d@vY#aV9<&TFu3W?LW-^?g!?syoOV7;y8%esDlt(`t4fyPPB5G zw?|WwNAG7SC`A@_NVvt-sXQDs%>pG+2b6I(R1vBQpQVR#Ys83?(@HEpN_J7Ea_7)I z@{$`7^6DFcau}1GpR_S1jzZEbOujZgBQ9SF^fd5$ zAL+@EwCN&kpxFT$jx%52t>r)yO9R_rel>0iUQj5Fh^0*Uew>j*P}ky}hF~OBP|O;Q ztRkUSp$y5$00vUw!h`oZGGlg}ojCNqh3!Kq@=* z1@NTR>V0{vuiF-7N{@$TW|s*J_4G*@LLqeh*=)?!^UM?qqYs>tVfc0g6TJgv^>HJ^TFbHO0EFld#>g z_!16UY;T;uDQ!aDyaFgs0ihEmp+cD7PEPa_6a?sC0|1UY{eh(ay5l5CHg_pabjw({ zGJy4C-}d{@e}6iqioQtF-~8W?siuNSx-kC!i|qe#%yS5}o&NDZ>?!~0zy&eb0$=*Z z&P|2}!k?St-#=y}`c*D9!*>VHe>%qH5^$@)U19Hjynp)j&cC@B!V~so5wHDEz~%Q@ zLFWfJPjSSLuKXXz{J(iLE|fMF%*P1-8>NtK#Q{cXHqi2|o0#8hJ&uO^S%LqTH&8elpQymy?(B6;%tEetG3I@nMVJQ6tg`vL#_|BZ2lCp9f${0qg{Q5JtY=b4kS-YVW}+$SxF>`(NtVwiH^Kbi*1`$9&DI z3@OR`@U6Vqcbup7+v;4@>|OE2mr9M$(xdM498t_^uSJGu)5$gC_(}0^_-Z)f9coQOa#y_RXzK)zKIrS=e&7vM^LXz@ zqCNYdOE;T&r4o9(D3s&39@Fq4&mUMj3R@h&aziTaWNjGgMJmwkf#%Ix`wN{t*KB;) zD7xQ3!MRn-0?OE(;6W{QMUd5(;h+m689jzgoBRYvA!6+@p2=(yJ(^FXyKMT^2i%jI zprmVvI%q|#z@_m#6x?bjOvaBaaQ8ES$w^}${w-%FX3Q7<{^q+__n`(tU>sp<|~J$4I-D$;V-x4p!R zb#r^nC8s)bl0LmSOLf(p?00=dHW{ahe6fjqWxjq41|ZuT?gF9cR?jcq=~HoaUVYaL z`=t80K#maF4#rM|7^@yxN2~)Sv$WbN&z}DA6H=?r5@>I8f4sBnTFApituhe`^*b;X z%vWDSb64#nszH!A{38TKYvBSRXpbEX1tVBOypAo3(?#4tEuNfujqg}cpYe{i8%XS2 z@V`1wk5n;WFZtk3h!gluOY%bKMrQDqUaeEYeDuh=FXzstTFzbRmPUn{)svXDs~@_n zy0rjo&q1OC%Q8N1OU?zqJS#%Qx@1#Pn3w+XcFjr&?4`L^)tlB|V!QpS(Sv9WMWaI% zD9sJ^rCh!!Cl&!{e&`8_$vd%-9=>=?-lOTT9JKD)jZ~Rl1ua8`BL^W!S4C{w3j?Z$ zoVJ%UobqMlVTu>S_C~|TKE6|c?|r|!;^6E~ zGvUtG3Hl=mlLLGiUj%WSS@B{kakq?|MaksB-LI8XILHfT)kHt4#Oh5T4se4Wb|^)y&%6nmI(^$i#HVHI3$I(7%`iuC!} zSbR==ntt12kHb$xgo*Po;&ck3B;D~=Z!qze05Lqbu<`cb16!8>P*rfFPY~uCYEMM9_wn+!F&JUimb;r1<6 zi*F51+e4x~;P%$;S9y(ZIWTNjG>G{aM`l%flCeRfE`Jy}WgV?d+lUwsoN%-#3C$4t zV4G}q3uSh3H4jdvH1*B<&-&d-I&c!PiRxlA(;)kr^Ll=-kHht7+t_n@eT{RUauW9& zB1(cWp+bt$kn8K^k>pzv{VWd8V2p$n2G37fL&Fx%A$-T1JIX$Kcn`hC{lC!l@IAcs z%9pjoS-Qad82uKG(UEOUO|hTH4jL5k`He+(|kMer+S?4JD9KJ`6r0W(*uPF z7$+njevN0nMiS7M)(?!Lo{i}25-CR({POL*<${$>(4ZI`B`C)Y!X+Q_bJ(yu&9^70 znFc&fd1orvY zyoVnm&y5ZEd{VW5K4{^3A+e6Uk=6{&QtI)FQ7)$CV-}Yf^&!ai%nX} z*TeBX*q-DWjYN$1aq$RbKt6{76*aQWZ}1pS72zNP;PCKC&}eLrqs{)}#736*VYN}# zJqjEnI4^kFWt`}|I#QE`IfC8Iy zl`VkGV6CBiqyy5%J^qMx({?0Cso66>40| z^2E)uWF3^V8i4)6{j%wFlJ?@)-(}8IYB)kVCHk+kbZJ&PwwX!Lrwd7B$Df6@c2( z0KmQgyQk_EL{3HeVuvhRJ((5etXU*KU*Y#(cVZh(vO7=X{n%Z4Vs;F+dRE1oRj`6n zK46&xt@)PTt2I|v@sNVWlG zsO?qUpbZ^M1YBMHyhmVzrp)zb$fdGM8xPxCxD;=7KCk0}1`Y$%yswF~mzjFl`r=;E zRL?JyZS?=5-Kl%OVbX6N$f`lfT)wv3xMw#c(^gGdnTA8}r85xFo@QN#=2d0Vy)DcH zPmBu89})HWgBMBi@IxY2`Xd~Avf}K9?It%!d2tYl*rF<9anVPsT3_6B;AH10a4uO0 zo_H7ZP1nY0(AZ{F0nh4iP4KjcsnE2j__%dk-AebJY+|E~zGc7}EQ=p=gi__*w5pi|;CT@4Sw5Kl8MDV8eV}ZACCU#uuy^=dTYfx>>4e<2urFtdglVDajnM|! zb`lS3omSVAl@x%ZRyXXUkqOFBc?(d{nHjHyCexpZK7N*<#WgE$e{UI~k4{!whp#6F zqwP}~;pHjebmd3&0!^Kgkj&**7l7nsuu2k_&?6ynNW#@3A$cjKPNruKy2>~Az+rk0 zPx~s)TI7VvNnV^&-y9k7BUEDTsG=TnFVF}L3C61#Md{%>_ggh$$&p^?-#8=j(3FRU z(qX!N&+&U_rZ$O;hT5wN8@{fS^6eQgKhs_H?3{ZaZJXn!Zi?Jtp*;!X(!EosUdws# zD;&Q^(pBwk?OsndlX~f!)I$<}Kjv(1FyJ~8iE4{CdYw6k`xf9h z8X?1K`E`zu@MYBlWZE{YIj`8P)FH^GB$rB4Mrfk9M;WhxDZP zoA5p?ArsrT{Nwp2J8w|b0X}X~*Jk|{K{$L5`%e2^YTAc|q!T0_YKWv?R<%h7H9t~C zgQ2NjOS`ov_SgG}7Ub_h;l+ z=J&wB{xB#=5edZKZmi6ryaUeb@&3`P(&FrAqJ^&*y^)EDv^Yo>VbK!v!A0x!m8C&{ zEi&;Mz!EeJl&6n6>}KTZGac+GD*9dR#dmuLiPTj3fd>(XE7I5=G?z4A8ec!IoW9`} zty|PBO5W5YPF}`%l~}#|1Fd4{y@>S1gRaly+$c_pirq4ZRj{bEu-GNY{*60Z({=u7 z@I#MhlAFuL&rU1vaxOpi(x3Oj%SVC49`U=~Is#L)`7bz4+w~qC@3=l6!8|RUy*2K5 zS!dh~@cW9{GYcB~cJcQ^@_$GXowUaj~ItSlkXNpV&Hc zxN>Gz|8?=KHz~~n6@^H!ousQp4vO@rurFibmFfZ7i~m+o*5>FD$5-s^l&li~`!!SF z5DFJYNnY<@^i>Zc@}b3X<@YKZ;AbJ^>aa9eJ%!mQ#oQ0j0&SdYl-nTVlT6TZ3Pcr)|HJ?-RZ`TmjC%z3PgHCuyQJ{f z+u?{l)Hq@MkWuFa`>o5=n$tx4^gnUvFR&+!pDw7W6?^RyeY#Bg`JwBz!68^Ic^z-Q z;PmZNeO?$v!kp*MX_Qp+J`jOCM2w?5s>1J6I4ighiwt~bh?ko-?TS_ks$sO`e$Ysw zO?V}cSwAmB-Y}#l_tuVS!A=EU(2Pj6v$;@MH#+1nmqH>V^vFduT~<)&icm=GBfkz>0av~@2kqF_ zSP`PPwQfNYfj%P;@(%;HLiS;-LJsT;_TyOyrPSIbXl1hyJ#i9UNz7aDTs^#W=q<qk@S<<1E&1oN~RW0c=6DTX`y#+djQ0wOL>y zmpos9{ejKL@y1>Sno6d9wo)P)gTHkG1jX>kPHL>4kto5@%uvifX~Eo9C%+HNb}obW z(SZ*jHC!;d+`b8^fR4R|d|&jQV%7LOOpU+x^hW%8i9AhzC#|i_BkS&p3lbG|aXMxA zkA+{UU8PIgd%2bRqe35fiQMVVEv1y~tsYzht)^np*!bPMZ5Z$Z&e7E#ng}Fkdt~LA zi+{OUbXK?3kL7UXz#s;BboxEP4oa8{pS`ACO4qb89}(H=9{mIllrYJ10jF}^S~pt) zc!b7foIu}Uq=eC+?XW4x-{cpMYj<4>k0;`E@&l<4pF$#fr?V&Q#L7%H-l84ah2=bV z2i&Y9>KW$hkJpLxG)0RDO-p4czDd|Vo9T@a&)baG4n4)#GR#KLnQs~!INdR56xT<; z9h-NC3d`b3yoQuS*(Jhx%MsCY)q>*tXtsAt%mo~OOL>PwE<}F%&b!br$_(x=Cq?ye zZ$jugJUuMnhsWs~no$QZXSQVD35^wkR^4fZVA3##iM=p}&M{*=*UP?Je zygErEdsip(U4KqRdP}iB$^OqQpOc?xm2eY{Qr%w-E4yT2yp$u*-eDBizp-CRCGj>$ z1Pk5*dJ9zhPF@9ii!y1W>+4c{BJIjB)>y@+REfUv$gQS0EHWNZ26xOH<73X&^BN1q zeQhMsUP&EptnWB16nr{}Hmyh2b(#iTz|d`oqEL6=mLf4pg4X_BtKl^Q+k-p>gO>tk zhDO@(l1*NJ<%<{`k$fW+<>POgx)#YWpGz>PSWro+7-K3;;gZTS(^G|7RZy!5X3615>$iId!Lvul!9xTN;wbZy>Z}^)naN+B5N{k@Zd6 z74jC_wAxXS^QW;FR{FLfx2ua)quJppv1>@mpjzB>1)ARX<8tIRO640e*F#P`l5)7V zZXwFMvB5G^Edmvs3AP0FxOJ;jE~K6=8F37$@_g3ID#6d#MV%8u6U~F|YWNYKsd_5ln(%s7J%4s62Uu1m_Yc^#NZe`uB3T0da*sP;EH;WCd zdnXR*6b>p?jkrAnWt(L`FOwN5iuK8|^soGcw*tM$9GXI9)|)7{N~{!8W(H@jP_#=J zNQqgVrR=qni&fB;a%E4^G())-IqE@KyRU#*G47moEzH80ae^;?UR=|vz;j*7Mr42+;jBm z48nl4e_q~JQ{8Jd3IRy&+a$S!R}m4?j4`0Hd5J+Fd7Y4Xjhe3%D&J=YOLQ4qF! z`EYYGp5k`ZhgTV2W+jYf*-Rx_q!vWqi*cqZG4R~b@s~bB(bQzK8BQ>n<5V)?N|s?I87s#Bp}PP^>jzCp`Nk zKUvJC5cHwOHgFtg8|v09Z;Vp73L39B9IGsB7p{c9nsEJ!GNgipWRjabBIJXh`!Nwf z8ISp({sn2e%5Jxl3#l`7GT|>W5BD=^W}SDSk}ChGpK1+Q(3yOW^~_P1uV>}S`^2so z9Haqe^XW?dr?Rm{e;9Y*2RldIlZcZB6i(4<0Z5XPhiByvPJSa{L0W9XC#Y;WgkDGU zykDC#c%UKv+@c{HYDa}tAQbDb^I*yzFZUT=CufN$)A0Stt~alEi!5yC=y-_xC&WI~ z)XKS^5LgZ4A=P1ed08_mqV{R~fJDCw^ig#}RyS(-(ymiDDx}mzx(z=t?RFBBKz;}g zBv?RR$L=y-YrnkYGb=KCO@z<5^zxKOW!5j@WC<6D?IND_JUWi)-yA*jjPk7d(6H*B|_#L?CeQvFbZbs#oW3@O=xi zXTw;Z^CX_5BX)%S{~2Zbi+*?*yO{j4O^12_YIGp`^!zl~$5fH1{eFYM!@Cao1#Hu^$MzOdo2r4O>_0+bq^O#`&?-Cb5!in{lxNxE%L$XWRGC`k^J(GaU8Xv)=-W~ z5L#kTd=kacE^sxY^{cufzZHmDPvFWlb+5HI9ki`v>Sj}TFKig@P+6`70Qz&bdX8|8 z6&&vDbCZ<_*6T~~#11t)NvVQpAcf`@yAGOgXW47oPS9{=-8VFp6u78VB%WcBzI}<~ zfU1Rjoa<$lO4?5cW8&vPxBmc+#P$a!IsWIriwuviz4O6x=f8h)Ou$xoX{uw{bMYjf z`~{v24W`k;IpMfxG9@u(V=eT9K$z}rWl|Fls7?&9Fp2Z4mH@mh--|EfoW;p`c;^NC zWhcer?2^?I$M2bWKmN?=R8;fe;PFSGd}=F@bh)UgW+l!}xIa#Fl?fODED!dEvMcXn zM#X*+K%D%<=S~mK2y|wH=TNAq028zz#(ymKnl;%jE#BDkChq1gEPf&OQ}o)kTDMQT z`(MTlkik(QF!1AX#TAjJX3(yPKj5cF=Si};i@?)WM1|#w@PQd&JTEZ=n#-qL+luCn z_MMomDIV(!ST(NBKVOR1f40zW<>PADT1T(RXju4JM?ioq>tm@E_`AUXBENTYHFai5 z02hDyl8ZIAHkF_=mJ27&*{z%pdhV2LkJ_grFzwb8YD1X$DHw{JPFiJA+F4&H-yH0= zTCh7?Ui@L{BPCl-cZt}U))%KUXS=hiO?Xcb5ohq8;F`&qs@(U$`y3Z1=|0X3axbSg z3JvR+$cy(AKj0`#rH9SbTMi4HHPGvw7ZdyVtZGp1epTGGH1G4$b-;E$({o*4-27CO zNK{d`OiAO{wR-z{&1<{fu^Xj+?H4V^Wea6mkEfXh@K|}jz>~YZB8t>RM_0y94q_)b zuqD3xoUF)Wbt!Qu_x8jB5R)2?*YVet9?hcf?%BSHiCMn=lq|GcVC%H{!kog>qLj1b z)?G6JSlBqY_#~$Uo!?2Fl9>27dnN9KgLm+ooZCmYBwKx>BBEB)&oktQPS;P2zm>j4d9lyhmfxK;?tXurK!w+K=X?=`W?^OWBIPdYyH$%k_nheF>VVNZ z)HzQdk-svPbMI>Y$NViW%<0{IukTf)PJ|J++20N65^yMi=sZ>5ZFn`cvN7EZxD2jI zM$5dYI_G`oV=Bw~-orFulR#CRf>FxX9o1lSR?@n6PO4s28A|NuXH>XU@0`3gf2|?h zPcPZVk>5wEN;_9@3p$%WZ#mAoQvZGJTiPq+}tHS+t_{@FxMQkQcP7fXQ{{-@nZv?f^LW*ooaJ zjj{Be5H*f#uy=L`8NhF6NsCA8=8Iy&>pvZB1>cys52?=s zTzfNt-qyRMr!=>#^qxYU(`_7S zakZ~Y^-h04tynXmz*g;2v)gp}{j#Y|hpYWM9rX5FDBrEyXr74N201D9Q6^5!&s9<` zovVp+W4a}QC6LKHX%Eqm8nfY|!&)FZyX)-<0mq`zFX0oR>mNzZJ9nQKO+CQgeKN;- z%<*=?$_=(+E=jCmyz>O-wk#d{3~){zsx#_ua8U^}Qr(i-FJlYkwXv>qZ1P1lZoaO${# zhU;3!J9wk&*~0Z*JeZ>c!-LWo$+WG*LVc6x?tZESdfe*@?^)4cO#{uR@eIo8bpCio z^ZkZ)&v(~4tcScA%OR7IQS7ZR2s3NxpOn1&GE$74x$W~re7I-WvUtt~ogy{On^xwX z{nam#^zFTx?G8{a2zwa5%=Xr<&}>Mw=G#mCFfYplljoMUP=~#+_40*yW8wkbqItpB z6Z!i|VK#k#(s{i&Hc`iS-R#=3?rZyAbq~>>_KMBU+wM=}6P)W*-~B zp>sWHu6I)R^IXFMr%iukgW%a@-3iG%`b`t-tPU4mIhB5#yQ7>?Gzxp<=BFU#th5j% z@?bUCc$}1O^bC3$4ouzOpac2&3lCZIvQhi(aP6M)bIPQg?Fn^bwLnTvE`m<*qY-yc zV&m{i3F2tEJ$Nw+SE@x?jpuYb{#v0;)QZtk2wVE1=y?-CC7n77OlKm!+;y37?kvVn zT`QIqWCQ+hxZ}v=E}DLMm#f*2M}VTn&VBZXyQs-pst7QPMz9%51ny^%d-A$MYG}oL z9o95W>)D7)zPo~A?eBTWeI=scED4w?>@D2_)=QAud)5H1_02WR-W!FzMh_ftaGz7; z6~D@4?%%JAp5i+ee0wNe(MXJcJVezu`D&fiHYgWq0e+HlZ@z3ayv_K=sIbeQ=)hQP zGg2-L#&o+*@_dhHaAiz1Ut#Hb9_|o^5nhkp*Zo}lVG&(DOYK^qqQiRBj2-kVcR#EI z0y5i0Psi8Dhd}Ri6u(1P9j1v#vq+st49lXo_#u^Gw2}++RDi0?)JIZouUwF&3Wh>Z z@XhO1O$=6sPRvgf`GE&Y`aq}-SfmzJU1q$F+=nb!QCGJIPcn^xVc)YTQ|TXJ7B0(5 zO^b0VU>|a}Q6*@8}KtI?!ae1YvXp zI=v_vEV4+)H3SKwXA5sSLvuhRBlQ}8t~SSfuU|9YJfSj>4YQa}U00X-?fIi*F#Yn&eI}GnXA1aTx^2MQ z1c!^fLqHa15`c;+;_Sa231z+P{LTPh3@cSsKo1YjV61#901NdM6G`@Njv!r)W5CBQ zcGnnT$W8Lz!5a|TGEeigqRKEl;wYY;r-*v1f2!vaBMKpRMF`_a@*Xj=S??o zE4s9c@>kkrtk(tJY(dCFP1++U?{83R+13zX(=1UlKQIm@tE_z=Cpl%z4jfj5DbN~8 z!G(>}i@yn!ijm2-S0g~iU{F@Y#JHVc1c%NUT7H*bW1Qqv<~JPJ0+}4;i;Nr1d0Y<+ z-CB?_mxFb?q|K!05RBL8+t>uoAdIi~YXtuFfj!+>#JOt5&hOyQiSx&|!);aJkYXLT zN^jg*j(^?l&ktH^@a1M38pD5m=dTymnB|NsSQWv<@q3*8dEj9sxZj=p2@SnJdjBxs8 Ht%v^)w+=6c diff --git a/docs/authors.html b/docs/authors.html index f462b62..3bc0cf2 100644 --- a/docs/authors.html +++ b/docs/authors.html @@ -1,55 +1,12 @@ - - - - - - - -Authors • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Authors and Citation • hrbrthemes - + + - - - -
-
-
-
+
-
-

Authors

+
+
+

Authors

+
+ + +
  • +

    Bob Rudis. Author, maintainer. +

    +
    • +
  • +

    Patrick Kennedy. Contributor. +

    +
    • +
  • +

    Philipp Reiner. Contributor. +

    +
    • +
  • +

    Dan Wilson. Contributor. +
    Secondary axis support

    +
    • +
  • +

    Xavier Adam. Contributor. +

    +
    • +
  • +

    Google. Copyright holder. +
    Roboto Condensed & Titillium Web Fonts

    +
    • +
  • +

    IBM. Copyright holder. +
    Plex Sans Font

    +
    • +
  • +

    Goldman Sachs. Copyright holder. +
    Goldman Sans Font

    +
    • +
  • +

    Impallari Type. Copyright holder. +
    Public Sans Font

    +
    • +
  • +

    Jacob Barnett. Contributor. +

    +
    • +
  • +

    Thomas J. Leeper. Contributor. +

    +
    • +
  • +

    Joris Meys. Contributor. +

    +
    • +
+
+
+

Citation

+ Source: DESCRIPTION +
-
    -
  • -

    Bob Rudis. Author, maintainer. ORCID -

    -
    • -
  • -

    Patrick Kennedy. Contributor. -

    -
    • -
  • -

    Philipp Reiner. Contributor. -

    -
    • -
  • -

    Dan Wilson. Contributor. -
    Secondary axis support

    -
    • -
  • -

    Xavier Adam. Contributor. -

    -
    • -
  • -

    Google. Copyright holder. -
    Roboto Condensed & Titillium Web Fonts

    -
    • -
  • -

    IBM. Copyright holder. -
    Plex Sans Font

    -
    • -
  • -

    Jacob Barnett. Contributor. -

    -
    • -
  • -

    Thomas J. Leeper. Contributor. ORCID -

    -
    • -
  • -

    Joris Meys. Contributor. -

    -
    • -
+ +

Rudis B (2022). +hrbrthemes: Additional Themes, Theme Components and Utilities for 'ggplot2'. +R package version 0.8.6, http://github.com/hrbrmstr/hrbrthemes. +

+ 
@Manual{,
+  title = {hrbrthemes: Additional Themes, Theme Components and Utilities for 'ggplot2'},
+  author = {Bob Rudis},
+  year = {2022},
+  note = {R package version 0.8.6},
+  url = {http://github.com/hrbrmstr/hrbrthemes},
+}
-
-
-

Developed by Bob Rudis.

+ +
+

Developed by Bob Rudis.

-

Site built with pkgdown 1.2.0.

+

Site built with pkgdown 2.0.2.9000.

-
-
+ +
+ + + - - + diff --git a/docs/bootstrap-toc.css b/docs/bootstrap-toc.css new file mode 100644 index 0000000..5a85941 --- /dev/null +++ b/docs/bootstrap-toc.css @@ -0,0 +1,60 @@ +/*! + * Bootstrap Table of Contents v0.4.1 (http://afeld.github.io/bootstrap-toc/) + * Copyright 2015 Aidan Feldman + * Licensed under MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md) */ + +/* modified from https://github.com/twbs/bootstrap/blob/94b4076dd2efba9af71f0b18d4ee4b163aa9e0dd/docs/assets/css/src/docs.css#L548-L601 */ + +/* All levels of nav */ +nav[data-toggle='toc'] .nav > li > a { + display: block; + padding: 4px 20px; + font-size: 13px; + font-weight: 500; + color: #767676; +} +nav[data-toggle='toc'] .nav > li > a:hover, +nav[data-toggle='toc'] .nav > li > a:focus { + padding-left: 19px; + color: #563d7c; + text-decoration: none; + background-color: transparent; + border-left: 1px solid #563d7c; +} +nav[data-toggle='toc'] .nav > .active > a, +nav[data-toggle='toc'] .nav > .active:hover > a, +nav[data-toggle='toc'] .nav > .active:focus > a { + padding-left: 18px; + font-weight: bold; + color: #563d7c; + background-color: transparent; + border-left: 2px solid #563d7c; +} + +/* Nav: second level (shown on .active) */ +nav[data-toggle='toc'] .nav .nav { + display: none; /* Hide by default, but at >768px, show it */ + padding-bottom: 10px; +} +nav[data-toggle='toc'] .nav .nav > li > a { + padding-top: 1px; + padding-bottom: 1px; + padding-left: 30px; + font-size: 12px; + font-weight: normal; +} +nav[data-toggle='toc'] .nav .nav > li > a:hover, +nav[data-toggle='toc'] .nav .nav > li > a:focus { + padding-left: 29px; +} +nav[data-toggle='toc'] .nav .nav > .active > a, +nav[data-toggle='toc'] .nav .nav > .active:hover > a, +nav[data-toggle='toc'] .nav .nav > .active:focus > a { + padding-left: 28px; + font-weight: 500; +} + +/* from https://github.com/twbs/bootstrap/blob/e38f066d8c203c3e032da0ff23cd2d6098ee2dd6/docs/assets/css/src/docs.css#L631-L634 */ +nav[data-toggle='toc'] .nav > .active > ul { + display: block; +} diff --git a/docs/bootstrap-toc.js b/docs/bootstrap-toc.js new file mode 100644 index 0000000..1cdd573 --- /dev/null +++ b/docs/bootstrap-toc.js @@ -0,0 +1,159 @@ +/*! + * Bootstrap Table of Contents v0.4.1 (http://afeld.github.io/bootstrap-toc/) + * Copyright 2015 Aidan Feldman + * Licensed under MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md) */ +(function() { + 'use strict'; + + window.Toc = { + helpers: { + // return all matching elements in the set, or their descendants + findOrFilter: function($el, selector) { + // http://danielnouri.org/notes/2011/03/14/a-jquery-find-that-also-finds-the-root-element/ + // http://stackoverflow.com/a/12731439/358804 + var $descendants = $el.find(selector); + return $el.filter(selector).add($descendants).filter(':not([data-toc-skip])'); + }, + + generateUniqueIdBase: function(el) { + var text = $(el).text(); + var anchor = text.trim().toLowerCase().replace(/[^A-Za-z0-9]+/g, '-'); + return anchor || el.tagName.toLowerCase(); + }, + + generateUniqueId: function(el) { + var anchorBase = this.generateUniqueIdBase(el); + for (var i = 0; ; i++) { + var anchor = anchorBase; + if (i > 0) { + // add suffix + anchor += '-' + i; + } + // check if ID already exists + if (!document.getElementById(anchor)) { + return anchor; + } + } + }, + + generateAnchor: function(el) { + if (el.id) { + return el.id; + } else { + var anchor = this.generateUniqueId(el); + el.id = anchor; + return anchor; + } + }, + + createNavList: function() { + return $('
    '); + }, + + createChildNavList: function($parent) { + var $childList = this.createNavList(); + $parent.append($childList); + return $childList; + }, + + generateNavEl: function(anchor, text) { + var $a = $(''); + $a.attr('href', '#' + anchor); + $a.text(text); + var $li = $('
  • '); + $li.append($a); + return $li; + }, + + generateNavItem: function(headingEl) { + var anchor = this.generateAnchor(headingEl); + var $heading = $(headingEl); + var text = $heading.data('toc-text') || $heading.text(); + return this.generateNavEl(anchor, text); + }, + + // Find the first heading level (`

    `, then `

    `, etc.) that has more than one element. Defaults to 1 (for `

    `). + getTopLevel: function($scope) { + for (var i = 1; i <= 6; i++) { + var $headings = this.findOrFilter($scope, 'h' + i); + if ($headings.length > 1) { + return i; + } + } + + return 1; + }, + + // returns the elements for the top level, and the next below it + getHeadings: function($scope, topLevel) { + var topSelector = 'h' + topLevel; + + var secondaryLevel = topLevel + 1; + var secondarySelector = 'h' + secondaryLevel; + + return this.findOrFilter($scope, topSelector + ',' + secondarySelector); + }, + + getNavLevel: function(el) { + return parseInt(el.tagName.charAt(1), 10); + }, + + populateNav: function($topContext, topLevel, $headings) { + var $context = $topContext; + var $prevNav; + + var helpers = this; + $headings.each(function(i, el) { + var $newNav = helpers.generateNavItem(el); + var navLevel = helpers.getNavLevel(el); + + // determine the proper $context + if (navLevel === topLevel) { + // use top level + $context = $topContext; + } else if ($prevNav && $context === $topContext) { + // create a new level of the tree and switch to it + $context = helpers.createChildNavList($prevNav); + } // else use the current $context + + $context.append($newNav); + + $prevNav = $newNav; + }); + }, + + parseOps: function(arg) { + var opts; + if (arg.jquery) { + opts = { + $nav: arg + }; + } else { + opts = arg; + } + opts.$scope = opts.$scope || $(document.body); + return opts; + } + }, + + // accepts a jQuery object, or an options object + init: function(opts) { + opts = this.helpers.parseOps(opts); + + // ensure that the data attribute is in place for styling + opts.$nav.attr('data-toggle', 'toc'); + + var $topContext = this.helpers.createChildNavList(opts.$nav); + var topLevel = this.helpers.getTopLevel(opts.$scope); + var $headings = this.helpers.getHeadings(opts.$scope, topLevel); + this.helpers.populateNav($topContext, topLevel, $headings); + } + }; + + $(function() { + $('nav[data-toggle="toc"]').each(function(i, el) { + var $nav = $(el); + Toc.init($nav); + }); + }); +})(); diff --git a/docs/index.html b/docs/index.html index d615dc2..5165a94 100644 --- a/docs/index.html +++ b/docs/index.html @@ -5,24 +5,28 @@ -Additional Themes, Theme Components and Utilities for 'ggplot2' • hrbrthemes - - - - - + + + + + + - - + + +
    -
    -

    -hrbrthemes : Additional Themes and Theme Components for ‘ggplot2’

    -

    Project Status: Active - The project has reached a stable, usable state and is being actively developed. codecov Travis-CI Build Status CRAN_Status_Badge downloadsDOI

    + + +
    +

    hrbrthemes +

    +

    Additional Themes and Theme Components for ‘ggplot2’

    -

    This is a very focused package that provides typography-centric themes and theme components for ggplot2. It’s a an extract/riff of hrbrmisc created by request.

    +

    This is a very focused package that provides typography-centric themes and theme components for ggplot2. It’s a an extract/riff of hrbrmisc created by request.

    The core theme: theme_ipsum (“ipsum” is Latin for “precise”) uses Arial Narrow which should be installed on practically any modern system, so it’s “free”-ish. This font is condensed, has solid default kerning pairs and geometric numbers. That’s what I consider the “font trifecta” must-have for charts. An additional quality for fonts for charts is that they have a diversity of weights. Arial Narrow (the one on most systems, anyway) does not have said diversity but this quality is not (IMO) a “must have”.

    The following functions are implemented/objects are exported:

    Themes:

    • -theme_ft_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
      • +theme_ipsum: Arial Narrow
    • -theme_ipsum: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography
      • +theme_ipsum_gs: Goldman Sans Condensed
    • -theme_ipsum_ps: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
      • +theme_ipsum_es: Econ Sans Condensed
    • -theme_ipsum_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
      • +theme_ipsum_rc: Roboto Condensed
    • -theme_ipsum_tw: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
      • +theme_ipsum_ps: IBM Plex Sans font
    • -theme_modern_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
      • +theme_ipsum_pub: Public Sans +
    • +theme_ipsum_tw: Titillium Web
      • +
    • +theme_modern_rc: Roboto Condensed dark theme
      • +
    • +theme_ft_rc: Dark theme based on FT’s dark theme (Roboto Condensed)

    Scales (that align with various themes):

    • -scale_color_ft: Discrete color & fill scales based on the FT palette
      • -
    • scale_color_ipsum: Discrete color & fill scales based on the ipsum palette
    • -scale_colour_ft: Discrete color & fill scales based on the FT palette
      • -
    • scale_colour_ipsum: Discrete color & fill scales based on the ipsum palette
    • -scale_fill_ft: Discrete color & fill scales based on the FT palette
      • -
    • scale_fill_ipsum: Discrete color & fill scales based on the ipsum palette
    • -scale_x_comma: X & Y scales with opinionated pre-sets for percent & comma label formats
      • +scale_color_ft: Discrete color & fill scales based on the FT palette +
    • +scale_colour_ft: Discrete color & fill scales based on the FT palette
      • +
    • +scale_fill_ft: Discrete color & fill scales based on the FT palette
      • +
    • +scale_x_comma: X & Y scales with opinionated presets for percent & comma label formats
    • -scale_x_percent: X & Y scales with opinionated pre-sets for percent & comma label formats
      • +scale_x_percent: X & Y scales with opinionated presets for percent & comma label formats
    • -scale_y_comma: X & Y scales with opinionated pre-sets for percent & comma label formats
      • +scale_y_comma: X & Y scales with opinionated presets for percent & comma label formats
    • -scale_y_percent: X & Y scales with opinionated pre-sets for percent & comma label formats
      • +scale_y_percent: X & Y scales with opinionated presets for percent & comma label formats

    Palettes/Named Colors:

      @@ -146,14 +153,28 @@

    • font_an: Arial Narrow font name R variable aliases
    • -font_ps: PlexSans font name R variable aliases
      • +font_es: Econ Sans font name R variable aliases
    • -font_ps_light: PlexSans font name R variable aliases
      • +font_es_bold: Econ Sans font name R variable aliases +
    • +font_es_light: Econ Sans font name R variable aliases
    • font_rc: Roboto Condensed font name R variable aliases
    • font_rc_light: Roboto Condensed font name R variable aliases
    • +font_pub: Public Sans font name R variable aliases
      • +
    • +font_pub_bold: Public Sans font name R variable aliases
      • +
    • +font_pub_light: Public Sans font name R variable aliases
      • +
    • +font_pub_thin: Public Sans font name R variable aliases
      • +
    • +font_ps: PlexSans font name R variable aliases
      • +
    • +font_ps_light: PlexSans font name R variable aliases
      • +
    • font_tw: Titillium Web font name R variable aliases
    • font_tw_bold: Titillium Web font name R variable aliases
      • @@ -176,6 +197,8 @@

    • gg_check: Spell check ggplot2 plot labels
    • +import_econ_sans: Import Econ Sans Condensed font for use in charts
      • +
    • import_plex_sans: Import IBM Plex Sans font for use in charts
    • import_roboto_condensed: Import Roboto Condensed font for use in charts
      • @@ -186,184 +209,209 @@

    • update_geom_font_defaults: Update matching font defaults for text geoms

    -
    -

    -Installation

    -
    devtools::install_github("hrbrmstr/hrbrthemes")
    +
    +

    Installation +

    +
    +install.packages("hrbrthemes") # NOTE: CRAN version is 0.8.0
+# or
+install.packages("hrbrthemes", repos = c("https://cinc.rud.is", "https://cloud.r-project.org/"))
+# or
+remotes::install_git("https://git.rud.is/hrbrmstr/hrbrthemes.git")
+# or
+remotes::install_git("https://git.sr.ht/~hrbrmstr/hrbrthemes")
+# or
+remotes::install_gitlab("hrbrmstr/hrbrthemes")
+# or
+remotes::install_bitbucket("hrbrmstr/hrbrthemes")
+# or
+remotes::install_github("hrbrmstr/hrbrthemes")
    +

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

    -
    -

    -Usage

    -
    library(hrbrthemes)
-library(gcookbook)
-library(tidyverse)
-
-# current verison
-packageVersion("hrbrthemes")
-## [1] '0.6.0'
    +
    +

    Usage +

    +
    +library(hrbrthemes)
+library(gcookbook)
+library(tidyverse)
+
+# current verison
+packageVersion("hrbrthemes")
+## [1] '0.8.6'
    -
    -

    -Base theme (Arial Narrow)

    - -

    +
    +

    Base theme (Arial Narrow) +

    +
    +ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") + 
+  theme_ipsum()
    +

    -
    -

    -Roboto Condensed

    - -

    +
    +

    Roboto Condensed +

    +
    +ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") + 
+  theme_ipsum_rc()
    +

    -
    -

    -New FT Theme!

    - -

    +
    +

    New FT Theme! +

    +
    +ggplot(mtcars, aes(mpg, wt)) +
+  geom_point(color = ft_cols$yellow) +
+  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'") + 
+  theme_ft_rc()
    +

    -
    -

    -IBM Plex Sans

    - -

    +
    +

    IBM Plex Sans +

    +
    +ggplot(mpg, aes(displ, hwy)) +
+  geom_jitter(aes(color=class, fill=class), size=3, shape=21, alpha=1/2) +
+  scale_x_continuous(expand=c(0,0), limits=c(1, 8), breaks=1:8) +
+  scale_y_continuous(expand=c(0,0), limits=c(10, 50)) +
+  scale_color_ipsum() +
+  scale_fill_ipsum() +
+  facet_wrap(~class, scales="free") +
+  labs(
+    title="IBM Plex Sans Test",
+    subtitle="This is a subtitle to see the how it looks in IBM Plex Sans",
+    caption="Source: hrbrthemes & IBM"
+  ) +
+  theme_ipsum_ps(grid="XY", axis="xy") +
+  theme(legend.position="none") -> gg
+
+flush_ticks(gg)
+## theme(axis.text.x=element_text(hjust=c(0, rep(0.5, 6), 1))) +
+## theme(axis.text.y=element_text(vjust=c(0, rep(0.5, 3), 1)))
    +

    -
    -

    -Titillium Web

    - -

    +
    +

    Titillium Web +

    +
    +ggplot(mpg, aes(displ, hwy)) +
+  geom_jitter(aes(color=class, fill=class), size=3, shape=21, alpha=1/2) +
+  scale_x_continuous(expand=c(0,0), limits=c(1, 8), breaks=1:8) +
+  scale_y_continuous(expand=c(0,0), limits=c(10, 50)) +
+  scale_color_ipsum() +
+  scale_fill_ipsum() +
+  facet_wrap(~class, scales="free") +
+  labs(
+    title="Titillium Web",
+    subtitle="This is a subtitle to see the how it looks in Titillium Web",
+    caption="Source: hrbrthemes & Google"
+  ) +
+  theme_ipsum_tw(grid="XY", axis="xy") +
+  theme(legend.position="none") -> gg
+
+flush_ticks(gg)
+## theme(axis.text.x=element_text(hjust=c(0, rep(0.5, 6), 1))) +
+## theme(axis.text.y=element_text(vjust=c(0, rep(0.5, 3), 1)))
    +

    -
    -

    -Scales (Color/Fill)

    - -

    +
    +

    Scales (Color/Fill) +

    +
    +ggplot(mtcars, aes(mpg, wt)) +
+  geom_point(aes(color=factor(carb))) +
+  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'") + 
+  scale_color_ipsum() +
+  theme_ipsum_rc()
    +

    -
    -

    -Scales (Axis)

    - -

    - -

    - -

    +
    +

    Scales (Axis) +

    +
    +count(mpg, class) %>% 
+  mutate(pct=n/sum(n)) %>% 
+  ggplot(aes(class, pct)) +
+  geom_col() +
+  scale_y_percent() +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 column chart example with percents",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") + 
+  theme_ipsum(grid="Y")
    +

    +
    +ggplot(uspopage, aes(x=Year, y=Thousands, fill=AgeGroup)) + 
+  geom_area() +
+  scale_fill_ipsum() +
+  scale_x_continuous(expand=c(0,0)) +
+  scale_y_comma() +
+  labs(title="Age distribution of population in the U.S., 1900-2002",
+       subtitle="Example data from the R Graphics Cookbook",
+       caption="Source: R Graphics Cookbook") +
+  theme_ipsum_rc(grid="XY") +
+  theme(axis.text.x=element_text(hjust=c(0, 0.5, 0.5, 0.5, 1))) +
+  theme(legend.position="bottom")
    +

    +
    +update_geom_font_defaults(font_rc_light)
+
+count(mpg, class) %>% 
+  mutate(n=n*2000) %>% 
+  arrange(n) %>% 
+  mutate(class=factor(class, levels=class)) %>% 
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=scales::comma(n)), hjust=0, nudge_y=2000) +
+  scale_y_comma(limits=c(0,150000)) +
+  coord_flip() +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 column chart example with commas",
+       subtitle="A plot that is only useful for demonstration purposes, esp since you'd never\nreally want direct labels and axis labels",
+       caption="Brought to you by the letter 'g'") + 
+  theme_ipsum_rc(grid="X")
    +

    -
    -

    -Spellcheck ggplot2 labels

    - -

    +
    +

    Spellcheck ggplot2 labels +

    +
    +df <- data.frame(x=c(20, 25, 30), y=c(4, 4, 4), txt=c("One", "Two", "Three"))
+
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  labs(x="This is some txt", y="This is more text",
+       title="Thisy is a titlle",
+       subtitle="This is a subtitley",
+       caption="This is a captien") +
+  theme_ipsum_rc(grid="XY") -> gg
+
+gg_check(gg)
+## Possible misspelled words in [title]: (Thisy, titlle)
+## Possible misspelled words in [subtitle]: (subtitley)
+## Possible misspelled words in [caption]: (captien)
    +

    -
    -

    -hrbrthemes Metrics

    - +
    +

    hrbrthemes Metrics +

    +
    @@ -378,62 +426,94 @@

    - - - - - - - - + + + + + + + + + + + + + + + + + + + - - - - - - - + + + + + + +
    Lang # Files
    R200.9110820.92110.685830.78240.8917240.803270.729080.84
    HTML10.042970.14320.0720.00
    Rmd 20.091240.1990.321620.220.071290.06980.211680.16
    -
    -

    -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.

    +
    +

    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.

    +
    - + + + - - + diff --git a/docs/pkgdown.css b/docs/pkgdown.css index 2e4f0cf..80ea5b8 100644 --- a/docs/pkgdown.css +++ b/docs/pkgdown.css @@ -17,12 +17,14 @@ html, body { height: 100%; } +body { + position: relative; +} + body > .container { display: flex; height: 100%; flex-direction: column; - - padding-top: 60px; } body > .container .row { @@ -54,8 +56,10 @@ img.icon { float: right; } -img { +/* Ensure in-page images don't run outside their container */ +.contents img { max-width: 100%; + height: auto; } /* Fix bug in bootstrap (only seen in firefox) */ @@ -65,18 +69,21 @@ summary { /* Typographic tweaking ---------------------------------*/ -.contents h1.page-header { +.contents .page-header { margin-top: calc(-60px + 1em); } +dd { + margin-left: 3em; +} + /* Section anchors ---------------------------------*/ a.anchor { - margin-left: -30px; - display:inline-block; - width: 30px; - height: 30px; - visibility: hidden; + display: none; + margin-left: 5px; + width: 20px; + height: 20px; background-image: url(./link.svg); background-repeat: no-repeat; @@ -84,17 +91,15 @@ a.anchor { background-position: center center; } -.hasAnchor:hover a.anchor { - visibility: visible; -} - -@media (max-width: 767px) { - .hasAnchor:hover a.anchor { - visibility: hidden; - } +h1:hover .anchor, +h2:hover .anchor, +h3:hover .anchor, +h4:hover .anchor, +h5:hover .anchor, +h6:hover .anchor { + display: inline-block; } - /* Fixes for fixed navbar --------------------------*/ .contents h1, .contents h2, .contents h3, .contents h4 { @@ -102,37 +107,135 @@ a.anchor { margin-top: -40px; } -/* Static header placement on mobile devices */ -@media (max-width: 767px) { - .navbar-fixed-top { - position: absolute; - } - .navbar { - padding: 0; - } +/* Navbar submenu --------------------------*/ + +.dropdown-submenu { + position: relative; +} + +.dropdown-submenu>.dropdown-menu { + top: 0; + left: 100%; + margin-top: -6px; + margin-left: -1px; + border-radius: 0 6px 6px 6px; +} + +.dropdown-submenu:hover>.dropdown-menu { + display: block; +} + +.dropdown-submenu>a:after { + display: block; + content: " "; + float: right; + width: 0; + height: 0; + border-color: transparent; + border-style: solid; + border-width: 5px 0 5px 5px; + border-left-color: #cccccc; + margin-top: 5px; + margin-right: -10px; +} + +.dropdown-submenu:hover>a:after { + border-left-color: #ffffff; } +.dropdown-submenu.pull-left { + float: none; +} + +.dropdown-submenu.pull-left>.dropdown-menu { + left: -100%; + margin-left: 10px; + border-radius: 6px 0 6px 6px; +} /* Sidebar --------------------------*/ -#sidebar { +#pkgdown-sidebar { margin-top: 30px; + position: -webkit-sticky; + position: sticky; + top: 70px; } -#sidebar h2 { + +#pkgdown-sidebar h2 { font-size: 1.5em; margin-top: 1em; } -#sidebar h2:first-child { +#pkgdown-sidebar h2:first-child { margin-top: 0; } -#sidebar .list-unstyled li { +#pkgdown-sidebar .list-unstyled li { margin-bottom: 0.5em; } +/* bootstrap-toc tweaks ------------------------------------------------------*/ + +/* All levels of nav */ + +nav[data-toggle='toc'] .nav > li > a { + padding: 4px 20px 4px 6px; + font-size: 1.5rem; + font-weight: 400; + color: inherit; +} + +nav[data-toggle='toc'] .nav > li > a:hover, +nav[data-toggle='toc'] .nav > li > a:focus { + padding-left: 5px; + color: inherit; + border-left: 1px solid #878787; +} + +nav[data-toggle='toc'] .nav > .active > a, +nav[data-toggle='toc'] .nav > .active:hover > a, +nav[data-toggle='toc'] .nav > .active:focus > a { + padding-left: 5px; + font-size: 1.5rem; + font-weight: 400; + color: inherit; + border-left: 2px solid #878787; +} + +/* Nav: second level (shown on .active) */ + +nav[data-toggle='toc'] .nav .nav { + display: none; /* Hide by default, but at >768px, show it */ + padding-bottom: 10px; +} + +nav[data-toggle='toc'] .nav .nav > li > a { + padding-left: 16px; + font-size: 1.35rem; +} + +nav[data-toggle='toc'] .nav .nav > li > a:hover, +nav[data-toggle='toc'] .nav .nav > li > a:focus { + padding-left: 15px; +} + +nav[data-toggle='toc'] .nav .nav > .active > a, +nav[data-toggle='toc'] .nav .nav > .active:hover > a, +nav[data-toggle='toc'] .nav .nav > .active:focus > a { + padding-left: 15px; + font-weight: 500; + font-size: 1.35rem; +} + +/* orcid ------------------------------------------------------------------- */ + .orcid { - height: 16px; + font-size: 16px; + color: #A6CE39; + /* margins are required by official ORCID trademark and display guidelines */ + margin-left:4px; + margin-right:4px; vertical-align: middle; } @@ -140,14 +243,14 @@ a.anchor { .ref-index th {font-weight: normal;} -.ref-index td {vertical-align: top;} +.ref-index td {vertical-align: top; min-width: 100px} .ref-index .icon {width: 40px;} .ref-index .alias {width: 40%;} .ref-index-icons .alias {width: calc(40% - 40px);} .ref-index .title {width: 60%;} .ref-arguments th {text-align: right; padding-right: 10px;} -.ref-arguments th, .ref-arguments td {vertical-align: top;} +.ref-arguments th, .ref-arguments td {vertical-align: top; min-width: 100px} .ref-arguments .name {width: 20%;} .ref-arguments .desc {width: 80%;} @@ -160,31 +263,26 @@ table { /* Syntax highlighting ---------------------------------------------------- */ -pre { - word-wrap: normal; - word-break: normal; - border: 1px solid #eee; -} - -pre, code { +pre, code, pre code { background-color: #f8f8f8; color: #333; } +pre, pre code { + white-space: pre-wrap; + word-break: break-all; + overflow-wrap: break-word; +} -pre code { - overflow: auto; - word-wrap: normal; - white-space: pre; +pre { + border: 1px solid #eee; } -pre .img { +pre .img, pre .r-plt { margin: 5px 0; } -pre .img img { +pre .img img, pre .r-plt img { background-color: #fff; - display: block; - height: auto; } code a, pre a { @@ -201,9 +299,8 @@ a.sourceLine:hover { .kw {color: #264D66;} /* keyword */ .co {color: #888888;} /* comment */ -.message { color: black; font-weight: bolder;} -.error { color: orange; font-weight: bolder;} -.warning { color: #6A0366; font-weight: bolder;} +.error {font-weight: bolder;} +.warning {font-weight: bolder;} /* Clipboard --------------------------*/ @@ -222,6 +319,19 @@ a.sourceLine:hover { visibility: visible; } +/* headroom.js ------------------------ */ + +.headroom { + will-change: transform; + transition: transform 200ms linear; +} +.headroom--pinned { + transform: translateY(0%); +} +.headroom--unpinned { + transform: translateY(-100%); +} + /* mark.js ----------------------------*/ mark { @@ -234,3 +344,41 @@ mark { .html-widget { margin-bottom: 10px; } + +/* fontawesome ------------------------ */ + +.fab { + font-family: "Font Awesome 5 Brands" !important; +} + +/* don't display links in code chunks when printing */ +/* source: https://stackoverflow.com/a/10781533 */ +@media print { + code a:link:after, code a:visited:after { + content: ""; + } +} + +/* Section anchors --------------------------------- + Added in pandoc 2.11: https://github.com/jgm/pandoc-templates/commit/9904bf71 +*/ + +div.csl-bib-body { } +div.csl-entry { + clear: both; +} +.hanging-indent div.csl-entry { + margin-left:2em; + text-indent:-2em; +} +div.csl-left-margin { + min-width:2em; + float:left; +} +div.csl-right-inline { + margin-left:2em; + padding-left:1em; +} +div.csl-indent { + margin-left: 2em; +} diff --git a/docs/pkgdown.js b/docs/pkgdown.js index 706ad58..6f0eee4 100644 --- a/docs/pkgdown.js +++ b/docs/pkgdown.js @@ -2,18 +2,11 @@ (function($) { $(function() { - $("#sidebar") - .stick_in_parent({offset_top: 40}) - .on('sticky_kit:bottom', function(e) { - $(this).parent().css('position', 'static'); - }) - .on('sticky_kit:unbottom', function(e) { - $(this).parent().css('position', 'relative'); - }); + $('.navbar-fixed-top').headroom(); - $('body').scrollspy({ - target: '#sidebar', - offset: 60 + $('body').css('padding-top', $('.navbar').height() + 10); + $(window).resize(function(){ + $('body').css('padding-top', $('.navbar').height() + 10); }); $('[data-toggle="tooltip"]').tooltip(); @@ -25,6 +18,10 @@ for (var i = 0; i < links.length; i++) { if (links[i].getAttribute("href") === "#") continue; + // Ignore external links + if (links[i].host !== location.host) + continue; + var nav_path = paths(links[i].pathname); var length = prefix_length(nav_path, cur_path); @@ -52,13 +49,14 @@ return(pieces); } + // Returns -1 if not found function prefix_length(needle, haystack) { if (needle.length > haystack.length) - return(0); + return(-1); // Special case for length-0 haystack, since for loop won't run if (haystack.length === 0) { - return(needle.length === 0 ? 1 : 0); + return(needle.length === 0 ? 0 : -1); } for (var i = 0; i < haystack.length; i++) { @@ -82,7 +80,7 @@ $(document).ready(function() { var copyButton = ""; - $(".examples, div.sourceCode").addClass("hasCopyButton"); + $("div.sourceCode").addClass("hasCopyButton"); // Insert copy buttons: $(copyButton).prependTo(".hasCopyButton"); @@ -93,7 +91,7 @@ // Initialize clipboard: var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', { text: function(trigger) { - return trigger.parentNode.textContent; + return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, ""); } }); diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml index ae3eb50..611a330 100644 --- a/docs/pkgdown.yml +++ b/docs/pkgdown.yml @@ -1,6 +1,10 @@ -pandoc: 2.3.1 -pkgdown: 1.2.0 +pandoc: 2.16.1 +pkgdown: 2.0.2.9000 pkgdown_sha: ~ articles: why_hrbrthemes: why_hrbrthemes.html +last_built: 2022-02-11T23:35Z +urls: + reference: https://cinc.rud.is/web/packages/hrbrthemes/reference + article: https://cinc.rud.is/web/packages/hrbrthemes/articles diff --git a/docs/reference/ArialNarrow.html b/docs/reference/ArialNarrow.html index a86ffb7..73a69a3 100644 --- a/docs/reference/ArialNarrow.html +++ b/docs/reference/ArialNarrow.html @@ -1,58 +1,12 @@ - - - - - - - -Arial Narrow font name R variable aliases — font_an • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Arial Narrow font name R variable aliases — font_an • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Arial Narrow font name R variable aliases

    - Source: R/theme-ipsum.r + Source: R/theme-ipsum.r
    -

    font_an == "Arial Narrow"

    -
    - 
    font_an
    - -

    Format

    +
    + 
    font_an
    +
    +
    +

    Format

    length 1 character vector

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/EconSansCondensed.html b/docs/reference/EconSansCondensed.html new file mode 100644 index 0000000..915550c --- /dev/null +++ b/docs/reference/EconSansCondensed.html @@ -0,0 +1,114 @@ + +Econ Sans Condensed font name R variable aliases — font_es • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Econ Sans Condensed font name R variable aliases

    + Source: R/econ-sans.R + +
    + +
    +

    font_es == "EconSansCndLig"

    +

    font_es_bold == "EconSansCndBol"

    +

    font_es_light == "EconSansCndLig"

    +
    + +
    + 
    font_es
+
+font_es_bold
+
+font_es_light
    +
    + +
    +

    Format

    +

    length 1 character vector

    +

    An object of class character of length 1.

    +

    An object of class character of length 1.

    +
    +
    +

    Note

    +

    font_es_bold (a.k.a. "EconSansCndBol") is not available on +Windows and will throw a warning if used in plots.

    +

    font_es_light (a.k.a. "EconSansCndLig") is not available on +Windows and will throw a warning if used in plots.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/GoldmanSans.html b/docs/reference/GoldmanSans.html new file mode 100644 index 0000000..7f97dcd --- /dev/null +++ b/docs/reference/GoldmanSans.html @@ -0,0 +1,97 @@ + +Goldman Sans font name R variable aliases — font_gs • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Goldman Sans font name R variable aliases

    + Source: R/goldmansans.R + +
    + +
    +

    font_gs == "Goldman Sans Condensed"

    +
    + +
    + 
    font_gs
    +
    + +
    +

    Format

    +

    length 1 character vector

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/Inter.html b/docs/reference/Inter.html new file mode 100644 index 0000000..b50e6aa --- /dev/null +++ b/docs/reference/Inter.html @@ -0,0 +1,127 @@ + +Inter font name R variable aliases — font_inter_thin • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Inter font name R variable aliases

    + Source: R/inter.R + +
    + +
    +

    font_inter_thin == "Inter-Thin"

    +

    font_inter_thin_italic == "Inter-ThinItalic"

    +

    font_inter_medium == "Inter-Medium"

    +

    font_inter_medium_italic == "Inter-MediumItalic"

    +

    font_inter_semibold == "Inter-SemiBold"

    +

    font_inter_bold == "Inter-Bold"

    +

    font_inter_italic == "Inter-Italic"

    +
    + +
    + 
    font_inter_thin
+
+font_inter_thin_italic
+
+font_inter_medium
+
+font_inter_medium_italic
+
+font_inter_semibold
+
+font_inter_bold
+
+font_inter_italic
    +
    + +
    +

    Format

    +

    length 1 character vector

    +

    length 1 character vector

    +

    length 1 character vector

    +

    length 1 character vector

    +

    length 1 character vector

    +

    length 1 character vector

    +

    length 1 character vector

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/PlexSans.html b/docs/reference/PlexSans.html index d03088d..2a59d13 100644 --- a/docs/reference/PlexSans.html +++ b/docs/reference/PlexSans.html @@ -1,59 +1,13 @@ - - - - - - - -PlexSans font name R variable aliases — font_ps • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -PlexSans font name R variable aliases — font_ps • hrbrthemes - - - + + -
    -
    - -
    -
    +

    PlexSans font name R variable aliases

    - Source: R/plexsans.R + Source: R/plexsans.R
    -

    font_ps == "IBMPlexSans"

    font_ps_light == "IBMPlexSans-Light"

    -
    - 
    font_ps
+    
    
+    
    font_ps
 
-font_ps_light
    
-        
-    
    Format
    
+font_ps_light
    +
    +
    +

    Format

    length 1 character vector

    - -

    Note

    - +

    An object of class character of length 1.

    +
    +
    +

    Note

    font_ps_light (a.k.a. "IBMPlexSans-Light") is not available on Windows and will throw a warning if used in plots.

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/PublicSans.html b/docs/reference/PublicSans.html new file mode 100644 index 0000000..089cc7f --- /dev/null +++ b/docs/reference/PublicSans.html @@ -0,0 +1,117 @@ + +Public Sans font name R variable aliases — font_pub • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Public Sans font name R variable aliases

    + Source: R/public-sans.R + +
    + +
    +

    font_pub == "Public Sans"

    +

    font_pub_bold == "Public Sans Bold"

    +

    font_pub_light == "Public Sans Light"

    +

    font_pub_thin == "Public Sans Thin"

    +
    + +
    + 
    font_pub
+
+font_pub_bold
+
+font_pub_light
+
+font_pub_thin
    +
    + +
    +

    Format

    +

    length 1 character vector

    +

    An object of class character of length 1.

    +

    An object of class character of length 1.

    +

    An object of class character of length 1.

    +
    +
    +

    Note

    +

    font_pub_bold (a.k.a. "Public Sans Bold") is not available on +Windows and will throw a warning if used in plots.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/RobotoCondensed.html b/docs/reference/RobotoCondensed.html index a30d110..d082f35 100644 --- a/docs/reference/RobotoCondensed.html +++ b/docs/reference/RobotoCondensed.html @@ -1,59 +1,13 @@ - - - - - - - -Roboto Condensed font name R variable aliases — font_rc • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Roboto Condensed font name R variable aliases — font_rc • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Roboto Condensed font name R variable aliases

    - Source: R/roboto-condensed.r + Source: R/roboto-condensed.r
    -

    font_rc == "Roboto Condensed"

    font_fc_light == "Roboto Condensed Light"

    -
    - 
    font_rc
+    
    
+    
    font_rc
 
-font_rc_light
    
-        
-    
    Format
    
+font_rc_light
    +
    +
    +

    Format

    length 1 character vector

    - -

    Note

    - +

    An object of class character of length 1.

    +
    +
    +

    Note

    font_rc_light (a.k.a. "Roboto Condensed Light") is not available on Windows and will throw a warning if used in plots.

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/Rplot001.png b/docs/reference/Rplot001.png new file mode 100644 index 0000000000000000000000000000000000000000..17a358060aed2a86950757bbd25c6f92c08c458f GIT binary patch literal 1011 zcmeAS@N?(olHy`uVBq!ia0y~yV0-|=9Be?5+AI5}0x7m6Z+90U4Fo@(ch>_c&H|6f zVg?3oArNM~bhqvg0|WD9PZ!6KiaBo&GBN^{G%5UFpXcEKVvd5*5Eu=C0SJK)8A6*F U7`aXvEC5;V>FVdQ&MBb@00SN#Z2$lO literal 0 HcmV?d00001 diff --git a/docs/reference/TinyHand.html b/docs/reference/TinyHand.html new file mode 100644 index 0000000..16ef0bf --- /dev/null +++ b/docs/reference/TinyHand.html @@ -0,0 +1,97 @@ + +TinyHand Web font name R variable aliases — font_th • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    TinyHand Web font name R variable aliases

    + Source: R/tinyhand.R + +
    + +
    +

    font_th == "BF Tiny Hand"

    +
    + +
    + 
    font_th
    +
    + +
    +

    Format

    +

    length 1 character vector

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/TitilliumWeb.html b/docs/reference/TitilliumWeb.html index 49fa661..0f672ee 100644 --- a/docs/reference/TitilliumWeb.html +++ b/docs/reference/TitilliumWeb.html @@ -1,60 +1,14 @@ - - - - - - - -Titillium Web font name R variable aliases — font_tw • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Titillium Web font name R variable aliases — font_tw • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Titillium Web font name R variable aliases

    - Source: R/titillium-web.R + Source: R/titillium-web.R
    -

    font_tw == "Titillium Web"

    font_tw_light == "Titillium Web Bold"

    font_tw_light == "Titillium Web Light"

    -
    - 
    font_tw
+    
    
+    
    font_tw
 
-font_tw_bold
+font_tw_bold
 
-font_tw_light
    
-        
-    
    Format
    
+font_tw_light
    +
    +
    +

    Format

    length 1 character vector

    - -

    Note

    - +

    An object of class character of length 1.

    +

    An object of class character of length 1.

    +
    +
    +

    Note

    font_tw_light (a.k.a. "Titillium Web Bold") is not available on Windows and will throw a warning if used in plots.

    font_tw_light (a.k.a. "Titillium Web Light") is not available on Windows and will throw a warning if used in plots.

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/figures/README-an-1.png b/docs/reference/figures/README-an-1.png new file mode 100644 index 0000000000000000000000000000000000000000..5d620ab9496b78e65ebd9522ef21607195460663 GIT binary patch literal 26372 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 N=3_n8N@csh{sWgz_m2Po literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-ax1-1.png b/docs/reference/figures/README-ax1-1.png new file mode 100644 index 0000000000000000000000000000000000000000..89b38859a85ac01bf127a8d718de18bf8c9d5dab GIT binary patch literal 28127 zcmdqI1ys~s+deuBjf9fYC|x2gJqn04(v6ffNH+|kq<~2GP|_gXpwb{PGz=}>T|=D# ze4h7xzwiCtZ=JRN=d5*(vY7epeeZo=`?{}v?cW5!N(xdqSY%iL002k&m4q??fC>Tt zkiTOfBU)N&Xg3fKC}z*)p927;5%(?(Q4!Zjj>=Lm0L6V2YXAU{RY^`&($FJ#XJ_Zv zuV0CIWk*Lxqobo|aQOB0H6mDEUjFj(5(;#eadL7p44Y|cY6?xst@_>`lAHs9Kyq_)JrMsQ zk_-(EpFVxMxw*Npu#lCN#lpgZii(<^o_=s};OOXhetz!Y;PB|tBRf00^78VjsVOiR z+}76C(9oc(s~Z&+MMg&U_U+r>zkhFRY*<-Y5fT!rtE>C_`(t5Y4G$0F;o-Hnw^vnF zg@%T{d-u-9#>P1$uBD}AVq!vHUq2!uLP|>N!-o$N5)x%)Wy;FRT3T8`EiNt&3JUV^@!{s?ZftBMAtAB0wl*;_DJUq2jEqc3NMK`QtEs8! z>+AdS<;&jQ-r(S1Nl8g-Ypc7vdvI_t1_nk)M@MaKt&ot=^XJcVa&mBRaFUXeK7INm zBO_B?UA?@#TvSxV$jC@VMdc6_O-V_KkB=W8AJ5Cn`|R1XH*elNeE6`dtBa41FSnxJ zKRWemNu}M#FW)#_b2{$g6@b#Wcou`Y(+d8v$f(PUMD>)MrDcd<|D{DK4PAA_PaRGn}1F!e@0D${S2ptn5 zw2KM=fsp=w{HNxB?*6O!ugCwNkGfgr4J&^ySC6bvsCi@lqQG11I>!_VYvX)0+x-E@ z1vt9|wkv5n-5#+P^Km{k*JlK4-T2;$l8!WMzZu3V`h4%zCn-g<IuMZ;Qx4FUtrup9KcU?rX!ZM0Mz5war81Kr38=u5Uwi zK!Ip{?t#5hUe&*1NNT~BK3elYZSysU2T*#F#NYT(sRSD1{!mR&xo@vYgEdq+`^+w^t*LOZR$KPz2WQ3JgV%kuCV=_XPFfhN%GmOpnC7$g zk@TL^OD9czq_P+xV1&WHId{2&)RnhFuc$04m{Nl%$Y$vX|GH&`bjf z=l)IQ%NW7me9eUq3;{oeuquLt^sf5}1CsY^ouSuF*X6nkz;uJ?kr!)H_S9TqGyCh;;l-mOpHTM�H& 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 Gr~d&+4E1LK literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-ax2-1.png b/docs/reference/figures/README-ax2-1.png new file mode 100644 index 0000000000000000000000000000000000000000..d78747a64b1cf459cf0e40c28f6b94bd1b67e8a3 GIT binary patch literal 43223 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 literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-ax3-1.png b/docs/reference/figures/README-ax3-1.png new file mode 100644 index 0000000000000000000000000000000000000000..7549b2ed0d888703e5668cff6f4d3c9ab6057b94 GIT binary patch literal 32405 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

    dfK2Tmqkq z8D2U2bp64^ zA7Bpc9V7!LMKtMK03Iv z4~=HsT15C6L~NE8DL%q663B2U@v6!EcjOLLGgb037NbHw*I7A0ud(K_VC+ld-^NIA zrB6)KxPA3$^4{}wF8t3y9UQ|`->G8_KplHq6`*E(m^7$=kRKT@-fkqv7^C!VxZgEs zZ0a`|AlQ^?G2z0C;-r8G_9HCwYfF@k6PVH4^*~~WMWzPmjel&%tJfV=TV8A;#+4}j z`K=&v^mB7`1N5Rn34bR{RP!wVzJFx+bVObrR7cIgj*>II%6cF(_~k>mhCnzlM+;$7#8Dyu{^MLtTuZa^-xK2W}=^by#<`KXDJd zg+N~WPtkCZ=Ui4xOEj1KkHl|yJp^YiHM52fYL79a7^`gkD?t>}h$3Q3i_adp?IM%trbFJiTf$9I<~rU8UI z*9e}Bx$5F|lD;-73vzcIDO~XbsMpW(tSUL`4McCu5=xuk1Bzi&dSm(O2d<@~ zO=McaAHO-1_yuwL9c0zWi?zr6}dQPxI#jmaf(7jgc6>@dM)8`j29O(N&T2*fSWW zTZ5ncD3B`84F?y<8c56C_`6+qLaSF_0~DUM3HTwM=&{B1=7iCs4qww6@>t~l@r{vH z`B(2_u|9BStYzqpAxFE?T2%@hNL1zRZjP`kq`R3MGBpznAaRjz(!1FSoIPv)Y6RE{ zRrD*$^F2t*yl-7>2h36LIC|A9=?;FVN6hVXw`^oz2>2qvUTovK|7P?{4FgENKK(kw zvP^8H_XK1?k^8v|raY%r@(LF`x^^ojW!wdbW<=36(_=kVltlqY<}>DuxN74SvJ-rW zihY!}rVMr0OTk@J=i?Vm{};+nNNSITVj7X;N#l!x47!c5;7C%ouSD%p6?&!nV?V>y zsU`NvtOIuY9&NleeFU>MGUCI54G!<|kQJ(?ejUki02H3uK&-w%I6>-9?!9H$&x#(y zD#FHE(0&)ymA^Nnf@KY$nW%OtVu7phbd#e1YJ7B0K#jTzVlkbgpUk}$`GU%1<)4#! zr@K7{`FvXA>cZ%G0M_Zi=OW+Ezk)*o+iiXXqZ5YL zlnYS$VD2Yl+;ZTyQ8IyMqL3;u=ADydtA~Sth~pJbbk--CVj|dXDIgikKxheBjhF{m zA&fDVZk&zG@DT2(NDTid2`N3k92=m1M1ZXJT)JPnJ_n8A5Cs>^BDk5NB@o%1ZySSZ z4qTR6F<0*dIznh2)u|s#DXQhgVZqn$D0sgC#_Vit0QV`6?IvW$`Jn92nuQQ+-~?$4egd~pe7 zOlr+~>!e(>*8{vKPW99On7tiBs8b(j)AXXH)Q9X z)`5WqoOTGQ*)J9T;j_}m-StmFM>Mqy-(vjwTYksZrxF*bI+4H>r!JiAM}If?ct^Qc zuISN5IarcG)48z`d2fub2Fv@aXb*jSWC;-FKM;cdEO{il4UF))M^IXX3RM8X_N9+) zgvdz;N$>iz{slFebdTop+9e({S*JDddqn7qQi5fSM=*h@6nX zeduEhZ6XZo9jU=(vYL9I@DKY{@{~31O+JE7pI@L%Hnn;&hLabcg%!) zk-Vm;sb8mggO^Q4mtVW;G?zu^e&L)C8k%~02X^F8UI)5U0z^}{_zI1v$$INkTuR^e zh?}2HYz|PWmIh98HGrQ~D=+_6i*IO!bFw*;y!a!6{a3sHTZAQq2;>o1pGfZY8o4=N zCg!0zD9TZx!Q&4@dC^Kr)rFqDoh6VO^K38wB^Ua~S*oRrfXf{uFw_u@)%l_MkHK9O zXFgOu!+IVjDE=NXl-uVKi#WuCdpl8M^;GW{a%7L$a~ro4Qe!(jR?X8aTlP zAgWeg|9!-`!EX>ZU?RUdn2wnU=(W|ydA%2%_0<2(M<*Tt5kD$!3=%jg#Ps8`vKZV5 z1^(SCZ_kHD^Oz4RaGv$Pq~3XKA0~B3Ksm0WTha!*A>Gp z!Bw<8a+GE#@OS-7N2ly^H^;-};kDm0deT(S@>9}!mCSc-+2{CTrkuL8zWQJg74P&p zis%poP~G&R7Yrhg)xsJ~`qyV~JH{OrvPDVf>0Wc*AL(-m)u0*U7h7CJQRRebquEkx zy{+|WI{wjI&d~Z2dX#vM_QWMP_D^7Bg~;To9)NR6BR{gSG1v$(1=iJ&ER-AfPvlri zYC#3isOv*4*mcNiWh4fq&&W*ZCJ1MLs!n~l_fl~zMcuH(*bg?{8ll?#+@&BMj7;Ab zV3UV&67?HC%jM|xQW@f2a8tO2vSrl|xgSx@`;arl5S172v;8&dy@Kis^X2~C&#u>@ z2S>aS0+|%cFZ^VR2Z?W-FKy3KyC787K zkS66fZ6|YI$u~rS0A5K+_l$ke>EvFE9(Pv9Z5nndbggq8Kpd*{0ax|i3Pn7@1Tewj z4p`;#<`OsJJns(N;HVyoEv*5%=ULB?pE@2UAdZm9fC^-rDJBwrkSK+AMhctJu@HQIhMJC?gBLmMgz8Y_ z+rCUkmj3k9r}Ux%a}_#xR*>OIx!6155^I>b$+9Ulbe+OTKR-Zt$RAD_;QMs{mm zu@K~zuTMCpdu_S^8I!lV1ASUcZ^KNnJ>%))U?dK|MmVBX9aw7|GFDxzBU!h{xTC!^ zw>@p$sv1$>S6=%%xzF|tC~XE-9wYhJKr#Iz0`2s-FVvR&t}}Qa~^ceYxyBY%wZ-M z_lu*%`4qtiC8xV%x^q~3hxg9rkLdFEQX_+X29?r^?B&iAvk5ge)a^UtwPQ=e_M&=g z5fFO9Y3zHO(GY3kDssRx_$=y`T~Gc#WMH{xo2y!F_GFRa^r-j{FUFH|#L+SdM@>L+ zQGD~by~{*v;lN7(a;K9Sg1hSeiw*&beol2^VxR1pv84YfF7=t}bz4AH$CF3q7aOrx zVU5GDC1LXz)vBJG5C@YaDdZxtQ6%*dj1d*r2Iqr5Ooc6tAQtjR6L8=4fevY>)ffC8 zPHdH~l{e8T@rk18X;157R*7oOxj+YVtJsVSJfytMnexZ2Dqa02B>my}}u;U;N97kCBh4b{DOamE@=Dc-=a?{I2)T>T} zo^+NpS0-?}=1`{@;_@5M-{9w%wNl8iuv3qElw%?QFyICRSROH4xUi(GPX@;HrM5Q(#Bt4qXTE&QT`nJZhNRDSBqzvOh`pMDe(msUf zWVCjwW<&VfMyE~V{E$N{{wSFjQ|Oe%rEA;6g|m9UA&9O_O&U1w(x`wt3$MttndvdC zo7gZtn2Y&OA-xpJCbL__|NhOA%2hllZ_RHS8d`PVWY#r4uR2l9&j-Z?tkR#p{HEC| zJ5BFXRAUgQ0D}m`2Z_pRFY^$kFY@b`)9e3X+e4lcW}V$UeRR5|!J7SZ9MMC1g{Afu z-AKXl6yYU;~26w62iw z-Jsb6mTP()olCIFGiH{*1xra2yqQUt-atuDcJi`j2zIhm;vdOn= z3}8CS5c@sVpQa2W*n*Gh%=7H@H@mVCBBihn;0tedPd4h**8fr3+H?5(XJH)JSqyTl zI(f{(ii@gd>y~8l5LUUL*}0#S1dMHN8>-?;&1aLq8U9D48%Vdm*})#IwODEjUFk^# zMNdr`SOSX1Q?XTNsV0j5uuyHAmRxiieEuQMW_1rq6B&S#Fv;lY=QSz18M!;1aK&;X z&l)cvscCTO@!9{E6B7?krcF7Mbw77>Gsx^BG;t^U;OvV$XMl|elKN;VgPC2gHG`EV z1$zvB@(>Rg;xwo&q(d%!Fq6xX{ci>Vpu{ncSJm}-WtbHlP6f4b3DHpB4*dz?N#i|R zftN42^3rZlwR4+~2y+rXmfMT==^z~I$?6H*v^ouJGifz?GQonJsj*(rQBEf)wY<7m zw5eP7uShnhLei7Ys1hFE)S;$AY7|QYHMHX&2FL0OS$TekH92_Zr9DSLpYjs^{T$4_ z$RzMWG{xstvLr0r@pW&|uyb5@`1PE)eXqC8AJ=^nIKq8K<7dC2vB&oD!KW_Kqx~uc zwp0903L|7)e9OMIf9X?e#UkQb|5TRH9>W|0oCGWS-o>ZfDPxTeFZJKbiUUz> zC@raue5ZO>RCutQm8UPT!vyDiI%EJB z{)21Co@%1q?l)}z`pZdn^PADDns!fE2O}IKT_WPS(ZH)9dGE=frkDj24+LY|T+&y_ zbh-hh=B@Gwd5wJ5Z=zVNq8amO!1R)E@*^eNFa?aLrl>{(L`%P% z7XCrNGi_nBFi36MJO58wI>u*6bd@CSyP6gmzvTZ7lVY_d4yc?=WJC!6v*0KRpK!tZ z?h~DJ!b;-a7((M39h)uG)^SU6>kI;8WFz8Y?1%s>*KyzyftPTynT;V%5nB*}T&f9N zQAmSF($Z;Bh%`wqd9o`n06#3Ws+cWv^QonTDmngZk&l}iHOA%3e zz_8Y(z10=ts38Y;+>#RztD7zzcU?c&usHAD)Ffr63oTS$U8T4iXRLIs5PD+}xJ%K` zUnnxyJBM2I2!PI|gyb|7!ny9?JJAzlHIyp^xAzY2U?(!}8R?Pl&AQAV$d~7HsuOr! zTmRY;THSRY4O2jp|2_Sm^#3*eaCzZ@{^7dA zf8Xxm!5?n_ZMz5h|H1xW+u8bp?D!w00W#iw5&Ow-HzJLX@@wO{WX!~`*X zmm)~s6VbqT9G^PO2@!n$7s?1_}dSCC1 z?!~iC$uQa3{c|+u)Uen6-#lf`rWD)-y<^L$K|uf_(C+DVl#N5j!Yh7eOz)T&L`Mw_ z0Ld2MC)L*bYJfic@*Kc`4@JsJPFT@gY)d2cyHLCXz$5^eFz4wP^c02T^=0~juieo9 z?iF1r@63vtRX=*~{q{pd;A~Kk8-NZ845(CZDU4D59_#lj*Q=97=wZVFUEbgnr_%|N z?A5IdlloXB#135H(3dWM5MUx$Bz%GDQ{No^%1y8LSOZ3*gMg0D-RQ-mWC%n4(A4=d z{@}Q*uATEpXu6b+V_`u9(*jVzGYWkMZ}wqH^p=QD6%cUDd1hq|4vDb>{+$)ZLEefn z{VS&6dFg_E;rLaMz+aSeR$7Zi-WkqrL+`@>CH92p59t!tzvSCb%x9*lkpJj|5b4i$ z0J>mmn2w&Z?V#NhIUhc}pnp|qq@M@K5UC2V?q|nI4mm#XDy(kgT&iM?qm_=!-V3cH zYH<8517f!ETaVzwjqav_>dPmN2^5@$&Swq=duea?hTYv;Y%cmF%wI339ZT0aH<=*l zyKMXP+B^!I9)W440av-sn^Iwjmm^uCb8i{RyD{bxoEeee(bExgZ+`3v5_R!MTF7y(Mih3wAIr$iTh2y3oJGRdwKdWb zz&R&Y?4^{)e8qtZ$!`O-F0%8|1TVNM)D+w%khT((JDIQ1P!4HWqJ5+>s2*mq%n1Xiog~wdva!g@M{tjc$ialO9OP^&(PQMxZxUo3z=Uup*jg6ilmd}d^qpS_~7+j01x2wX(etv$Ic00Ze z*izpD8J9Bw!0F!sS0`VbJgus$Mh+5=K_N=glzfD6^?eypvIY9IJ=}oLpRz=7bIg?s zpXbdX^jQkvDmeekG$7iy(9|Nql;(539 zkvB#tmsfTsJQ61GRgOB40~)`$c(Ii?-()e}tT=Ej2U+a}4Ow3FJ~92EYrVqGJzRpKnCRkfVE&G7L5ItxjfgzZPQTIJwm1v;U^l*1J+qYVNP(L3F1=kv1MtP~YlG zbJZK>68xzF2Kd9NL#W|@vgC%;*3@V*D$t8|)pqhv1|Rz{lla>Gvnxpz?l{K6{7#18 z-z2RV5GMP>V4can|4{Qt^=~$IA&+X{eMjZ}d{tcf@8Wr^i~GO~?9>0@@&t|AkBL1Oh|RYf13<=P&+*A=BI+RS}_m&NLIzW3JppCMKXU1RM-PVBdRix z2!sJ*d;)ah)vo=kA@6eTM!z(RABgwd4+T|k3;G!CPaQt1XTf5=Vbrks*F+SH5kU~5 z@SUjVMLGOY#g*LZ+&rQ^5K**?!8TroXCIr@QU6$Ty6CkLfj-V3OXlo;aFOQ1{zDdy zfnX2hDuQZ|vV@|L^8eLn-A%~*`H0ksjPssC#s=j9_voz4a{ z*s=D>A9t`muRO$|eFXEKLi)3F6-5lLI8=jf+4K+~hX7=Ud{TPTV+_11)kRcPL8v=< zhUkf=*Uw)eXwfH8GOT6W${%p(WLPvF^z1|ll3gWX)eRX6aorfQ zrGi7ygxM+J^?;3?T)1D7CNqIs^BE&ICM+5qIx#+IC0jgs7EoPbVb+R!d%5JhI#|{7 zSm^}VNC?HWt6f`~Dw;+kCAh9cg{q_j5{5lFFPy5+_$p|sw^dMJ3VKbyCly(Rub}hz zps447OcdZrNmUNJ3Yvxp()wP<06w&8hnwVjEgcsfq!}YP;&`d;Dmum*?U`tb-7v4U zNUe2qR^#1#9OgX#*!nD_GqPi^koi8p&SB=wLT|VFsaXEd1=aYxW9FI1H6VHkXJaYZ z%{bnf-SNC>loGg66Ki2LuV00v zWhAV=pXbL1<|yTJR)w1j4?l`Nfs*t^%>TOfz1n9!^*P%+%?{#@K)y(9LQ(!s&_7Yw5^$|=baC|=+EOp5LxHdfD$X8QroHaT;wt-O1uf!;~CO!c;|4_8x0kjE+tnb;^p@ zKtJC!R;eKiVx`YFaAxqbjwzhujaqNBql%Zsgi>45RHtEHw-_~|HvxL*DaP7%#d#UB z&)?Y(O@XuK3Ce{M7wUrGXb{Lx&2J5n^GmeDN_#vNiA-58a=psK)49t=^8}{2ZlUBk zRw##$>f+d?WSxs932HBm5@f>d=V>vK!7m&DjoJAkp4Dt@Zzrh8bdWZ(zbcCk&*c+; zwMO2kA6HbmGPt{=S==wY!WK1M_ZQg!_xwAwX6c7l(@Ce{M`|0 zQ!kISWzH?ag#?Ox3*_=yYT9;fi*FQY4$KxOKnvRvq<=N=q)F*I{ZNL~i5W9LrLiW^x9w8S6I3_Eu zVH$tLn9)E0*ED)a`=4F_N0nlOLZ}rMXr?m44kR5V(yvc@oRM_nNI&sKw2lX6Htwm6 zo6Hz|>Ptd0$`1%OVS`E14A&&6l~yY%4(6qLC)+g->wDcpP)&3ITVrg$LdV(dT}_je&!#nK@q*1=Z4%E zqL}8`dQr*csD&zu2zUgr*hF{1>ql_OL;cQ1pmIC|R^$78lCRbrm_E<&8Y7Rh6>iF> zi-rYTlH2I^+xpd2`8(z$(j6R3LDG^sStW@K-S5CHJ>KelZAVm!omBZ+XAQB4vjy!F z;D&FTi@@pejt=5xuI>JI?V^npH6%)*J_f713J|TOSOJ!yh6q;YuKUhE-*OV@%nNKU z7j-?2l1|{^eM-R(|H18ryi1vZfT=vFd+@4F zvLd2!%`3ZJYaXZ9{x)wmmul*x^sEdnDDp92%uMGl`<`XGfc+rh>|HGs0ROd6FY$IM ziI2FkeGubrN54t{HrdwZS)HG)?z0o382(Y;H~GeFwF1gK&~Q`NZO&60=nrK0#`syL z@8(4G3oRZV^kw2yNo|mIuIRgx&fITBQmuz1VHr(UJ;WPiC!Nv)LldzI2w@z6$sYfw zxbKc?qU-vdfPjL46hTlxK&k@L1q7nfYmnYmdY2M<2`ary2Z0FEtJ0)DBE5z#AfR-D zfOH7$PEeosdB69&-@5nybJv13nVEg|{_S%1J~=bzf+G-5s)3KZ2=w~jDDP{owY}G&x0qSMGQ~q$(MWmb zvb-bw)o#`Hq3Zq??Q*A15kLvPpbZ!{yBQfLl3hUHpiEzSATQ!TA~MeM6k#iL)~ahDeufJY9BNoiWHCZ4eS=&% zuB%oPj~TEUSKJHhaK(2~@-pQz#etcR>;W)?ii>?rfT7!ZS7!z}O1GF8F`FsmB z>#TZo1+PNO*=%OzbZn!^JIGe3$+oHdfD|BvRs*R12`_M2MeH8Sk&3X)_ZYKn)${AH z(HuO9J{wYo#Dhw|F$kzWI2fxvRf0=zyz-kj$C?@RjQy?ZNaB4w+EZVjgg-RSI8ZW> z1%w^zEzk(yKlc1z*FaC)tNYF1+^!&_b2mew83uAa6hJ6wFhb~9Y-)&uU|-vQ_c>>j z3n1z)%zN%&ut6s2F9aYeEP2W&#B607*2#cCvgx5s1Xe7>5(D&ZjnRUp2Axs?Nm(lu z{2d9nF1L+syj|t3V)87Dea>-O;^Wo^lnOQ;?{=ghSbyN2Bj&$`;_@!uyn9GAh9mHl z0j$D=FvS)ZGu@oVn%CyqoIk1|pjn<(tyi|OoNn8Uf(v!P__GFzC$FN!YKf@{^y$$) zL=r>o{9b`OfvJ&Zgw?D@Qx3PWo(-`5ZWF<^x{Ovv_k0!3QFuN3BO*JR93i%dX_=1M);_p+f(Yu=ub6!u2ux?$n zTViMf;O03lw^Rr&*j=}JP zpni!L76*5LkopY{k$H+tWSYB-&Z*dYf!g#R!ClLbOa#44$g{CGRvFTvIgjm$ zyB%Btz}!KJG{G>|+!?Vr7`Y0&UO3$%IbH1e?NQaM<`=a9myaYaXj6mwd_Q`2f{NG2 zX>aPu#jYC9b#w9~cYPbpUU=mJ#9Ooaq%$rqB2crT71!I9o)f_--5}@7$Ok^tKn3Fc z6tlI-+0kfI*~Kb2T#{aACv#ubi>v0nkOyEO4-z?|e;%nc!<2gMI4kYk5h z3`Enn@Ro4|jb}$t3MtQ9_BfK_IT$ByryS64{j|a8vKWHS=yb?l$q@HQ-VzsLC^QjC1hRoc8nm&vIf6kXL|o_LewR_ zXkyk(8FhZ+y=<-5ieHoFSviGW9dTf{k|j{g5XY5Qk0e`!r5~=n=e=bJ9~uks&teH6 zYAdRZ6$c}~B!izg7GS89_8~euCkqIo=|Vc?CBTOk9T#*3=GO+ zkUw4r-kE4+S8QH<_JLYnD^|JV)N9{6b#SE;36Co9X`)E;O;4_R`o@Eozn_0DBdO|9 zgC8ey8#6pb!Y)bXph_TcjnzpEOq9!WG-&nx&^wP$tY|X5!0{jfDrhDWpP_pCVEx?) zOl{2>?5CJMD~C}>V+ohMMF3d1EHel(W0R&n4!~2zN0v(|S_cf;(}Kn#KrV8Pgsn&F zxz*C0@U3x2()x^Vzj_~|R~Z7bZO?k_>Idv`hp)4o zxI88u=us6l1To;E?3i<^T<5~Abp#Uz%{N@@h0Q4QjSh^!C@jxLXR7FTUvj;IIE`R8 zCy3)6OBUg_l&3{TmRfdrR&>G=a8-fOdOT#VpZd^idH9j}a@~iW@ljNNkc_O%(+J#R z1~A#}AU+5q`@&Uj`9zN7w{hws_Eyuq$c(EtGXP2tXQQKan@Z+VkUpjf5WNEJYl}lM#auT6r&jf;LhiUcM*o zmN8uh9Y&Uf`Qk!jya8pB0wT1{Y9{XXbsvlRiAyaK&wp4)pBakPbny}P*Dm`w6-m>8 zn36@j>-K`G>*R-ZN?OW8l+W0AzpHgCUUBQJo zKp%8k|J@w?IR^OqAp1whgc7{>Mzff>X=!H9qC>)crpVDv@CWHDUqXFN?oSUNz9RsU zzd_LYNy*EPnV`r12JvWut8($`1~$W@=DP)9L@Y)S530z&6;+4Y$|-_@GG zJOztx z-A3MV)w;tssuiN{eoGQcqaVrk!M2Ep*hkh|+GZlaRiDfgc3{YWpdv#awcAEyC*lt2 zR@+T7z0HY)xG*su;--ktsB-&Vtdjt(bCvnxDdN{i?{|vUK2AMaR}D1e4M4@{5J?-<0`Z<0?F)$NY@n@dCws+IG9_KE(+I zwiyP$aI!_=uacf2~(A&M@`cBjU)^2S%Ayk0nd!Y6N&bg4; zSbi`+NmRLV_OmMCD;|giq@lWwJs_rnmdY&6}7}p)7X0~BpG^VD0n)8rpo>&*5HOe*2;+B}UQM>)bP5hM*t#2MG zU@Y}X=V37e{=w?&gXVa%LXl3UZGDP`e78#D{P83eP4k}`eg?iWbz}0wi)r}CR=nj` zj6zknw;Z%AD)iQV0|~e={DzpKfBS+T-FHN%3`30|GJC{(F;t!F`U+LpV_m6uI(s!@ zJN=--DC^96qwx1@R|kBhgoSUA_1;!QD|b$A@z+v#@@$3`IHWh(#_=!X09@SQH#)z~ zG2coWpTi#O>dIeQ-9qx*gWH!RO~w+Vph;~P${wTU)icW+l9tOpnzyC|2DhOPd%W}% zPC0zOc0q|VwmjZNJrgMpdnm(^Cn76A{!KIYIFt6R1)^z%(M0|8F|Jmi7sOHxLR&Mz z!n$s*DX~^z{zdQHJ5*O-JOed^<_ToG7PxVZp<+D=?1xgT`%;oAJ)hWSkwZg@BP!Hk zyX0xZM8a)4PI0OZ_{nqHzV8ZBjr~4xmXb|f$>3Gg_&hUQJRNrr0ohOxo8ZUyl5Ym@qxnb?n3^T=f<(dy9~-?(t}iu@*^w?J@GsJ zdCaxktfUKLEFtEH^Y=#zhwga*m!V--P|<3fxi8BL=t=dRZMkZQz@9;L(UNPxTodi2 zK>}6oG>ocBfZN)-Ut7)IMjPhNKQ*=fex0^e(N&v5YHX0(JKrJYt#g5^{RPnKI2Z*I z95BjvaMz?fRVudbR0$((1MKf%-C-$VsVTIiFXc{^QJ;4B5%w5{j zDOZiqBA=m@_rV9a9zzp{qgC2Qcj3LxpGWWLE3RV;*+ZNz9m|3gc7yE%1UN7-bjO7T z-9m1%bJ06snu(y0yp9~fAHpN$>9lR;zm2K`r70Api#J@V0pI~EOeXEY6X2d1M{Bzr z$H^xUI@p{v?yz=z=7c7f1T}(+2N}}IebPlcsVmv_;kV-jkT*V+T?;csKiEu0IIX)L zbPB7%5~30l=`zcg%RDy%e;7=VqBt|>KJ5Fjtv!1n4qv6S62ZYbLsom&(5^^-#?Zwk z)a-9B3ww>oe3AF{C@Ar4UAhD9E;8xS^xZ4QXX34T^qGWLX~hjLwsZG2yYJwE1* zK5Ke{05geH?AEwk#Rp5s1Um!nL*K)%cejg-wBTuO_ciBYnu%>yp|~SX@1K@h+No{O z5O+^L&|Qfx2pW+auA7zd1oZA8QeN^57M#LAe=Jh+-ff8=_@Iro;dcODOvs$2j^0c& z+C;vqd6J7~`MDxW_+UpzyxoyE*m+>$IWsk$pZzYZO}xav?W}wH!8fFrSmqpWE7q=F? zw)Y3KHA{9lT#<$Oz7blwC4GwtzOofIN46_u1KS}%Dvq`@dmg~dVgNy;*uKO91kgI92{Bn;vq zE%(4v7621-egWHz5E(83j=fmGXDr~8Bm@pS_y?Zj!D@-l*T%#wCXPyxFhg7BV~R0u&NQ!1Xo^ zK#w0U8D~Vh^#`ral7g^Ma0+gdi6;;&d@MZdv#!4pW`|(~cP-=oLi}Gyuu21eNGQ&6 zW5s}afWomiYcKv$@0`mol3%L)Ey(Z!)(|rPVMnoc&K;$9v>?9$HlS9fuYMXFP+{7v zE;g!xAJC-G+*{yV9{`+B=$e>X4XlRmWV!9HJwYOnSragkL^FSx5}M{+*t9;a`5u;^ ztg|dK=2hzv0ZzCKOP2cMyAy-AHCDq4DHrEvzb&E16*Of>8^AKOONOKcpZ)RjWBLmz z&1H7q)d;L!8pAgGjG&b0JH&bnNd6sK0=od)9I`lx3TM~#409$+(HMBK9>>E z!C9_m+J6bYu_Q?ip`*|Z*1F)bu5#D3BG?uO<^ZW>j{jP)>Unk?+T0b=jCVb#{2YCC zKlJ5dgiy>YTuV{z)Zzx-aYI00hDUd`vOgX%nxvU1CyekULg8+{l(bj$JL&IvzYq{V zm$(MMwV(%vgeNUZepRNtLxce38k0LZy7amdLTpEsJiv)t+sjD}stdx#o2o@S_jn#P z6oG*8P<+rO>Ari2z2Ix3qb0ejSyagWVQ0_Yt0)JlOaRRR4O;r4noYdJ&4Z2Gip!|H z4qXBiHIs06#-c-fK0*wMmbnHM$Fn>}G@KqRfpFRbv_(lT*HD2mC;@1Mb?=iPkEFL2 z90c+O>To>`=kFst2~jHzd$p@-PjsKQdXzSdotq99Nuv#&)3v%(i{p6_+JL{D$hC)= z9o=eH*tG6Xh&{ItDIm_e6@k0VASK!zDIc-M(Ri_z7P&9I2pLvKsL)r8p%1p2yS_Is zMKp@8Vl9FJP-SvixRwze5;m)!$Hx&KN~u)tH}koj)lmtqcu1aX9x#q@Tx6=b*NAuF zJUm6iUozYs#@Y?AfxrON4%M1B0+xM^Ir2kPX6&$!(GrYXVU>0|KdLE85^!l_!)QTu zV0P}`-eNq4PgSA^Gktj9Sq-%3Wcw5NjHX5xV(pNQzhnK<p-#)5 zdeO$8YJKuCqTAfmreC}TD^x-e>%7&|6o)uqR9dbd{6%Nt_-s4$8H`jXDRO?Ij$v1) zP8;inhRb`7fU!+eZ%57?LBF=Wi1<;wFZxRw&!pBJeE->5D0=F~ZpAoE9`d#YEt zuYi$30JAf0Dw#>ST+D7H@gX5A3VtG`);WUJk`xzwrL$JSs)HRO@KM{2x9Oc#P}L6H zwU~*=POi5{nHmx?o+zSu4}ymxCdtdm_9N6_x6UqO@u-{sa?W6*5kDpM@v&i9lSS?U z+||F$x6-jz_BKRA{B0s@B`uxx*oe=RG}J+r^TnLoBLMvXdYjb;O`b)H1oXTqtc0|` zci-Qx>C;@NME8g!hUhskX`W~t9>qb1QxPQer2N>-oJ~F0WcJ4GJD6DzfzII)*!1_h z8Ygam0GrxykpG?(fhnl`tu}C;`@2*o`1K8p+~Gt-mC;tGDqT8ajM?s&O?-6>y=e6qBR4=2I(24GN<9ee^&LO5-3` zCC?6aoBZ^Q5B&+au(T$oCk;erZuAxB)eH~z5ZeaK&$(ePWdA%`?3`B+@?Yuy6}A-N zuxF`KpBJ;gkNwNodH}Fs+n$R)FBahvhVQUNCtLy~1h0Fb_%P>2xb(+1AUg<5CWCuW z8f-3;0agcW`CL9Plvt6g<@^H*`cV+}EUW}W=E?NSx3ulWw>^W#AjCb1l=?5a-Gnd9 zAG zZ^I;y;SvHrP*h1Ybys?~Tt!$_0{49>?VBkAN$sT>O*-BE7ht^9E_*>|6h}pnS)P4* z`l7>8{=slB83&^YJ8%;#unzsAxei?-eiTOQW!-E}RwCxsFVU%VJ@8QBThT;e#QqPC zzoG>wDTxDPstdUGcvGlsF^a2|o<}VscNZ(a?X6}V5?@@Nweqs_Dms0n!lPHcUAwLK zv+(0dlE`kF%_p$d8}1Mz-K5)?Go5rNKRhX6cIJqj{&k(d6 zjc#q)?fb>rzw6mA=UqbeM1|j6&z>SMWybb2NSF%8Gs-CWg?Hv*B zEggu9(Mg@^yDTM0icwQKSEKJw5r74A5z&Z;6y^2fi#%E6%De*|`4Os{0*tJ8zA-l- zOzS@hYLmiTg*p^C^&05;0>#A+osD*aSLzEOu*@i6Ss$o<;>)uSSeADaX#bXU0Iqe%;IQ*%3=lw?5yAa(MHfh78c^c_&k4{9zBd`54C=lcWH#s!@kf zi`L!wr27^P4m-VqGcT5LVFnkFzJTFXdA5acQ9sU*pN){^>a2bKrI$06B5aQquWziO z+g`i<#x04kw%L-=>m4FV9@!&;Zs13m_Z22^2k}cEtp=Z#+tE5$3;siIjG(6? zTkYGf_uyZF*&O0lIJ#`r=bJ0n(bSt=y^e7RLT+}f%01_tnyxM}!t8SdO8~9X0Ga@m zL;_n~MQ6$>FMTsi%XqB42#8;)*fkgm_YN{ z?l`VqO?zJG`HDm2t&tYz*%H)Eqf&>hVc%J%fhdy{>PUw0#NA21Uw#&#k zIMWIm?q3ITAA=U`1Zju_HwXp~`MUvxy%~EId_A(a+u>QohB#D` zRp)u-{vz*K#^NPCLF6Yle^N z>mO}Ose;fR{IHc8Do`==yVwqf{t&qjh;t;kgBZT`*!1()F}OXQO~29CAL;ZudENFp zsr2;vu>Bu(CX6wvCc;(482vj`d1*#PQ_cwbdr5;BJA?{>SHvUdvY~X>@IQ(ePc?cB zy;?|;`*KgH@|s&5_n9eV`(y1Vm%FwJY~0sI20czHdh2%u>g`6DW56Nor-n1a(%ZNw zZO84VmH6DfIFpt-q!l)H@d{NJ!ylnDJ7U#EiB;Ld3Z&bvqou<)>d}Gf&*Y4wZ3ioC z<{V=P<{nLItpJ9Dk~8`S2q7Kq=NUWW>XBp{FV16@s^HP?R{lh_{A@uZaYXlHjnclb zV{%l%&Q#83(lT1wYGt&UjofKMC#41-ZIF$t;c4$C&dm*Fo9r=xhlwxzZO^y0W@|Kw z^YM=Nin{(P(kLulb`+!~*S*{2?8HcoEYTE&x_upAJ1A4Y)>&Lx`mjgO8(HF8m|BIa~R=U{?{Wk4bw><3Jnmo zTJiYE)KPeEy5m0}Jd6wN&i@g+t*PG+C-FULtXr`bpq*wh=y(%c)y7}>S~IPq|0fdEjMv1XfAmV4t* zWOG6H`KY1gN^2BWqZL-$ohtgOEM(xULWyQJWLac&Ez_aoAAVir@iF$`S3edIpyZEC zBaGyYQFYRC?I^0kg&Gzr;G&`reZ9Qyes=m-ppQN=plwbrFq|)QyrH(?6qsnL)hq4G zTN2Z!I0!7g)uKScnfx>-HJ1to0fAbp`wa{_iUk?7@D{;8uJFEUPbT8gqM^sLA@{6s z4`!)?j#zrA8Y=LPLHpz``eKu z)tmBdE_i}Cw10&J_}))(9qZeSD(=*w7?U<*t=FYJlGEvE{&X@!k(*mFYC`C`u^PL= zP(oOc=Y~Gp$SnOP&v{l@_8MFg9xN1Dkg0WM))#O7yPkb;%vcUs)W`Tv(?$*{>b7@L*B)GY;6e8eoB`JQb&ga?B?9n8YF z)nag;D&0J%5s<7qFAINC_IZsNn*C?$X2Q1luRPy{?#S@I{h8C+x`!JvGnxt)LP$$t4$-GUI0xcHn;xh4~0B6ChdO+`@Zx*rJ!VOK}MMi@M}a-8)S z`orZK9rVwg9`P?V@4CW>#1i7O<(wlr9@I@l@N)~Fbceb)j@!%2Q)Al_odxlx8f1;<+wi{>S5{tW>K<0jV@a`KF%q$IIv+MYFSbx>uiS-;ETEOu#%X z$mzP?_i^s5+DFCh=9Ii}C#7k`iI)WGB)#$0DW}H|XAHS^PTnQKqzVByj)zFr=ANU4 z3h`!QxzCYgi~fRq25dcC z-93iZi$WXHv{ej7i!oq3foZc-&;vd39ND)C9)y?r%5>@sx^Pb=WnOu7>;iv4qW%i1 zeB)azriY(fn%0$)uRpP}N6gIJN@*u*zH_jgBRdr@MU5{(AWhMYup%K>%KP1IyS(ek zOc$&(6WJ)v-i|O4i1C%;OzF!O!_({cQcPa* zJWFOBj!+`Q5#)`#7CQZT4pdGxL~%XGmcLwp6S$t<|&&ew5e_9owBPiu{2_6SWM)HYFsLz;tUH{ks??n91*L#$tK+O z(yTUw$%VF9M0Zzne>ABY6vZ0U>LUMcA|0KvbglxP`H9RI$CC$-{t97T)J^TV69HKa zD)7!qPcZq1+WJVr`XnrV3bAB|&ircSCMkkn=E9-1b&j zG50r*3ujSY8jQzj81$0PSV=HExRGhm8=Kjn@lVy@>>2IY#f#Y%v3BRHt8BCR@l#VVEJbwA3ws)$08WzpGZKWVgG%S+51B$m-dT$%PTAI+~*NusVIwgXU zm17#^EBoa=@S$w!gX7HCT!Ca71}&Rt3rRHmp54l`KeFRFB70V7?vH0og4QB3>}E@z z44nXHkkkG4tuiVmGKS3dG>F4<@O5=>Z)k8=a2Vc!wVT?4(QlYM`=s!g_#Nryjogd= zITKIk1$~)ZxsG3EwXX0JZBeA&oXdg)4fcLvGf4$|Sl_gXWlQWfD5R|9vP^iSI5dS@ zjtmEHRe^cGH3nzUMKSaWyUtk2$$}i@F*Kz_9((Vr@xu#pL*ig(2L79M&o^Pe);+JA zdr__0qh8{G7obKTxKdiXVo4dn&%SdZtE6vrLkkJ~+~-(wT3HyoF~kDq)rB}SI#fIc z^OMoCeh-iU;*FZpyL89W*`jwWA>jPmy;7`BRm?SkO z5@hmXZWdBkOjcA3xs4hj%k4Uw5^Iv1IqXzktz5o92z1!I7)G9Ou~`qXp5j^a?*Ck( ztNke(tWE8nTkT$C*Y}dZuP3hPOp*Wx515ZMjw3TxlPyvTrmC%JLs#Jt4?T^Ehf3dG z!>;E(?4d(zx4(VBNu8OzXsSP!-|;;6!=(Rm-kbWAIwOi&YA$UY;t_+W8`RH?ckq;D zwSCKd3?dU)D>d)z?MJP}Iy+>3SMZ^T$O_x&$Gc5@wujZ#n^k3G;;qG0U6_k>q)FH3 zj_gZY$`qB><+<{ws8ObvD0(H776*!g=-qqGo~}#Etb6=xHq`QVy}amUHFXL*pV%hi6-4anfcs72GRDW91BTgHr#)L9S)Zn&%`>uVWg=*G+5J`W6s2SF z&}`PiL>2xDv3Q~nl${<+FZHAvFpGMyz3=tV3&i?Q>CLp={%%K1U%ObIoXr$IojAqJ@I9m5$yi~sUbxgoMCv`#0S<8Ufao#Xw{u%C)S1wr!dM07-Yzw# zIkEpVl3|o`xs+0wYFVV_q5QCybsgea8kock(-VvyR4qNsYId zDK@PH4*${B{Z28$it!}j3C|t%Va*o`~#zk@1OMIdUE%q-pC1f|4rG$G4@JUTXq)K^M3j2`!-!RQO%x@M!c9j z_bVkGZ!dX^tNl>#x|Vk^A*)I*mYhjsonq+)kF_-Kasan4vJULnkEg{s32b}`>SRp6 zw!oEhG#vKGZ1zI0p7x}s(VL_OeV@+3QNCH#a*MOm=mE#l{k0b$ZOLEPvpjMavOO6j zOde8xMYvt^#{ndG0%;pEi?qe}`_ez@SZIm)jJ{_8P3^tnl9q+07}5~`RzJ~DL?3

    %SkhHg4#6mSLBDeM<}LQ={4b#m)41U+lgT5^R5R-oNb)@t<2q zV7Hq1&#fb{EdDQcuJ{-`>wdp6Zdc2#qmIlWu)nCL&E&|;WI%HBwRHa*8<5+RuqXjv zuMho|IO2;2kH94DQlPf>+wpFqWh~r2@q@oe*U9!YaDn^m8LYNXj z@Wx*&`mM%o@`<=A&SL4OMOBfz&B=WlsH&`$jn(uiWhbF43VZ=8F4IfTDEj0{>I~}3 zQ}JZ_(!h6%y2lh3URo@gFSZsVTzB>*>IO{iuNB;tP3ca%OqixsP?%fM+EJ3hF zr?{T6g>G?VZ8(xObvjV9+X$N6VrE7DbtZ;<!{G zy0cr_im}ZvU6f^}7esa;x5}zQ_8p#+s#zM z;}&IEq`e)N`tFA{H*Zds*C z@T#?|!1_l)gL><|{$tp7b4wtEm~i!FC-wK1GVROO6Pc%0SV4NiF)H2t6y})u{O{ux z0{V5!n+?MiT59GhEhU@~O#(WICL7`4dPU-wqq@Qf1WpHr{Iu^!ctU-vk6mXj~|(lQOs?NFw2b1g7y_irK{s{eGc95 zb*05z(hx+!%Sc24#Y**-zBB=-gblP3&+#TrLV4QgaJG!>9JkT9HIy_AdDyD_T_K$G z8e7&zzp2qzGSorJ{RqK6zV=tb&d{)3#6lc742~j$!I{L7f_vi}AS*>^<)J&@ozteG zw?E%yIZi3+6ED9glc=%XV_Dy@9C_9uxbLypN(Zs?Vy`w{A4r$2=z$ccsESe2{LLwZ z-yHN{E~3#+E^s0Lr2FT7fdCh{%jX-9c1uObltWaD>|=`E%?Car+q02~>7>__p~C4= zp+c9IEk>8h`u->f;VR#FLTh?|8BXhoRLe@hiLxAHV~X*I`Rz}r zj<5PzXEv2?uCs9BJQJ7tAT@mP-%XwbP_&`6Ub&1>H$0yT7oYHLx) zK0R!o1~>=~94Ja;&Nf2MvRm_aethyIN|S2pXm>j5=43X(OBXZ9c}AwAGTtqSf;ZrJ)xDD>?d1WADLX*Kf)M7cPsDf zET_RRODW|Ja0{KUgveuaM!{*Q%oGO)LNdZH=y+J}v|f zF+?4;CzPrbk;4F8JdIOHl<=wd?%?RQC~M1vQJwz7CKq!9A?`0+Qnm~2JBseb^3!>(>1Ys?x_BL$VyPYOa)N&)~ zBsxXsj6ptSDPY-dft>!YroZNtjjq+{Kc>4}^|69sz0_-W?bEQL=em1wBK>nQV~zcJ z2C8b0Zt{LTpUBRZu7U+L@#(&-HEQ~O%c5JI0_TeguDVD=FP(nJ9#`p! zn3t&s#vX_8iPsHIUZIkX%{S9uH8wi8=;F(bH-=;41-tFyOT)od^cy{G1p63m=lmWA z&23%Z#*aGAwstcrbmQ8Mw>L%vTJWnZ;5dX(=cvfw8XLNrdU&tfaQu{*?^WgzF*nPR zDMoR=wTblBOYFe*2hsL@ys7cV&*dLK2Q5xi#e)~Gz<`@b01Aa55IDfa|BG|r0_DHa z|BvSY4&lGu{~yl*2;RTl{~yn>u>VQ_e|C;IYixob3keG^#^P{;g9t!gT1Bel;gc8t E3+~rfvj6}9 literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-ft-1.png b/docs/reference/figures/README-ft-1.png new file mode 100644 index 0000000000000000000000000000000000000000..3b3d6bbe2e7600c6d7b8e2b5e2dafe6b5f59765f GIT binary patch literal 24118 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 literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-ps-1.png b/docs/reference/figures/README-ps-1.png new file mode 100644 index 0000000000000000000000000000000000000000..f1337915fd160a664fe734a9a19224957625884c GIT binary patch literal 60724 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 YjJA087M)Q~#lNbJ4b1c_b?=A&6VKeL;{X5v literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-sc-1.png b/docs/reference/figures/README-sc-1.png new file mode 100644 index 0000000000000000000000000000000000000000..84d5fa309839c0e09c037b0a648b06f836cd3d63 GIT binary patch literal 26647 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 literal 0 HcmV?d00001 diff --git a/docs/reference/figures/README-sp-1.png b/docs/reference/figures/README-sp-1.png new file mode 100644 index 0000000000000000000000000000000000000000..de492701930e000c75ae831dd980b63b71548d5c GIT binary patch literal 17581 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 literal 0 HcmV?d00001 diff --git a/docs/reference/flush_ticks.html b/docs/reference/flush_ticks.html index 7c64bc5..af1b906 100644 --- a/docs/reference/flush_ticks.html +++ b/docs/reference/flush_ticks.html @@ -1,64 +1,18 @@ - - - - - - - -Makes axis text labels flush on the ends — flush_ticks • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - -Makes axis text labels flush on the ends — flush_ticks • hrbrthemes - - - - - - - - - - - - + + -

    -
    - -
    -
    +

    Makes axis text labels flush on the ends

    - Source: R/flush-ticks.R + Source: R/flush-ticks.R
    - -

    A covenience function intended for basic, fixed-scale plots only (i.e. does not handle -free scales in facets).
    -
    +

    A convenience function intended for basic, fixed-scale plots only (i.e. does not handle +free scales in facets).

    You need to pass in a ggplot2 object to this function. It can't be +'d in a chain of geoms, coords, scales, themes, etc. It also builds the plot (but does not display -it) so if the plt takes a while (i.e. has lots of data or transforms) this will also +it) so if the plot takes a while (i.e. has lots of data or transforms) this will also take a while.

    -
    - 
    flush_ticks(gg, flush = "XY", plot = TRUE, cat = TRUE)
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - -
    gg

    ggplot2 plot object

    flush

    either "X" or "Y" or "XY" to flush individual or both axes. Default: both.

    plot

    if FALSE then the ggplot object will be returned invisibly

    cat

    if TRUE then display theme() statements and copy them to the clipboard

    - -

    Value

    - -

    ggplot2 object with theme() elements added

    - -

    Note

    +
    + 
    flush_ticks(gg, flush = "XY", plot = TRUE, cat = TRUE)
    +
    +
    +

    Arguments

    +
    gg
    +

    ggplot2 plot object

    +
    flush
    +

    either "X" or "Y" or "XY" to flush individual or both axes. Default: both.

    +
    plot
    +

    if FALSE then the ggplot object will be returned invisibly

    +
    cat
    +

    if TRUE then display theme() statements and copy them to the clipboard

    +
    +
    +

    Value

    +

    ggplot2 object with theme() elements added

    +
    +
    +

    Note

    Intended for basic, fixed-scale plots only (i.e. does not handle free scales in facets).

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/ft_cols.html b/docs/reference/ft_cols.html index c91b5e3..3536b4d 100644 --- a/docs/reference/ft_cols.html +++ b/docs/reference/ft_cols.html @@ -1,58 +1,12 @@ - - - - - - - -FT color palette — ft_cols • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -FT color palette — ft_cols • hrbrthemes - - - + + -
    -
    - -
    -
    +

    FT color palette

    - Source: R/ft.R + Source: R/ft.R
    -

    FT color palette

    -
    - 
    ft_cols
+    
    
+    
    ft_cols
 
-ft_text_col
    
-        
-    
    Format
    
+ft_text_col
    +
    +
    +

    Format

    An object of class list of length 9.

    - -

    Note

    - -

    don't forget you can use scales::alpha() with these colors

    - - -
    - +
    +

    Note

    +

    don't forget you can use scales::alpha() with these colors

    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/ft_geom_defaults.html b/docs/reference/ft_geom_defaults.html index 2704782..e27bff2 100644 --- a/docs/reference/ft_geom_defaults.html +++ b/docs/reference/ft_geom_defaults.html @@ -1,58 +1,12 @@ - - - - - - - -Change geom defaults from black to custom lights for the FT theme — ft_geom_defaults • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Change geom defaults from black to custom lights for the FT theme — ft_geom_defaults • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Change geom defaults from black to custom lights for the FT theme

    - Source: R/ft.R + Source: R/ft.R
    -

    Change geom defaults from black to custom lights for the FT theme

    -
    - 
    ft_geom_defaults()
    - +
    + 
    ft_geom_defaults()
    +
    -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/ft_pal-1.png b/docs/reference/ft_pal-1.png index 6e30ea030639d13753cafbed6825a808925a0701..c75c28c559985e4008cdce831da65271593ff31d 100644 GIT binary patch literal 35458 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 diff --git a/docs/reference/ft_pal.html b/docs/reference/ft_pal.html index 6a8d040..f21a677 100644 --- a/docs/reference/ft_pal.html +++ b/docs/reference/ft_pal.html @@ -1,58 +1,12 @@ - - - - - - - -A bright qualitative color palette — ft_pal • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A bright qualitative color palette — ft_pal • hrbrthemes - - - + + -
    -
    - -
    -
    +

    A bright qualitative color palette

    - Source: R/ft.R + Source: R/ft.R
    -

    A bright qualitative color palette

    -
    - 
    ft_pal()
    - +
    + 
    ft_pal()
    +
    -

    Examples

    - 
    library(scales)
-scales::show_col(ft_pal()(8))
    -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/gg_check-1.png b/docs/reference/gg_check-1.png index 5ffc45bd289c060c824c0bcfe08ee9335932c050..7b668e8a2d786fff5909b060b99c7b2bc10311cd 100644 GIT binary patch literal 43790 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 literal 67262 zcmeFZXCRzw*ETFdB9TI(BoQTS(TN^i3KD`u8Jz^tjp&9^QwSL%g6Ogt!YI+ZA<;sR zsL^{FozV^6^Rn;z{_Y)~@BQ)qc>e4^+4i*Sy3TW*YaQ!Y$6Bu+swkX2edRO}5z*QE z_wK3@5s|tP5gj)sI{{wli}<)iL_~7g^3I)y)^`-{*xA@Qs6TsR@>Jm|{HcSbiJHP~ zBBGlpl%|2jRZS}CGDmZkKU&mngkCy*k~zzIHVh{8F~8J%U_b;OabKjDdD?V+q2

    Q*j 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 - - - - - - -Spell check ggplot2 plot labels — gg_check • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Spell check ggplot2 plot labels — gg_check • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Spell check ggplot2 plot labels

    - Source: R/check.r + Source: R/check.r
    -

    Due to the way ggplot2 objects are created, this has to be used in a standalone context.

    -
    - 
    gg_check(gg, dict, ignore)
    - -

    Arguments

    - - - - - - - - - - - - - - -
    gg

    ggplot2 object

    dict

    a dictionary object or string which can be passed to hunspell::dictionary. -Defaults to hunspell::dictionary("en_US")

    ignore

    character vector with additional approved words added to the dictionary. -Defaults to hunspell::en_stats

    - -

    Value

    +
    + 
    gg_check(gg, dict, ignore)
    +
    +
    +

    Arguments

    +
    gg
    +

    ggplot2 object

    +
    dict
    +

    a dictionary object or string which can be passed to hunspell::dictionary. +Defaults to hunspell::dictionary("en_US")

    +
    ignore
    +

    character vector with additional approved words added to the dictionary. +Defaults to hunspell::en_stats

    +
    +
    +

    Value

    the object that was passed in

    - -

    Details

    - +
    +
    +

    Details

    Current functionality only looks for misspelled words in the labels of ggplot2 objects. When misspelled words are found, a message is printed with the words and the label that they are in. No messages will be printed if there are no misspelled words.

    - - -

    Examples

    - 
    library(ggplot2)
-
-df <- data.frame(x=c(20, 25, 30), y=c(4, 4, 4), txt=c("One", "Two", "Three"))
-
-# not piping
-ggplot(mtcars, aes(mpg, wt)) +
-  geom_point() +
-  labs(x="This is some txt", y="This is more text",
-       title="Thisy is a titlle",
-       subtitle="This is a subtitley",
-       caption="This is a captien") -> gg
-
-gg_check(gg)
    #> Possible misspelled words in [title]: (Thisy, titlle)
    #> Possible misspelled words in [subtitle]: (subtitley)
    #> Possible misspelled words in [caption]: (captien)
    -
    - +
    +

    Examples

    + 
    library(ggplot2)
+
+df <- data.frame(x=c(20, 25, 30), y=c(4, 4, 4), txt=c("One", "Two", "Three"))
+
+# not piping
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  labs(x="This is some txt", y="This is more text",
+       title="Thisy is a titlle",
+       subtitle="This is a subtitley",
+       caption="This is a captien") -> gg
+
+gg_check(gg)
+#> Possible misspelled words in [title]: (Thisy, titlle)
+#> Possible misspelled words in [subtitle]: (subtitley)
+#> Possible misspelled words in [caption]: (captien)
+
+
    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/hrbrthemes-exports.html b/docs/reference/hrbrthemes-exports.html index 422f332..07a929c 100644 --- a/docs/reference/hrbrthemes-exports.html +++ b/docs/reference/hrbrthemes-exports.html @@ -1,60 +1,14 @@ - - - - - - - -hrbrthemes exported operators — hrbrthemes-exports • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - -hrbrthemes exported operators — hrbrthemes-exports • hrbrthemes - - - - - - - - - - - - + + -
    -
    - -
    -
    +

    hrbrthemes exported operators

    - Source: R/hrbrthemes-package.R + Source: R/hrbrthemes-package.R
    -

    The following functions are imported and then re-exported from the hrbrthemes package to enable use of the magrittr pipe operator with no additional library calls

    -
    - -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/hrbrthemes.html b/docs/reference/hrbrthemes.html index 11571b6..736f000 100644 --- a/docs/reference/hrbrthemes.html +++ b/docs/reference/hrbrthemes.html @@ -1,59 +1,13 @@ - - - - - - - -Additional Themes and Theme Components for 'ggplot2' — hrbrthemes • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Additional Themes and Theme Components for 'ggplot2' — hrbrthemes • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Additional Themes and Theme Components for 'ggplot2'

    - Source: R/hrbrthemes-package.R + Source: R/hrbrthemes-package.R
    -

    A compilation of extra themes and theme components for 'ggplot2' with an emphasis on typography.

    -
    - -

    Details

    +
    +

    Details

    The core theme: theme_ipsum ("ipsum" is Latin for "precise") uses Arial Narrow which should be installed on practically any modern system, so it's "free"-ish. This font is condensed, has solid default kerning pairs and geometric numbers. @@ -138,37 +75,42 @@

    Details Narrow (the one on most systems, anyway) does not have said diversity but this quality is not (IMO) a "must have".

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    - - -

    - + +

    Author

    Bob Rudis (bob@rud.is)

    +
    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/import_econ_sans.html b/docs/reference/import_econ_sans.html new file mode 100644 index 0000000..01721e9 --- /dev/null +++ b/docs/reference/import_econ_sans.html @@ -0,0 +1,107 @@ + +Import Roboto Condensed font for use in charts — import_econ_sans • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Import Roboto Condensed font for use in charts

    + Source: R/econ-sans.R + +
    + +
    +

    Roboto Condensed is a trademark of Google.

    +
    + +
    + 
    import_econ_sans()
    +
    + +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Note

    +

    This will take care of ensuring PDF/PostScript usage. The location of the +font directory is displayed after the base import is complete. It is highly +recommended that you install them on your system the same way you would any +other font you wish to use in other programs.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/import_goldman_sans.html b/docs/reference/import_goldman_sans.html new file mode 100644 index 0000000..ccb9665 --- /dev/null +++ b/docs/reference/import_goldman_sans.html @@ -0,0 +1,109 @@ + +Import Goldman Sans font for use in charts — import_goldman_sans • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Import Goldman Sans font for use in charts

    + Source: R/goldmansans.R + +
    + +
    +

    Goldman Sans is a trademark of Goldman Sachs and distributed under the +Goldman Sachs Restricted Font License.

    +
    + +
    + 
    import_goldman_sans()
    +
    + +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Note

    +

    This will take care of ensuring PDF/PostScript usage. The location of the +font directory is displayed after the base import is complete. It is highly +recommended that you install them on your system the same way you would any +other font you wish to use in other programs.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/import_inter.html b/docs/reference/import_inter.html new file mode 100644 index 0000000..97e93c5 --- /dev/null +++ b/docs/reference/import_inter.html @@ -0,0 +1,109 @@ + +Import Inter font for use in charts — import_inter • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Import Inter font for use in charts

    + Source: R/inter.R + +
    + +
    +

    Inter is Copyright (c) 2016-2020 The Inter Project Authors +(https://rsms.me/inter/).

    +
    + +
    + 
    import_inter()
    +
    + +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Note

    +

    This will take care of ensuring PDF/PostScript usage. The location of the +font directory is displayed after the base import is complete. It is highly +recommended that you install them on your system the same way you would any +other font you wish to use in other programs.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/import_plex_sans.html b/docs/reference/import_plex_sans.html index 9be007c..c91c740 100644 --- a/docs/reference/import_plex_sans.html +++ b/docs/reference/import_plex_sans.html @@ -1,58 +1,12 @@ - - - - - - - -Import IBM Plex Sans font for use in charts — import_plex_sans • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Import IBM Plex Sans font for use in charts — import_plex_sans • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Import IBM Plex Sans font for use in charts

    - Source: R/plexsans.R + Source: R/plexsans.R
    -

    IBM Plex Sans is a trademark of IBM and distributed under the SIL Open Font License, Version 1.1.

    -
    - 
    import_plex_sans()
    - -

    Details

    +
    + 
    import_plex_sans()
    +
    +
    +

    Details

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    - -

    Note

    - +
    +
    +

    Note

    This will take care of ensuring PDF/PostScript usage. The location of the font directory is displayed after the base import is complete. It is highly recommended that you install them on your system the same way you would any other font you wish to use in other programs.

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/import_public_sans.html b/docs/reference/import_public_sans.html new file mode 100644 index 0000000..a889e54 --- /dev/null +++ b/docs/reference/import_public_sans.html @@ -0,0 +1,109 @@ + +Import Public Sans font for use in charts — import_public_sans • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Import Public Sans font for use in charts

    + Source: R/public-sans.R + +
    + +
    +

    Public Sans is Copyright 2015 Impallari Type and licensed under the +SIL Open Font License, Version 1.1

    +
    + +
    + 
    import_public_sans()
    +
    + +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Note

    +

    This will take care of ensuring PDF/PostScript usage. The location of the +font directory is displayed after the base import is complete. It is highly +recommended that you install them on your system the same way you would any +other font you wish to use in other programs.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/import_roboto_condensed.html b/docs/reference/import_roboto_condensed.html index f73429b..e58bee4 100644 --- a/docs/reference/import_roboto_condensed.html +++ b/docs/reference/import_roboto_condensed.html @@ -1,58 +1,12 @@ - - - - - - - -Import Roboto Condensed font for use in charts — import_roboto_condensed • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Import Roboto Condensed font for use in charts — import_roboto_condensed • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Import Roboto Condensed font for use in charts

    - Source: R/roboto-condensed.r + Source: R/roboto-condensed.r
    -

    Roboto Condensed is a trademark of Google.

    -
    - 
    import_roboto_condensed()
    - -

    Details

    +
    + 
    import_roboto_condensed()
    +
    +
    +

    Details

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    - -

    Note

    - +
    +
    +

    Note

    This will take care of ensuring PDF/PostScript usage. The location of the font directory is displayed after the base import is complete. It is highly recommended that you install them on your system the same way you would any other font you wish to use in other programs.

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/import_tinyhand.html b/docs/reference/import_tinyhand.html new file mode 100644 index 0000000..16eff86 --- /dev/null +++ b/docs/reference/import_tinyhand.html @@ -0,0 +1,107 @@ + +Import Titillium Web font for use in charts — import_tinyhand • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Import Titillium Web font for use in charts

    + Source: R/tinyhand.R + +
    + +
    +

    Titillium Web is a trademark of Google.

    +
    + +
    + 
    import_tinyhand()
    +
    + +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Note

    +

    This will take care of ensuring PDF/PostScript usage. The location of the +font directory is displayed after the base import is complete. It is highly +recommended that you install them on your system the same way you would any +other font you wish to use in other programs.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/import_titillium_web.html b/docs/reference/import_titillium_web.html index 505c414..1c8df81 100644 --- a/docs/reference/import_titillium_web.html +++ b/docs/reference/import_titillium_web.html @@ -1,58 +1,12 @@ - - - - - - - -Import Titillium Web font for use in charts — import_titillium_web • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Import Titillium Web font for use in charts — import_titillium_web • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Import Titillium Web font for use in charts

    - Source: R/titillium-web.R + Source: R/titillium-web.R
    -

    Titillium Web is a trademark of Google.

    -
    - 
    import_titillium_web()
    - -

    Details

    +
    + 
    import_titillium_web()
    +
    +
    +

    Details

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    - -

    Note

    - +
    +
    +

    Note

    This will take care of ensuring PDF/PostScript usage. The location of the font directory is displayed after the base import is complete. It is highly recommended that you install them on your system the same way you would any other font you wish to use in other programs.

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/index.html b/docs/reference/index.html index 1833a7e..afd8be6 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -1,55 +1,12 @@ - - - - - - - -Function reference • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Function reference • hrbrthemes + + - - - -
    -
    - -
    -
    +

    Reference

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

    All functions

    + - - - - - - - + + + + + + - - - + + - - - + + - - - - - - - - - - - - - - - - - - - - - + + + + + + - - - + + - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - + - - - + + + + + + - - - - + + + - - - - + - - - - + + + - - -
    +

    All functions

    +

    font_an

    Arial Narrow font name R variable aliases

    +
    +

    font_es font_es_bold font_es_light

    +

    Econ Sans Condensed font name R variable aliases

    +

    font_gs

    +

    Goldman Sans font name R variable aliases

    +

    font_inter_thin font_inter_thin_italic font_inter_medium font_inter_medium_italic font_inter_semibold font_inter_bold font_inter_italic

    +

    Inter font name R variable aliases

    font_ps font_ps_light

    PlexSans font name R variable aliases

    +
    +

    font_pub font_pub_bold font_pub_light font_pub_thin

    +

    Public Sans font name R variable aliases

    font_rc font_rc_light

    Roboto Condensed font name R variable aliases

    +
    +

    font_th

    +

    TinyHand Web font name R variable aliases

    font_tw font_tw_bold font_tw_light

    Titillium Web font name R variable aliases

    +

    flush_ticks()

    Makes axis text labels flush on the ends

    +

    ft_cols ft_text_col

    FT color palette

    +

    ft_geom_defaults()

    Change geom defaults from black to custom lights for the FT theme

    +

    ft_pal()

    A bright qualitative color palette

    +

    gg_check()

    Spell check ggplot2 plot labels

    +

    hrbrthemes-exports

    hrbrthemes exported operators

    +
    +

    import_econ_sans()

    +

    Import Roboto Condensed font for use in charts

    +

    import_goldman_sans()

    +

    Import Goldman Sans font for use in charts

    +

    import_inter()

    +

    Import Inter font for use in charts

    import_plex_sans()

    Import IBM Plex Sans font for use in charts

    +
    +

    import_public_sans()

    +

    Import Public Sans font for use in charts

    import_roboto_condensed()

    Import Roboto Condensed font for use in charts

    +
    +

    import_tinyhand()

    +

    Import Titillium Web font for use in charts

    import_titillium_web()

    Import Titillium Web font for use in charts

    +

    ipsum()

    ipsum R markdown template

    +

    ipsum_pal()

    A muted, qualitative color palette

    +

    ipsum_pdf()

    ipsum R markdown template for PDF output

    +

    modern_geom_defaults()

    Change geom defaults from black to white for the modern theme

    +

    scale_colour_ft() scale_color_ft() scale_fill_ft()

    Discrete color & fill scales based on the FT palette

    +

    scale_colour_ipsum() scale_color_ipsum() scale_fill_ipsum()

    Discrete color & fill scales based on the ipsum palette

    +

    scale_x_percent() scale_y_percent() scale_x_comma() scale_y_comma()

    X & Y scales with opinionated pre-sets for percent & comma label formats

    +

    X & Y scales with opinionated presets for percent & comma label formats

    theme_ipsum()

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    +
    +

    theme_ipsum_es()

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    +

    theme_ipsum_gs()

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    +

    theme_ipsum_inter()

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    theme_ipsum_ps()

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    +

    theme_ipsum_pub()

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    theme_ft_rc() theme_modern_rc() theme_ipsum_rc()

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    theme_ipsum_tw()

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy

    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    +

    theme_tinyhand()

    +

    Something you should never use.

    update_geom_font_defaults()

    Update matching font defaults for text geoms

    - +
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/ipsum.html b/docs/reference/ipsum.html index 40ab056..6c4e900 100644 --- a/docs/reference/ipsum.html +++ b/docs/reference/ipsum.html @@ -1,58 +1,12 @@ - - - - - - - -ipsum R markdown template — ipsum • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -ipsum R markdown template — ipsum • hrbrthemes - - - + + -
    -
    - -
    -
    +

    ipsum R markdown template

    - Source: R/ipsum.r + Source: R/ipsum.r
    -

    Template for creating an R markdown document with an emphasis on typography

    -
    - 
    ipsum(number_sections = FALSE, fig_width = 7, fig_height = 5,
-  fig_retina = if (!fig_caption) 2, fig_caption = FALSE, dev = "png",
-  smart = TRUE, self_contained = TRUE, highlight = "default",
-  mathjax = "default", extra_dependencies = NULL, css = NULL,
-  includes = NULL, keep_md = FALSE, lib_dir = NULL,
-  md_extensions = NULL, pandoc_args = NULL, toc = FALSE,
-  toc_depth = 2, ...)
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    number_sections

    TRUE to number section headings

    fig_width

    Default width (in inches) for figures

    fig_height

    Default height (in inches) for figures

    fig_retina

    Scaling to perform for retina displays (defaults to 2, which +

    + 
    ipsum(
+  number_sections = FALSE,
+  fig_width = 7,
+  fig_height = 5,
+  fig_retina = if (!fig_caption) 2,
+  fig_caption = FALSE,
+  dev = "png",
+  smart = TRUE,
+  self_contained = TRUE,
+  highlight = "default",
+  mathjax = "default",
+  extra_dependencies = NULL,
+  css = NULL,
+  includes = NULL,
+  keep_md = FALSE,
+  lib_dir = NULL,
+  md_extensions = NULL,
+  pandoc_args = NULL,
+  toc = FALSE,
+  toc_depth = 2,
+  ...
+)
    +
    + +
    +

    Arguments

    +
    number_sections
    +

    TRUE to number section headings

    +
    fig_width
    +

    Default width (in inches) for figures

    +
    fig_height
    +

    Default height (in inches) for figures

    +
    fig_retina
    +

    Scaling to perform for retina displays (defaults to 2, which currently works for all widely used retina displays). Set to NULL to prevent retina scaling. Note that this will always be NULL when keep_md is specified (this is because fig_retina relies on -outputting HTML directly into the markdown document).

    fig_caption

    TRUE to render figures with captions

    dev

    Graphics device to use for figure output (defaults to png)

    smart

    Produce typographically correct output, converting straight -quotes to curly quotes, --- to em-dashes, -- to en-dashes, and ... to -ellipses.

    self_contained

    Produce a standalone HTML file with no external +outputting HTML directly into the markdown document).

    +
    fig_caption
    +

    TRUE to render figures with captions

    +
    dev
    +

    Graphics device to use for figure output (defaults to png)

    +
    smart
    +

    Deprecated

    +
    self_contained
    +

    Produce a standalone HTML file with no external dependencies, using data: URIs to incorporate the contents of linked scripts, stylesheets, images, and videos. Note that even for self contained documents MathJax is still loaded externally (this is necessary because of -its size).

    highlight

    Syntax highlighting style. Supported styles include +its size).

    +
    highlight
    +

    Syntax highlighting style. Supported styles include "default", "tango", "pygments", "kate", "monochrome", "espresso", "zenburn", -"haddock", and "textmate". Pass NULL to prevent syntax highlighting.

    mathjax

    Include mathjax. The "default" option uses an https URL from a +"haddock", and "textmate". Pass NULL to prevent syntax highlighting.

    +
    mathjax
    +

    Include mathjax. The "default" option uses an https URL from a MathJax CDN. The "local" option uses a local version of MathJax (which is copied into the output directory). You can pass an alternate URL or pass -NULL to exclude MathJax entirely.

    extra_dependencies, ...

    Additional function arguments to pass to the -base R Markdown HTML output formatter

    css

    One or more css files to include

    includes

    Named list of additional content to include within the -document (typically created using the includes function).

    keep_md

    Keep the markdown file generated by knitting.

    lib_dir

    Directory to copy dependent HTML libraries (e.g. jquery, +NULL to exclude MathJax entirely.

    +
    extra_dependencies, ...
    +

    Additional function arguments to pass to the +base R Markdown HTML output formatter

    +
    css
    +

    CSS and/or Sass files to include. Files with an extension of .sass +or .scss are compiled to CSS via sass::sass(). Also, if theme is a +bslib::bs_theme() object, Sass code may reference the relevant Bootstrap +Sass variables, functions, mixins, etc.

    +
    includes
    +

    Named list of additional content to include within the +document (typically created using the includes function).

    +
    keep_md
    +

    Keep the markdown file generated by knitting.

    +
    lib_dir
    +

    Directory to copy dependent HTML libraries (e.g. jquery, bootstrap, etc.) into. By default this will be the name of the document with -_files appended to it.

    md_extensions

    Markdown extensions to be added or removed from the -default definition or R Markdown. See the rmarkdown_format for -additional details.

    pandoc_args

    Additional command line options to pass to pandoc

    toc, toc_depth

    TOC params

    - - -
    -
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/ipsum_pal-1.png b/docs/reference/ipsum_pal-1.png index f52ab753bd70147da23ff4f1b2e4d92cc835e1c3..c7d143017bd67c994405df9f57dbd681bfbe304f 100644 GIT binary patch literal 40708 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 - - - - - - -A muted, qualitative color palette — ipsum_pal • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A muted, qualitative color palette — ipsum_pal • hrbrthemes - - - + + -
    -
    - -
    -
    +

    A muted, qualitative color palette

    - Source: R/color.r + Source: R/color.r
    -

    A muted, qualitative color palette

    -
    - 
    ipsum_pal()
    - +
    + 
    ipsum_pal()
    +
    -

    Examples

    - 
    library(scales)
-scales::show_col(ipsum_pal()(9))
    -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/ipsum_pdf.html b/docs/reference/ipsum_pdf.html index 1ff7927..a5bab4e 100644 --- a/docs/reference/ipsum_pdf.html +++ b/docs/reference/ipsum_pdf.html @@ -1,58 +1,12 @@ - - - - - - - -ipsum R markdown template for PDF output — ipsum_pdf • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -ipsum R markdown template for PDF output — ipsum_pdf • hrbrthemes - - - + + -
    -
    - -
    -
    +

    ipsum R markdown template for PDF output

    - Source: R/ipsum-pdf.R + Source: R/ipsum-pdf.R
    -

    Template for creating an R markdown documents with an emphasis on typography

    -
    - 
    ipsum_pdf(...)
    - -

    Arguments

    - - - - - - -
    ...

    Arguments to rmarkdown::pdf_document

    - -

    Value

    - -

    R Markdown output format to pass to render

    - +
    + 
    ipsum_pdf(...)
    +
    -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/modern_geom_defaults.html b/docs/reference/modern_geom_defaults.html index b6a2384..620ee28 100644 --- a/docs/reference/modern_geom_defaults.html +++ b/docs/reference/modern_geom_defaults.html @@ -1,58 +1,12 @@ - - - - - - - -Change geom defaults from black to white for the modern theme — modern_geom_defaults • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Change geom defaults from black to white for the modern theme — modern_geom_defaults • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Change geom defaults from black to white for the modern theme

    - Source: R/modern.r + Source: R/modern.r
    -

    Change geom defaults from black to white for the modern theme

    -
    - 
    modern_geom_defaults()
    - +
    + 
    modern_geom_defaults()
    +
    -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/scale_ft.html b/docs/reference/scale_ft.html index 985bde5..7e34326 100644 --- a/docs/reference/scale_ft.html +++ b/docs/reference/scale_ft.html @@ -1,58 +1,12 @@ - - - - - - - -Discrete color & fill scales based on the FT palette — scale_colour_ft • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Discrete color & fill scales based on the FT palette — scale_colour_ft • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Discrete color & fill scales based on the FT palette

    - Source: R/ft.R + Source: R/ft.R
    - -

    See ft_pal.

    - +

    See ft_pal().

    - 
    scale_colour_ft(...)
+    
    
+    
    scale_colour_ft(...)
 
-scale_color_ft(...)
+scale_color_ft(...)
 
-scale_fill_ft(...)
    
-    
-    
    Arguments
    
-    
-    
-    
-      
-      
-    
-    
    ...
    Arguments passed on to ggplot2::discrete_scale
    
-  
    aesthetics
    The names of the aesthetics that this scale works with
    
-  
    scale_name
    The name of the scale
    
-  
    palette
    A palette function that when called with a single integer
+scale_fill_ft(...)
+    
+
+    
    
+    
    Arguments
    
+    
    ...
    
+
    Arguments passed on to ggplot2::discrete_scale
    aesthetics
    
+
    The names of the aesthetics that this scale works with.
    
+
+    
    scale_name
    
+
    The name of the scale that should be used for error messages
+associated with this scale.
    
+
+    
    palette
    
+
    A palette function that when called with a single integer
 argument (the number of levels in the scale) returns the values that
-they should take.
    
-  
    name
    The name of the scale. Used as the axis or legend title. If
-waiver(), the default, the name of the scale is taken from the first
+they should take (e.g., scales::hue_pal()).
    
+
+    
    name
    
+
    The name of the scale. Used as the axis or legend title. If
+waiver(), the default, the name of the scale is taken from the first
 mapping used for that aesthetic. If NULL, the legend title will be
 omitted.
    
-  
    breaks
    One of:
-
      
-
    • NULL for no breaks
      • 
-
    • waiver() for the default breaks computed by the
-transformation object
      • 
+
+    
      breaks
      
+
      One of:
      • NULL for no breaks
        • 
+
      • waiver() for the default breaks (the scale limits)
        • 
 
      • A character vector of breaks
        • 
 
      • A function that takes the limits as input and returns breaks
-as output
        • 
-
      
-  
      labels
      One of:
-
        
-
      • NULL for no labels
        • 
-
      • waiver() for the default labels computed by the
+as output. Also accepts rlang lambda function
+notation.
        • 
+
      
+
+    
      labels
      
+
      One of:
      • NULL for no labels
        • 
+
      • waiver() for the default labels computed by the
 transformation object
        • 
 
      • A character vector giving labels (must be same length as breaks)
        • 
 
      • A function that takes the breaks as input and returns labels
-as output
        • 
-
      
-  
      limits
      A character vector that defines possible values of the scale
-and their order.
      
-  
      na.translate
      Unlike continuous scales, discrete scales can easily show
+as output. Also accepts rlang lambda function
+notation.
      
+
    
+
+    
    limits
    
+
    One of:
    • NULL to use the default scale values
      • 
+
    • A character vector that defines possible values of the scale and their
+order
      • 
+
    • A function that accepts the existing (automatic) values and returns
+new ones. Also accepts rlang lambda function
+notation.
      • 
+
    
+
+    
    na.translate
    
+
    Unlike continuous scales, discrete scales can easily show
 missing values, and do so by default. If you want to remove missing values
 from a discrete scale, specify na.translate = FALSE.
    
-  
    na.value
    If na.translate = TRUE, what value aesthetic
-value should missing be displayed as? Does not apply to position scales
+
+    
    na.value
    
+
    If na.translate = TRUE, what aesthetic value should the
+missing values be displayed as? Does not apply to position scales
 where NA is always placed at the far right.
    
-  
    drop
    Should unused factor levels be omitted from the scale?
+
+    
    drop
    
+
    Should unused factor levels be omitted from the scale?
 The default, TRUE, uses the levels that appear in the data;
 FALSE uses all the levels in the factor.
    
-  
    guide
    A function used to create a guide or its name. See
-guides() for more info.
    
-  
    super
    The super class to use for the constructed scale
    
-
    
-    
 
-  
    
-  
 
   
    
+
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/scale_ipsum.html b/docs/reference/scale_ipsum.html index a05386c..ecf956b 100644 --- a/docs/reference/scale_ipsum.html +++ b/docs/reference/scale_ipsum.html @@ -1,58 +1,12 @@ - - - - - - - -Discrete color & fill scales based on the ipsum palette — scale_colour_ipsum • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Discrete color & fill scales based on the ipsum palette — scale_colour_ipsum • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Discrete color & fill scales based on the ipsum palette

    - Source: R/color.r + Source: R/color.r
    - -

    See ipsum_pal.

    - +

    See ipsum_pal().

    - 
    scale_colour_ipsum(...)
+    
    
+    
    scale_colour_ipsum(...)
 
-scale_color_ipsum(...)
+scale_color_ipsum(...)
 
-scale_fill_ipsum(...)
    
-    
-    
    Arguments
    
-    
-    
-    
-      
-      
-    
-    
    ...
    Arguments passed on to ggplot2::discrete_scale
    
-  
    aesthetics
    The names of the aesthetics that this scale works with
    
-  
    scale_name
    The name of the scale
    
-  
    palette
    A palette function that when called with a single integer
+scale_fill_ipsum(...)
+    
+
+    
    
+    
    Arguments
    
+    
    ...
    
+
    Arguments passed on to ggplot2::discrete_scale
    aesthetics
    
+
    The names of the aesthetics that this scale works with.
    
+
+    
    scale_name
    
+
    The name of the scale that should be used for error messages
+associated with this scale.
    
+
+    
    palette
    
+
    A palette function that when called with a single integer
 argument (the number of levels in the scale) returns the values that
-they should take.
    
-  
    name
    The name of the scale. Used as the axis or legend title. If
-waiver(), the default, the name of the scale is taken from the first
+they should take (e.g., scales::hue_pal()).
    
+
+    
    name
    
+
    The name of the scale. Used as the axis or legend title. If
+waiver(), the default, the name of the scale is taken from the first
 mapping used for that aesthetic. If NULL, the legend title will be
 omitted.
    
-  
    breaks
    One of:
-
      
-
    • NULL for no breaks
      • 
-
    • waiver() for the default breaks computed by the
-transformation object
      • 
+
+    
      breaks
      
+
      One of:
      • NULL for no breaks
        • 
+
      • waiver() for the default breaks (the scale limits)
        • 
 
      • A character vector of breaks
        • 
 
      • A function that takes the limits as input and returns breaks
-as output
        • 
-
      
-  
      labels
      One of:
-
        
-
      • NULL for no labels
        • 
-
      • waiver() for the default labels computed by the
+as output. Also accepts rlang lambda function
+notation.
        • 
+
      
+
+    
      labels
      
+
      One of:
      • NULL for no labels
        • 
+
      • waiver() for the default labels computed by the
 transformation object
        • 
 
      • A character vector giving labels (must be same length as breaks)
        • 
 
      • A function that takes the breaks as input and returns labels
-as output
        • 
-
      
-  
      limits
      A character vector that defines possible values of the scale
-and their order.
      
-  
      na.translate
      Unlike continuous scales, discrete scales can easily show
+as output. Also accepts rlang lambda function
+notation.
      
+
    
+
+    
    limits
    
+
    One of:
    • NULL to use the default scale values
      • 
+
    • A character vector that defines possible values of the scale and their
+order
      • 
+
    • A function that accepts the existing (automatic) values and returns
+new ones. Also accepts rlang lambda function
+notation.
      • 
+
    
+
+    
    na.translate
    
+
    Unlike continuous scales, discrete scales can easily show
 missing values, and do so by default. If you want to remove missing values
 from a discrete scale, specify na.translate = FALSE.
    
-  
    na.value
    If na.translate = TRUE, what value aesthetic
-value should missing be displayed as? Does not apply to position scales
+
+    
    na.value
    
+
    If na.translate = TRUE, what aesthetic value should the
+missing values be displayed as? Does not apply to position scales
 where NA is always placed at the far right.
    
-  
    drop
    Should unused factor levels be omitted from the scale?
+
+    
    drop
    
+
    Should unused factor levels be omitted from the scale?
 The default, TRUE, uses the levels that appear in the data;
 FALSE uses all the levels in the factor.
    
-  
    guide
    A function used to create a guide or its name. See
-guides() for more info.
    
-  
    super
    The super class to use for the constructed scale
    
-
    
-    
 
-  
    
-  
 
   
    
+
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/scale_x_percent.html b/docs/reference/scale_x_percent.html index fc6ea6a..e35c496 100644 --- a/docs/reference/scale_x_percent.html +++ b/docs/reference/scale_x_percent.html @@ -1,58 +1,12 @@ - - - - - - - -X & Y scales with opinionated pre-sets for percent & comma label formats — scale_x_percent • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -X & Y scales with opinionated presets for percent & comma label formats — scale_x_percent • hrbrthemes - - - + + -
    -
    - -
    -
    +
    -

    X & Y scales with opinionated pre-sets for percent & comma label formats

    - Source: R/scales.r +

    X & Y scales with opinionated presets for percent & comma label formats

    + Source: R/scales.r
    -

    The _comma ones set comma format for axis text and expand=c(0,0) (you need to set limits).

    -
    - 
    scale_x_percent(name = waiver(), breaks = waiver(),
-  minor_breaks = waiver(), labels = scales::percent, limits = NULL,
-  expand = c(0.01, 0), oob = censor, na.value = NA_real_,
-  trans = "identity", position = "bottom", sec.axis = waiver())
-
-scale_y_percent(name = waiver(), breaks = waiver(),
-  minor_breaks = waiver(), labels = scales::percent, limits = NULL,
-  expand = c(0.01, 0), oob = censor, na.value = NA_real_,
-  trans = "identity", position = "left", sec.axis = waiver())
-
-scale_x_comma(name = waiver(), breaks = waiver(),
-  minor_breaks = waiver(), labels = scales::comma, limits = NULL,
-  expand = c(0.01, 0), oob = censor, na.value = NA_real_,
-  trans = "identity", position = "bottom", sec.axis = waiver())
+    
    
+    
    scale_x_percent(
+  name = waiver(),
+  breaks = waiver(),
+  minor_breaks = waiver(),
+  guide = waiver(),
+  n.breaks = NULL,
+  labels,
+  limits = NULL,
+  expand = c(0.01, 0),
+  oob = censor,
+  na.value = NA_real_,
+  trans = "identity",
+  position = "bottom",
+  sec.axis = waiver(),
+  accuracy = 1,
+  scale = 100,
+  prefix = "",
+  suffix = "%",
+  big.mark = " ",
+  decimal.mark = ".",
+  trim = TRUE,
+  ...
+)
+
+scale_y_percent(
+  name = waiver(),
+  breaks = waiver(),
+  minor_breaks = waiver(),
+  guide = waiver(),
+  n.breaks = NULL,
+  labels,
+  limits = NULL,
+  expand = c(0.01, 0),
+  oob = censor,
+  na.value = NA_real_,
+  trans = "identity",
+  position = "left",
+  sec.axis = waiver(),
+  accuracy = 1,
+  scale = 100,
+  prefix = "",
+  suffix = "%",
+  big.mark = " ",
+  decimal.mark = ".",
+  trim = TRUE,
+  ...
+)
+
+scale_x_comma(
+  name = waiver(),
+  breaks = waiver(),
+  minor_breaks = waiver(),
+  guide = waiver(),
+  n.breaks = NULL,
+  labels,
+  limits = NULL,
+  expand = c(0.01, 0),
+  oob = censor,
+  na.value = NA_real_,
+  trans = "identity",
+  position = "bottom",
+  sec.axis = waiver(),
+  accuracy = 1,
+  scale = 1,
+  prefix = "",
+  suffix = "",
+  big.mark = ",",
+  decimal.mark = ".",
+  trim = TRUE,
+  ...
+)
+
+scale_y_comma(
+  name = waiver(),
+  breaks = waiver(),
+  minor_breaks = waiver(),
+  guide = waiver(),
+  n.breaks = NULL,
+  labels,
+  limits = NULL,
+  expand = c(0.01, 0),
+  oob = censor,
+  na.value = NA_real_,
+  trans = "identity",
+  position = "left",
+  sec.axis = waiver(),
+  accuracy = 1,
+  scale = 1,
+  prefix = "",
+  suffix = "",
+  big.mark = ",",
+  decimal.mark = ".",
+  trim = TRUE,
+  ...
+)
    
+    
    
 
-scale_y_comma(name = waiver(), breaks = waiver(),
-  minor_breaks = waiver(), labels = scales::comma, limits = NULL,
-  expand = c(0.01, 0), oob = censor, na.value = NA_real_,
-  trans = "identity", position = "left", sec.axis = waiver())
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    name

    The name of the scale. Used as axis or legend title. If -waiver(), the default, the name of the scale is taken from the first +

    +

    Arguments

    +
    name
    +

    The name of the scale. Used as axis or legend title. If +waiver(), the default, the name of the scale is taken from the first mapping used for that aesthetic. If NULL, the legend title will be -omitted.

    breaks

    One of:

      -

    • NULL for no breaks

      • -

    • waiver() for the default breaks computed by the +omitted.

      +
      breaks
      +

      One of:

      • NULL for no breaks

        • +

      • waiver() for the default breaks computed by the transformation object

      • A numeric vector of positions

      • A function that takes the limits as input and returns breaks as output

        • -
    minor_breaks

    One of:

      -

    • NULL for no minor breaks

      • -

    • waiver() for the default breaks (one minor break between +

    +
    minor_breaks
    +

    One of:

    • NULL for no minor breaks

      • +

    • waiver() for the default breaks (one minor break between each major break)

    • A numeric vector of positions

    • A function that given the limits returns a vector of minor breaks.

      • -
    labels

    One of:

      -

    • NULL for no labels

      • -

    • waiver() for the default labels computed by the -transformation object

      • -

    • A character vector giving labels (must be same length as breaks)

      • -

    • A function that takes the breaks as input and returns labels -as output

      • -
    limits

    A numeric vector of length two providing limits of the scale. -Use NA to refer to the existing minimum or maximum.

    expand

    same as in ggplot2

    oob

    Function that handles limits outside of the scale limits -(out of bounds). The default replaces out of bounds values with NA.

    na.value

    If na.translate = TRUE, what value aesthetic + +

    guide
    +

    guide A function used to create a guide or its name. See guides() for more information.

    +
    n.breaks
    +

    An integer guiding the number of major breaks. The algorithm may choose a +slightly different number to ensure nice break labels. Will only have an effect if +breaks = waiver(). Use NULL to use the default number of breaks given by the transformation.

    +
    labels
    +

    Specifying overrides the default format (i.e. you really don't +want to do that). NULL means no labels.

    +
    limits
    +

    A numeric vector of length two providing limits of the scale. +Use NA to refer to the existing minimum or maximum.

    +
    expand
    +

    same as in ggplot2

    +
    oob
    +

    Function that handles limits outside of the scale limits +(out of bounds). The default replaces out of bounds values with NA.

    +
    na.value
    +

    If na.translate = TRUE, what value aesthetic value should missing be displayed as? Does not apply to position scales -where NA is always placed at the far right.

    trans

    Either the name of a transformation object, or the +where NA is always placed at the far right.

    +
    trans
    +

    Either the name of a transformation object, or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "exp", "identity", "log", "log10", "log1p", "log2", -"logit", "probability", "probit", "reciprocal", "reverse" and "sqrt".

    position

    The position of the axis. "left" or "right" for vertical -scales, "top" or "bottom" for horizontal scales

    sec.axis

    specify a secondary axis

    - -

    Details

    - -

    The _percent ones set precent format for axis text and expand=c(0,0) (you need to set limits).

    - - -
    - +
    +

    Details

    +

    The _percent ones set percent format for axis text and expand=c(0,0) (you need to set limits).

    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/theme_ipsum.html b/docs/reference/theme_ipsum.html index edbf644..ce39bf4 100644 --- a/docs/reference/theme_ipsum.html +++ b/docs/reference/theme_ipsum.html @@ -1,58 +1,12 @@ - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum • hrbrthemes - - - + + -
    -
    - -
    -
    +
    -

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    - Source: R/theme-ipsum.r +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/theme-ipsum.r
    -

    Also has a "dark" / "modern" version for the new RStudio theme

    -
    - 
    theme_ipsum(base_family = "Arial Narrow", base_size = 11.5,
-  plot_title_family = base_family, plot_title_size = 18,
-  plot_title_face = "bold", plot_title_margin = 10,
-  subtitle_family = base_family, subtitle_size = 12,
-  subtitle_face = "plain", 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_margin = 10,
-  axis_text_size = base_size, axis_title_family = subtitle_family,
-  axis_title_size = 9, axis_title_face = "plain",
-  axis_title_just = "rt", plot_margin = margin(30, 30, 30, 30),
-  grid_col = "#cccccc", grid = TRUE, axis_col = "#cccccc",
-  axis = FALSE, ticks = FALSE)
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    base_family, base_size

    base font family and size

    plot_title_family, plot_title_face, plot_title_size, plot_title_margin

    plot title family, face, size and margi

    subtitle_family, subtitle_face, subtitle_size

    plot subtitle family, face and size

    subtitle_margin

    plot subtitle margin bottom (single numeric value)

    strip_text_family, strip_text_face, strip_text_size

    facet label font family, face and size

    caption_family, caption_face, caption_size, caption_margin

    plot caption family, face, size and margin

    axis_text_size

    font size of axis text

    axis_title_family, axis_title_face, axis_title_size

    axis title font family, face and size

    axis_title_just

    axis title font justification, one of [blmcrt]

    plot_margin

    plot margin (specify with ggplot2::margin())

    grid_col, axis_col

    grid & axis colors; both default to #cccccc

    grid

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    axis

    add x or y axes? TRUE, FALSE, "xy"

    ticks

    ticks if TRUE add ticks

    - -

    Why Arial Narrow?

    +
    + 
    theme_ipsum(
+  base_family = "Arial Narrow",
+  base_size = 11.5,
+  plot_title_family = base_family,
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = base_family,
+  subtitle_size = 12,
+  subtitle_face = "plain",
+  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_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = subtitle_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margi

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification, one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin())

    +
    grid_col, axis_col
    +

    grid & axis colors; both default to #cccccc

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Why Arial Narrow?

    -

    First and foremost, Arial Narrow is generally installed by default or readily + +

    First and foremost, Arial Narrow is generally installed by default or readily available on any modern system, so it's "free"-ish; plus, it is a condensed font with solid default kerning pairs and geometric numbers.

    +
    +
    +

    Building upon theme_ipsum

    -

    Building upon theme_ipsum

    - -

    The function is setup in such a way that you can customize your own one by just +

    The function is setup in such a way that you can customize your own one by just wrapping the call and changing the parameters. See source for examples.

    +
    +
    +

    Gotchas

    -

    Gotchas

    - -

    There are distinctions between font names and various devices. Names that work +

    There are distinctions between font names and various devices. Names that work for display graphics devices and bitmap ones such as png may not work well for PostScript or PDF ones. You may need two versions of a font-based theme function for them to work in a particular situation. This situation usually only arises when using a newer font with many weights but somewhat irregular internal font name patterns.

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    - - -

    Examples

    - 
    # NOT RUN {
-library(ggplot2)
-library(dplyr)
-
-# seminal scatterplot
-ggplot(mtcars, aes(mpg, wt)) +
-  geom_point() +
-  labs(x="Fuel effiiency (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'") +
-  theme_ipsum()
-
-# seminal bar chart
-
-update_geom_font_defaults()
-
-count(mpg, class) %>%
-  ggplot(aes(class, n)) +
-  geom_col() +
-  geom_text(aes(label=n), nudge_y=3) +
-  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
-       title="Seminal ggplot2 bar chart example",
-       subtitle="A plot that is only useful for demonstration purposes",
-       caption="Brought to you by the letter 'g'") +
-  theme_ipsum(grid="Y") +
-  theme(axis.text.y=element_blank())
-# }
    -
    - +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum()
+
+# seminal bar chart
+
+update_geom_font_defaults()
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/theme_ipsum_es.html b/docs/reference/theme_ipsum_es.html new file mode 100644 index 0000000..10d7782 --- /dev/null +++ b/docs/reference/theme_ipsum_es.html @@ -0,0 +1,209 @@ + +A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum_es • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/econ-sans.R + +
    + +
    +

    You should import_econ_sans() first and also install the fonts on your +system before trying to use this theme.

    +
    + +
    + 
    theme_ipsum_es(
+  base_family = "EconSansCndReg",
+  base_size = 11.5,
+  plot_title_family = "EconSansCndBol",
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "EconSansCndLig" else
+    "EconSansCndLig",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "EconSansCndLig" else
+    "EconSansCndLig",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  panel_spacing = grid::unit(2, "lines"),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    + +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    panel_spacing
    +

    panel spacing (use unit())

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Econ Sans Condensed?

    + + +

    It's free, has tolerable kerning pairs and multiple weights. It's also different +than Arial Narrow and the fonts most folks use in ggplot2 charts.

    +
    + +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_es()
+
+# seminal bar chart
+
+# note: may need to make this font_es on Windows
+update_geom_font_defaults(family=font_es_light)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_es(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/theme_ipsum_gs.html b/docs/reference/theme_ipsum_gs.html new file mode 100644 index 0000000..4a9f689 --- /dev/null +++ b/docs/reference/theme_ipsum_gs.html @@ -0,0 +1,204 @@ + +A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum_gs • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/goldmansans.R + +
    + +
    +

    You should import_goldman_sans() first and also install the fonts on your +system before trying to use this theme.

    +
    + +
    + 
    theme_ipsum_gs(
+  base_family = "Goldman Sans Condensed",
+  base_size = 11.5,
+  plot_title_family = "Goldman Sans Condensed",
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "Goldman Sans Condensed" else
+    "Goldman Sans Condensed",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = "Goldman Sans Condensed",
+  strip_text_size = 12,
+  strip_text_face = "bold",
+  caption_family = if (.Platform$OS.type == "windows") "Goldman Sans Condensed" else
+    "Goldman Sans Condensed",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = 9,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    + +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Goldman Sans?

    + + +

    See https://design.gs.com/d/story/goldman-sans/.

    +
    + +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_gs()
+
+# seminal bar chart
+
+update_geom_font_defaults(family=font_gs_light)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_gs(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/theme_ipsum_inter.html b/docs/reference/theme_ipsum_inter.html new file mode 100644 index 0000000..d062e66 --- /dev/null +++ b/docs/reference/theme_ipsum_inter.html @@ -0,0 +1,204 @@ + +A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum_inter • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/inter.R + +
    + +
    +

    You should import_inter() first and also install the fonts on your +system before trying to use this theme.

    +
    + +
    + 
    theme_ipsum_inter(
+  base_family = "Inter-Medium",
+  base_size = 10,
+  plot_title_family = "Inter-Bold",
+  plot_title_size = 16,
+  plot_title_face = "bold",
+  plot_title_margin = 8,
+  subtitle_family = "Inter-Light",
+  subtitle_size = 12,
+  subtitle_face = "plain",
+  subtitle_margin = 13,
+  strip_text_family = "Inter-SemiBold",
+  strip_text_size = 12,
+  strip_text_face = "bold",
+  caption_family = "Inter-Thin",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_family = "Inter-Light",
+  axis_text_face = "plain",
+  axis_text_size = 9,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    + +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_family, axis_text_face, axis_text_size
    +

    axis text font family, face, and size

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Inter?

    + + +

    See https://design.gs.com/d/story/goldman-sans/.

    +
    + +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_inter()
+
+# seminal bar chart
+
+update_geom_font_defaults(family=font_inter_medium)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_inter(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/theme_ipsum_ps.html b/docs/reference/theme_ipsum_ps.html index 653ea3c..621bd5d 100644 --- a/docs/reference/theme_ipsum_ps.html +++ b/docs/reference/theme_ipsum_ps.html @@ -1,59 +1,13 @@ - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy — theme_ipsum_ps • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum_ps • hrbrthemes - - - + + -
    -
    - -
    -
    +
    -

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy

    - Source: R/plexsans.R +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/plexsans.R
    - -

    You should import_plex_sans first and also install the fonts on your +

    You should import_plex_sans() first and also install the fonts on your system before trying to use this theme.

    -
    - 
    theme_ipsum_ps(base_family = "IBMPlexSans", base_size = 11.5,
-  plot_title_family = "IBMPlexSans-Bold", plot_title_size = 18,
-  plot_title_face = "plain", plot_title_margin = 10,
-  subtitle_family = if (.Platform$OS.type == "windows") "IBMPlexSans"
-  else "IBMPlexSans-Light", subtitle_size = 13,
-  subtitle_face = "plain", subtitle_margin = 15,
-  strip_text_family = "IBMPlexSans-Medium", strip_text_size = 12,
-  strip_text_face = "plain", caption_family = if (.Platform$OS.type ==
-  "windows") "IBMPlexSans" else "IBMPlexSans-Thin", caption_size = 9,
-  caption_face = "plain", caption_margin = 10, axis_text_size = 9,
-  axis_title_family = base_family, axis_title_size = 9,
-  axis_title_face = "plain", axis_title_just = "rt",
-  plot_margin = margin(30, 30, 30, 30), grid_col = "#cccccc",
-  grid = TRUE, axis_col = "#cccccc", axis = FALSE, ticks = FALSE)
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    base_family, base_size

    base font family and size

    plot_title_family, plot_title_face, plot_title_size, plot_title_margin

    plot tilte family, face, size and margin

    subtitle_family, subtitle_face, subtitle_size

    plot subtitle family, face and size

    subtitle_margin

    plot subtitle margin bottom (single numeric value)

    strip_text_family, strip_text_face, strip_text_size

    facet label font family, face and size

    caption_family, caption_face, caption_size, caption_margin

    plot caption family, face, size and margin

    axis_text_size

    font size of axis text

    axis_title_family, axis_title_face, axis_title_size

    axis title font family, face and size

    axis_title_just

    axis title font justificationk one of [blmcrt]

    plot_margin

    plot margin (specify with ggplot2::margin)

    grid_col

    grid color

    grid

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    axis_col

    axis color

    axis

    add x or y axes? TRUE, FALSE, "xy"

    ticks

    ticks if TRUE add ticks

    - -

    Details

    +
    + 
    theme_ipsum_ps(
+  base_family = "IBMPlexSans",
+  base_size = 11.5,
+  plot_title_family = "IBMPlexSans-Bold",
+  plot_title_size = 18,
+  plot_title_face = "plain",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "IBMPlexSans" else
+    "IBMPlexSans-Light",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = "IBMPlexSans-Medium",
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "IBMPlexSans" else
+    "IBMPlexSans-Thin",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = 9,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why IBM Plex Sans?

    -

    Why IBM Plex Sans?

    - -

    It's free, has tolerable kerning pairs and multiple weights. It's also different +

    It's free, has tolerable kerning pairs and multiple weights. It's also different "not Helvetica".

    - - -

    Examples

    - 
    # NOT RUN {
-library(ggplot2)
-library(dplyr)
-
-# seminal scatterplot
-ggplot(mtcars, aes(mpg, wt)) +
-  geom_point() +
-  labs(x="Fuel effiiency (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'") +
-  theme_ipsum_rc()
-
-# seminal bar chart
-
-# note: make this font_rc on Windows
-update_geom_font_defaults(family=font_rc_light)
-
-count(mpg, class) %>%
-  ggplot(aes(class, n)) +
-  geom_col() +
-  geom_text(aes(label=n), nudge_y=3) +
-  labs(x="Fuel effiiency (mpg)", y="Weight (tons)",
-       title="Seminal ggplot2 bar chart example",
-       subtitle="A plot that is only useful for demonstration purposes",
-       caption="Brought to you by the letter 'g'") +
-  theme_ipsum_rc(grid="Y") +
-  theme(axis.text.y=element_blank())
-# }
    -
    - +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_rc()
+
+# seminal bar chart
+
+# note: make this font_rc on Windows
+update_geom_font_defaults(family=font_rc_light)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_rc(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/theme_ipsum_pub.html b/docs/reference/theme_ipsum_pub.html new file mode 100644 index 0000000..d4db409 --- /dev/null +++ b/docs/reference/theme_ipsum_pub.html @@ -0,0 +1,206 @@ + +A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum_pub • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/public-sans.R + +
    + +
    +

    You should import_public_sans() first and also install the fonts on your +system before trying to use this theme.

    +
    + +
    + 
    theme_ipsum_pub(
+  base_family = "Public Sans",
+  base_size = 10.5,
+  plot_title_family = if (.Platform$OS.type == "windows") "Public Sans" else
+    "Public Sans Bold",
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "Public Sans Thin" else
+    "Public Sans Thin",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "Public Sans Thin" else
+    "Public Sans Thin",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    + +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Public Sans?

    + + + +

    See the design principles.

    +
    + +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_pub()
+
+# seminal bar chart
+
+update_geom_font_defaults(family=font_pub)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_pub(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/theme_ipsum_rc.html b/docs/reference/theme_ipsum_rc.html index c457a9a..8c74ad8 100644 --- a/docs/reference/theme_ipsum_rc.html +++ b/docs/reference/theme_ipsum_rc.html @@ -1,59 +1,13 @@ - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy — theme_ft_rc • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ft_rc • hrbrthemes - - - + + -
    -
    - -
    -
    +
    -

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy

    - Source: R/ft.R, R/modern.r, R/roboto-condensed.r +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/ft.R, R/modern.r, R/roboto-condensed.r
    - -

    You should import_roboto_condensed first and also install the fonts on your +

    You should import_roboto_condensed() first and also install the fonts on your system before trying to use this theme.

    -
    - 
    theme_ft_rc(base_family = "Roboto Condensed", base_size = 11.5,
-  plot_title_family = base_family, plot_title_size = 18,
-  plot_title_face = "bold", plot_title_margin = 10,
-  subtitle_family = if (.Platform$OS.type == "windows")
-  "Roboto Condensed" else "Roboto Condensed Light", subtitle_size = 13,
-  subtitle_face = "plain", subtitle_margin = 15,
-  strip_text_family = base_family, strip_text_size = 12,
-  strip_text_face = "plain", caption_family = if (.Platform$OS.type ==
-  "windows") "Roboto Condensed" else "Roboto Condensed Light",
-  caption_size = 9, caption_face = "plain", caption_margin = 10,
-  axis_text_size = base_size, axis_title_family = base_family,
-  axis_title_size = 9, axis_title_face = "plain",
-  axis_title_just = "rt", plot_margin = margin(30, 30, 30, 30),
-  grid = TRUE, axis = FALSE, ticks = FALSE)
-
-theme_modern_rc(base_family = "Roboto Condensed", base_size = 11.5,
-  plot_title_family = base_family, plot_title_size = 18,
-  plot_title_face = "bold", plot_title_margin = 10,
-  subtitle_family = if (.Platform$OS.type == "windows")
-  "Roboto Condensed" else "Roboto Condensed Light", subtitle_size = 13,
-  subtitle_face = "plain", subtitle_margin = 15,
-  strip_text_family = base_family, strip_text_size = 12,
-  strip_text_face = "plain", caption_family = if (.Platform$OS.type ==
-  "windows") "Roboto Condensed" else "Roboto Condensed Light",
-  caption_size = 9, caption_face = "plain", caption_margin = 10,
-  axis_text_size = base_size, axis_title_family = base_family,
-  axis_title_size = 9, axis_title_face = "plain",
-  axis_title_just = "rt", plot_margin = margin(30, 30, 30, 30),
-  grid = TRUE, axis = FALSE, ticks = FALSE)
-
-theme_ipsum_rc(base_family = "Roboto Condensed", base_size = 11.5,
-  plot_title_family = base_family, plot_title_size = 18,
-  plot_title_face = "bold", plot_title_margin = 10,
-  subtitle_family = if (.Platform$OS.type == "windows")
-  "Roboto Condensed" else "Roboto Condensed Light", subtitle_size = 13,
-  subtitle_face = "plain", subtitle_margin = 15,
-  strip_text_family = base_family, strip_text_size = 12,
-  strip_text_face = "plain", caption_family = if (.Platform$OS.type ==
-  "windows") "Roboto Condensed" else "Roboto Condensed Light",
-  caption_size = 9, caption_face = "plain", caption_margin = 10,
-  axis_text_size = base_size, axis_title_family = base_family,
-  axis_title_size = 9, axis_title_face = "plain",
-  axis_title_just = "rt", plot_margin = margin(30, 30, 30, 30),
-  grid_col = "#cccccc", grid = TRUE, axis_col = "#cccccc",
-  axis = FALSE, ticks = FALSE)
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    base_family, base_size

    base font family and size

    plot_title_family, plot_title_face, plot_title_size, plot_title_margin

    plot tilte family, face, size and margin

    subtitle_family, subtitle_face, subtitle_size

    plot subtitle family, face and size

    subtitle_margin

    plot subtitle margin bottom (single numeric value)

    strip_text_family, strip_text_face, strip_text_size

    facet label font family, face and size

    caption_family, caption_face, caption_size, caption_margin

    plot caption family, face, size and margin

    axis_text_size

    font size of axis text

    axis_title_family, axis_title_face, axis_title_size

    axis title font family, face and size

    axis_title_just

    axis title font justificationk one of [blmcrt]

    plot_margin

    plot margin (specify with ggplot2::margin)

    grid

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    axis

    add x or y axes? TRUE, FALSE, "xy"

    ticks

    ticks if TRUE add ticks

    grid_col

    grid color

    axis_col

    axis color

    - -

    Details

    +
    + 
    theme_ft_rc(
+  base_family = "Roboto Condensed",
+  base_size = 11.5,
+  plot_title_family = base_family,
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "Roboto Condensed" else
+    "Roboto Condensed Light",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "Roboto Condensed" else
+    "Roboto Condensed Light",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid = TRUE,
+  axis = FALSE,
+  ticks = FALSE
+)
+
+theme_modern_rc(
+  base_family = "Roboto Condensed",
+  base_size = 11.5,
+  plot_title_family = base_family,
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "Roboto Condensed" else
+    "Roboto Condensed Light",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "Roboto Condensed" else
+    "Roboto Condensed Light",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid = TRUE,
+  axis = FALSE,
+  ticks = FALSE
+)
+
+theme_ipsum_rc(
+  base_family = "Roboto Condensed",
+  base_size = 11.5,
+  plot_title_family = base_family,
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "Roboto Condensed" else
+    "Roboto Condensed Light",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "Roboto Condensed" else
+    "Roboto Condensed Light",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  panel_spacing = grid::unit(2, "lines"),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    panel_spacing
    +

    panel spacing (use unit())

    +
    grid_col
    +

    grid color

    +
    axis_col
    +

    axis color

    +
    +
    +

    Details

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Roboto Condensed?

    -

    Why Roboto Condensed?

    - -

    It's free, has tolerable kerning pairs and multiple weights. It's also different +

    It's free, has tolerable kerning pairs and multiple weights. It's also different than Arial Narrow and the fonts most folks use in ggplot2 charts.

    - - -

    Examples

    - 
    # NOT RUN {
-library(ggplot2)
-library(dplyr)
-
-# seminal scatterplot
-ggplot(mtcars, aes(mpg, wt)) +
-  geom_point() +
-  labs(x="Fuel effiiency (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'") +
-  theme_ipsum_rc()
-
-# seminal bar chart
-
-# note: make this font_rc on Windows
-update_geom_font_defaults(family=font_rc_light)
-
-count(mpg, class) %>%
-  ggplot(aes(class, n)) +
-  geom_col() +
-  geom_text(aes(label=n), nudge_y=3) +
-  labs(x="Fuel effiiency (mpg)", y="Weight (tons)",
-       title="Seminal ggplot2 bar chart example",
-       subtitle="A plot that is only useful for demonstration purposes",
-       caption="Brought to you by the letter 'g'") +
-  theme_ipsum_rc(grid="Y") +
-  theme(axis.text.y=element_blank())
-# }
    -
    - +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_rc()
+
+# seminal bar chart
+
+# note: make this font_rc on Windows
+update_geom_font_defaults(family=font_rc_light)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_rc(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/theme_ipsum_tw.html b/docs/reference/theme_ipsum_tw.html index 74dfd22..fd58c46 100644 --- a/docs/reference/theme_ipsum_tw.html +++ b/docs/reference/theme_ipsum_tw.html @@ -1,59 +1,13 @@ - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy — theme_ipsum_tw • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography — theme_ipsum_tw • hrbrthemes - - - + + -
    -
    - -
    -
    +
    -

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy

    - Source: R/titillium-web.R +

    A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

    + Source: R/titillium-web.R
    - -

    You should import_titillium_web first and also install the fonts on your +

    You should import_titillium_web() first and also install the fonts on your system before trying to use this theme.

    -
    - 
    theme_ipsum_tw(base_family = "Titillium Web", base_size = 10.5,
-  plot_title_family = if (.Platform$OS.type == "windows") "Titillium Web"
-  else "Titillium Web Bold", plot_title_size = 18,
-  plot_title_face = "bold", plot_title_margin = 10,
-  subtitle_family = if (.Platform$OS.type == "windows") "Titillium Web"
-  else "Titillium Web Light", subtitle_size = 13,
-  subtitle_face = "plain", subtitle_margin = 15,
-  strip_text_family = base_family, strip_text_size = 12,
-  strip_text_face = "plain", caption_family = if (.Platform$OS.type ==
-  "windows") "Titillium Web" else "Titillium Web Light",
-  caption_size = 9, caption_face = "plain", caption_margin = 10,
-  axis_text_size = base_size, axis_title_family = base_family,
-  axis_title_size = 9, axis_title_face = "plain",
-  axis_title_just = "rt", plot_margin = margin(30, 30, 30, 30),
-  grid_col = "#cccccc", grid = TRUE, axis_col = "#cccccc",
-  axis = FALSE, ticks = FALSE)
    - -

    Arguments

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    base_family, base_size

    base font family and size

    plot_title_family, plot_title_face, plot_title_size, plot_title_margin

    plot tilte family, face, size and margin

    subtitle_family, subtitle_face, subtitle_size

    plot subtitle family, face and size

    subtitle_margin

    plot subtitle margin bottom (single numeric value)

    strip_text_family, strip_text_face, strip_text_size

    facet label font family, face and size

    caption_family, caption_face, caption_size, caption_margin

    plot caption family, face, size and margin

    axis_text_size

    font size of axis text

    axis_title_family, axis_title_face, axis_title_size

    axis title font family, face and size

    axis_title_just

    axis title font justificationk one of [blmcrt]

    plot_margin

    plot margin (specify with ggplot2::margin)

    grid_col

    grid color

    grid

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    axis_col

    axis color

    axis

    add x or y axes? TRUE, FALSE, "xy"

    ticks

    ticks if TRUE add ticks

    - -

    Details

    +
    + 
    theme_ipsum_tw(
+  base_family = "Titillium Web",
+  base_size = 10.5,
+  plot_title_family = if (.Platform$OS.type == "windows") "Titillium Web" else
+    "Titillium Web Bold",
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = if (.Platform$OS.type == "windows") "Titillium Web" else
+    "Titillium Web Light",
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = if (.Platform$OS.type == "windows") "Titillium Web" else
+    "Titillium Web Light",
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will -call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript devices. If you are running under Windows, the package calls the same function to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Titillium Web?

    -

    Why Titillium Web?

    - -

    It's free, has tolerable kerning pairs and multiple weights. It's also different +

    It's free, has tolerable kerning pairs and multiple weights. It's also different than Arial Narrow and the fonts most folks use in ggplot2 charts.

    - - -

    Examples

    - 
    # NOT RUN {
-library(ggplot2)
-library(dplyr)
-
-# seminal scatterplot
-ggplot(mtcars, aes(mpg, wt)) +
-  geom_point() +
-  labs(x="Fuel effiiency (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'") +
-  theme_ipsum_rc()
-
-# seminal bar chart
-
-# note: make this font_rc on Windows
-update_geom_font_defaults(family=font_rc_light)
-
-count(mpg, class) %>%
-  ggplot(aes(class, n)) +
-  geom_col() +
-  geom_text(aes(label=n), nudge_y=3) +
-  labs(x="Fuel effiiency (mpg)", y="Weight (tons)",
-       title="Seminal ggplot2 bar chart example",
-       subtitle="A plot that is only useful for demonstration purposes",
-       caption="Brought to you by the letter 'g'") +
-  theme_ipsum_tw(grid="Y") +
-  theme(axis.text.y=element_blank())
-# }
    -
    - +
    +

    Examples

    + 
    if (FALSE) {
+library(ggplot2)
+library(dplyr)
+
+# seminal scatterplot
+ggplot(mtcars, aes(mpg, wt)) +
+  geom_point() +
+  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'") +
+  theme_ipsum_rc()
+
+# seminal bar chart
+
+# note: make this font_rc on Windows
+update_geom_font_defaults(family=font_rc_light)
+
+count(mpg, class) %>%
+  ggplot(aes(class, n)) +
+  geom_col() +
+  geom_text(aes(label=n), nudge_y=3) +
+  labs(x="Fuel efficiency (mpg)", y="Weight (tons)",
+       title="Seminal ggplot2 bar chart example",
+       subtitle="A plot that is only useful for demonstration purposes",
+       caption="Brought to you by the letter 'g'") +
+  theme_ipsum_tw(grid="Y") +
+  theme(axis.text.y=element_blank())
+}
+
    +
    +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/reference/theme_tinyhand.html b/docs/reference/theme_tinyhand.html new file mode 100644 index 0000000..d09cc55 --- /dev/null +++ b/docs/reference/theme_tinyhand.html @@ -0,0 +1,171 @@ + +Something you should never use. — theme_tinyhand • hrbrthemes + + +
    +
    + + + +
    +
    +
    +

    Something you should never use.

    + Source: R/tinyhand.R + +
    + +
    +

    You should import_tinyhand() first and also install the fonts on your +system before trying to use this theme.

    +
    + +
    + 
    theme_tinyhand(
+  base_family = font_th,
+  base_size = 10.5,
+  plot_title_family = font_th,
+  plot_title_size = 18,
+  plot_title_face = "bold",
+  plot_title_margin = 10,
+  subtitle_family = font_th,
+  subtitle_size = 13,
+  subtitle_face = "plain",
+  subtitle_margin = 15,
+  strip_text_family = base_family,
+  strip_text_size = 12,
+  strip_text_face = "plain",
+  caption_family = font_th,
+  caption_size = 9,
+  caption_face = "plain",
+  caption_margin = 10,
+  axis_text_size = base_size,
+  axis_title_family = base_family,
+  axis_title_size = 9,
+  axis_title_face = "plain",
+  axis_title_just = "rt",
+  plot_margin = margin(30, 30, 30, 30),
+  grid_col = "#cccccc",
+  grid = TRUE,
+  axis_col = "#cccccc",
+  axis = FALSE,
+  ticks = FALSE
+)
    +
    + +
    +

    Arguments

    +
    base_family, base_size
    +

    base font family and size

    +
    plot_title_family, plot_title_face, plot_title_size, plot_title_margin
    +

    plot title family, face, size and margin

    +
    subtitle_family, subtitle_face, subtitle_size
    +

    plot subtitle family, face and size

    +
    subtitle_margin
    +

    plot subtitle margin bottom (single numeric value)

    +
    strip_text_family, strip_text_face, strip_text_size
    +

    facet label font family, face and size

    +
    caption_family, caption_face, caption_size, caption_margin
    +

    plot caption family, face, size and margin

    +
    axis_text_size
    +

    font size of axis text

    +
    axis_title_family, axis_title_face, axis_title_size
    +

    axis title font family, face and size

    +
    axis_title_just
    +

    axis title font justification; one of [blmcrt]

    +
    plot_margin
    +

    plot margin (specify with ggplot2::margin)

    +
    grid_col
    +

    grid color

    +
    grid
    +

    panel grid (TRUE, FALSE, or a combination of X, x, Y, y)

    +
    axis_col
    +

    axis color

    +
    axis
    +

    add x or y axes? TRUE, FALSE, "xy"

    +
    ticks
    +

    ticks if TRUE add ticks

    +
    +
    +

    Details

    +

    There is an option hrbrthemes.loadfonts which -- if set to TRUE -- will +call extrafont::loadfonts() to register non-core fonts with R PDF & PostScript +devices. If you are running under Windows, the package calls the same function +to register non-core fonts with the Windows graphics device.

    +
    +
    +

    Why Titillium Web?

    + + +

    It's free, has tolerable kerning pairs and multiple weights. It's also different +than Arial Narrow and the fonts most folks use in ggplot2 charts.

    +
    + +
    + +
    + + +
    +

    Developed by Bob Rudis.

    +
    + +
    +

    Site built with pkgdown 2.0.2.9000.

    +
    + +
    + + + + + + + + diff --git a/docs/reference/update_geom_font_defaults.html b/docs/reference/update_geom_font_defaults.html index dd7edb7..955f557 100644 --- a/docs/reference/update_geom_font_defaults.html +++ b/docs/reference/update_geom_font_defaults.html @@ -1,58 +1,12 @@ - - - - - - - -Update matching font defaults for text geoms — update_geom_font_defaults • hrbrthemes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Update matching font defaults for text geoms — update_geom_font_defaults • hrbrthemes - - - + + -
    -
    - -
    -
    +

    Update matching font defaults for text geoms

    - Source: R/theme-ipsum.r + Source: R/theme-ipsum.r
    -

    Updates [ggplot2::geom_label] and [ggplot2::geom_text] font defaults

    -
    - 
    update_geom_font_defaults(family = "Arial Narrow", face = "plain",
-  size = 3.5, color = "#2b2b2b")
    - -

    Arguments

    - - - - - - -
    family, face, size, color

    font family name, face, size and color

    - +
    + 
    update_geom_font_defaults(
+  family = "Arial Narrow",
+  face = "plain",
+  size = 3.5,
+  color = "#2b2b2b"
+)
    +
    -
    - +
    -
    -
    -

    Developed by Bob Rudis.

    + +
    +

    Developed by Bob Rudis.

    -

    Site built with pkgdown 1.2.0.

    +

    Site built with pkgdown 2.0.2.9000.

    -
    -
    + +
    + + + - - + diff --git a/docs/sitemap.xml b/docs/sitemap.xml new file mode 100644 index 0000000..dd66701 --- /dev/null +++ b/docs/sitemap.xml @@ -0,0 +1,153 @@ + + + + https://cinc.rud.is/web/packages/hrbrthemes/404.html + + + https://cinc.rud.is/web/packages/hrbrthemes/CONDUCT.html + + + https://cinc.rud.is/web/packages/hrbrthemes/LICENSE-text.html + + + https://cinc.rud.is/web/packages/hrbrthemes/articles/index.html + + + https://cinc.rud.is/web/packages/hrbrthemes/articles/why_hrbrthemes.html + + + https://cinc.rud.is/web/packages/hrbrthemes/authors.html + + + https://cinc.rud.is/web/packages/hrbrthemes/index.html + + + https://cinc.rud.is/web/packages/hrbrthemes/news/index.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ArialNarrow.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/EconSansCondensed.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/GoldmanSans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/Inter.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/PlexSans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/PublicSans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/RobotoCondensed.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/TinyHand.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/TitilliumWeb.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/flush_ticks.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ft_cols.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ft_geom_defaults.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ft_pal.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/gg_check.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/hrbrthemes-exports.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/hrbrthemes.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_econ_sans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_goldman_sans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_inter.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_plex_sans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_public_sans.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_roboto_condensed.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_tinyhand.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/import_titillium_web.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/index.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ipsum.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ipsum_pal.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/ipsum_pdf.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/modern_geom_defaults.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/scale_ft.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/scale_ipsum.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/scale_x_percent.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_es.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_gs.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_inter.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_ps.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_pub.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_rc.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_ipsum_tw.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/theme_tinyhand.html + + + https://cinc.rud.is/web/packages/hrbrthemes/reference/update_geom_font_defaults.html + + diff --git a/man/flush_ticks.Rd b/man/flush_ticks.Rd index 0c994e3..c0fcfbc 100644 --- a/man/flush_ticks.Rd +++ b/man/flush_ticks.Rd @@ -19,12 +19,12 @@ flush_ticks(gg, flush = "XY", plot = TRUE, cat = TRUE) ggplot2 object with \code{theme()} elements added } \description{ -A covenience function intended for basic, fixed-scale plots only (i.e. does not handle +A convenience function intended for basic, fixed-scale plots only (i.e. does not handle free scales in facets).\cr \cr You need to pass in a ggplot2 object to this function. It can't be \code{+}'d in a chain of geoms, coords, scales, themes, etc. It also builds the plot (but does not display -it) so if the plt takes a while (i.e. has lots of data or transforms) this will also +it) so if the plot takes a while (i.e. has lots of data or transforms) this will also take a while. } \note{ diff --git a/man/ipsum.Rd b/man/ipsum.Rd index b15c676..9d42d3e 100644 --- a/man/ipsum.Rd +++ b/man/ipsum.Rd @@ -44,6 +44,8 @@ outputting HTML directly into the markdown document).} \item{dev}{Graphics device to use for figure output (defaults to png)} +\item{smart}{Deprecated} + \item{self_contained}{Produce a standalone HTML file with no external dependencies, using data: URIs to incorporate the contents of linked scripts, stylesheets, images, and videos. Note that even for self contained @@ -62,7 +64,10 @@ copied into the output directory). You can pass an alternate URL or pass \item{extra_dependencies, ...}{Additional function arguments to pass to the base R Markdown HTML output formatter} -\item{css}{One or more css files to include} +\item{css}{CSS and/or Sass files to include. Files with an extension of .sass +or .scss are compiled to CSS via \code{sass::sass()}. Also, if \code{theme} is a +\code{\link[bslib:bs_theme]{bslib::bs_theme()}} object, Sass code may reference the relevant Bootstrap +Sass variables, functions, mixins, etc.} \item{includes}{Named list of additional content to include within the document (typically created using the \code{\link[rmarkdown]{includes}} function).} diff --git a/man/scale_ft.Rd b/man/scale_ft.Rd index 76d2590..fae8610 100644 --- a/man/scale_ft.Rd +++ b/man/scale_ft.Rd @@ -32,7 +32,8 @@ omitted.} \item \code{waiver()} for the default breaks (the scale limits) \item A character vector of breaks \item A function that takes the limits as input and returns breaks -as output +as output. Also accepts rlang \link[rlang:as_function]{lambda} function +notation. }} \item{\code{labels}}{One of: \itemize{ @@ -41,7 +42,8 @@ as output transformation object \item A character vector giving labels (must be same length as \code{breaks}) \item A function that takes the breaks as input and returns labels -as output +as output. Also accepts rlang \link[rlang:as_function]{lambda} function +notation. }} \item{\code{limits}}{One of: \itemize{ @@ -49,7 +51,8 @@ as output \item A character vector that defines possible values of the scale and their order \item A function that accepts the existing (automatic) values and returns -new ones +new ones. Also accepts rlang \link[rlang:as_function]{lambda} function +notation. }} \item{\code{na.translate}}{Unlike continuous scales, discrete scales can easily show missing values, and do so by default. If you want to remove missing values diff --git a/man/scale_ipsum.Rd b/man/scale_ipsum.Rd index e9f133a..87882a2 100644 --- a/man/scale_ipsum.Rd +++ b/man/scale_ipsum.Rd @@ -32,7 +32,8 @@ omitted.} \item \code{waiver()} for the default breaks (the scale limits) \item A character vector of breaks \item A function that takes the limits as input and returns breaks -as output +as output. Also accepts rlang \link[rlang:as_function]{lambda} function +notation. }} \item{\code{labels}}{One of: \itemize{ @@ -41,7 +42,8 @@ as output transformation object \item A character vector giving labels (must be same length as \code{breaks}) \item A function that takes the breaks as input and returns labels -as output +as output. Also accepts rlang \link[rlang:as_function]{lambda} function +notation. }} \item{\code{limits}}{One of: \itemize{ @@ -49,7 +51,8 @@ as output \item A character vector that defines possible values of the scale and their order \item A function that accepts the existing (automatic) values and returns -new ones +new ones. Also accepts rlang \link[rlang:as_function]{lambda} function +notation. }} \item{\code{na.translate}}{Unlike continuous scales, discrete scales can easily show missing values, and do so by default. If you want to remove missing values diff --git a/man/scale_x_percent.Rd b/man/scale_x_percent.Rd index 0682224..de8a8fe 100644 --- a/man/scale_x_percent.Rd +++ b/man/scale_x_percent.Rd @@ -5,7 +5,7 @@ \alias{scale_y_percent} \alias{scale_x_comma} \alias{scale_y_comma} -\title{X & Y scales with opinionated pre-sets for percent & comma label formats} +\title{X & Y scales with opinionated presets for percent & comma label formats} \usage{ scale_x_percent( name = waiver(), @@ -168,5 +168,5 @@ scales, "top" or "bottom" for horizontal scales} The \verb{_comma} ones set comma format for axis text and \code{expand=c(0,0)} (you need to set limits). } \details{ -The \verb{_percent} ones set precent format for axis text and \code{expand=c(0,0)} (you need to set limits). +The \verb{_percent} ones set percent format for axis text and \code{expand=c(0,0)} (you need to set limits). } diff --git a/man/theme_ipsum_es.Rd b/man/theme_ipsum_es.Rd index 678879e..4eef021 100644 --- a/man/theme_ipsum_es.Rd +++ b/man/theme_ipsum_es.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/econ-sans.R \name{theme_ipsum_es} \alias{theme_ipsum_es} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ipsum_es( base_family = "EconSansCndReg", @@ -41,7 +41,7 @@ theme_ipsum_es( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -55,7 +55,7 @@ theme_ipsum_es( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_ipsum_gs.Rd b/man/theme_ipsum_gs.Rd index c82377b..f9b1ccb 100644 --- a/man/theme_ipsum_gs.Rd +++ b/man/theme_ipsum_gs.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/goldmansans.R \name{theme_ipsum_gs} \alias{theme_ipsum_gs} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ipsum_gs( base_family = "Goldman Sans Condensed", @@ -40,7 +40,7 @@ theme_ipsum_gs( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -54,7 +54,7 @@ theme_ipsum_gs( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_ipsum_inter.Rd b/man/theme_ipsum_inter.Rd index e406657..c3e1691 100644 --- a/man/theme_ipsum_inter.Rd +++ b/man/theme_ipsum_inter.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/inter.R \name{theme_ipsum_inter} \alias{theme_ipsum_inter} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ipsum_inter( base_family = "Inter-Medium", @@ -40,7 +40,7 @@ theme_ipsum_inter( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -50,11 +50,11 @@ theme_ipsum_inter( \item{caption_family, caption_face, caption_size, caption_margin}{plot caption family, face, size and margin} -\item{axis_text_size}{font size of axis text} +\item{axis_text_family, axis_text_face, axis_text_size}{axis text font family, face, and size} \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_ipsum_ps.Rd b/man/theme_ipsum_ps.Rd index 3f77056..4ee5f2f 100644 --- a/man/theme_ipsum_ps.Rd +++ b/man/theme_ipsum_ps.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/plexsans.R \name{theme_ipsum_ps} \alias{theme_ipsum_ps} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ipsum_ps( base_family = "IBMPlexSans", @@ -40,7 +40,7 @@ theme_ipsum_ps( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -54,7 +54,7 @@ theme_ipsum_ps( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_ipsum_pub.Rd b/man/theme_ipsum_pub.Rd index 4bcfa97..83e6011 100644 --- a/man/theme_ipsum_pub.Rd +++ b/man/theme_ipsum_pub.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/public-sans.R \name{theme_ipsum_pub} \alias{theme_ipsum_pub} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ipsum_pub( base_family = "Public Sans", @@ -41,7 +41,7 @@ theme_ipsum_pub( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -55,7 +55,7 @@ theme_ipsum_pub( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_ipsum_rc.Rd b/man/theme_ipsum_rc.Rd index 282c0ce..e812885 100644 --- a/man/theme_ipsum_rc.Rd +++ b/man/theme_ipsum_rc.Rd @@ -4,7 +4,7 @@ \alias{theme_ft_rc} \alias{theme_modern_rc} \alias{theme_ipsum_rc} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ft_rc( base_family = "Roboto Condensed", @@ -105,7 +105,7 @@ theme_ipsum_rc( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -119,7 +119,7 @@ theme_ipsum_rc( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_ipsum_tw.Rd b/man/theme_ipsum_tw.Rd index 6dd7566..9287ba6 100644 --- a/man/theme_ipsum_tw.Rd +++ b/man/theme_ipsum_tw.Rd @@ -2,7 +2,7 @@ % Please edit documentation in R/titillium-web.R \name{theme_ipsum_tw} \alias{theme_ipsum_tw} -\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typoghraphy} +\title{A precise & pristine \link{ggplot2} theme with opinionated defaults and an emphasis on typography} \usage{ theme_ipsum_tw( base_family = "Titillium Web", @@ -41,7 +41,7 @@ theme_ipsum_tw( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -55,7 +55,7 @@ theme_ipsum_tw( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/man/theme_tinyhand.Rd b/man/theme_tinyhand.Rd index 7445091..33b0b34 100644 --- a/man/theme_tinyhand.Rd +++ b/man/theme_tinyhand.Rd @@ -38,7 +38,7 @@ theme_tinyhand( \arguments{ \item{base_family, base_size}{base font family and size} -\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot tilte family, face, size and margin} +\item{plot_title_family, plot_title_face, plot_title_size, plot_title_margin}{plot title family, face, size and margin} \item{subtitle_family, subtitle_face, subtitle_size}{plot subtitle family, face and size} @@ -52,7 +52,7 @@ theme_tinyhand( \item{axis_title_family, axis_title_face, axis_title_size}{axis title font family, face and size} -\item{axis_title_just}{axis title font justificationk one of \verb{[blmcrt]}} +\item{axis_title_just}{axis title font justification; one of \verb{[blmcrt]}} \item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} diff --git a/vignettes/why_hrbrthemes.R b/vignettes/why_hrbrthemes.R new file mode 100644 index 0000000..63ae293 --- /dev/null +++ b/vignettes/why_hrbrthemes.R @@ -0,0 +1,17 @@ +## ----echo=FALSE, fig.width=8-------------------------------------------------- +library(ggplot2) +library(gridExtra) + +ggplot(mtcars, aes(wt, mpg)) + + geom_point() + + labs(x="Weight (tons)", y="Efficiency (MPG)", + title="Lorem ipsum dolor sit amet", + subtitle="Mauris ultricies sem volutpat magna venenatis") -> gg + +grid.arrange( + gg + theme_minimal(base_family="serif") + theme(plot.margin=margin(t=20, b=20, l=15, r=30)), + gg + theme_minimal(base_family="sans") + theme(plot.margin=margin(t=20, b=20, l=30, r=15)), + ncol=2 +) + + diff --git a/vignettes/why_hrbrthemes.Rmd b/vignettes/why_hrbrthemes.Rmd index f5dc3ab..053d290 100644 --- a/vignettes/why_hrbrthemes.Rmd +++ b/vignettes/why_hrbrthemes.Rmd @@ -81,7 +81,7 @@ Proportional digits stand out (in a "yes, I just spilled sriracha on my white sh ### Clean and compact -The figure used in the previous section provided an example of condensed/narrow fonts and regular. Chart space is at a premium and it's important to label and annotate your creations (sparingly but sufficiently). Choosing a font that is too wide will reduce your available space and also make it harder to read the text. Choosing a font that is too narrow/compressed/condensed will create different legiibility problems. +The figure used in the previous section provided an example of condensed/narrow fonts and regular. Chart space is at a premium and it's important to label and annotate your creations (sparingly but sufficiently). Choosing a font that is too wide will reduce your available space and also make it harder to read the text. Choosing a font that is too narrow/compressed/condensed will create different legibility problems. NOTE: It's _really_ hard to find a **free** condensed/narrow font with great kerning pairs and tabular digits. Such is the way of things. @@ -106,7 +106,7 @@ There is plenty of room to work with in Open Sans. You can embolden the title, b ### TTF. Meh. -I'll use another over-simplification and state that there two main font types: OTF and TTF (it's another lie of convenience). OTF (OpenType) is more modern and flexible. TTF (TrueType) has been around longer and was a precursor to OTF. If you make PDFs or PostScript files from R you pretty much _need_ to use TTF fonts due to the underlying tooling that it relies on. If you are making PNGs or SVGs you can likely use OTF but most communciations teams and publications want PDFs. +I'll use another over-simplification and state that there two main font types: OTF and TTF (it's another lie of convenience). OTF (OpenType) is more modern and flexible. TTF (TrueType) has been around longer and was a precursor to OTF. If you make PDFs or PostScript files from R you pretty much _need_ to use TTF fonts due to the underlying tooling that it relies on. If you are making PNGs or SVGs you can likely use OTF but most communications teams and publications want PDFs. ## Spacing Out diff --git a/vignettes/why_hrbrthemes.html b/vignettes/why_hrbrthemes.html new file mode 100644 index 0000000..404b0d9 --- /dev/null +++ b/vignettes/why_hrbrthemes.html @@ -0,0 +1,341 @@ + + + + + + + + + + + + + + + + +Why hrbrthemes? + + + + + + + + + + + + + + + + + + + + + + +

    Why hrbrthemes?

    +

    Bob Rudis

    +

    2022-02-11

    + + + + +

    The hrbrthemes package has two goals. First, it provides a base theme that focuses on typographic elements, including where various labels are placed as well as the fonts that are used. The second goal centers around productivity for a production workflow. In fact, this “production workflow” is the context for where the elements of hrbrthemes should be used.

    +

    A “production workflow” is when you intend for the output of your work to be put into a publication of some kind, whether it be a blog post, academic paper, presentation, internal report or industry publication. When you’re cranking through an analysis, the visual elements don’t need to be perfect. They are there to validate/support your work and are more of a starting point for the finished product than anything else. The level of attention to detail on the final graphical products can be a great motivator for your audience to either dive deep into your analysis text or relegate it to the TLDR pile.

    +
    +

    Font Fundamentals

    +

    There are nigh countless tomes written about the colors you should consider using in charts as well as how to produce “minimal” charts (i.e. eliminate “chart junk”). One area that is rarely discussed is the use of fonts in charts (i.e. chart typography). The hrbrthemes package is very opinionated about chart typography:

    +
      +
    • The font family used should be sans-serif typeface
      • +
    • The font family used should have an awesome, default kern[ing] table
      • +
    • The font family used should have tabular figures (digits) vs proportional ones
      • +
    • The font family used should be a condensed or narrow typeface
      • +
    • Ideally, the font family used will have 100, 300, 500, 700 and 900 weights vs regular, bold, italic and bold italic
      • +
    • Because we’re working in ggplot2-land, the font family used should also be a TrueType font (TTF)
      • +
    +
    +

    Why sans-serif?

    +

    To use a gross oversimplification, there are two basic font types: Serif and Sans-serif (that’s a lie of convenience, there are more than two). hrbrthemes suggests using sans-serif fonts since they have a more “modern” feel to them, you’re not producing long-form text and labels on charts may need to scale down to small sizes. Typography nerds on either side of the serif vs sans-serif debate can point to 100+ years of research-based evidence supporting their particular “side”.

    +

    You can compare the typography in the two (non-hrbrthemes) charts below to see if you prefer sans-serif over serif:

    +

    +

    If you work in a company, your communications department likely has a set of core brand fonts and said font groups likely contain both serif and sans-serif and you should strive to keep with the brand image and use whatever font(s) work best or work with your comms team to pick a standard, complementary font for the charts you produce.

    +
    +
    +

    Kern-what?

    +

    Kerning is nothing more than a fancy word for spaces between letters and fonts have built-in tables for how various pairs of letters should be placed next to each other. Great fonts have kerning tables that typography nerds immediately recognize and adore. Fonts with poor kerning tables are easily recognized as such by even the least font-aware viewer.

    +
    +


    +https://www.xkcd.com/1015/

    +
    +

    Bad kerning will be a distraction from the chart contents. Great kerning will be a subconscious reinforcement of just how awesome your visualizations are.

    +
    +
    +

    Tabula Figura

    +

    Tabular digits line up when placed on top of each other. Proportional ones do not. This is best explained visually:

    +
    +

    +
    +

    Can you spot the proportional digits from the tabular ones? (Hint: there are two of each.)

    +

    Proportional digits stand out (in a “yes, I just spilled sriracha on my white shirt” way) when used on the Y axis of a chart and the numeric labels contain numbers of varying widths (like Hind and Encode Sans Condensed in the example above). Using proportional digits will be one further, subtle, subliminal message to viewers that there is something not-quite-awesome about your creation.

    +
    +
    +

    Clean and compact

    +

    The figure used in the previous section provided an example of condensed/narrow fonts and regular. Chart space is at a premium and it’s important to label and annotate your creations (sparingly but sufficiently). Choosing a font that is too wide will reduce your available space and also make it harder to read the text. Choosing a font that is too narrow/compressed/condensed will create different legibility problems.

    +

    NOTE: It’s really hard to find a free condensed/narrow font with great kerning pairs and tabular digits. Such is the way of things.

    +

    (As an aside, the default line-height for Hind and M+ 1c is also sub-optimal and would require tweaking in ggplot2 calls to correct.)

    +
    +
    +

    Weight. What?

    +

    Most fonts (and, more importantly, most free fonts) come in regular, italic, bold and bold italic (which I can’t bring myself to code in here). You really want to avoid italic and bold italic, especially at very small or very large sizes. Bold should be used sparingly as it draws the eye to that text.

    +

    Ideally, you’d use a font with a broad diversity of weights. The term weight can be though of as a numeric scale (the one used here was introduced by TrueType) between 100 and 900 (usually at 100 or 200 increments) or with names ranging from “hairline” through “ultra-black”.

    +

    Take Open Sans, for example:

    +
    +

    +
    +

    There is plenty of room to work with in Open Sans. You can embolden the title, but mute the other labels and choose appropriate label fonts to both enhance style as well as reduce importance. Lighter weights are great for captions and even some direct annotations. Heaver weights should be used sparingly and for emphasis.

    +
    +
    +

    TTF. Meh.

    +

    I’ll use another over-simplification and state that there two main font types: OTF and TTF (it’s another lie of convenience). OTF (OpenType) is more modern and flexible. TTF (TrueType) has been around longer and was a precursor to OTF. If you make PDFs or PostScript files from R you pretty much need to use TTF fonts due to the underlying tooling that it relies on. If you are making PNGs or SVGs you can likely use OTF but most communications teams and publications want PDFs.

    +
    +
    +
    +

    Spacing Out

    +

    Label/title placement is also important, as is the distance between those elements. Put text bits too close to each other or too far apart from each other will send negative subliminal messages. Centering vs left- or right-justification will also convey other messages (old-school vs modern, to put it somewhat bluntly).

    +

    hrbrthemes makes opinionated choices over the spacing between title elements and all labels. For some elements, it makes very new choices (such as the justification of the axis labels).

    +

    The font choices you make may cause you to adjust the hrbrthemes defaults, especially if you choose a font with a wonky line-height.

    +
    + + + + + + + + + + +