😎 Give your xaringan slides some style
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

349 lines
17KB

  1. <!-- Generated by pkgdown: do not edit by hand -->
  2. <!DOCTYPE html>
  3. <html lang="en">
  4. <head>
  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.0">
  8. <title>An Inverse Plot Theme for ggplot2 by xaringanthemer — theme_xaringan_inverse • xaringanthemer</title>
  9. <!-- favicons -->
  10. <link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png">
  11. <link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png">
  12. <link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png" />
  13. <link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png" />
  14. <link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png" />
  15. <link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png" />
  16. <!-- jquery -->
  17. <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
  18. <!-- Bootstrap -->
  19. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
  20. <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
  21. <!-- bootstrap-toc -->
  22. <link rel="stylesheet" href="../bootstrap-toc.css">
  23. <script src="../bootstrap-toc.js"></script>
  24. <!-- Font Awesome icons -->
  25. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
  26. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
  27. <!-- clipboard.js -->
  28. <script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
  29. <!-- headroom.js -->
  30. <script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
  31. <script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
  32. <!-- pkgdown -->
  33. <link href="../pkgdown.css" rel="stylesheet">
  34. <script src="../pkgdown.js"></script>
  35. <link href="../extra.css" rel="stylesheet">
  36. <meta property="og:title" content="An Inverse Plot Theme for ggplot2 by xaringanthemer — theme_xaringan_inverse" />
  37. <meta property="og:description" content="
  38. A ggplot2 xaringanthemer plot theme to seamlessly match the &quot;inverse&quot;
  39. xaringan slide colors and styles as styled by xaringanthemer. See
  40. vignette(&quot;ggplot2-themes&quot;) for more information and examples." />
  41. <meta property="og:image" content="https://pkg.garrickadenbuie.com/xaringanthemer/logo.png" />
  42. <meta name="twitter:card" content="summary" />
  43. <meta name="twitter:creator" content="@grrrck" />
  44. <meta name="twitter:site" content="@grrrck" />
  45. <meta name="robots" content="noindex">
  46. <!-- mathjax -->
  47. <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
  48. <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
  49. <!--[if lt IE 9]>
  50. <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
  51. <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
  52. <![endif]-->
  53. </head>
  54. <body data-spy="scroll" data-target="#toc">
  55. <div class="container template-reference-topic">
  56. <header>
  57. <div class="navbar navbar-default navbar-fixed-top" role="navigation">
  58. <div class="container">
  59. <div class="navbar-header">
  60. <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
  61. <span class="sr-only">Toggle navigation</span>
  62. <span class="icon-bar"></span>
  63. <span class="icon-bar"></span>
  64. <span class="icon-bar"></span>
  65. </button>
  66. <span class="navbar-brand">
  67. <a class="navbar-link" href="../index.html">xaringanthemer</a>
  68. <span class="version label label-danger" data-toggle="tooltip" data-placement="bottom" title="In-development version">0.4.0.9000</span>
  69. </span>
  70. </div>
  71. <div id="navbar" class="navbar-collapse collapse">
  72. <ul class="nav navbar-nav">
  73. <li>
  74. <a href="../articles/xaringanthemer.html">Features</a>
  75. </li>
  76. <li>
  77. <a href="../reference/index.html">Reference</a>
  78. </li>
  79. <li>
  80. <a href="../articles/themes.html">Themes</a>
  81. </li>
  82. <li>
  83. <a href="../articles/ggplot2-themes.html">ggplot2 Themes</a>
  84. </li>
  85. <li class="dropdown">
  86. <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
  87. More
  88. <span class="caret"></span>
  89. </a>
  90. <ul class="dropdown-menu" role="menu">
  91. <li>
  92. <a href="../articles/fonts.html">Fonts</a>
  93. </li>
  94. <li>
  95. <a href="../articles/template-variables.html">Template Variables</a>
  96. </li>
  97. </ul>
  98. </li>
  99. </ul>
  100. <ul class="nav navbar-nav navbar-right">
  101. <li class="dropdown">
  102. <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
  103. <span class="far fa-newspaper fa-lg"></span>
  104. <span class="caret"></span>
  105. </a>
  106. <ul class="dropdown-menu" role="menu">
  107. <li>
  108. <a href="https://garrickadenbuie.com/blog/xaringanthemer-v0-3-0/">xaringanthemer 0.3.0</a>
  109. </li>
  110. <li class="divider"></li>
  111. <li>
  112. <a href="../news/index.html">Changelog</a>
  113. </li>
  114. </ul>
  115. </li>
  116. <li>
  117. <a href="https://github.com/gadenbuie/xaringanthemer">
  118. <span class="fab fa-github fa-lg"></span>
  119. </a>
  120. </li>
  121. <li>
  122. <a href="https://twitter.com/grrrck">
  123. <span class="fab fa-twitter fa-lg"></span>
  124. </a>
  125. </li>
  126. <li>
  127. <a href="https://www.garrickadenbuie.com">
  128. <span class="fas fa-home fa-lg"></span>
  129. </a>
  130. </li>
  131. </ul>
  132. </div><!--/.nav-collapse -->
  133. </div><!--/.container -->
  134. </div><!--/.navbar -->
  135. </header>
  136. <div class="row">
  137. <div class="col-md-9 contents">
  138. <div class="page-header">
  139. <h1>An Inverse Plot Theme for ggplot2 by xaringanthemer</h1>
  140. <small class="dont-index">Source: <a href='https://github.com/gadenbuie/xaringanthemer/blob/master/R/ggplot2.R'><code>R/ggplot2.R</code></a></small>
  141. <div class="hidden name"><code>theme_xaringan_inverse.Rd</code></div>
  142. </div>
  143. <div class="ref-description">
  144. <p><a href='https://lifecycle.r-lib.org/articles/stages.html#maturing'><img src='figures/lifecycle-maturing.svg' alt='[Maturing]' /></a></p>
  145. <p>A <span class="pkg">ggplot2</span> xaringanthemer plot theme to seamlessly match the "inverse"
  146. <span class="pkg">xaringan</span> slide colors and styles as styled by <a href='xaringanthemer-package.html'>xaringanthemer</a>. See
  147. <code><a href='../articles/ggplot2-themes.html'>vignette("ggplot2-themes")</a></code> for more information and examples.</p>
  148. </div>
  149. <pre class="usage"><span class='fu'>theme_xaringan_inverse</span><span class='op'>(</span>
  150. text_color <span class='op'>=</span> <span class='cn'>NULL</span>,
  151. background_color <span class='op'>=</span> <span class='cn'>NULL</span>,
  152. accent_color <span class='op'>=</span> <span class='cn'>NULL</span>,
  153. accent_secondary_color <span class='op'>=</span> <span class='cn'>NULL</span>,
  154. css_file <span class='op'>=</span> <span class='cn'>NULL</span>,
  155. set_ggplot_defaults <span class='op'>=</span> <span class='cn'>TRUE</span>,
  156. text_font <span class='op'>=</span> <span class='cn'>NULL</span>,
  157. text_font_use_google <span class='op'>=</span> <span class='cn'>NULL</span>,
  158. text_font_size <span class='op'>=</span> <span class='cn'>NULL</span>,
  159. title_font <span class='op'>=</span> <span class='cn'>NULL</span>,
  160. title_font_use_google <span class='op'>=</span> <span class='cn'>NULL</span>,
  161. title_font_size <span class='op'>=</span> <span class='cn'>NULL</span>,
  162. use_showtext <span class='op'>=</span> <span class='cn'>NULL</span>
  163. <span class='op'>)</span></pre>
  164. <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
  165. <table class="ref-arguments">
  166. <colgroup><col class="name" /><col class="desc" /></colgroup>
  167. <tr>
  168. <th>text_color</th>
  169. <td><p>Color for text and foreground, inherits from <code>text_color</code></p></td>
  170. </tr>
  171. <tr>
  172. <th>background_color</th>
  173. <td><p>Color for background, inherits from
  174. <code>background_color</code></p></td>
  175. </tr>
  176. <tr>
  177. <th>accent_color</th>
  178. <td><p>Color for titles and accents, inherits from
  179. <code>header_color</code></p></td>
  180. </tr>
  181. <tr>
  182. <th>accent_secondary_color</th>
  183. <td><p>Color for secondary accents, inherits from
  184. <code>text_bold_color</code></p></td>
  185. </tr>
  186. <tr>
  187. <th>css_file</th>
  188. <td><p>Path to a <span class="pkg">xaringanthemer</span> CSS file, from which the
  189. theme variables and values will be inferred. In general, if you use the
  190. <span class="pkg">xaringathemer</span> defaults, you will not need to set this. This feature
  191. lets you create a <span class="pkg">ggplot2</span> theme for your <span class="pkg">xaringan</span> slides, even
  192. if you have only saved your theme CSS file and you aren't creating your
  193. CSS theme with <span class="pkg">xaringanthemer</span> in your slides' source file.</p></td>
  194. </tr>
  195. <tr>
  196. <th>set_ggplot_defaults</th>
  197. <td><p>Should defaults be set for <span class="pkg">ggplot2</span> <em>geoms</em>?
  198. Defaults to TRUE. To restore ggplot's defaults, or the previously set geom
  199. defaults, see <code><a href='theme_xaringan_set_defaults.html'>theme_xaringan_restore_defaults()</a></code>.</p></td>
  200. </tr>
  201. <tr>
  202. <th>text_font</th>
  203. <td><p>Font to use for text elements, passed to
  204. <code><a href='https://rdrr.io/pkg/sysfonts/man/font_add_google.html'>sysfonts::font_add_google()</a></code>, if available and <code>text_font_use_google</code> is
  205. <code>TRUE</code>. Inherits from <code>text_font_family</code>. If manually specified, can be a
  206. <code><a href='google_font.html'>google_font()</a></code>.</p></td>
  207. </tr>
  208. <tr>
  209. <th>text_font_use_google</th>
  210. <td><p>Is <code>text_font</code> available on <a href='https://fonts.google.com'>Google Fonts</a>?</p></td>
  211. </tr>
  212. <tr>
  213. <th>text_font_size</th>
  214. <td><p>Base text font size, inherits from <code>text_font_size</code>, or
  215. defaults to 11.</p></td>
  216. </tr>
  217. <tr>
  218. <th>title_font</th>
  219. <td><p>Font to use for title elements, passed to
  220. <code><a href='https://rdrr.io/pkg/sysfonts/man/font_add_google.html'>sysfonts::font_add_google()</a></code>, if available and <code>title_font_use_google</code> is
  221. <code>TRUE</code>. Inherits from <code>title_font_family</code>. If manually specified, can be a
  222. <code><a href='google_font.html'>google_font()</a></code>.</p></td>
  223. </tr>
  224. <tr>
  225. <th>title_font_use_google</th>
  226. <td><p>Is <code>title_font</code> available on <a href='https://fonts.google.com'>Google Fonts</a>?</p></td>
  227. </tr>
  228. <tr>
  229. <th>title_font_size</th>
  230. <td><p>Base text font size, inherits from <code>title_font_size</code>,
  231. or defaults to 14.</p></td>
  232. </tr>
  233. <tr>
  234. <th>use_showtext</th>
  235. <td><p>If <code>TRUE</code> the <span class="pkg">showtext</span> package will be
  236. used to register Google fonts. Set to <code>FALSE</code> to disable this feature
  237. entirely, which may result in errors during plotting if the fonts used are
  238. not available locally. The default is <code>TRUE</code> when the <span class="pkg">showtext</span>
  239. package is installed.</p></td>
  240. </tr>
  241. </table>
  242. <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
  243. <p>A ggplot2 theme</p>
  244. <h2 class="hasAnchor" id="see-also"><a class="anchor" href="#see-also"></a>See also</h2>
  245. <div class='dont-index'><p>Other xaringanthemer ggplot2 themes:
  246. <code><a href='theme_xaringan_base.html'>theme_xaringan_base</a>()</code>,
  247. <code><a href='theme_xaringan_set_defaults.html'>theme_xaringan_set_defaults</a>()</code>,
  248. <code><a href='theme_xaringan.html'>theme_xaringan</a>()</code></p></div>
  249. <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
  250. <pre class="examples"><span class='r-in'><span class='co'># Requires ggplot2</span></span>
  251. <span class='r-in'><span class='va'>has_ggplot2</span> <span class='op'>&lt;-</span> <span class='fu'><a href='https://rdrr.io/r/base/ns-load.html'>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>
  252. <span class='r-in'></span>
  253. <span class='r-in'><span class='kw'>if</span> <span class='op'>(</span><span class='va'>has_ggplot2</span><span class='op'>)</span> <span class='op'>{</span></span>
  254. <span class='r-in'> <span class='co'># Because this is an example, we'll save the CSS to a temp file</span></span>
  255. <span class='r-in'> <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'>tempfile</a></span><span class='op'>(</span>fileext <span class='op'>=</span> <span class='st'>".css"</span><span class='op'>)</span></span>
  256. <span class='r-in'></span>
  257. <span class='r-in'> <span class='co'># Create the xaringan theme: dark blue background with teal green accents</span></span>
  258. <span class='r-in'> <span class='fu'><a href='style_duo.html'>style_duo</a></span><span class='op'>(</span></span>
  259. <span class='r-in'> primary_color <span class='op'>=</span> <span class='st'>"#002b36"</span>,</span>
  260. <span class='r-in'> secondary_color <span class='op'>=</span> <span class='st'>"#31b09e"</span>,</span>
  261. <span class='r-in'> <span class='co'># Using basic fonts for this example, but the plot theme will</span></span>
  262. <span class='r-in'> <span class='co'># automatically use your theme font if you use Google fonts</span></span>
  263. <span class='r-in'> text_font_family <span class='op'>=</span> <span class='st'>"sans"</span>,</span>
  264. <span class='r-in'> header_font_family <span class='op'>=</span> <span class='st'>"serif"</span>,</span>
  265. <span class='r-in'> outfile <span class='op'>=</span> <span class='va'>path_to_css_file</span></span>
  266. <span class='r-in'> <span class='op'>)</span></span>
  267. <span class='r-in'></span>
  268. <span class='r-in'> <span class='kw'><a href='https://rdrr.io/r/base/library.html'>library</a></span><span class='op'>(</span><span class='va'><a href='https://ggplot2.tidyverse.org'>ggplot2</a></span><span class='op'>)</span></span>
  269. <span class='r-in'> <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/ggplot.html'>ggplot</a></span><span class='op'>(</span><span class='va'>mpg</span><span class='op'>)</span> <span class='op'>+</span></span>
  270. <span class='r-in'> <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/aes.html'>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>
  271. <span class='r-in'> <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/geom_point.html'>geom_point</a></span><span class='op'>(</span><span class='op'>)</span> <span class='op'>+</span></span>
  272. <span class='r-in'> <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/labs.html'>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>
  273. <span class='r-in'> <span class='co'># themed to match the inverse slides: teal background with dark blue text</span></span>
  274. <span class='r-in'> <span class='fu'>theme_xaringan_inverse</span><span class='op'>(</span><span class='op'>)</span></span>
  275. <span class='r-in'><span class='op'>}</span></span>
  276. <span class='r-plt img'><img src='theme_xaringan_inverse-1.png' alt='' width='700' height='433' /></span>
  277. </pre>
  278. </div>
  279. <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
  280. <nav id="toc" data-toggle="toc" class="sticky-top">
  281. <h2 data-toc-skip>Contents</h2>
  282. </nav>
  283. </div>
  284. </div>
  285. <footer>
  286. <div class="copyright">
  287. <p>Developed by <a href='https://www.garrickadenbuie.com'>Garrick Aden-Buie</a>.</p>
  288. </div>
  289. <div class="pkgdown">
  290. <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.6.1.</p>
  291. </div>
  292. </footer>
  293. </div>
  294. </body>
  295. </html>