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

220 lines
16KB

  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>Custom xaringan CSS Themes • xaringanthemer</title>
  9. <!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">
  10. <link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
  11. <link rel="apple-touch-icon" type="image/png" sizes="180x180" href="apple-touch-icon.png">
  12. <link rel="apple-touch-icon" type="image/png" sizes="120x120" href="apple-touch-icon-120x120.png">
  13. <link rel="apple-touch-icon" type="image/png" sizes="76x76" href="apple-touch-icon-76x76.png">
  14. <link rel="apple-touch-icon" type="image/png" sizes="60x60" href="apple-touch-icon-60x60.png">
  15. <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">
  16. <link href="deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet">
  17. <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">
  18. <link href="deps/Outfit-0.4.9/font.css" rel="stylesheet">
  19. <link href="deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet">
  20. <link href="deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet">
  21. <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">
  22. <meta property="og:title" content="Custom xaringan CSS Themes">
  23. <meta name="description" content="Give your xaringan slides some style with xaringanthemer.
  24. Easy slide and plot themes for xaringan slides.
  25. ">
  26. <meta property="og:description" content="Give your xaringan slides some style with xaringanthemer.
  27. Easy slide and plot themes for xaringan slides.
  28. ">
  29. <meta property="og:image" content="https://pkg.garrickadenbuie.com/xaringanthemer/logo.png">
  30. <meta name="twitter:card" content="summary">
  31. <meta name="twitter:creator" content="@grrrck">
  32. <meta name="twitter:site" content="@grrrck">
  33. </head>
  34. <body>
  35. <a href="#main" class="visually-hidden-focusable">Skip to contents</a>
  36. <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">
  37. <a class="navbar-brand me-2" href="index.html">xaringanthemer</a>
  38. <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">0.4.3</small>
  39. <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
  40. <span class="navbar-toggler-icon"></span>
  41. </button>
  42. <div id="navbar" class="collapse navbar-collapse ms-3">
  43. <ul class="navbar-nav me-auto">
  44. <li class="nav-item"><a class="nav-link" href="articles/xaringanthemer.html">Features</a></li>
  45. <li class="nav-item"><a class="nav-link" href="reference/index.html">Reference</a></li>
  46. <li class="nav-item dropdown">
  47. <button class="nav-link dropdown-toggle" type="button" id="dropdown-themes" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Themes</button>
  48. <ul class="dropdown-menu" aria-labelledby="dropdown-themes">
  49. <li><h6 class="dropdown-header" data-toc-skip>Themes</h6></li>
  50. <li><a class="dropdown-item" href="articles/themes.html">Slide Themes</a></li>
  51. <li><a class="dropdown-item" href="articles/ggplot2-themes.html">ggplot2 Themes</a></li>
  52. <li><hr class="dropdown-divider"></li>
  53. <li><h6 class="dropdown-header" data-toc-skip>More Customization</h6></li>
  54. <li><a class="dropdown-item" href="articles/fonts.html">Fonts</a></li>
  55. <li><a class="dropdown-item" href="articles/template-variables.html">Template Variables</a></li>
  56. </ul>
  57. </li>
  58. </ul>
  59. <ul class="navbar-nav">
  60. <li class="nav-item dropdown">
  61. <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>
  62. <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="dropdown-">
  63. <li><a class="external-link dropdown-item" href="https://garrickadenbuie.com/blog/xaringanthemer-v0-3-0/">xaringanthemer 0.3.0</a></li>
  64. <li><hr class="dropdown-divider"></li>
  65. <li><a class="dropdown-item" href="news/index.html">Changelog</a></li>
  66. </ul>
  67. </li>
  68. <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>
  69. <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>
  70. <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>
  71. </ul>
  72. </div>
  73. </div>
  74. </nav><div class="container template-home">
  75. <div class="row">
  76. <main id="main" class="col-md-9"><div class="section level1">
  77. <div class="page-header">
  78. <img src="logo.png" class="logo" alt=""><h1 id="xaringanthemer-">xaringanthemer <a class="anchor" aria-label="anchor" href="#xaringanthemer-"></a>
  79. </h1>
  80. </div>
  81. <!-- badges: start -->
  82. <p>Give your <a href="https://github.com/yihui/xaringan" class="external-link">xaringan</a> slides some style with <strong>xaringanthemer</strong> within your <code>slides.Rmd</code> file without (much) CSS.</p>
  83. <p><img src="https://raw.githubusercontent.com/gadenbuie/xaringanthemer/assets/examples.gif" alt="Animation previewing many xaringanthemer themes"></p>
  84. <div class="section level2">
  85. <h2 id="installation">Installation<a class="anchor" aria-label="anchor" href="#installation"></a>
  86. </h2>
  87. <p>You can install <strong>xaringanthemer</strong> from CRAN</p>
  88. <div class="sourceCode" id="cb1"><pre class="downlit sourceCode r">
  89. <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/utils/install.packages.html" class="external-link">install.packages</a></span><span class="op">(</span><span class="st">"xaringanthemer"</span><span class="op">)</span></span></code></pre></div>
  90. <p>or you can install the development version of xaringanthemer from <a href="https://github.com/gadenbuie/xaringanthemer" class="external-link">GitHub</a>.</p>
  91. <div class="sourceCode" id="cb2"><pre class="downlit sourceCode r">
  92. <code class="sourceCode R"><span><span class="co"># install.packages("remotes")</span></span>
  93. <span><span class="fu">remotes</span><span class="fu">::</span><span class="fu">install_github</span><span class="op">(</span><span class="st">"gadenbuie/xaringanthemer"</span><span class="op">)</span></span></code></pre></div>
  94. </div>
  95. <div class="section level2">
  96. <h2 id="quick-intro">Quick Intro<a class="anchor" aria-label="anchor" href="#quick-intro"></a>
  97. </h2>
  98. <!-- Set link to theme-settings, template-variables, theme functions -->
  99. <p>First, add the <code>xaringan-themer.css</code> file to the YAML header of your xaringan slides.</p>
  100. <div class="sourceCode" id="cb3"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb3-1"><a href="#cb3-1" tabindex="-1"></a><span class="fu">output</span><span class="kw">:</span></span>
  101. <span id="cb3-2"><a href="#cb3-2" tabindex="-1"></a><span class="at"> xaringan:</span><span class="fu">:moon_reader</span><span class="kw">:</span></span>
  102. <span id="cb3-3"><a href="#cb3-3" tabindex="-1"></a><span class="at"> </span><span class="fu">css</span><span class="kw">:</span><span class="at"> xaringan-themer.css</span></span></code></pre></div>
  103. <p>Then, in a hidden chunk just after the knitr setup chunk, load <strong>xaringanthemer</strong> and try one of the <a href="#themes">theme functions</a>.</p>
  104. <div class="sourceCode" id="cb4"><pre class="sourceCode markdown"><code class="sourceCode markdown"><span id="cb4-1"><a href="#cb4-1" tabindex="-1"></a><span class="in">```{r xaringan-themer, include=FALSE, warning=FALSE}</span></span>
  105. <span id="cb4-2"><a href="#cb4-2" tabindex="-1"></a><span class="in">library(xaringanthemer)</span></span>
  106. <span id="cb4-3"><a href="#cb4-3" tabindex="-1"></a><span class="in">style_mono_accent(</span></span>
  107. <span id="cb4-4"><a href="#cb4-4" tabindex="-1"></a><span class="in"> base_color = "#1c5253",</span></span>
  108. <span id="cb4-5"><a href="#cb4-5" tabindex="-1"></a><span class="in"> header_font_google = google_font("Josefin Sans"),</span></span>
  109. <span id="cb4-6"><a href="#cb4-6" tabindex="-1"></a><span class="in"> text_font_google = google_font("Montserrat", "300", "300i"),</span></span>
  110. <span id="cb4-7"><a href="#cb4-7" tabindex="-1"></a><span class="in"> code_font_google = google_font("Fira Mono")</span></span>
  111. <span id="cb4-8"><a href="#cb4-8" tabindex="-1"></a><span class="in">)</span></span>
  112. <span id="cb4-9"><a href="#cb4-9" tabindex="-1"></a><span class="in">```</span></span></code></pre></div>
  113. <p><img src="https://raw.githubusercontent.com/gadenbuie/xaringanthemer/assets/example_mono_accent_1c5253.png" alt="Example title and normal slides using a green xaringanthemer theme" data-external="1"></p>
  114. <div class="section level3">
  115. <h3 id="matching-ggplot-themes">Matching ggplot Themes<a class="anchor" aria-label="anchor" href="#matching-ggplot-themes"></a>
  116. </h3>
  117. <p><strong>xaringanthemer</strong> even provides a <a href="https://ggplot2.tidyverse.org" class="external-link">ggplot2</a> theme with <code><a href="reference/theme_xaringan.html">theme_xaringan()</a></code> that uses the colors and fonts from your slide theme. Built on the <a href="https://github.com/yixuan/showtext" class="external-link">showtext</a> package, and designed to work seamlessly with <a href="https://fonts.google.com" class="external-link">Google Fonts</a>.</p>
  118. <p>Color and fill scales are also provided for matching sequential color scales based on the primary color used in your slides. See <code><a href="reference/scale_xaringan.html">?scale_xaringan</a></code> for more details.</p>
  119. <p>More details and examples can be found in <code><a href="articles/ggplot2-themes.html">vignette("ggplot2-themes")</a></code>.</p>
  120. <div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">
  121. <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>
  122. <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="op">)</span> <span class="op">+</span></span>
  123. <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">cut</span>, fill <span class="op">=</span> <span class="va">cut</span><span class="op">)</span> <span class="op">+</span></span>
  124. <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>show.legend <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span> <span class="op">+</span></span>
  125. <span> <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span></span>
  126. <span> x <span class="op">=</span> <span class="st">"Cut"</span>,</span>
  127. <span> y <span class="op">=</span> <span class="st">"Count"</span>,</span>
  128. <span> title <span class="op">=</span> <span class="st">"A Fancy diamonds Plot"</span></span>
  129. <span> <span class="op">)</span> <span class="op">+</span></span>
  130. <span> <span class="fu"><a href="reference/theme_xaringan.html">theme_xaringan</a></span><span class="op">(</span>background_color <span class="op">=</span> <span class="st">"#FFFFFF"</span><span class="op">)</span> <span class="op">+</span></span>
  131. <span> <span class="fu"><a href="reference/scale_xaringan.html">scale_xaringan_fill_discrete</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>
  132. <p><img src="reference/figures/index-theme_xaringan_demo-1.png" width="100%"></p>
  133. </div>
  134. <div class="section level3">
  135. <h3 id="tab-completion">Tab Completion<a class="anchor" aria-label="anchor" href="#tab-completion"></a>
  136. </h3>
  137. <p><strong>xaringanthemer</strong> is <kbd>Tab</kbd> friendly – <a href="#theme-settings">use autocomplete to explore</a> the <a href="vignettes/template-variables.html">template variables</a> that you can adjust in each of the themes!</p>
  138. <p><img src="https://raw.githubusercontent.com/gadenbuie/xaringanthemer/assets/example-rstudio-completion.gif" alt="Demonstration of argument auto-completion with RStudio" data-external="1"></p>
  139. </div>
  140. <div class="section level3">
  141. <h3 id="r-markdown-template-in-rstudio">R Markdown Template in RStudio<a class="anchor" aria-label="anchor" href="#r-markdown-template-in-rstudio"></a>
  142. </h3>
  143. <p>You can also skip the above and just create a <em>Ninja Themed Presentation</em> from the New R Markdown Document menu in RStudio.</p>
  144. <center>
  145. <img src="https://raw.githubusercontent.com/gadenbuie/xaringanthemer/assets/rmarkdown-template-screenshot.png" alt="The 'New R Markdown Document' menu in RStudio" data-external="1">
  146. </center>
  147. </div>
  148. </div>
  149. <div class="section level2">
  150. <h2 id="features">Features<a class="anchor" aria-label="anchor" href="#features"></a>
  151. </h2>
  152. <p>There’s a lot more that <strong>xaringanthemer</strong> can do! <a href="https://pkg.garrickadenbuie.com/xaringanthemer/articles/xaringanthemer.html">Discover xaringanthemer’s features.</a></p>
  153. </div>
  154. </div>
  155. </main><aside class="col-md-3"><div class="links">
  156. <h2 data-toc-skip>Links</h2>
  157. <ul class="list-unstyled">
  158. <li><a href="https://cloud.r-project.org/package=xaringanthemer" class="external-link">View on CRAN</a></li>
  159. <li><a href="https://github.com/gadenbuie/xaringanthemer/" class="external-link">Browse source code</a></li>
  160. <li><a href="https://github.com/gadenbuie/xaringanthemer/issues" class="external-link">Report a bug</a></li>
  161. </ul>
  162. </div>
  163. <div class="license">
  164. <h2 data-toc-skip>License</h2>
  165. <ul class="list-unstyled">
  166. <li><a href="LICENSE.html">Full license</a></li>
  167. <li><small><a href="https://opensource.org/licenses/mit-license.php" class="external-link">MIT</a> + file <a href="LICENSE-text.html">LICENSE</a></small></li>
  168. </ul>
  169. </div>
  170. <div class="citation">
  171. <h2 data-toc-skip>Citation</h2>
  172. <ul class="list-unstyled">
  173. <li><a href="authors.html#citation">Citing xaringanthemer</a></li>
  174. </ul>
  175. </div>
  176. <div class="developers">
  177. <h2 data-toc-skip>Developers</h2>
  178. <ul class="list-unstyled">
  179. <li>
  180. <a href="https://www.garrickadenbuie.com" class="external-link">Garrick Aden-Buie</a> <br><small class="roles"> Author, maintainer </small> <a href="https://orcid.org/0000-0002-7111-0077" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
  181. </ul>
  182. </div>
  183. </aside>
  184. </div>
  185. <footer><div class="pkgdown-footer-left">
  186. <p>Developed by <a href="https://www.garrickadenbuie.com" class="external-link">Garrick Aden-Buie</a>.</p>
  187. </div>
  188. <div class="pkgdown-footer-right">
  189. <p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.1.0.</p>
  190. </div>
  191. </footer>
  192. </div>
  193. <script src="doc-versions.js"></script>
  194. </body>
  195. </html>