diff --git a/DESCRIPTION b/DESCRIPTION index 6b93265..070250a 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -34,6 +34,7 @@ BugReports: https://github.com/hrbrmstr/hrbrthemes/issues Copyright: file inst/COPYRIGHTS License: MIT + file LICENSE Encoding: UTF-8 +Language: en-US Suggests: testthat, dplyr, @@ -58,5 +59,5 @@ Imports: tools, magrittr, gdtools -RoxygenNote: 7.1.0 +RoxygenNote: 7.1.1 VignetteBuilder: knitr diff --git a/R/econ-sans.R b/R/econ-sans.R index b2b3fb5..05aca54 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 5e53bde..125da19 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/plexsans.R b/R/plexsans.R index babc46c..b87a93e 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 ec83767..41b1058 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 fcff8dc..0fde8d9 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..3955aeb 100644 --- a/R/scales.r +++ b/R/scales.r @@ -7,7 +7,7 @@ is.formula <- function (x) { inherits(x, "formula") } #' #' 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/theme-ipsum.r b/R/theme-ipsum.r index a88fc83..cd4b4dc 100644 --- a/R/theme-ipsum.r +++ b/R/theme-ipsum.r @@ -27,7 +27,7 @@ #' #' @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 title family, face, size and margi +#' @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 diff --git a/R/tinyhand.R b/R/tinyhand.R index 7cb6049..bef63cc 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 fb3bec0..ea31d8c 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..d60e498 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) 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/docs/articles/why_hrbrthemes.html b/docs/articles/why_hrbrthemes.html index e112614..156d921 100644 --- a/docs/articles/why_hrbrthemes.html +++ b/docs/articles/why_hrbrthemes.html @@ -137,7 +137,7 @@

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.

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

@@ -155,7 +155,7 @@

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.

diff --git a/docs/index.html b/docs/index.html index d615dc2..044b251 100644 --- a/docs/index.html +++ b/docs/index.html @@ -95,17 +95,17 @@

Themes:

  • -theme_ft_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
    • +theme_ft_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography
  • theme_ipsum: 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
    • +theme_ipsum_ps: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography
  • -theme_ipsum_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
    • +theme_ipsum_rc: 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
    • +theme_ipsum_tw: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography
  • -theme_modern_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy
    • +theme_modern_rc: A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typography

Scales (that align with various themes):

    diff --git a/docs/reference/flush_ticks.html b/docs/reference/flush_ticks.html index 7c64bc5..84d6606 100644 --- a/docs/reference/flush_ticks.html +++ b/docs/reference/flush_ticks.html @@ -32,12 +32,12 @@ - @@ -127,12 +127,12 @@

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

    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.

    diff --git a/docs/reference/index.html b/docs/reference/index.html index 1833a7e..87c5d48 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -260,19 +260,19 @@

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

    diff --git a/docs/reference/scale_x_percent.html b/docs/reference/scale_x_percent.html index fc6ea6a..bfa5357 100644 --- a/docs/reference/scale_x_percent.html +++ b/docs/reference/scale_x_percent.html @@ -227,7 +227,7 @@

    Arg

    Details

    -

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

diff --git a/docs/reference/theme_ipsum_ps.html b/docs/reference/theme_ipsum_ps.html index 653ea3c..32021a6 100644 --- a/docs/reference/theme_ipsum_ps.html +++ b/docs/reference/theme_ipsum_ps.html @@ -6,7 +6,7 @@ -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 @@ -30,7 +30,7 @@ - + @@ -115,7 +115,7 @@
-

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

Source: R/plexsans.R
@@ -151,7 +151,7 @@

Arg plot_title_family, plot_title_face, plot_title_size, plot_title_margin -

plot tilte family, face, size and margin

+

plot title family, face, size and margin

subtitle_family, subtitle_face, subtitle_size @@ -179,7 +179,7 @@

Arg axis_title_just -

axis title font justificationk one of [blmcrt]

+

axis title font justification one of [blmcrt]

plot_margin diff --git a/docs/reference/theme_ipsum_rc.html b/docs/reference/theme_ipsum_rc.html index c457a9a..f111bdd 100644 --- a/docs/reference/theme_ipsum_rc.html +++ b/docs/reference/theme_ipsum_rc.html @@ -6,7 +6,7 @@ -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 @@ -30,7 +30,7 @@ - + @@ -115,7 +115,7 @@
-

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

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

Arg plot_title_family, plot_title_face, plot_title_size, plot_title_margin -

plot tilte family, face, size and margin

+

plot title family, face, size and margin

subtitle_family, subtitle_face, subtitle_size @@ -210,7 +210,7 @@

Arg axis_title_just -

axis title font justificationk one of [blmcrt]

+

axis title font justification one of [blmcrt]

plot_margin diff --git a/docs/reference/theme_ipsum_tw.html b/docs/reference/theme_ipsum_tw.html index 74dfd22..0df424a 100644 --- a/docs/reference/theme_ipsum_tw.html +++ b/docs/reference/theme_ipsum_tw.html @@ -6,7 +6,7 @@ -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 @@ -30,7 +30,7 @@ - + @@ -115,7 +115,7 @@
-

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

Source: R/titillium-web.R
@@ -153,7 +153,7 @@

Arg plot_title_family, plot_title_face, plot_title_size, plot_title_margin -

plot tilte family, face, size and margin

+

plot title family, face, size and margin

subtitle_family, subtitle_face, subtitle_size @@ -181,7 +181,7 @@

Arg axis_title_just -

axis title font justificationk one of [blmcrt]

+

axis title font justification one of [blmcrt]

plot_margin diff --git a/inst/WORDLIST b/inst/WORDLIST new file mode 100644 index 0000000..4e044bb --- /dev/null +++ b/inst/WORDLIST @@ -0,0 +1,61 @@ +Arial +Impallari +OpenType +Plex +PlexSans +roboto +Roboto +Tabula +TinyHand +Titillium +TrueType + +asn +atanh +boxcox +CDN +centric +comms +coords +cran +css +DOI +Figura +geoms +ggplot +github +https +hunspell +ing +ipsum +ish +jquery +kate +kern +kerning +Kerning +LoC +magrittr +MathJax +mathjax +OTF +pandoc +params +png +pre +pts +pygments +rc +remotes +Rmd +RStudio +rud +SIL +stylesheets +textmate +TLDR +TOC +TTF +URIs +uswds +zenburn 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/gg_check.Rd b/man/gg_check.Rd index 568f019..c864272 100644 --- a/man/gg_check.Rd +++ b/man/gg_check.Rd @@ -9,7 +9,7 @@ gg_check(gg, dict, ignore) \arguments{ \item{gg}{ggplot2 object} -\item{dict}{a dictionary object or string which can be passed to \link[hunspell:dictionary]{hunspell::dictionary}. +\item{dict}{a dictionary object or string which can be passed to \link[hunspell:hunspell]{hunspell::dictionary}. Defaults to \code{hunspell::dictionary("en_US")}} \item{ignore}{character vector with additional approved words added to the dictionary. diff --git a/man/ipsum.Rd b/man/ipsum.Rd index c72c9de..b15c676 100644 --- a/man/ipsum.Rd +++ b/man/ipsum.Rd @@ -44,10 +44,6 @@ outputting HTML directly into the markdown document).} \item{dev}{Graphics device to use for figure output (defaults to png)} -\item{smart}{Produce typographically correct output, converting straight -quotes to curly quotes, \code{---} to em-dashes, \code{--} to en-dashes, and -\code{...} to ellipses.} - \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 diff --git a/man/scale_ft.Rd b/man/scale_ft.Rd index b5765ed..76d2590 100644 --- a/man/scale_ft.Rd +++ b/man/scale_ft.Rd @@ -43,13 +43,19 @@ transformation object \item A function that takes the breaks as input and returns labels as output }} - \item{\code{limits}}{A character vector that defines possible values of the scale -and their order.} + \item{\code{limits}}{One of: +\itemize{ +\item \code{NULL} to use the default scale values +\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 +}} \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 from a discrete scale, specify \code{na.translate = FALSE}.} - \item{\code{na.value}}{If \code{na.translate = TRUE}, what value aesthetic -value should missing be displayed as? Does not apply to position scales + \item{\code{na.value}}{If \code{na.translate = TRUE}, what aesthetic value should the +missing values be displayed as? Does not apply to position scales where \code{NA} is always placed at the far right.} \item{\code{drop}}{Should unused factor levels be omitted from the scale? The default, \code{TRUE}, uses the levels that appear in the data; diff --git a/man/scale_ipsum.Rd b/man/scale_ipsum.Rd index 4fbf3ee..e9f133a 100644 --- a/man/scale_ipsum.Rd +++ b/man/scale_ipsum.Rd @@ -43,13 +43,19 @@ transformation object \item A function that takes the breaks as input and returns labels as output }} - \item{\code{limits}}{A character vector that defines possible values of the scale -and their order.} + \item{\code{limits}}{One of: +\itemize{ +\item \code{NULL} to use the default scale values +\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 +}} \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 from a discrete scale, specify \code{na.translate = FALSE}.} - \item{\code{na.value}}{If \code{na.translate = TRUE}, what value aesthetic -value should missing be displayed as? Does not apply to position scales + \item{\code{na.value}}{If \code{na.translate = TRUE}, what aesthetic value should the +missing values be displayed as? Does not apply to position scales where \code{NA} is always placed at the far right.} \item{\code{drop}}{Should unused factor levels be omitted from the scale? The default, \code{TRUE}, uses the levels that appear in the data; diff --git a/man/scale_x_percent.Rd b/man/scale_x_percent.Rd index 0682224..67a0e87 100644 --- a/man/scale_x_percent.Rd +++ b/man/scale_x_percent.Rd @@ -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.Rd b/man/theme_ipsum.Rd index 26697b2..3fca22f 100644 --- a/man/theme_ipsum.Rd +++ b/man/theme_ipsum.Rd @@ -38,7 +38,7 @@ theme_ipsum( \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 title family, face, size and margi} +\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} diff --git a/man/theme_ipsum_es.Rd b/man/theme_ipsum_es.Rd index 08cdbc3..fac2a40 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,9 +55,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{panel_spacing}{panel spacing (use \code{unit()})} diff --git a/man/theme_ipsum_gs.Rd b/man/theme_ipsum_gs.Rd index a237301..43f1905 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,9 +54,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{grid_col}{grid color} diff --git a/man/theme_ipsum_ps.Rd b/man/theme_ipsum_ps.Rd index 63f2977..2af343f 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,9 +54,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{grid_col}{grid color} diff --git a/man/theme_ipsum_pub.Rd b/man/theme_ipsum_pub.Rd index 2774dac..199f95c 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,9 +55,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{grid_col}{grid color} diff --git a/man/theme_ipsum_rc.Rd b/man/theme_ipsum_rc.Rd index 0de04ba..99917fb 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,9 +119,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{grid}{panel grid (\code{TRUE}, \code{FALSE}, or a combination of \code{X}, \code{x}, \code{Y}, \code{y})} diff --git a/man/theme_ipsum_tw.Rd b/man/theme_ipsum_tw.Rd index 3734494..e51ad08 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,9 +55,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{grid_col}{grid color} diff --git a/man/theme_tinyhand.Rd b/man/theme_tinyhand.Rd index d5e7286..1aead0e 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,9 +52,9 @@ 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:margin]{ggplot2::margin})} +\item{plot_margin}{plot margin (specify with \link[ggplot2:element]{ggplot2::margin})} \item{grid_col}{grid color} 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