😎 Give your xaringan slides some style
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.

113 lines
4.0KB

  1. % Generated by roxygen2: do not edit by hand
  2. % Please edit documentation in R/ggplot2.R
  3. \name{theme_xaringan_inverse}
  4. \alias{theme_xaringan_inverse}
  5. \title{An Inverse Plot Theme for ggplot2 by xaringanthemer}
  6. \usage{
  7. theme_xaringan_inverse(
  8. text_color = NULL,
  9. background_color = NULL,
  10. accent_color = NULL,
  11. accent_secondary_color = NULL,
  12. css_file = NULL,
  13. set_ggplot_defaults = TRUE,
  14. text_font = NULL,
  15. text_font_use_google = NULL,
  16. text_font_size = NULL,
  17. title_font = NULL,
  18. title_font_use_google = NULL,
  19. title_font_size = NULL,
  20. use_showtext = TRUE
  21. )
  22. }
  23. \arguments{
  24. \item{text_color}{Color for text and foreground, inherits from \code{text_color}}
  25. \item{background_color}{Color for background, inherits from
  26. \code{background_color}}
  27. \item{accent_color}{Color for titles and accents, inherits from
  28. \code{header_color}}
  29. \item{accent_secondary_color}{Color for secondary accents, inherits from
  30. \code{text_bold_color}}
  31. \item{css_file}{Path to a \pkg{xaringanthemer} CSS file, from which the
  32. theme variables and values will be inferred. In general, if you use the
  33. \pkg{xaringathemer} defaults, you will not need to set this. This feature
  34. lets you create a \pkg{ggplot2} theme for your \pkg{xaringan} slides, even
  35. if you have only saved your theme CSS file and you aren't creating your
  36. CSS theme with \pkg{xaringanthemer} in your slides' source file.}
  37. \item{set_ggplot_defaults}{Should defaults be set for \pkg{ggplot2} \emph{geoms}?
  38. Defaults to TRUE. To restore ggplot's defaults, or the previously set geom
  39. defaults, see \code{\link[=theme_xaringan_restore_defaults]{theme_xaringan_restore_defaults()}}.}
  40. \item{text_font}{Font to use for text elements, passed to
  41. \code{\link[sysfonts:font_add_google]{sysfonts::font_add_google()}}, if available and \code{text_font_use_google} is
  42. \code{TRUE}. Inherits from \code{text_font_family}.}
  43. \item{text_font_use_google}{Is \code{text_font} available on \href{https://fonts.google.com}{Google Fonts}?}
  44. \item{text_font_size}{Base text font size, inherits from \code{text_font_size}, or
  45. defaults to 11.}
  46. \item{title_font}{Font to use for title elements, passed to
  47. \code{\link[sysfonts:font_add_google]{sysfonts::font_add_google()}}, if available and \code{title_font_use_google} is
  48. \code{TRUE}. Inherits from \code{title_font_family}.}
  49. \item{title_font_use_google}{Is \code{title_font} available on \href{https://fonts.google.com}{Google Fonts}?}
  50. \item{title_font_size}{Base text font size, inherits from \code{title_font_size},
  51. or defaults to 14.}
  52. \item{use_showtext}{If \code{TRUE} (default) the \pkg{showtext} package will be
  53. used to register Google fonts. Set to \code{FALSE} to disable this feature
  54. entirely, which may result in errors during plotting if the fonts used are
  55. not available locally.}
  56. }
  57. \value{
  58. A ggplot2 theme
  59. }
  60. \description{
  61. \strong{Lifecycle:} \href{https://www.tidyverse.org/lifecycle/#maturing}{Maturing}
  62. A \pkg{ggplot2} xaringanthemer plot theme to seamlessly match the "inverse"
  63. \pkg{xaringan} slide colors and styles as styled by \link{xaringanthemer}.
  64. }
  65. \examples{
  66. # Requires ggplot2
  67. has_ggplot2 <- requireNamespace("ggplot2", quietly = TRUE)
  68. if (has_ggplot2) {
  69. # Because this is an example, we'll save the CSS to a temp file
  70. path_to_css_file <- tempfile(fileext = ".css")
  71. # Create the xaringan theme: dark blue background with teal green accents
  72. style_duo(
  73. primary_color = "#002b36",
  74. secondary_color = "#31b09e",
  75. # Using basic fonts for this example, but the plot theme will
  76. # automatically use your theme font if you use Google fonts
  77. text_font_family = "sans",
  78. header_font_family = "serif",
  79. outfile = path_to_css_file
  80. )
  81. library(ggplot2)
  82. ggplot(iris) +
  83. aes(Petal.Length, Petal.Width) +
  84. geom_point() +
  85. ggtitle("Yet another Iris plot") +
  86. # themed to match the inverse slides: teal background with dark blue text
  87. theme_xaringan_inverse()
  88. }
  89. }
  90. \seealso{
  91. Other xaringanthemer ggplot2 themes:
  92. \code{\link{theme_xaringan_base}()},
  93. \code{\link{theme_xaringan_set_defaults}()},
  94. \code{\link{theme_xaringan}()}
  95. }
  96. \concept{xaringanthemer ggplot2 themes}