😎 Give your xaringan slides some style
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.

222 lines
18KB

  1. <!DOCTYPE html>
  2. <!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>An Inverse Plot Theme for ggplot2 by xaringanthemer — theme_xaringan_inverse • xaringanthemer</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/IBM_Plex_Mono-0.4.9/font.css" rel="stylesheet"><link href="../deps/Outfit-0.4.9/font.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><link href="../extra.css" rel="stylesheet"><meta property="og:title" content="An Inverse Plot Theme for ggplot2 by xaringanthemer — theme_xaringan_inverse"><meta name="description" content='
  3. A ggplot2 xaringanthemer plot theme to seamlessly match the "inverse"
  4. xaringan slide colors and styles as styled by xaringanthemer. See
  5. vignette("ggplot2-themes") for more information and examples.'><meta property="og:description" content='
  6. A ggplot2 xaringanthemer plot theme to seamlessly match the "inverse"
  7. xaringan slide colors and styles as styled by xaringanthemer. See
  8. vignette("ggplot2-themes") for more information and examples.'><meta property="og:image" content="https://pkg.garrickadenbuie.com/xaringanthemer/logo.png"><meta name="twitter:card" content="summary"><meta name="twitter:creator" content="@grrrck"><meta name="twitter:site" content="@grrrck"></head><body>
  9. <a href="#main" class="visually-hidden-focusable">Skip to contents</a>
  10. <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">
  11. <a class="navbar-brand me-2" href="../index.html">xaringanthemer</a>
  12. <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">0.4.3</small>
  13. <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
  14. <span class="navbar-toggler-icon"></span>
  15. </button>
  16. <div id="navbar" class="collapse navbar-collapse ms-3">
  17. <ul class="navbar-nav me-auto"><li class="nav-item"><a class="nav-link" href="../articles/xaringanthemer.html">Features</a></li>
  18. <li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
  19. <li class="nav-item dropdown">
  20. <button class="nav-link dropdown-toggle" type="button" id="dropdown-themes" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Themes</button>
  21. <ul class="dropdown-menu" aria-labelledby="dropdown-themes"><li><h6 class="dropdown-header" data-toc-skip>Themes</h6></li>
  22. <li><a class="dropdown-item" href="../articles/themes.html">Slide Themes</a></li>
  23. <li><a class="dropdown-item" href="../articles/ggplot2-themes.html">ggplot2 Themes</a></li>
  24. <li><hr class="dropdown-divider"></li>
  25. <li><h6 class="dropdown-header" data-toc-skip>More Customization</h6></li>
  26. <li><a class="dropdown-item" href="../articles/fonts.html">Fonts</a></li>
  27. <li><a class="dropdown-item" href="../articles/template-variables.html">Template Variables</a></li>
  28. </ul></li>
  29. </ul><ul class="navbar-nav"><li class="nav-item dropdown">
  30. <button class="nav-link dropdown-toggle" type="button" id="dropdown-" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true"><span class="fa far fa-newspaper fa-lg"></span> </button>
  31. <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="dropdown-"><li><a class="external-link dropdown-item" href="https://garrickadenbuie.com/blog/xaringanthemer-v0-3-0/">xaringanthemer 0.3.0</a></li>
  32. <li><hr class="dropdown-divider"></li>
  33. <li><a class="dropdown-item" href="../news/index.html">Changelog</a></li>
  34. </ul></li>
  35. <li class="nav-item"><a class="external-link nav-link" href="https://github.com/gadenbuie/xaringanthemer"><span class="fa fab fa-github fa-lg"></span></a></li>
  36. <li class="nav-item"><a class="external-link nav-link" href="https://twitter.com/grrrck"><span class="fa fab fa-twitter fa-lg"></span></a></li>
  37. <li class="nav-item"><a class="external-link nav-link" href="https://www.garrickadenbuie.com"><span class="fa fas fa-home fa-lg"></span></a></li>
  38. </ul></div>
  39. </div>
  40. </nav><div class="container template-reference-topic">
  41. <div class="row">
  42. <main id="main" class="col-md-9"><div class="page-header">
  43. <img src="../logo.png" class="logo" alt=""><h1>An Inverse Plot Theme for ggplot2 by xaringanthemer</h1>
  44. <small class="dont-index">Source: <a href="https://github.com/gadenbuie/xaringanthemer/blob/v0.4.3/R/ggplot2.R" class="external-link"><code>R/ggplot2.R</code></a></small>
  45. <div class="d-none name"><code>theme_xaringan_inverse.Rd</code></div>
  46. </div>
  47. <div class="ref-description section level2">
  48. <p><a href="https://lifecycle.r-lib.org/articles/stages.html#maturing" class="external-link"><img src="figures/lifecycle-maturing.svg" alt="[Maturing]"></a></p>
  49. <p>A <span class="pkg">ggplot2</span> xaringanthemer plot theme to seamlessly match the "inverse"
  50. <span class="pkg">xaringan</span> slide colors and styles as styled by <a href="xaringanthemer-package.html">xaringanthemer</a>. See
  51. <code><a href="../articles/ggplot2-themes.html">vignette("ggplot2-themes")</a></code> for more information and examples.</p>
  52. </div>
  53. <div class="section level2">
  54. <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
  55. <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">theme_xaringan_inverse</span><span class="op">(</span></span>
  56. <span> text_color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  57. <span> background_color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  58. <span> accent_color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  59. <span> accent_secondary_color <span class="op">=</span> <span class="cn">NULL</span>,</span>
  60. <span> css_file <span class="op">=</span> <span class="cn">NULL</span>,</span>
  61. <span> set_ggplot_defaults <span class="op">=</span> <span class="cn">TRUE</span>,</span>
  62. <span> text_font <span class="op">=</span> <span class="cn">NULL</span>,</span>
  63. <span> text_font_use_google <span class="op">=</span> <span class="cn">NULL</span>,</span>
  64. <span> text_font_size <span class="op">=</span> <span class="cn">NULL</span>,</span>
  65. <span> title_font <span class="op">=</span> <span class="cn">NULL</span>,</span>
  66. <span> title_font_use_google <span class="op">=</span> <span class="cn">NULL</span>,</span>
  67. <span> title_font_size <span class="op">=</span> <span class="cn">NULL</span>,</span>
  68. <span> use_showtext <span class="op">=</span> <span class="cn">NULL</span></span>
  69. <span><span class="op">)</span></span></code></pre></div>
  70. </div>
  71. <div class="section level2">
  72. <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>
  73. <dl><dt id="arg-text-color">text_color<a class="anchor" aria-label="anchor" href="#arg-text-color"></a></dt>
  74. <dd><p>Color for text and foreground, inherits from <code>text_color</code></p></dd>
  75. <dt id="arg-background-color">background_color<a class="anchor" aria-label="anchor" href="#arg-background-color"></a></dt>
  76. <dd><p>Color for background, inherits from
  77. <code>background_color</code></p></dd>
  78. <dt id="arg-accent-color">accent_color<a class="anchor" aria-label="anchor" href="#arg-accent-color"></a></dt>
  79. <dd><p>Color for titles and accents, inherits from
  80. <code>header_color</code></p></dd>
  81. <dt id="arg-accent-secondary-color">accent_secondary_color<a class="anchor" aria-label="anchor" href="#arg-accent-secondary-color"></a></dt>
  82. <dd><p>Color for secondary accents, inherits from
  83. <code>text_bold_color</code></p></dd>
  84. <dt id="arg-css-file">css_file<a class="anchor" aria-label="anchor" href="#arg-css-file"></a></dt>
  85. <dd><p>Path to a <span class="pkg">xaringanthemer</span> CSS file, from which the
  86. theme variables and values will be inferred. In general, if you use the
  87. <span class="pkg">xaringathemer</span> defaults, you will not need to set this. This feature
  88. lets you create a <span class="pkg">ggplot2</span> theme for your <span class="pkg">xaringan</span> slides, even
  89. if you have only saved your theme CSS file and you aren't creating your
  90. CSS theme with <span class="pkg">xaringanthemer</span> in your slides' source file.</p></dd>
  91. <dt id="arg-set-ggplot-defaults">set_ggplot_defaults<a class="anchor" aria-label="anchor" href="#arg-set-ggplot-defaults"></a></dt>
  92. <dd><p>Should defaults be set for <span class="pkg">ggplot2</span> <em>geoms</em>?
  93. Defaults to TRUE. To restore ggplot's defaults, or the previously set geom
  94. defaults, see <code><a href="theme_xaringan_set_defaults.html">theme_xaringan_restore_defaults()</a></code>.</p></dd>
  95. <dt id="arg-text-font">text_font<a class="anchor" aria-label="anchor" href="#arg-text-font"></a></dt>
  96. <dd><p>Font to use for text elements, passed to
  97. <code><a href="https://rdrr.io/pkg/sysfonts/man/font_add_google.html" class="external-link">sysfonts::font_add_google()</a></code>, if available and <code>text_font_use_google</code> is
  98. <code>TRUE</code>. Inherits from <code>text_font_family</code>. If manually specified, can be a
  99. <code><a href="google_font.html">google_font()</a></code>.</p></dd>
  100. <dt id="arg-text-font-use-google">text_font_use_google<a class="anchor" aria-label="anchor" href="#arg-text-font-use-google"></a></dt>
  101. <dd><p>Is <code>text_font</code> available on <a href="https://fonts.google.com" class="external-link">Google Fonts</a>?</p></dd>
  102. <dt id="arg-text-font-size">text_font_size<a class="anchor" aria-label="anchor" href="#arg-text-font-size"></a></dt>
  103. <dd><p>Base text font size, inherits from <code>text_font_size</code>, or
  104. defaults to 11.</p></dd>
  105. <dt id="arg-title-font">title_font<a class="anchor" aria-label="anchor" href="#arg-title-font"></a></dt>
  106. <dd><p>Font to use for title elements, passed to
  107. <code><a href="https://rdrr.io/pkg/sysfonts/man/font_add_google.html" class="external-link">sysfonts::font_add_google()</a></code>, if available and <code>title_font_use_google</code> is
  108. <code>TRUE</code>. Inherits from <code>title_font_family</code>. If manually specified, can be a
  109. <code><a href="google_font.html">google_font()</a></code>.</p></dd>
  110. <dt id="arg-title-font-use-google">title_font_use_google<a class="anchor" aria-label="anchor" href="#arg-title-font-use-google"></a></dt>
  111. <dd><p>Is <code>title_font</code> available on <a href="https://fonts.google.com" class="external-link">Google Fonts</a>?</p></dd>
  112. <dt id="arg-title-font-size">title_font_size<a class="anchor" aria-label="anchor" href="#arg-title-font-size"></a></dt>
  113. <dd><p>Base text font size, inherits from <code>title_font_size</code>,
  114. or defaults to 14.</p></dd>
  115. <dt id="arg-use-showtext">use_showtext<a class="anchor" aria-label="anchor" href="#arg-use-showtext"></a></dt>
  116. <dd><p>If <code>TRUE</code> the <span class="pkg">showtext</span> package will be
  117. used to register Google fonts. Set to <code>FALSE</code> to disable this feature
  118. entirely, which may result in errors during plotting if the fonts used are
  119. not available locally. The default is <code>TRUE</code> when the <span class="pkg">showtext</span>
  120. package is installed.</p></dd>
  121. </dl></div>
  122. <div class="section level2">
  123. <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
  124. <p>A ggplot2 theme</p>
  125. </div>
  126. <div class="section level2">
  127. <h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"></a></h2>
  128. <div class="dont-index"><p>Other xaringanthemer ggplot2 themes:
  129. <code><a href="theme_xaringan.html">theme_xaringan</a>()</code>,
  130. <code><a href="theme_xaringan_base.html">theme_xaringan_base</a>()</code>,
  131. <code><a href="theme_xaringan_set_defaults.html">theme_xaringan_set_defaults</a>()</code></p></div>
  132. </div>
  133. <div class="section level2">
  134. <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
  135. <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="co"># Requires ggplot2</span></span></span>
  136. <span class="r-in"><span><span class="va">has_ggplot2</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/ns-load.html" class="external-link">requireNamespace</a></span><span class="op">(</span><span class="st">"ggplot2"</span>, quietly <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></span>
  137. <span class="r-in"><span></span></span>
  138. <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="va">has_ggplot2</span><span class="op">)</span> <span class="op">{</span></span></span>
  139. <span class="r-in"><span> <span class="co"># Because this is an example, we'll save the CSS to a temp file</span></span></span>
  140. <span class="r-in"><span> <span class="va">path_to_css_file</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/tempfile.html" class="external-link">tempfile</a></span><span class="op">(</span>fileext <span class="op">=</span> <span class="st">".css"</span><span class="op">)</span></span></span>
  141. <span class="r-in"><span></span></span>
  142. <span class="r-in"><span> <span class="co"># Create the xaringan theme: dark blue background with teal green accents</span></span></span>
  143. <span class="r-in"><span> <span class="fu"><a href="style_duo.html">style_duo</a></span><span class="op">(</span></span></span>
  144. <span class="r-in"><span> primary_color <span class="op">=</span> <span class="st">"#002b36"</span>,</span></span>
  145. <span class="r-in"><span> secondary_color <span class="op">=</span> <span class="st">"#31b09e"</span>,</span></span>
  146. <span class="r-in"><span> <span class="co"># Using basic fonts for this example, but the plot theme will</span></span></span>
  147. <span class="r-in"><span> <span class="co"># automatically use your theme font if you use Google fonts</span></span></span>
  148. <span class="r-in"><span> text_font_family <span class="op">=</span> <span class="st">"sans"</span>,</span></span>
  149. <span class="r-in"><span> header_font_family <span class="op">=</span> <span class="st">"serif"</span>,</span></span>
  150. <span class="r-in"><span> outfile <span class="op">=</span> <span class="va">path_to_css_file</span></span></span>
  151. <span class="r-in"><span> <span class="op">)</span></span></span>
  152. <span class="r-in"><span></span></span>
  153. <span class="r-in"><span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://ggplot2.tidyverse.org" class="external-link">ggplot2</a></span><span class="op">)</span></span></span>
  154. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/ggplot.html" class="external-link">ggplot</a></span><span class="op">(</span><span class="va">mpg</span><span class="op">)</span> <span class="op">+</span></span></span>
  155. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span><span class="va">cty</span>, <span class="va">hwy</span><span class="op">)</span> <span class="op">+</span></span></span>
  156. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_point.html" class="external-link">geom_point</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
  157. <span class="r-in"><span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">ggtitle</a></span><span class="op">(</span><span class="st">"Fuel Efficiency of Various Cars"</span><span class="op">)</span> <span class="op">+</span></span></span>
  158. <span class="r-in"><span> <span class="co"># themed to match the inverse slides: teal background with dark blue text</span></span></span>
  159. <span class="r-in"><span> <span class="fu">theme_xaringan_inverse</span><span class="op">(</span><span class="op">)</span></span></span>
  160. <span class="r-in"><span><span class="op">}</span></span></span>
  161. <span class="r-plt img"><img src="theme_xaringan_inverse-1.png" alt="" width="700" height="433"></span>
  162. </code></pre></div>
  163. </div>
  164. </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
  165. </nav></aside></div>
  166. <footer><div class="pkgdown-footer-left">
  167. <p>Developed by <a href="https://www.garrickadenbuie.com" class="external-link">Garrick Aden-Buie</a>.</p>
  168. </div>
  169. <div class="pkgdown-footer-right">
  170. <p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.1.0.</p>
  171. </div>
  172. </footer></div>
  173. <script src="../doc-versions.js"></script></body></html>