😎 Give your xaringan slides some style
Nie możesz wybrać więcej, niż 25 tematów Tematy muszą się zaczynać od litery lub cyfry, mogą zawierać myślniki ('-') i mogą mieć do 35 znaków.

309 lines
14KB

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