😎 Give your xaringan slides some style
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.

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