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.
285 lines
16 KiB
285 lines
16 KiB
<!-- Generated by pkgdown: do not edit by hand -->
|
|
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<title>A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy — theme_ipsum_ps • hrbrthemes</title>
|
|
|
|
<!-- jquery -->
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js" integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=" crossorigin="anonymous"></script>
|
|
<!-- Bootstrap -->
|
|
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha256-916EbMg70RQy9LHiGkXzG8hSg9EdNy97GazNG/aiY1w=" crossorigin="anonymous" />
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha256-U5ZEeKfGNOja007MMD3YBI0A3OSZOQbeG6z2f2Y0hu8=" crossorigin="anonymous"></script>
|
|
|
|
<!-- Font Awesome icons -->
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" integrity="sha256-eZrrJcwDc/3uDhsdt61sL2oOBY362qM3lon1gyExkL0=" crossorigin="anonymous" />
|
|
|
|
<!-- clipboard.js -->
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.4/clipboard.min.js" integrity="sha256-FiZwavyI2V6+EXO1U+xzLG3IKldpiTFf3153ea9zikQ=" crossorigin="anonymous"></script>
|
|
|
|
<!-- sticky kit -->
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/sticky-kit/1.1.3/sticky-kit.min.js" integrity="sha256-c4Rlo1ZozqTPE2RLuvbusY3+SU1pQaJC0TjuhygMipw=" crossorigin="anonymous"></script>
|
|
|
|
<!-- pkgdown -->
|
|
<link href="../pkgdown.css" rel="stylesheet">
|
|
<script src="../pkgdown.js"></script>
|
|
|
|
|
|
|
|
<meta property="og:title" content="A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy — theme_ipsum_ps" />
|
|
|
|
<meta property="og:description" content="You should import_plex_sans first and also install the fonts on your
|
|
system before trying to use this theme." />
|
|
<meta name="twitter:card" content="summary" />
|
|
|
|
|
|
|
|
<!-- mathjax -->
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
|
|
<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>
|
|
|
|
<!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
|
|
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
|
|
<![endif]-->
|
|
|
|
|
|
</head>
|
|
|
|
<body>
|
|
<div class="container template-reference-topic">
|
|
<header>
|
|
<div class="navbar navbar-default navbar-fixed-top" role="navigation">
|
|
<div class="container">
|
|
<div class="navbar-header">
|
|
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
|
|
<span class="sr-only">Toggle navigation</span>
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
</button>
|
|
<span class="navbar-brand">
|
|
<a class="navbar-link" href="../index.html">hrbrthemes</a>
|
|
<span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.6.0</span>
|
|
</span>
|
|
</div>
|
|
|
|
<div id="navbar" class="navbar-collapse collapse">
|
|
<ul class="nav navbar-nav">
|
|
<li>
|
|
<a href="../index.html">
|
|
<span class="fa fa-home fa-lg"></span>
|
|
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="../reference/index.html">Reference</a>
|
|
</li>
|
|
<li class="dropdown">
|
|
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
|
|
Articles
|
|
|
|
<span class="caret"></span>
|
|
</a>
|
|
<ul class="dropdown-menu" role="menu">
|
|
<li>
|
|
<a href="../articles/why_hrbrthemes.html">Why hrbrthemes?</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href="../news/index.html">Changelog</a>
|
|
</li>
|
|
</ul>
|
|
|
|
<ul class="nav navbar-nav navbar-right">
|
|
<li>
|
|
<a href="https://github.com/hrbrmstr/hrbrthemes">
|
|
<span class="fa fa-github fa-lg"></span>
|
|
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
|
|
</div><!--/.nav-collapse -->
|
|
</div><!--/.container -->
|
|
</div><!--/.navbar -->
|
|
|
|
|
|
</header>
|
|
|
|
<div class="row">
|
|
<div class="col-md-9 contents">
|
|
<div class="page-header">
|
|
<h1>A precise & pristine ggplot2 theme with opinionated defaults and an emphasis on typoghraphy</h1>
|
|
<small class="dont-index">Source: <a href='https://github.com/hrbrmstr/hrbrthemes/blob/master/R/plexsans.R'><code>R/plexsans.R</code></a></small>
|
|
<div class="hidden name"><code>theme_ipsum_ps.Rd</code></div>
|
|
</div>
|
|
|
|
<div class="ref-description">
|
|
|
|
<p>You should <a href='import_plex_sans'>import_plex_sans</a> first and also install the fonts on your
|
|
system before trying to use this theme.</p>
|
|
|
|
</div>
|
|
|
|
<pre class="usage"><span class='fu'>theme_ipsum_ps</span>(<span class='kw'>base_family</span> <span class='kw'>=</span> <span class='st'>"IBMPlexSans"</span>, <span class='kw'>base_size</span> <span class='kw'>=</span> <span class='fl'>11.5</span>,
|
|
<span class='kw'>plot_title_family</span> <span class='kw'>=</span> <span class='st'>"IBMPlexSans-Bold"</span>, <span class='kw'>plot_title_size</span> <span class='kw'>=</span> <span class='fl'>18</span>,
|
|
<span class='kw'>plot_title_face</span> <span class='kw'>=</span> <span class='st'>"plain"</span>, <span class='kw'>plot_title_margin</span> <span class='kw'>=</span> <span class='fl'>10</span>,
|
|
<span class='kw'>subtitle_family</span> <span class='kw'>=</span> <span class='kw'>if</span> (<span class='no'>.Platform</span>$<span class='no'>OS.type</span> <span class='kw'>==</span> <span class='st'>"windows"</span>) <span class='st'>"IBMPlexSans"</span>
|
|
<span class='kw'>else</span> <span class='st'>"IBMPlexSans-Light"</span>, <span class='kw'>subtitle_size</span> <span class='kw'>=</span> <span class='fl'>13</span>,
|
|
<span class='kw'>subtitle_face</span> <span class='kw'>=</span> <span class='st'>"plain"</span>, <span class='kw'>subtitle_margin</span> <span class='kw'>=</span> <span class='fl'>15</span>,
|
|
<span class='kw'>strip_text_family</span> <span class='kw'>=</span> <span class='st'>"IBMPlexSans-Medium"</span>, <span class='kw'>strip_text_size</span> <span class='kw'>=</span> <span class='fl'>12</span>,
|
|
<span class='kw'>strip_text_face</span> <span class='kw'>=</span> <span class='st'>"plain"</span>, <span class='kw'>caption_family</span> <span class='kw'>=</span> <span class='kw'>if</span> (<span class='no'>.Platform</span>$<span class='no'>OS.type</span> <span class='kw'>==</span>
|
|
<span class='st'>"windows"</span>) <span class='st'>"IBMPlexSans"</span> <span class='kw'>else</span> <span class='st'>"IBMPlexSans-Thin"</span>, <span class='kw'>caption_size</span> <span class='kw'>=</span> <span class='fl'>9</span>,
|
|
<span class='kw'>caption_face</span> <span class='kw'>=</span> <span class='st'>"plain"</span>, <span class='kw'>caption_margin</span> <span class='kw'>=</span> <span class='fl'>10</span>, <span class='kw'>axis_text_size</span> <span class='kw'>=</span> <span class='fl'>9</span>,
|
|
<span class='kw'>axis_title_family</span> <span class='kw'>=</span> <span class='no'>base_family</span>, <span class='kw'>axis_title_size</span> <span class='kw'>=</span> <span class='fl'>9</span>,
|
|
<span class='kw'>axis_title_face</span> <span class='kw'>=</span> <span class='st'>"plain"</span>, <span class='kw'>axis_title_just</span> <span class='kw'>=</span> <span class='st'>"rt"</span>,
|
|
<span class='kw'>plot_margin</span> <span class='kw'>=</span> <span class='fu'>margin</span>(<span class='fl'>30</span>, <span class='fl'>30</span>, <span class='fl'>30</span>, <span class='fl'>30</span>), <span class='kw'>grid_col</span> <span class='kw'>=</span> <span class='st'>"#cccccc"</span>,
|
|
<span class='kw'>grid</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>, <span class='kw'>axis_col</span> <span class='kw'>=</span> <span class='st'>"#cccccc"</span>, <span class='kw'>axis</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>, <span class='kw'>ticks</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>)</pre>
|
|
|
|
<h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
|
|
<table class="ref-arguments">
|
|
<colgroup><col class="name" /><col class="desc" /></colgroup>
|
|
<tr>
|
|
<th>base_family, base_size</th>
|
|
<td><p>base font family and size</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>plot_title_family, plot_title_face, plot_title_size, plot_title_margin</th>
|
|
<td><p>plot tilte family, face, size and margin</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>subtitle_family, subtitle_face, subtitle_size</th>
|
|
<td><p>plot subtitle family, face and size</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>subtitle_margin</th>
|
|
<td><p>plot subtitle margin bottom (single numeric value)</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>strip_text_family, strip_text_face, strip_text_size</th>
|
|
<td><p>facet label font family, face and size</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>caption_family, caption_face, caption_size, caption_margin</th>
|
|
<td><p>plot caption family, face, size and margin</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>axis_text_size</th>
|
|
<td><p>font size of axis text</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>axis_title_family, axis_title_face, axis_title_size</th>
|
|
<td><p>axis title font family, face and size</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>axis_title_just</th>
|
|
<td><p>axis title font justificationk one of <code>[blmcrt]</code></p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>plot_margin</th>
|
|
<td><p>plot margin (specify with <a href='https://ggplot2.tidyverse.org/reference/element.html'>ggplot2::margin</a>)</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>grid_col</th>
|
|
<td><p>grid color</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>grid</th>
|
|
<td><p>panel grid (<code>TRUE</code>, <code>FALSE</code>, or a combination of <code>X</code>, <code>x</code>, <code>Y</code>, <code>y</code>)</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>axis_col</th>
|
|
<td><p>axis color</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>axis</th>
|
|
<td><p>add x or y axes? <code>TRUE</code>, <code>FALSE</code>, "<code>xy</code>"</p></td>
|
|
</tr>
|
|
<tr>
|
|
<th>ticks</th>
|
|
<td><p>ticks if <code>TRUE</code> add ticks</p></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
|
|
|
|
<p>There is an option <code>hrbrthemes.loadfonts</code> which -- if set to <code>TRUE</code> -- will
|
|
call <code><a href='https://www.rdocumentation.org/packages/extrafont/topics/loadfonts'>extrafont::loadfonts()</a></code> to register non-core fonts with R PDF & PostScript
|
|
devices. If you are running under Windows, the package calls the same function
|
|
to register non-core fonts with the Windows graphics device.</p>
|
|
|
|
<h2 class="hasAnchor" id="why-ibm-plex-sans-"><a class="anchor" href="#why-ibm-plex-sans-"></a>Why IBM Plex Sans?</h2>
|
|
|
|
|
|
<p>It's free, has tolerable kerning pairs and multiple weights. It's also different
|
|
"not Helvetica".</p>
|
|
|
|
|
|
<h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
|
|
<pre class="examples"><span class='co'># NOT RUN {</span>
|
|
<span class='fu'><a href='https://www.rdocumentation.org/packages/base/topics/library'>library</a></span>(<span class='no'>ggplot2</span>)
|
|
<span class='fu'><a href='https://www.rdocumentation.org/packages/base/topics/library'>library</a></span>(<span class='no'>dplyr</span>)
|
|
|
|
<span class='co'># seminal scatterplot</span>
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/ggplot.html'>ggplot</a></span>(<span class='no'>mtcars</span>, <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/aes.html'>aes</a></span>(<span class='no'>mpg</span>, <span class='no'>wt</span>)) +
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/geom_point.html'>geom_point</a></span>() +
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/labs.html'>labs</a></span>(<span class='kw'>x</span><span class='kw'>=</span><span class='st'>"Fuel effiiency (mpg)"</span>, <span class='kw'>y</span><span class='kw'>=</span><span class='st'>"Weight (tons)"</span>,
|
|
<span class='kw'>title</span><span class='kw'>=</span><span class='st'>"Seminal ggplot2 scatterplot example"</span>,
|
|
<span class='kw'>subtitle</span><span class='kw'>=</span><span class='st'>"A plot that is only useful for demonstration purposes"</span>,
|
|
<span class='kw'>caption</span><span class='kw'>=</span><span class='st'>"Brought to you by the letter 'g'"</span>) +
|
|
<span class='fu'><a href='theme_ipsum_rc.html'>theme_ipsum_rc</a></span>()
|
|
|
|
<span class='co'># seminal bar chart</span>
|
|
|
|
<span class='co'># note: make this font_rc on Windows</span>
|
|
<span class='fu'><a href='update_geom_font_defaults.html'>update_geom_font_defaults</a></span>(<span class='kw'>family</span><span class='kw'>=</span><span class='no'>font_rc_light</span>)
|
|
|
|
<span class='fu'><a href='https://dplyr.tidyverse.org/reference/tally.html'>count</a></span>(<span class='no'>mpg</span>, <span class='no'>class</span>) <span class='kw'>%>%</span>
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/ggplot.html'>ggplot</a></span>(<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/aes.html'>aes</a></span>(<span class='no'>class</span>, <span class='no'>n</span>)) +
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/geom_bar.html'>geom_col</a></span>() +
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/geom_text.html'>geom_text</a></span>(<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/aes.html'>aes</a></span>(<span class='kw'>label</span><span class='kw'>=</span><span class='no'>n</span>), <span class='kw'>nudge_y</span><span class='kw'>=</span><span class='fl'>3</span>) +
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/labs.html'>labs</a></span>(<span class='kw'>x</span><span class='kw'>=</span><span class='st'>"Fuel effiiency (mpg)"</span>, <span class='kw'>y</span><span class='kw'>=</span><span class='st'>"Weight (tons)"</span>,
|
|
<span class='kw'>title</span><span class='kw'>=</span><span class='st'>"Seminal ggplot2 bar chart example"</span>,
|
|
<span class='kw'>subtitle</span><span class='kw'>=</span><span class='st'>"A plot that is only useful for demonstration purposes"</span>,
|
|
<span class='kw'>caption</span><span class='kw'>=</span><span class='st'>"Brought to you by the letter 'g'"</span>) +
|
|
<span class='fu'><a href='theme_ipsum_rc.html'>theme_ipsum_rc</a></span>(<span class='kw'>grid</span><span class='kw'>=</span><span class='st'>"Y"</span>) +
|
|
<span class='fu'><a href='https://ggplot2.tidyverse.org/reference/theme.html'>theme</a></span>(<span class='kw'>axis.text.y</span><span class='kw'>=</span><span class='fu'><a href='https://ggplot2.tidyverse.org/reference/element.html'>element_blank</a></span>())
|
|
<span class='co'># }</span></pre>
|
|
</div>
|
|
<div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
|
|
<h2>Contents</h2>
|
|
<ul class="nav nav-pills nav-stacked">
|
|
<li><a href="#arguments">Arguments</a></li>
|
|
|
|
<li><a href="#details">Details</a></li>
|
|
|
|
<li><a href="#why-ibm-plex-sans-">Why IBM Plex Sans?</a></li>
|
|
|
|
<li><a href="#examples">Examples</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<footer>
|
|
<div class="copyright">
|
|
<p>Developed by Bob Rudis.</p>
|
|
</div>
|
|
|
|
<div class="pkgdown">
|
|
<p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.2.0.</p>
|
|
</div>
|
|
</footer>
|
|
</div>
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|
|
|
|
|