garrick
/
xaringanthemer
rƩplica de https://github.com/gadenbuie/xaringanthemer.git
Seguir 1
Destacar 0
Fork 0
CĆ³digo Incidencias 0 Lanzamientos 10 Wiki Actividad
šŸ˜Ž Give your xaringan slides some style
No puede seleccionar mĆ”s de 25 temas Los temas deben comenzar con una letra o nĆŗmero, pueden incluir guiones ('-') y pueden tener hasta 35 caracteres de largo.
523 Commits
5 Ramas
Ɓrbol: cdc18d5a87
Ramas Etiquetas
${ item.name }
Crear rama ${ searchTerm }
desde 'cdc18d5a87'
${ noResults }
xaringanthemer/articles/ggplot2-themes.html

466 lĆ­neas
40KB
Original Blame HistĆ³rico 

  1. <!DOCTYPE html>

  2. <!-- Generated by pkgdown: do not edit by hand --><html lang="en">

  3. <head>

  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

  5. <meta charset="utf-8">

  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">

  7. <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

  8. <title>ggplot2 Themes ā€¢ xaringanthemer</title>

  9. <!-- favicons --><link rel="icon" type="image/png" sizes="96x96" href="../favicon-96x96.png">

  10. <link rel="icon" type="ā€image/svg+xmlā€" href="../favicon.svg">

  11. <link rel="apple-touch-icon" sizes="180x180" href="../apple-touch-icon.png">

  12. <link rel="icon" sizes="any" href="../favicon.ico">

  13. <link rel="manifest" href="../site.webmanifest">

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

  15. <link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet">

  16. <script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/IBM_Plex_Mono-0.4.10/font.css" rel="stylesheet">

  17. <link href="../deps/Outfit-0.4.10/font.css" rel="stylesheet">

  18. <link href="../deps/font-awesome-6.5.2/css/all.min.css" rel="stylesheet">

  19. <link href="../deps/font-awesome-6.5.2/css/v4-shims.min.css" rel="stylesheet">

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

  21. <meta property="og:title" content="ggplot2 Themes">

  22. </head>

  23. <body>

  24.     <a href="#main" class="visually-hidden-focusable">Skip to contents</a>

  25. 

  26. 

  27.     <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

  28. 

  29.     <a class="navbar-brand me-2" href="../index.html">xaringanthemer</a>

  30. 

  31.     <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">0.4.4</small>

  32. 

  33. 

  34.     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">

  35.       <span class="navbar-toggler-icon"></span>

  36.     </button>

  37. 

  38.     <div id="navbar" class="collapse navbar-collapse ms-3">

  39.       <ul class="navbar-nav me-auto">

  40. <li class="nav-item"><a class="nav-link" href="../articles/xaringanthemer.html">Features</a></li>

  41. <li class="nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>

  42. <li class="active nav-item dropdown">

  43.   <button class="nav-link dropdown-toggle" type="button" id="dropdown-themes" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Themes</button>

  44.   <ul class="dropdown-menu" aria-labelledby="dropdown-themes">

  45. <li><h6 class="dropdown-header" data-toc-skip>Themes</h6></li>

  46.     <li><a class="dropdown-item" href="../articles/themes.html">Slide Themes</a></li>

  47.     <li><a class="dropdown-item" href="../articles/ggplot2-themes.html">ggplot2 Themes</a></li>

  48.     <li><hr class="dropdown-divider"></li>

  49.     <li><h6 class="dropdown-header" data-toc-skip>More Customization</h6></li>

  50.     <li><a class="dropdown-item" href="../articles/fonts.html">Fonts</a></li>

  51.     <li><a class="dropdown-item" href="../articles/template-variables.html">Template Variables</a></li>

  52.   </ul>

  53. </li>

  54.       </ul>

  55. <ul class="navbar-nav">

  56. <li class="nav-item dropdown">

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

  58.   <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="dropdown-">

  59. <li><a class="external-link dropdown-item" href="https://garrickadenbuie.com/blog/xaringanthemer-v0-3-0/">xaringanthemer 0.3.0</a></li>

  60.     <li><hr class="dropdown-divider"></li>

  61.     <li><a class="dropdown-item" href="../news/index.html">Changelog</a></li>

  62.   </ul>

  63. </li>

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

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

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

  67.       </ul>

  68. </div>

  69. 

  70. 

  71.   </div>

  72. </nav><div class="container template-article">

  73. 

  74. 

  75. 

  76. 

  77. <div class="row">

  78.   <main id="main" class="col-md-9"><div class="page-header">

  79.       <img src="../logo.png" class="logo" alt=""><h1>ggplot2 Themes</h1>

  80.             

  81.       

  82.       <small class="dont-index">Source: <a href="https://github.com/gadenbuie/xaringanthemer/blob/main/vignettes/ggplot2-themes.Rmd" class="external-link"><code>vignettes/ggplot2-themes.Rmd</code></a></small>

  83.       <div class="d-none name"><code>ggplot2-themes.Rmd</code></div>

  84.     </div>

  85. 

  86.     

  87.     

  88. <style type="text/css">

  89. img { max-width: 100%; border: none; }

  90. </style>

  91. <p><strong>xaringanthemer</strong> provides two <a href="https://ggplot2.tidyverse.org" class="external-link">ggplot2</a> themes for your <a href="https://github.com/yihui/xaringan" class="external-link">xaringan</a> slides to help

  92. your data visualizations blend seamlessly into your slides. Use

  93. <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> to create plots that match your primary

  94. slide style or <code><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse()</a></code> to match the style

  95. of your inverse slides.</p>

  96. <p><img src="https://raw.githubusercontent.com/gadenbuie/xaringanthemer/assets/theme-xaringan-inverse.png" alt="Examples slides with ggplot2 plots that match the xaringanthemer theme" data-external="1"></p>

  97. <div class="section level3">

  98. <h3 id="key-features">Key Features<a class="anchor" aria-label="anchor" href="#key-features"></a>

  99. </h3>

  100. <ul>

  101. <li><p>The ggplot2 themes <a href="#setup-your-theme">uses the colors

  102. and themes</a> from the <strong>xaringanthemer</strong> style functions,

  103. if you set your theme inside your slides. Otherwise, it <a href="#using-xaringan-themer-css">draws from the

  104. <code>xaringan-themer.css</code> file</a>.</p></li>

  105. <li><p>The themes <a href="#colors">pick appropriate colors</a> for

  106. titles, grid lines, and axis text, and also sets the default colors of

  107. geoms like <code><a href="https://ggplot2.tidyverse.org/reference/geom_point.html" class="external-link">ggplot2::geom_point()</a></code> and

  108. <code><a href="https://ggplot2.tidyverse.org/reference/geom_text.html" class="external-link">ggplot2::geom_text()</a></code>. There are also monotone <a href="#scale-xaringan">color and fill scales</a> based around the

  109. primary accent color used in your xaringan theme.</p></li>

  110. <li><p>If you use Google Fonts in your slides, the ggplot2 themes use

  111. the showtext package to <a href="#fonts">automatically match the title

  112. and axis text fonts</a> of your plots to the heading and text fonts in

  113. your xaringan theme.</p></li>

  114. <li><p>Iā€™ve done my best to set up everything so that <em>it just

  115. works</em>, but sometimes the showtext package adds a bit of

  116. complication to the routine data visualization workflow. At the end of

  117. this vignette I include <a href="#tips">a few tips</a> for working with

  118. showtext.</p></li>

  119. </ul>

  120. </div>

  121. <div class="section level2">

  122. <h2 id="setup-your-theme">Setup Your Theme<a class="anchor" aria-label="anchor" href="#setup-your-theme"></a>

  123. </h2>

  124. <p><code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> is designed to automatically use the

  125. fonts and colors you used for your slidesā€™ style theme. Here Iā€™m going

  126. to use a moderately customized color theme based on

  127. <code><a href="../reference/style_mono_accent.html">style_mono_accent()</a></code>, that results in the xaringan theme

  128. previewed in the slides above.</p>

  129. <p>Iā€™ve also picked out a few fonts from <a href="https://fonts.google.com" class="external-link">Google Fonts</a> that I would probably

  130. never use in a real presentation, but theyā€™re flashy enough to make it

  131. easy to see that weā€™re not using the standard default fonts.</p>

  132. <div class="sourceCode" id="cb1"><pre class="sourceCode markdown"><code class="sourceCode markdown"><span id="cb1-1"><a href="#cb1-1" tabindex="-1"></a><span class="in">```{r xaringan-themer, include=FALSE, warning=FALSE}</span></span>

  133. <span id="cb1-2"><a href="#cb1-2" tabindex="-1"></a><span class="in">library(xaringanthemer)</span></span>

  134. <span id="cb1-3"><a href="#cb1-3" tabindex="-1"></a><span class="in">style_mono_accent(</span></span>

  135. <span id="cb1-4"><a href="#cb1-4" tabindex="-1"></a><span class="in">  base_color = "#DC322F",               # bright red</span></span>

  136. <span id="cb1-5"><a href="#cb1-5" tabindex="-1"></a><span class="in">  inverse_background_color = "#002B36", # dark dark blue</span></span>

  137. <span id="cb1-6"><a href="#cb1-6" tabindex="-1"></a><span class="in">  inverse_header_color = "#31b09e",     # light aqua green</span></span>

  138. <span id="cb1-7"><a href="#cb1-7" tabindex="-1"></a><span class="in">  inverse_text_color = "#FFFFFF",       # white</span></span>

  139. <span id="cb1-8"><a href="#cb1-8" tabindex="-1"></a><span class="in">  title_slide_background_color = "var(--base)",</span></span>

  140. <span id="cb1-9"><a href="#cb1-9" tabindex="-1"></a><span class="in">  text_font_google = google_font("Kelly Slab"),</span></span>

  141. <span id="cb1-10"><a href="#cb1-10" tabindex="-1"></a><span class="in">  header_font_google = google_font("Oleo Script")</span></span>

  142. <span id="cb1-11"><a href="#cb1-11" tabindex="-1"></a><span class="in">)</span></span>

  143. <span id="cb1-12"><a href="#cb1-12" tabindex="-1"></a><span class="in">```</span></span></code></pre></div>

  144. <p>If you use a hidden chunk like this one inside your slidesā€™ R

  145. Markdown source file, <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> will know which

  146. colors and fonts youā€™ve picked.</p>

  147. <p>Adding <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> to a ggplot, like this

  148. demonstration plot using the <code>mpg</code> dataset from ggplot2,

  149. changes the colors and fonts of your plot theme.</p>

  150. <div class="sourceCode" id="cb2"><pre class="downlit sourceCode r">

  151. <code class="sourceCode R"><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>

  152. <span></span>

  153. <span><span class="va">g_base</span> <span class="op">&lt;-</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>

  154. <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">hwy</span>, <span class="va">cty</span><span class="op">)</span> <span class="op">+</span></span>

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

  156. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>x <span class="op">=</span> <span class="st">"Highway MPG"</span>, y <span class="op">=</span> <span class="st">"City MPG"</span>, title <span class="op">=</span> <span class="st">"Fuel Efficiency"</span><span class="op">)</span></span>

  157. <span></span>

  158. <span><span class="co"># Basic plot with default theme</span></span>

  159. <span><span class="va">g_base</span></span></code></pre></div>

  160. <div class="sourceCode" id="cb3"><pre class="downlit sourceCode r">

  161. <code class="sourceCode R"><span><span class="co"># Fancy slide-matching themed plot</span></span>

  162. <span><span class="va">g_base</span> <span class="op">+</span> <span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>

  163. <p><img src="ggplot2-themes_files/figure-html/ggplot2-demo-1-1.png" width="48%"><img src="ggplot2-themes_files/figure-html/ggplot2-demo-2-1.png" width="48%"></p>

  164. <p>With <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> the fonts and colors match the

  165. slide theme. The default colors of points (like other geometries) has

  166. been changed as well to match the slide colors.</p>

  167. <p>To restore the previous default colors of ggplot2 geoms, call</p>

  168. <div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">

  169. <code class="sourceCode R"><span><span class="fu"><a href="../reference/theme_xaringan_set_defaults.html">theme_xaringan_restore_defaults</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>

  170. <p>Add <code><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse()</a></code> to automatically create a

  171. plot that matches the inverse slide style.</p>

  172. <div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">

  173. <code class="sourceCode R"><span><span class="co"># theme_xaringan() on the left, theme_xaringan_inverse() on the right</span></span>

  174. <span><span class="va">g_base</span> <span class="op">+</span> <span class="fu"><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>

  175. <p><img src="ggplot2-themes_files/figure-html/ggplot2-demo-2-1.png" width="48%"><img src="ggplot2-themes_files/figure-html/ggplot2-demo-inverse-1.png" width="48%"></p>

  176. </div>

  177. <div class="section level2">

  178. <h2 id="using-xaringan-themer-css">Using <code>theme_xaringan()</code> without calling a style

  179. function<a class="anchor" aria-label="anchor" href="#using-xaringan-themer-css"></a>

  180. </h2>

  181. <p>Once youā€™ve set up your custom xaringan theme, you might want to use

  182. the themeā€™s CSS file for new presentations instead of rebuilding your

  183. theme with every new slide deck.</p>

  184. <p>In these cases, <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> will look for a CSS

  185. file written by <strong>xaringanthemer</strong> in your slidesā€™

  186. directory or in a sub-folder under the same directory that it can use to

  187. determine the colors and fonts used in your slides.</p>

  188. <p>If you happen to have multiple slide themes written by

  189. <strong>xaringanthemer</strong> in the same directory, the one named

  190. <code>xaringan-themer.css</code> will be used. If xaringanthemer picks

  191. the wrong file, you can use the <code>css_file</code> in

  192. <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> to specify exactly which CSS file to

  193. use.</p>

  194. <div class="sourceCode" id="cb6"><pre class="downlit sourceCode r">

  195. <code class="sourceCode R"><span><span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span>css_file <span class="op">=</span> <span class="st">"my-slide-style.css"</span><span class="op">)</span></span></code></pre></div>

  196. <p>Note that you can use <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> anywhere you

  197. want, not just in xaringan slides! (For example,

  198. <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> is working great in these vignettes!) This

  199. means that you can use your plot theme in reports and websites while

  200. maintaining a consistent look and feel or brand.</p>

  201. <p>Finally, you donā€™t even need a xaringanthemer CSS file. You can

  202. specify the key ingredients for the theme as arguments to

  203. <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code>, namely text, background, and accent

  204. colors as well as text and title fonts.</p>

  205. <p>The R chunk below replicated the demonstrated theme, but doesnā€™t

  206. require a slide style to be set or stored in a CSS file.</p>

  207. <div class="sourceCode" id="cb7"><pre class="downlit sourceCode r">

  208. <code class="sourceCode R"><span><span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span></span>

  209. <span>  text_color <span class="op">=</span> <span class="st">"#3D3E38"</span>,</span>

  210. <span>  background_color <span class="op">=</span> <span class="st">"#FFFFFF"</span>,</span>

  211. <span>  accent_color <span class="op">=</span> <span class="st">"#DC322F"</span>,</span>

  212. <span>  text_font <span class="op">=</span> <span class="st">"Kelly Slab"</span>,</span>

  213. <span>  text_font_use_google <span class="op">=</span> <span class="cn">TRUE</span>,</span>

  214. <span>  title_font <span class="op">=</span> <span class="st">"Oleo Script"</span>,</span>

  215. <span>  title_font_use_google <span class="op">=</span> <span class="cn">TRUE</span></span>

  216. <span><span class="op">)</span></span></code></pre></div>

  217. </div>

  218. <div class="section level2">

  219. <h2 id="colors">Colors<a class="anchor" aria-label="anchor" href="#colors"></a>

  220. </h2>

  221. <p>As demonstrated above, <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> and

  222. <code><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse()</a></code> modify the default colors and

  223. fonts of geometries. This means that <code><a href="https://ggplot2.tidyverse.org/reference/geom_point.html" class="external-link">geom_point()</a></code>,

  224. <code><a href="https://ggplot2.tidyverse.org/reference/geom_bar.html" class="external-link">geom_bar()</a></code>, <code><a href="https://ggplot2.tidyverse.org/reference/geom_text.html" class="external-link">geom_text()</a></code> and other geoms used

  225. in your plots will reasonably match your slide themes with no extra

  226. work.</p>

  227. <div class="sourceCode" id="cb8"><pre class="downlit sourceCode r">

  228. <code class="sourceCode R"><span><span class="va">g_diamonds</span> <span class="op">&lt;-</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">diamonds</span>, <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span>x <span class="op">=</span> <span class="va">cut</span><span class="op">)</span><span class="op">)</span> <span class="op">+</span></span>

  229. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_bar.html" class="external-link">geom_bar</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span>

  230. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>x <span class="op">=</span> <span class="cn">NULL</span>, y <span class="op">=</span> <span class="cn">NULL</span>, title <span class="op">=</span> <span class="st">"Diamond Cut Quality"</span><span class="op">)</span> <span class="op">+</span></span>

  231. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/lims.html" class="external-link">ylim</a></span><span class="op">(</span><span class="fl">0</span>, <span class="fl">25000</span><span class="op">)</span></span>

  232. <span></span>

  233. <span><span class="va">g_diamonds</span> <span class="op">+</span> <span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>

  234. <p><img src="ggplot2-themes_files/figure-html/demo-geom-defaults-1.png" width="960"></p>

  235. <p>Whenever <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> or

  236. <code><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse()</a></code> are called, the default values of

  237. many of ggplot2 geoms are set by default. You can opt out of this by

  238. setting <code>set_ggplot_defaults = FALSE</code> when using either

  239. theme. You can also restore the geom aesthetic defaults to their

  240. original values before the first time <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> or

  241. <code><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse()</a></code> were used by running</p>

  242. <div class="sourceCode" id="cb9"><pre class="downlit sourceCode r">

  243. <code class="sourceCode R"><span><span class="fu"><a href="../reference/theme_xaringan_set_defaults.html">theme_xaringan_restore_defaults</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>

  244. <div class="section level3">

  245. <h3 id="scale-xaringan">Custom Color and Fill Scales<a class="anchor" aria-label="anchor" href="#scale-xaringan"></a>

  246. </h3>

  247. <p>xaringanthemer includes monotone color and fill scales to match your

  248. ggplot2 theme. The scale functions all follow the naming pattern

  249. <code>scale_xaringan_&lt;aes&gt;_&lt;data_type&gt;()</code>, where

  250. <code>&lt;aes&gt;</code> is replaced with either <code>color</code> or

  251. <code>fill</code> and <code>&lt;data_type&gt;</code> is one of

  252. <code>discrete</code> or <code>continuous</code>.</p>

  253. <p>These scales use <code><a href="https://colorspace.R-Forge.R-project.org/reference/hcl_palettes.html" class="external-link">colorspace::sequential_hcl()</a></code> to create

  254. a sequential, monotone color scale based on the primary accent color in

  255. your slides. Color scales matching the inverse slides are possible by

  256. setting the argument <code>inverse = TRUE</code>.</p>

  257. <div class="sourceCode" id="cb10"><pre class="downlit sourceCode r">

  258. <code class="sourceCode R"><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">diamonds</span>, <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span>x <span class="op">=</span> <span class="va">cut</span><span class="op">)</span><span class="op">)</span> <span class="op">+</span></span>

  259. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_bar.html" class="external-link">geom_bar</a></span><span class="op">(</span><span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span>fill <span class="op">=</span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes_eval.html" class="external-link">after_stat</a></span><span class="op">(</span><span class="va">count</span><span class="op">)</span><span class="op">)</span>, show.legend <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span> <span class="op">+</span></span>

  260. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>x <span class="op">=</span> <span class="cn">NULL</span>, y <span class="op">=</span> <span class="st">"Count"</span>, title <span class="op">=</span> <span class="st">"Diamond Cut Quality"</span><span class="op">)</span> <span class="op">+</span></span>

  261. <span>  <span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span>

  262. <span>  <span class="fu"><a href="../reference/scale_xaringan.html">scale_xaringan_fill_continuous</a></span><span class="op">(</span><span class="op">)</span></span>

  263. <span></span>

  264. <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="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span>x <span class="op">=</span> <span class="va">hwy</span>, y <span class="op">=</span> <span class="va">cty</span><span class="op">)</span><span class="op">)</span> <span class="op">+</span></span>

  265. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_count.html" class="external-link">geom_count</a></span><span class="op">(</span><span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span>color <span class="op">=</span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes_eval.html" class="external-link">after_stat</a></span><span class="op">(</span><span class="va">n</span><span class="op">)</span><span class="op">)</span>, show.legend <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span> <span class="op">+</span></span>

  266. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>x <span class="op">=</span> <span class="st">"Highway MPG"</span>, y <span class="op">=</span> <span class="st">"City MPG"</span>, title <span class="op">=</span> <span class="st">"Fuel Efficiency"</span><span class="op">)</span> <span class="op">+</span></span>

  267. <span>  <span class="fu"><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span>

  268. <span>  <span class="fu"><a href="../reference/scale_xaringan.html">scale_xaringan_color_continuous</a></span><span class="op">(</span>breaks <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/seq.html" class="external-link">seq</a></span><span class="op">(</span><span class="fl">3</span>, <span class="fl">12</span>, <span class="fl">2</span><span class="op">)</span>, inverse <span class="op">=</span> <span class="cn">TRUE</span>, begin <span class="op">=</span> <span class="fl">1</span>, end <span class="op">=</span> <span class="fl">0</span><span class="op">)</span></span></code></pre></div>

  269. <p><img src="ggplot2-themes_files/figure-html/scale-xaringan-1.png" width="48%"><img src="ggplot2-themes_files/figure-html/scale-xaringan-2.png" width="48%"></p>

  270. <p>In general, these color scales arenā€™t great at representing the

  271. underlying data. In both examples above, the color and fill scales

  272. duplicate information displayed via other aesthetics (the height of the

  273. bar or the size of the point). I recommend using these scales primarily

  274. for style, although the scales can be more or less effective depending

  275. on your color scheme.</p>

  276. <p>The scales come with a few more options:</p>

  277. <ul>

  278. <li><p>Choose a different primary color using the <code>color</code>

  279. argument.</p></li>

  280. <li><p>Use the inverse color slide theme color with

  281. <code>inverse = TRUE</code> (only applies when <code>color</code> is not

  282. supplied).</p></li>

  283. <li><p>Invert the direction of the discrete scales with

  284. <code>direction = -1</code>.</p></li>

  285. <li><p>Control the range of the continuous color scale used with

  286. <code>begin</code> and <code>end</code>. You can also invert the

  287. direction of the continuous color scale by setting

  288. <code>begin = 1</code> and <code>end = 0</code>.</p></li>

  289. </ul>

  290. </div>

  291. </div>

  292. <div class="section level2">

  293. <h2 id="fonts">Fonts<a class="anchor" aria-label="anchor" href="#fonts"></a>

  294. </h2>

  295. <div class="section level3">

  296. <h3 id="automatically-match-slide-and-plot-fonts">Automatically match slide and plot fonts<a class="anchor" aria-label="anchor" href="#automatically-match-slide-and-plot-fonts"></a>

  297. </h3>

  298. <p>xaringanthemer uses the <a href="https://github.com/yixuan/showtext" class="external-link">showtext</a> and <a href="https://github.com/yixuan/sysfonts" class="external-link">sysfonts</a> packages by

  299. Yixuan Qiu to automatically download and register <a href="https://fonts.google.com" class="external-link">Google Fonts</a> for use with your

  300. ggplot2 plots.</p>

  301. <p>In your slide theme, use the <code>&lt;type&gt;_font_google</code>

  302. argument with the <code>google_font("&lt;font name&gt;")</code> helper

  303. (or the default xaringanthemer fonts) and <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code>

  304. will handle the rest. In our demo theme, we used

  305. <code><a href="../reference/style_mono_accent.html">style_mono_accent()</a></code> with</p>

  306. <ul>

  307. <li>

  308. <code>text_font_google = google_font("Kelley Slab")</code> and</li>

  309. <li>

  310. <code>header_font_google = google_font("Oleo Script")</code>.</li>

  311. </ul>

  312. <div class="sourceCode" id="cb11"><pre class="downlit sourceCode r">

  313. <code class="sourceCode R"><span><span class="va">g_diamonds_with_text</span> <span class="op">&lt;-</span></span>

  314. <span>  <span class="va">g_diamonds</span> <span class="op">+</span></span>

  315. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_text.html" class="external-link">geom_text</a></span><span class="op">(</span><span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes.html" class="external-link">aes</a></span><span class="op">(</span>y <span class="op">=</span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes_eval.html" class="external-link">after_stat</a></span><span class="op">(</span><span class="va">count</span><span class="op">)</span>, label <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/format.html" class="external-link">format</a></span><span class="op">(</span><span class="fu"><a href="https://ggplot2.tidyverse.org/reference/aes_eval.html" class="external-link">after_stat</a></span><span class="op">(</span><span class="va">count</span><span class="op">)</span>, big.mark <span class="op">=</span> <span class="st">","</span><span class="op">)</span><span class="op">)</span>,</span>

  316. <span>    vjust <span class="op">=</span> <span class="op">-</span><span class="fl">0.30</span>, size <span class="op">=</span> <span class="fl">8</span>, stat <span class="op">=</span> <span class="st">"count"</span><span class="op">)</span> <span class="op">+</span></span>

  317. <span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>x <span class="op">=</span> <span class="st">"Cut"</span>, y <span class="op">=</span> <span class="st">"Count"</span><span class="op">)</span></span>

  318. <span></span>

  319. <span><span class="va">g_diamonds_with_text</span> <span class="op">+</span> <span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>

  320. <p><img src="ggplot2-themes_files/figure-html/text%20demo-1.png" width="960"></p>

  321. <p><code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> applies the header font to the plot and

  322. axis titles and the text font to the axis ticks labels and any text

  323. geoms or annotations.</p>

  324. </div>

  325. <div class="section level3">

  326. <h3 id="manually-specify-plot-fonts">Manually specify plot fonts<a class="anchor" aria-label="anchor" href="#manually-specify-plot-fonts"></a>

  327. </h3>

  328. <p>You can also specify specific fonts for your plot theme. Both

  329. <code>text_font</code> and <code>title_font</code> in

  330. <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> and <code><a href="../reference/theme_xaringan_inverse.html">theme_xaringan_inverse()</a></code>

  331. accept <code><a href="../reference/google_font.html">google_font()</a></code>s directly.</p>

  332. <div class="sourceCode" id="cb12"><pre class="downlit sourceCode r">

  333. <code class="sourceCode R"><span><span class="va">g_diamonds_with_text</span> <span class="op">+</span></span>

  334. <span>  <span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span></span>

  335. <span>    text_font <span class="op">=</span> <span class="fu"><a href="../reference/google_font.html">google_font</a></span><span class="op">(</span><span class="st">"Ranga"</span><span class="op">)</span>,</span>

  336. <span>    title_font <span class="op">=</span> <span class="fu"><a href="../reference/google_font.html">google_font</a></span><span class="op">(</span><span class="st">"Holtwood One SC"</span><span class="op">)</span></span>

  337. <span>  <span class="op">)</span></span></code></pre></div>

  338. <p><img src="ggplot2-themes_files/figure-html/text-demo-2-1.png" width="960"></p>

  339. </div>

  340. <div class="section level3">

  341. <h3 id="using-fonts-not-in-google-fonts">Using fonts not in Google Fonts<a class="anchor" aria-label="anchor" href="#using-fonts-not-in-google-fonts"></a>

  342. </h3>

  343. <p>If you want to use a font that isnā€™t in the Google Fonts collection,

  344. you need to manually register the font with sysfonts so that it can be

  345. used in your plots.</p>

  346. <p>I found a nice open source font called <strong>Glacial

  347. Indifference</strong> by Alfredo Marco Pradil available at <a href="https://fontlibrary.org" class="external-link">fontlibrary.org</a>. In my theme style

  348. function, I would use</p>

  349. <pre><code><span><span class="fu"><a href="../reference/style_mono_accent.html">style_mono_accent</a></span><span class="op">(</span></span>

  350. <span>  text_font_family <span class="op">=</span> <span class="st">"GlacialIndifferenceRegular"</span>,</span>

  351. <span>  text_font_url <span class="op">=</span> <span class="st">"https://fontlibrary.org/face/glacial-indifference"</span></span>

  352. <span><span class="op">)</span></span></code></pre>

  353. <p>but sysfonts wonā€™t know where to find the TTF font files for this

  354. font.</p>

  355. <p>To register the font with sysfonts, we use

  356. <code><a href="https://rdrr.io/pkg/sysfonts/man/font_add.html" class="external-link">sysfonts::font_add()</a></code>, but first we need to download the

  357. font file ā€” the <code><a href="https://rdrr.io/pkg/sysfonts/man/font_add.html" class="external-link">sysfonts::font_add()</a></code> function requires the

  358. font file to be local.</p>

  359. <p>By inspecting the CSS file at the link I used in

  360. <code>text_font_url</code>, I found a direct URL for the

  361. <code>.ttf</code> files for <em>GlacialIndifferenceRegular</em>. Iā€™ve

  362. included <em>Glacial Indifference</em> in the xaringanthemer

  363. package.</p>

  364. <div class="sourceCode" id="cb14"><pre class="downlit sourceCode r">

  365. <code class="sourceCode R"><span><span class="co"># Path to the local custom font file</span></span>

  366. <span><span class="va">font_temp</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/system.file.html" class="external-link">system.file</a></span><span class="op">(</span></span>

  367. <span>  <span class="st">"fonts/GlacialIndifferenceRegular.ttf"</span>, package <span class="op">=</span> <span class="st">"xaringanthemer"</span></span>

  368. <span><span class="op">)</span></span>

  369. <span></span>

  370. <span><span class="co"># Register the font with sysfonts/showtext</span></span>

  371. <span><span class="fu">sysfonts</span><span class="fu">::</span><span class="fu"><a href="https://rdrr.io/pkg/sysfonts/man/font_add.html" class="external-link">font_add</a></span><span class="op">(</span>family <span class="op">=</span> <span class="st">"GlacialIndifferenceRegular"</span>, regular <span class="op">=</span> <span class="va">font_temp</span><span class="op">)</span></span>

  372. <span></span>

  373. <span><span class="co"># Now it's available for use!</span></span>

  374. <span><span class="va">g_diamonds_with_text</span> <span class="op">+</span></span>

  375. <span>  <span class="fu"><a href="../reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span></span>

  376. <span>    text_font <span class="op">=</span> <span class="st">"GlacialIndifferenceRegular"</span>,</span>

  377. <span>    title_font <span class="op">=</span> <span class="st">"GlacialIndifferenceRegular"</span></span>

  378. <span>  <span class="op">)</span></span></code></pre></div>

  379. <p><img src="ggplot2-themes_files/figure-html/sysfonts-custom-font-1.png" width="960"></p>

  380. </div>

  381. </div>

  382. <div class="section level2">

  383. <h2 id="tips">Tips for using the showtext package<a class="anchor" aria-label="anchor" href="#tips"></a>

  384. </h2>

  385. <p>Working with fonts is notoriously frustrating, but <a href="https://github.com/yixuan/showtext" class="external-link">showtext</a> and <a href="https://github.com/yixuan/sysfonts" class="external-link">sysfonts</a> do a great job

  386. ensuring that Google Fonts and custom fonts work on all platforms. As

  387. youā€™ve seen in the examples above, the process is mostly seamless, but

  388. there are a few caveats and places where the methods used by these

  389. packages may interrupt a typical ggplot2 workflow.</p>

  390. <div class="section level3">

  391. <h3 id="r-markdown">R Markdown<a class="anchor" aria-label="anchor" href="#r-markdown"></a>

  392. </h3>

  393. <p>To use the showtext package in R Markdown, knitr requires that the

  394. <code>fig.showtext</code> chunk option be set to <code>TRUE</code>,

  395. either in the chunk producing the figure or globally in the

  396. document.</p>

  397. <p>xaringanthemer tries to set this chunk option for you, but in some

  398. circumstances itā€™s possible to call <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code> in a

  399. way that xaringanthemer canā€™t set this option for you. When this

  400. happens, xaringanthemer will produce an error:</p>

  401. <pre><code>Error in verify_fig_showtext(fn) :

  402.   To use theme_xaringan_base() with knitr, you need to set the chunk

  403.   option `fig.showtext = TRUE` for this chunk. Or you can set this option

  404.   globally with `knitr::opts_chunk$set(fig.showtext = TRUE)`.</code></pre>

  405. <p>If you find yourself facing this error, follow the instructions and

  406. choose one of the two suggestions:</p>

  407. <ol style="list-style-type: decimal">

  408. <li><p>Add <code>fig.showtext = TRUE</code> to the chunk producing the

  409. figure</p></li>

  410. <li><p>Or set the option globally in your <code>setup</code> chunk with

  411. <code>knitr::opts_chunk$set(fig.showtext = TRUE)</code>.</p></li>

  412. </ol>

  413. </div>

  414. <div class="section level3">

  415. <h3 id="macos">MacOS<a class="anchor" aria-label="anchor" href="#macos"></a>

  416. </h3>

  417. <p>On MacOS, youā€™ll need to have <code>xquartz</code> installed for

  418. <code>sysfonts</code> to work properly. If you use <a href="https://brew.sh/" class="external-link">homebrew</a>, you can install

  419. <code>xquartz</code> with</p>

  420. <div class="sourceCode" id="cb16"><pre class="sourceCode bash"><code class="sourceCode bash"><span id="cb16-1"><a href="#cb16-1" tabindex="-1"></a><span class="ex">brew</span> cask install xquartz</span></code></pre></div>

  421. </div>

  422. <div class="section level3">

  423. <h3 id="in-rstudio">In RStudio<a class="anchor" aria-label="anchor" href="#in-rstudio"></a>

  424. </h3>

  425. <p>showtext and RStudioā€™s graphic device donā€™t always work well

  426. together. Depending on your version of RStudio, if you try to preview

  427. plots that use <code><a href="../reference/theme_xaringan.html">theme_xaringan()</a></code>, the fonts in the preview

  428. will still be the default sans font or you may not see a plot at

  429. all.</p>

  430. <p>To work around this, open a new <code><a href="https://rdrr.io/r/grDevices/quartz.html" class="external-link">quartz()</a></code> (MacOS) or

  431. <code><a href="https://rdrr.io/r/grDevices/x11.html" class="external-link">x11()</a></code> (Windows/Unix) plot device. The plots will then

  432. render in a separate window. I usually create a <code><a href="https://rdrr.io/r/grDevices/quartz.html" class="external-link">quartz()</a></code>

  433. device with a similar size ratio to my slides.</p>

  434. <div class="sourceCode" id="cb17"><pre class="downlit sourceCode r">

  435. <code class="sourceCode R"><span><span class="co">## On Windows</span></span>

  436. <span><span class="co"># x11(width = 16 * 2/3, height = 9 * 2/3)</span></span>

  437. <span></span>

  438. <span><span class="co">## On MacOS</span></span>

  439. <span><span class="fu"><a href="https://rdrr.io/r/grDevices/quartz.html" class="external-link">quartz</a></span><span class="op">(</span>width <span class="op">=</span> <span class="fl">16</span> <span class="op">*</span> <span class="fl">2</span><span class="op">/</span><span class="fl">3</span>, height <span class="op">=</span> <span class="fl">9</span> <span class="op">*</span> <span class="fl">2</span><span class="op">/</span><span class="fl">3</span><span class="op">)</span></span>

  440. <span><span class="co">## run plot code to preview in separate window</span></span>

  441. <span><span class="fu"><a href="https://rdrr.io/r/grDevices/dev.html" class="external-link">dev.off</a></span><span class="op">(</span><span class="op">)</span> <span class="co"># call when done to close the device</span></span></code></pre></div>

  442. </div>

  443. </div>

  444.   </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>

  445.     </nav></aside>

  446. </div>

  447. 

  448. 

  449. 

  450.     <footer><div class="pkgdown-footer-left">

  451.   <p>Developed by <a href="https://www.garrickadenbuie.com" class="external-link">Garrick Aden-Buie</a>.</p>

  452. </div>

  453. 

  454. <div class="pkgdown-footer-right">

  455.   <p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.1.3.</p>

  456. </div>

  457. 

  458.     </footer>

  459. </div>

  460. 

  461. 

  462. 

  463.   <script src="../doc-versions.js"></script>

  464. </body>

  465. </html>