Jekyll2022-07-08T11:39:18-04:00https://mmistakes.github.io/minimal-mistakes/feed.xmlMinimal MistakesA flexible Jekyll theme for your blog or site with a minimalist aesthetic.Michael RoseExclude Post from Search Index2017-11-28T00:00:00-05:002018-02-19T08:06:00-05:00https://mmistakes.github.io/minimal-mistakes/jekyll/post-exclude-search<p>This post should not appear in the search index because it has the following YAML Front Matter:</p>
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">search</span><span class="pi">:</span> <span class="no">false</span>
</code></pre></div></div>
<p class="notice--info"><strong>Note:</strong> <code class="language-plaintext highlighter-rouge">search: false</code> only works to exclude posts when using Lunr as a search provider.</p>
<p>To exclude files when using Algolia as a search provider add an array to <code class="language-plaintext highlighter-rouge">algolia.files_to_exclude</code> in your <code class="language-plaintext highlighter-rouge">_config.yml</code>. For more configuration options be sure to check their <a href="https://community.algolia.com/jekyll-algolia/options.html">full documentation</a>.</p>
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">algolia</span><span class="pi">:</span>
<span class="c1"># Exclude more files from indexing</span>
<span class="na">files_to_exclude</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">index.html</span>
<span class="pi">-</span> <span class="s">index.md</span>
<span class="pi">-</span> <span class="s">excluded-file.html</span>
<span class="pi">-</span> <span class="s">_posts/2017-11-28-post-exclude-search.md</span>
<span class="pi">-</span> <span class="s">subdirectory/*.html</span>
</code></pre></div></div>Michael RoseThis post should not appear in the search index because it has the following YAML Front Matter:Layout: Header Video2017-01-23T00:00:00-05:002017-01-23T00:00:00-05:00https://mmistakes.github.io/minimal-mistakes/layout/uncategorized/layout-header-video<p>This post should display a <strong>header with a responsive video</strong>, if the theme supports it.</p>
<h2 id="settings">Settings</h2>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code class="language-plaintext highlighter-rouge">id</code></td>
<td><strong>Required</strong></td>
<td>ID of the video</td>
</tr>
<tr>
<td><code class="language-plaintext highlighter-rouge">provider</code></td>
<td><strong>Required</strong></td>
<td>Hosting provider of the video, either <code class="language-plaintext highlighter-rouge">youtube</code> or <code class="language-plaintext highlighter-rouge">vimeo</code></td>
</tr>
</tbody>
</table>
<h3 id="youtube">YouTube</h3>
<p>To embed the following YouTube video at url <code class="language-plaintext highlighter-rouge">https://www.youtube.com/watch?v=-PVofD2A9t8</code> (long version) or <code class="language-plaintext highlighter-rouge">https://youtu.be/-PVofD2A9t8</code> (short version) into a post or page’s main content you’d use:</p>
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="nv">video</span><span class="w"> </span><span class="na">id</span><span class="o">=</span><span class="s2">"-PVofD2A9t8"</span><span class="w"> </span><span class="na">provider</span><span class="o">=</span><span class="s2">"youtube"</span><span class="w"> </span><span class="p">%}</span>
</code></pre></div></div>
<!-- Courtesy of embedresponsively.com //-->
<div class="responsive-video-container">
<iframe src="https://www.youtube-nocookie.com/embed/-PVofD2A9t8" frameborder="0" webkitallowfullscreen="" mozallowfullscreen="" allowfullscreen=""></iframe>
</div>
<p>To embed it as a video header you’d use the following YAML Front Matter</p>
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">header</span><span class="pi">:</span>
<span class="na">video</span><span class="pi">:</span>
<span class="na">id</span><span class="pi">:</span> <span class="s">-PVofD2A9t8</span>
<span class="na">provider</span><span class="pi">:</span> <span class="s">youtube</span>
</code></pre></div></div>
<h3 id="vimeo">Vimeo</h3>
<p>To embed the following Vimeo video at url <code class="language-plaintext highlighter-rouge">https://vimeo.com/212731897</code> into a post or page’s main content you’d use:</p>
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="nv">video</span><span class="w"> </span><span class="na">id</span><span class="o">=</span><span class="s2">"212731897"</span><span class="w"> </span><span class="na">provider</span><span class="o">=</span><span class="s2">"vimeo"</span><span class="w"> </span><span class="p">%}</span>
</code></pre></div></div>
<!-- Courtesy of embedresponsively.com //-->
<div class="responsive-video-container">
<iframe src="https://player.vimeo.com/video/212731897?dnt=true" frameborder="0" webkitallowfullscreen="" mozallowfullscreen="" allowfullscreen=""></iframe>
</div>
<p>To embed it as a video header you’d use the following YAML Front Matter</p>
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">header</span><span class="pi">:</span>
<span class="na">video</span><span class="pi">:</span>
<span class="na">id</span><span class="pi">:</span> <span class="m">212731897</span>
<span class="na">provider</span><span class="pi">:</span> <span class="s">vimeo</span>
</code></pre></div></div>Michael RoseThis post should display a header with a responsive video, if the theme supports it.Gemified Theme – Beta Release2016-10-06T00:00:00-04:002018-03-20T16:01:04-04:00https://mmistakes.github.io/minimal-mistakes/jekyll/gemified-theme-beta<p>Hot on the heels of Jekyll v3.3.0 is a beta release of Minimal Mistakes… as a gemified theme.</p>
<p><a href="https://rubygems.org/gems/minimal-mistakes-jekyll"><code class="language-plaintext highlighter-rouge">minimal-mistakes-jekyll</code></a> can only be used with Jekyll proper. If you’re hosting on GitHub Pages or using that gem the theme won’t work. 3rd party themes haven’t been white-listed so it’s a no go for now.</p>
<p>Fine with all that? Great. Let’s continue.</p>
<p>If you’re migrating a site already using Minimal Mistakes and haven’t customized any of the <code class="language-plaintext highlighter-rouge">_includes</code>, <code class="language-plaintext highlighter-rouge">_layouts</code>, <code class="language-plaintext highlighter-rouge">_sass</code> partials, or <code class="language-plaintext highlighter-rouge">assets</code> this should be quick and painless.</p>
<h2 id="step-1-remove-theme-files">Step 1: Remove Theme Files</h2>
<p>Remove <code class="language-plaintext highlighter-rouge">_includes</code>, <code class="language-plaintext highlighter-rouge">_layouts</code>, <code class="language-plaintext highlighter-rouge">_sass</code>, <code class="language-plaintext highlighter-rouge">assets</code> folders and files within. You won’t need these anymore as they’re bundled in the theme.</p>
<p>If you customized any of these then leave them alone and only remove the untouched ones. If setup correctly your modified versions should act as <a href="http://jekyllrb.com/docs/themes/#overriding-theme-defaults">overrides</a> to the versions bundled with the theme.</p>
<h2 id="step-2-update-gemfile">Step 2: Update <code class="language-plaintext highlighter-rouge">Gemfile</code></h2>
<p>Replace <code class="language-plaintext highlighter-rouge">gem "github-pages</code> or <code class="language-plaintext highlighter-rouge">gem "jekyll"</code> with <code class="language-plaintext highlighter-rouge">gem "jekyll", "~> 3.3.0"</code>. You’ll need the latest version of Jekyll<sup id="fnref:update-jekyll" role="doc-noteref"><a href="#fn:update-jekyll" class="footnote" rel="footnote">1</a></sup> for Minimal Mistakes to work and load all of the /assets/ properly.</p>
<p>Add the Minimal Mistakes theme gem:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s2">"minimal-mistakes-jekyll"</span>
</code></pre></div></div>
<p>When finished your <code class="language-plaintext highlighter-rouge">Gemfile</code> should look something like this:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s2">"https://rubygems.org"</span>
<span class="n">gem</span> <span class="s2">"jekyll"</span><span class="p">,</span> <span class="s2">"~> 3.3.0"</span>
<span class="n">gem</span> <span class="s2">"minimal-mistakes-jekyll"</span>
</code></pre></div></div>
<h2 id="step-3-run-bundler">Step 3: Run Bundler</h2>
<p>Run <code class="language-plaintext highlighter-rouge">bundle install</code> (or <code class="language-plaintext highlighter-rouge">bundle update</code> if you’re updating an existing repo) to install/update Jekyll and the theme.</p>
<h2 id="step-4-install-the-theme">Step 4: Install the Theme</h2>
<p>Add <code class="language-plaintext highlighter-rouge">theme: "minimal-mistakes-jekyll"</code> to your <code class="language-plaintext highlighter-rouge">_config.yml</code> file.</p>
<p>If you’re migrating from an existing Minimal Mistakes site you shouldn’t have to change anything else after this. If it’s a new site consult then docs to <a href="/minimal-mistakes/docs/configuration/">properly config</a>.</p>
<p class="notice--danger"><strong>Please Note:</strong> Paths for image headers, overlays, teasers, <a href="/minimal-mistakes/docs/helpers/#gallery">galleries</a>, and <a href="/minimal-mistakes/docs/helpers/#feature-row">feature rows</a> have changed and now require a full path. Instead of just <code class="language-plaintext highlighter-rouge">image: filename.jpg</code> you’ll need to use the full path eg: <code class="language-plaintext highlighter-rouge">image: assets/images/filename.jpg</code>. The preferred location is now <code class="language-plaintext highlighter-rouge">assets/images</code> but can be placed elsewhere or external hosted. This all applies for image references in <code class="language-plaintext highlighter-rouge">_config.yml</code> and <code class="language-plaintext highlighter-rouge">author.yml</code> as well.</p>
<h2 id="step-5-jekyll-new-tweaks">Step 5: <code class="language-plaintext highlighter-rouge">jekyll new</code> Tweaks</h2>
<p>If this is a new site be sure to add the following files to <code class="language-plaintext highlighter-rouge">_data/</code> and customize as you see fit. There is currently no way of bundling them in with the theme, so be sure to consult the docs on how to properly use both.</p>
<ul>
<li><a href="https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml"><code class="language-plaintext highlighter-rouge">_data/ui-text.yml</code></a> - UI text <a href="/minimal-mistakes/docs/ui-text/">documentation</a></li>
<li><a href="https://github.com/mmistakes/minimal-mistakes/blob/master/_data/navigation.yml"><code class="language-plaintext highlighter-rouge">_data/navigation.yml</code></a> - navigation <a href="/minimal-mistakes/docs/navigation/">documentation</a></li>
</ul>
<p>You’ll also need to:</p>
<ul>
<li>Replace <code class="language-plaintext highlighter-rouge"><site root>/index.html</code> with a modified <a href="https://github.com/mmistakes/minimal-mistakes/blob/master/index.html">Minimal Mistakes <code class="language-plaintext highlighter-rouge">index.html</code></a>.</li>
<li>Change <code class="language-plaintext highlighter-rouge">layout: post</code> in <code class="language-plaintext highlighter-rouge">_posts/0000-00-00-welcome-to-jekyll.markdown</code> to <code class="language-plaintext highlighter-rouge">layout: single</code>.</li>
<li>Remove <code class="language-plaintext highlighter-rouge">about.md</code>, or at the very least change <code class="language-plaintext highlighter-rouge">layout: page</code> to <code class="language-plaintext highlighter-rouge">layout: single</code> and remove references to <code class="language-plaintext highlighter-rouge">icon-github.html</code> (or <a href="https://github.com/jekyll/minima/tree/master/_includes">copy to your <code class="language-plaintext highlighter-rouge">_includes</code></a> if using).</li>
</ul>
<hr />
<p>That’s it! If all goes well running <code class="language-plaintext highlighter-rouge">bundle exec jekyll serve</code> should spin-up your site. If you encounter any bumps please file an issue on GitHub and make sure to indicate you’re testing the pre-release Ruby gem version.</p>
<p><a href="https://github.com/mmistakes/minimal-mistakes/issues/new" class="btn btn--info btn--large">File an issue</a></p>
<p>Thanks!</p>
<div class="footnotes" role="doc-endnotes">
<ol>
<li id="fn:update-jekyll" role="doc-endnote">
<p>You could also run <code class="language-plaintext highlighter-rouge">bundle update jekyll</code> to update Jekyll. <a href="#fnref:update-jekyll" class="reversefootnote" role="doc-backlink">↩</a></p>
</li>
</ol>
</div>Michael RoseHot on the heels of Jekyll v3.3.0 is a beta release of Minimal Mistakes… as a gemified theme.Gemified Theme – Alpha Release2016-09-21T00:00:00-04:002018-03-20T16:00:58-04:00https://mmistakes.github.io/minimal-mistakes/jekyll/gemified-theme-alpha<p>Jekyll <a href="http://jekyllrb.com/docs/themes/">themes distributed as Ruby gems</a> are finally here to make installing and upgrading much easier. Gone are the days of forking a repo just to “install it”. Or dealing with merge conflicts when pulling in upstream commits to “upgrade it”.</p>
<p>If you’re interested in testing out Minimal Mistakes as a gemified theme read on. There are a few caveats though:</p>
<ol>
<li>Support for a theme <code class="language-plaintext highlighter-rouge">assets</code> folder was recently <a href="https://github.com/jekyll/jekyll/pull/5364">added to Jekyll core</a>, but has yet to be released or rolled into the <code class="language-plaintext highlighter-rouge">github-pages</code> gem. Meaning you can’t use Minimal Mistakes as a Ruby gem there just yet… locally served or self-hosted installs should be fine if you don’t mind using a pre-release version of Jekyll.</li>
<li>Windows users can’t currently use themes packaged as gems due to a <a href="https://github.com/jekyll/jekyll/issues/5192">bug with file paths</a> in Jekyll core. This is being worked on so hopefully a <a href="https://github.com/jekyll/jekyll/pull/5256">fix is on the way</a> soon.</li>
</ol>
<p>Fine with all that? Great. Let’s continue.</p>
<p>If you’re migrating a site already using Minimal Mistakes and haven’t customized any of the <code class="language-plaintext highlighter-rouge">_includes</code>, <code class="language-plaintext highlighter-rouge">_layouts</code>, <code class="language-plaintext highlighter-rouge">_sass</code> partials, or <code class="language-plaintext highlighter-rouge">assets</code> this should be quick and painless.</p>
<h2 id="step-1-remove-theme-files">Step 1: Remove Theme Files</h2>
<p>Remove <code class="language-plaintext highlighter-rouge">_includes</code>, <code class="language-plaintext highlighter-rouge">_layouts</code>, <code class="language-plaintext highlighter-rouge">_sass</code>, <code class="language-plaintext highlighter-rouge">assets</code> folders and files within. You won’t need these anymore as they’re bundled in the theme.</p>
<p>If you customized any of these then leave them alone and only remove the untouched ones. If setup correctly your modified versions should act as <a href="http://jekyllrb.com/docs/themes/#overriding-theme-defaults">overrides</a> to the versions bundled with the theme.</p>
<h2 id="step-2-update-gemfile">Step 2: Update <code class="language-plaintext highlighter-rouge">Gemfile</code></h2>
<p>In order to test you’ll need to install pre-release gems of Jekyll and Minimal Mistakes.</p>
<p>Start by replacing <code class="language-plaintext highlighter-rouge">gem "github-pages"</code> or <code class="language-plaintext highlighter-rouge">gem "jekyll"</code> with the following:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s2">"jekyll"</span><span class="p">,</span> <span class="ss">:git</span> <span class="o">=></span> <span class="s2">"https://github.com/jekyll/jekyll.git"</span>
</code></pre></div></div>
<p>Then add the pre-release Minimal Mistakes theme gem:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s2">"minimal-mistakes-jekyll"</span><span class="p">,</span> <span class="ss">:git</span> <span class="o">=></span> <span class="s2">"https://github.com/mmistakes/minimal-mistakes.git"</span><span class="p">,</span> <span class="ss">:branch</span> <span class="o">=></span> <span class="s2">"feature/theme-gem"</span><span class="sb">`
</span></code></pre></div></div>
<p>When finished your <code class="language-plaintext highlighter-rouge">Gemfile</code> should look something like this:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s2">"https://rubygems.org"</span>
<span class="n">gem</span> <span class="s2">"jekyll"</span><span class="p">,</span> <span class="ss">:git</span> <span class="o">=></span> <span class="s2">"https://github.com/jekyll/jekyll.git"</span>
<span class="n">gem</span> <span class="s2">"minimal-mistakes-jekyll"</span><span class="p">,</span> <span class="ss">:git</span> <span class="o">=></span> <span class="s2">"https://github.com/mmistakes/minimal-mistakes.git"</span><span class="p">,</span> <span class="ss">:branch</span> <span class="o">=></span> <span class="s2">"feature/theme-gem"</span>
<span class="n">group</span> <span class="ss">:jekyll_plugins</span> <span class="k">do</span>
<span class="c1"># gem "jekyll-archives"</span>
<span class="n">gem</span> <span class="s2">"jekyll-paginate"</span>
<span class="n">gem</span> <span class="s2">"jekyll-sitemap"</span>
<span class="n">gem</span> <span class="s2">"jekyll-gist"</span>
<span class="n">gem</span> <span class="s2">"jekyll-feed"</span>
<span class="k">end</span>
</code></pre></div></div>
<h2 id="step-3-run-bundler">Step 3: Run Bundler</h2>
<p>Run <code class="language-plaintext highlighter-rouge">bundle install</code> (or <code class="language-plaintext highlighter-rouge">bundle update</code> if you’re updating an existing repo) to install the pre-release gems.</p>
<h2 id="step-4-install-the-theme">Step 4: Install the Theme</h2>
<p>Add <code class="language-plaintext highlighter-rouge">theme: "minimal-mistakes-jekyll"</code> to your <code class="language-plaintext highlighter-rouge">_config.yml</code> file.</p>
<p>If you’re migrating from an existing Minimal Mistakes site you shouldn’t have to change anything else after this. If it’s a new site consult then docs to <a href="/minimal-mistakes/docs/configuration/">properly config</a>.</p>
<p class="notice--danger"><strong>Please Note:</strong> Paths for image headers, overlays, teasers, <a href="/minimal-mistakes/docs/helpers/#gallery">galleries</a>, and <a href="/minimal-mistakes/docs/helpers/#feature-row">feature rows</a> have changed and now require a full path. Instead of just <code class="language-plaintext highlighter-rouge">image: filename.jpg</code> you’ll need to use the full path eg: <code class="language-plaintext highlighter-rouge">image: assets/images/filename.jpg</code>. The preferred location is now <code class="language-plaintext highlighter-rouge">assets/images</code> but can be placed elsewhere or external hosted. This applies for image references in <code class="language-plaintext highlighter-rouge">_config.yml</code> and <code class="language-plaintext highlighter-rouge">author.yml</code>.</p>
<h2 id="step-5-jekyll-new-tweaks">Step 5: <code class="language-plaintext highlighter-rouge">jekyll new</code> Tweaks</h2>
<p>If this is a new site be sure to add the following files to <code class="language-plaintext highlighter-rouge">_data/</code> and customize as you see fit. There is currently no way of bundling them in with the theme, so be sure to consult the docs on how to properly use both.</p>
<ul>
<li><a href="https://github.com/mmistakes/minimal-mistakes/blob/master/_data/ui-text.yml"><code class="language-plaintext highlighter-rouge">_data/ui-text.yml</code></a> - UI text <a href="/minimal-mistakes/docs/ui-text/">documentation</a></li>
<li><a href="https://github.com/mmistakes/minimal-mistakes/blob/master/_data/navigation.yml"><code class="language-plaintext highlighter-rouge">_data/navigation.yml</code></a> - navigation <a href="/minimal-mistakes/docs/navigation/">documentation</a></li>
</ul>
<p>You’ll also need to:</p>
<ul>
<li>Replace <code class="language-plaintext highlighter-rouge"><site root>/index.html</code> with a modified <a href="https://github.com/mmistakes/minimal-mistakes/blob/master/index.html">Minimal Mistakes <code class="language-plaintext highlighter-rouge">index.html</code></a>.</li>
<li>Change <code class="language-plaintext highlighter-rouge">layout: post</code> in <code class="language-plaintext highlighter-rouge">_posts/0000-00-00-welcome-to-jekyll.markdown</code> to <code class="language-plaintext highlighter-rouge">layout: single</code>.</li>
<li>Remove <code class="language-plaintext highlighter-rouge">about.md</code>, or at the very least change <code class="language-plaintext highlighter-rouge">layout: page</code> to <code class="language-plaintext highlighter-rouge">layout: single</code> and remove references to <code class="language-plaintext highlighter-rouge">icon-github.html</code> (or <a href="https://github.com/jekyll/minima/tree/master/_includes">copy to your <code class="language-plaintext highlighter-rouge">_includes</code></a> if using).</li>
</ul>
<hr />
<p>That’s it! If all goes well running <code class="language-plaintext highlighter-rouge">bundle exec jekyll serve</code> should spin-up your site. If you encounter any bumps please file an issue on GitHub and make sure to indicate you’re testing the pre-release Ruby gem version.</p>
<p><a href="https://github.com/mmistakes/minimal-mistakes/issues/new" class="btn btn--info btn--large">File an issue</a></p>
<p>Thanks!</p>Michael RoseJekyll themes distributed as Ruby gems are finally here to make installing and upgrading much easier. Gone are the days of forking a repo just to “install it”. Or dealing with merge conflicts when pulling in upstream commits to “upgrade it”.Welcome to Jekyll!2016-02-24T00:00:00-05:002016-02-24T00:00:00-05:00https://mmistakes.github.io/minimal-mistakes/jekyll/welcome-to-jekyll<p>You’ll find this post in your <code class="language-plaintext highlighter-rouge">_posts</code> directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, which launches a web server and auto-regenerates your site when a file is updated.</p>
<p>To add new posts, simply add a file in the <code class="language-plaintext highlighter-rouge">_posts</code> directory that follows the convention <code class="language-plaintext highlighter-rouge">YYYY-MM-DD-name-of-post.ext</code> and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.</p>
<p>Jekyll also offers powerful support for code snippets:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">def</span> <span class="nf">print_hi</span><span class="p">(</span><span class="nb">name</span><span class="p">)</span>
<span class="nb">puts</span> <span class="s2">"Hi, </span><span class="si">#{</span><span class="nb">name</span><span class="si">}</span><span class="s2">"</span>
<span class="k">end</span>
<span class="n">print_hi</span><span class="p">(</span><span class="s1">'Tom'</span><span class="p">)</span>
<span class="c1">#=> prints 'Hi, Tom' to STDOUT.</span>
</code></pre></div></div>
<p>Check out the <a href="http://jekyllrb.com/docs/home">Jekyll docs</a> for more info on how to get the most out of Jekyll. File all bugs/feature requests at <a href="https://github.com/jekyll/jekyll">Jekyll’s GitHub repo</a>. If you have questions, you can ask them on <a href="https://talk.jekyllrb.com/">Jekyll Talk</a>.</p>Michael RoseYou’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.Markup: Syntax Highlighting2013-08-16T00:00:00-04:002018-01-03T09:45:06-05:00https://mmistakes.github.io/minimal-mistakes/markup-syntax-highlighting<p>Syntax highlighting is a feature that displays source code, in different colors and fonts according to the category of terms. This feature facilitates writing in a structured language such as a programming language or a markup language as both structures and syntax errors are visually distinct. Highlighting does not affect the meaning of the text itself; it is intended only for human readers.<sup id="fnref:1" role="doc-noteref"><a href="#fn:1" class="footnote" rel="footnote">1</a></sup></p>
<h3 id="gfm-code-blocks">GFM Code Blocks</h3>
<p>GitHub Flavored Markdown <a href="https://help.github.com/articles/creating-and-highlighting-code-blocks/">fenced code blocks</a> are supported. To modify styling and highlight colors edit <code class="language-plaintext highlighter-rouge">/_sass/syntax.scss</code>.</p>
<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nf">#container</span> <span class="p">{</span>
<span class="nl">float</span><span class="p">:</span> <span class="nb">left</span><span class="p">;</span>
<span class="nl">margin</span><span class="p">:</span> <span class="m">0</span> <span class="m">-240px</span> <span class="m">0</span> <span class="m">0</span><span class="p">;</span>
<span class="nl">width</span><span class="p">:</span> <span class="m">100%</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>
<figure class="highlight"><pre><code class="language-scss" data-lang="scss"><span class="nc">.highlight</span> <span class="p">{</span>
<span class="nl">margin</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
<span class="nl">padding</span><span class="p">:</span> <span class="m">1em</span><span class="p">;</span>
<span class="nl">font-family</span><span class="p">:</span> <span class="nv">$monospace</span><span class="p">;</span>
<span class="nl">font-size</span><span class="p">:</span> <span class="nv">$type-size-7</span><span class="p">;</span>
<span class="nl">line-height</span><span class="p">:</span> <span class="m">1</span><span class="mi">.8</span><span class="p">;</span>
<span class="p">}</span></code></pre></figure>
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><nav</span> <span class="na">class=</span><span class="s">"pagination"</span> <span class="na">role=</span><span class="s">"navigation"</span><span class="nt">></span>
{% if page.previous %}
<span class="nt"><a</span> <span class="na">href=</span><span class="s">"{{ site.url }}{{ page.previous.url }}"</span> <span class="na">class=</span><span class="s">"btn"</span> <span class="na">title=</span><span class="s">"{{ page.previous.title }}"</span><span class="nt">></span>Previous article<span class="nt"></a></span>
{% endif %}
{% if page.next %}
<span class="nt"><a</span> <span class="na">href=</span><span class="s">"{{ site.url }}{{ page.next.url }}"</span> <span class="na">class=</span><span class="s">"btn"</span> <span class="na">title=</span><span class="s">"{{ page.next.title }}"</span><span class="nt">></span>Next article<span class="nt"></a></span>
{% endif %}
<span class="nt"></nav></span><span class="c"><!-- /.pagination --></span>
</code></pre></div></div>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
<span class="k">class</span> <span class="nc">TagIndex</span> <span class="o"><</span> <span class="no">Page</span>
<span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">site</span><span class="p">,</span> <span class="n">base</span><span class="p">,</span> <span class="n">dir</span><span class="p">,</span> <span class="n">tag</span><span class="p">)</span>
<span class="vi">@site</span> <span class="o">=</span> <span class="n">site</span>
<span class="vi">@base</span> <span class="o">=</span> <span class="n">base</span>
<span class="vi">@dir</span> <span class="o">=</span> <span class="n">dir</span>
<span class="vi">@name</span> <span class="o">=</span> <span class="s1">'index.html'</span>
<span class="nb">self</span><span class="p">.</span><span class="nf">process</span><span class="p">(</span><span class="vi">@name</span><span class="p">)</span>
<span class="nb">self</span><span class="p">.</span><span class="nf">read_yaml</span><span class="p">(</span><span class="no">File</span><span class="p">.</span><span class="nf">join</span><span class="p">(</span><span class="n">base</span><span class="p">,</span> <span class="s1">'_layouts'</span><span class="p">),</span> <span class="s1">'tag_index.html'</span><span class="p">)</span>
<span class="nb">self</span><span class="p">.</span><span class="nf">data</span><span class="p">[</span><span class="s1">'tag'</span><span class="p">]</span> <span class="o">=</span> <span class="n">tag</span>
<span class="n">tag_title_prefix</span> <span class="o">=</span> <span class="n">site</span><span class="p">.</span><span class="nf">config</span><span class="p">[</span><span class="s1">'tag_title_prefix'</span><span class="p">]</span> <span class="o">||</span> <span class="s1">'Tagged: '</span>
<span class="n">tag_title_suffix</span> <span class="o">=</span> <span class="n">site</span><span class="p">.</span><span class="nf">config</span><span class="p">[</span><span class="s1">'tag_title_suffix'</span><span class="p">]</span> <span class="o">||</span> <span class="s1">'&#8211;'</span>
<span class="nb">self</span><span class="p">.</span><span class="nf">data</span><span class="p">[</span><span class="s1">'title'</span><span class="p">]</span> <span class="o">=</span> <span class="s2">"</span><span class="si">#{</span><span class="n">tag_title_prefix</span><span class="si">}#{</span><span class="n">tag</span><span class="si">}</span><span class="s2">"</span>
<span class="nb">self</span><span class="p">.</span><span class="nf">data</span><span class="p">[</span><span class="s1">'description'</span><span class="p">]</span> <span class="o">=</span> <span class="s2">"An archive of posts tagged </span><span class="si">#{</span><span class="n">tag</span><span class="si">}</span><span class="s2">."</span>
<span class="k">end</span>
<span class="k">end</span>
<span class="k">end</span>
</code></pre></div></div>
<h3 id="code-blocks-in-lists">Code Blocks in Lists</h3>
<p>Indentation matters. Be sure the indent of the code block aligns with the first non-space character after the list item marker (e.g., <code class="language-plaintext highlighter-rouge">1.</code>). Usually this will mean indenting 3 spaces instead of 4.</p>
<ol>
<li>Do step 1.</li>
<li>
<p>Now do this:</p>
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">def</span> <span class="nf">print_hi</span><span class="p">(</span><span class="nb">name</span><span class="p">)</span>
<span class="nb">puts</span> <span class="s2">"Hi, </span><span class="si">#{</span><span class="nb">name</span><span class="si">}</span><span class="s2">"</span>
<span class="k">end</span>
<span class="n">print_hi</span><span class="p">(</span><span class="s1">'Tom'</span><span class="p">)</span>
<span class="c1">#=> prints 'Hi, Tom' to STDOUT.</span>
</code></pre></div> </div>
</li>
<li>Now you can do this.</li>
</ol>
<h3 id="jekyll-highlight-tag">Jekyll Highlight Tag</h3>
<p>An example of a code blocking using Jekyll’s <a href="https://jekyllrb.com/docs/templates/#code-snippet-highlighting"><code class="language-plaintext highlighter-rouge">{% highlight %}</code> tag</a>.</p>
<figure class="highlight"><pre><code class="language-javascript" data-lang="javascript"><table class="rouge-table"><tbody><tr><td class="gutter gl"><pre class="lineno">1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
</pre></td><td class="code"><pre><span class="c1">// 'gulp html' -- does nothing</span>
<span class="c1">// 'gulp html --prod' -- minifies and gzips HTML files for production</span>
<span class="nx">gulp</span><span class="p">.</span><span class="nx">task</span><span class="p">(</span><span class="dl">'</span><span class="s1">html</span><span class="dl">'</span><span class="p">,</span> <span class="p">()</span> <span class="o">=></span> <span class="p">{</span>
<span class="k">return</span> <span class="nx">gulp</span><span class="p">.</span><span class="nx">src</span><span class="p">(</span><span class="nx">paths</span><span class="p">.</span><span class="nx">siteFolderName</span> <span class="o">+</span> <span class="nx">paths</span><span class="p">.</span><span class="nx">htmlPattern</span><span class="p">)</span>
<span class="p">.</span><span class="nx">pipe</span><span class="p">(</span><span class="nx">when</span><span class="p">(</span><span class="nx">argv</span><span class="p">.</span><span class="nx">prod</span><span class="p">,</span> <span class="nx">htmlmin</span><span class="p">({</span>
<span class="na">removeComments</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
<span class="na">collapseWhitespace</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
<span class="na">collapseBooleanAttributes</span><span class="p">:</span> <span class="kc">false</span><span class="p">,</span>
<span class="na">removeAttributeQuotes</span><span class="p">:</span> <span class="kc">false</span><span class="p">,</span>
<span class="na">removeRedundantAttributes</span><span class="p">:</span> <span class="kc">false</span><span class="p">,</span>
<span class="na">minifyJS</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
<span class="na">minifyCSS</span><span class="p">:</span> <span class="kc">true</span>
<span class="p">})))</span>
<span class="p">.</span><span class="nx">pipe</span><span class="p">(</span><span class="nx">when</span><span class="p">(</span><span class="nx">argv</span><span class="p">.</span><span class="nx">prod</span><span class="p">,</span> <span class="nx">size</span><span class="p">({</span><span class="na">title</span><span class="p">:</span> <span class="dl">'</span><span class="s1">optimized HTML</span><span class="dl">'</span><span class="p">})))</span>
<span class="p">.</span><span class="nx">pipe</span><span class="p">(</span><span class="nx">when</span><span class="p">(</span><span class="nx">argv</span><span class="p">.</span><span class="nx">prod</span><span class="p">,</span> <span class="nx">gulp</span><span class="p">.</span><span class="nx">dest</span><span class="p">(</span><span class="nx">paths</span><span class="p">.</span><span class="nx">siteFolderName</span><span class="p">)))</span>
<span class="p">.</span><span class="nx">pipe</span><span class="p">(</span><span class="nx">when</span><span class="p">(</span><span class="nx">argv</span><span class="p">.</span><span class="nx">prod</span><span class="p">,</span> <span class="nx">gzip</span><span class="p">({</span><span class="na">append</span><span class="p">:</span> <span class="kc">true</span><span class="p">})))</span>
<span class="p">.</span><span class="nx">pipe</span><span class="p">(</span><span class="nx">when</span><span class="p">(</span><span class="nx">argv</span><span class="p">.</span><span class="nx">prod</span><span class="p">,</span> <span class="nx">size</span><span class="p">({</span>
<span class="na">title</span><span class="p">:</span> <span class="dl">'</span><span class="s1">gzipped HTML</span><span class="dl">'</span><span class="p">,</span>
<span class="na">gzip</span><span class="p">:</span> <span class="kc">true</span>
<span class="p">})))</span>
<span class="p">.</span><span class="nx">pipe</span><span class="p">(</span><span class="nx">when</span><span class="p">(</span><span class="nx">argv</span><span class="p">.</span><span class="nx">prod</span><span class="p">,</span> <span class="nx">gulp</span><span class="p">.</span><span class="nx">dest</span><span class="p">(</span><span class="nx">paths</span><span class="p">.</span><span class="nx">siteFolderName</span><span class="p">)))</span>
<span class="p">});</span>
</pre></td></tr></tbody></table></code></pre></figure>
<figure class="highlight"><pre><code class="language-wl" data-lang="wl"><table class="rouge-table"><tbody><tr><td class="gutter gl"><pre class="lineno">1
2
3
4
</pre></td><td class="code"><pre><span class="bp">Module</span><span class="p">[{}</span><span class="o">,</span><span class="w">
</span><span class="nb">Sqrt</span><span class="p">[</span><span class="m">2</span><span class="p">]</span><span class="w">
</span><span class="m">4</span><span class="w">
</span><span class="p">]</span>
</pre></td></tr></tbody></table></code></pre></figure>
<h3 id="github-gist-embed">GitHub Gist Embed</h3>
<p>An example of a Gist embed below.</p>
<script src="https://gist.github.com/mmistakes/77c68fbb07731a456805a7b473f47841.js"></script>
<div class="footnotes" role="doc-endnotes">
<ol>
<li id="fn:1" role="doc-endnote">
<p><a href="http://en.wikipedia.org/wiki/Syntax_highlighting">http://en.wikipedia.org/wiki/Syntax_highlighting</a> <a href="#fnref:1" class="reversefootnote" role="doc-backlink">↩</a></p>
</li>
</ol>
</div>Michael RosePost displaying the various ways of highlighting code in Markdown.Markup: Another Post with Images2013-05-22T00:00:00-04:002013-05-22T00:00:00-04:00https://mmistakes.github.io/minimal-mistakes/markup-more-images<p>Here are some examples of what a post with images might look like. If you want to display two or three images next to each other responsively use <code class="language-plaintext highlighter-rouge">figure</code> with the appropriate <code class="language-plaintext highlighter-rouge">class</code>. Each instance of <code class="language-plaintext highlighter-rouge">figure</code> is auto-numbered and displayed in the caption.</p>
<h3 id="figures-for-images-or-video">Figures (for images or video)</h3>
<h4 id="one-up">One Up</h4>
<figure>
<a href="http://farm9.staticflickr.com/8426/7758832526_cc8f681e48_b.jpg"><img src="http://farm9.staticflickr.com/8426/7758832526_cc8f681e48_c.jpg" /></a>
<figcaption><a href="http://www.flickr.com/photos/80901381@N04/7758832526/" title="Morning Fog Emerging From Trees by A Guy Taking Pictures, on Flickr">Morning Fog Emerging From Trees by A Guy Taking Pictures, on Flickr</a>.</figcaption>
</figure>
<p>Vero laborum commodo occupy. Semiotics voluptate mumblecore pug. Cosby sweater ullamco quinoa ennui assumenda, sapiente occupy delectus lo-fi. Ea fashion axe Marfa cillum aliquip. Retro Bushwick keytar cliche. Before they sold out sustainable gastropub Marfa readymade, ethical Williamsburg skateboard brunch qui consectetur gentrify semiotics. Mustache cillum irony, fingerstache magna pour-over keffiyeh tousled selfies.</p>
<h4 id="two-up">Two Up</h4>
<p>Apply the <code class="language-plaintext highlighter-rouge">half</code> class like so to display two images side by side that share the same caption.</p>
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><figure</span> <span class="na">class=</span><span class="s">"half"</span><span class="nt">></span>
<span class="nt"><a</span> <span class="na">href=</span><span class="s">"/assets/images/image-filename-1-large.jpg"</span><span class="nt">><img</span> <span class="na">src=</span><span class="s">"/assets/images/image-filename-1.jpg"</span><span class="nt">></a></span>
<span class="nt"><a</span> <span class="na">href=</span><span class="s">"/assets/images/image-filename-2-large.jpg"</span><span class="nt">><img</span> <span class="na">src=</span><span class="s">"/assets/images/image-filename-2.jpg"</span><span class="nt">></a></span>
<span class="nt"><figcaption></span>Caption describing these two images.<span class="nt"></figcaption></span>
<span class="nt"></figure></span>
</code></pre></div></div>
<p>And you’ll get something that looks like this:</p>
<figure class="half">
<a href="http://placehold.it/1200x600.JPG"><img src="http://placehold.it/600x300.jpg" /></a>
<a href="http://placehold.it/1200x600.jpeg"><img src="http://placehold.it/600x300.jpg" /></a>
<figcaption>Two images.</figcaption>
</figure>
<h4 id="three-up">Three Up</h4>
<p>Apply the <code class="language-plaintext highlighter-rouge">third</code> class like so to display three images side by side that share the same caption.</p>
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><figure</span> <span class="na">class=</span><span class="s">"third"</span><span class="nt">></span>
<span class="nt"><img</span> <span class="na">src=</span><span class="s">"/images/image-filename-1.jpg"</span><span class="nt">></span>
<span class="nt"><img</span> <span class="na">src=</span><span class="s">"/images/image-filename-2.jpg"</span><span class="nt">></span>
<span class="nt"><img</span> <span class="na">src=</span><span class="s">"/images/image-filename-3.jpg"</span><span class="nt">></span>
<span class="nt"><figcaption></span>Caption describing these three images.<span class="nt"></figcaption></span>
<span class="nt"></figure></span>
</code></pre></div></div>
<p>And you’ll get something that looks like this:</p>
<figure class="third">
<img src="http://placehold.it/600x300.jpg" />
<img src="http://placehold.it/600x300.jpg" />
<img src="http://placehold.it/600x300.jpg" />
<figcaption>Three images.</figcaption>
</figure>Michael RoseExamples and code for displaying images in posts.Markup: HTML Tags and Formatting2013-01-11T00:00:00-05:002013-01-11T00:00:00-05:00https://mmistakes.github.io/minimal-mistakes/markup/markup-html-tags-and-formatting<p>A variety of common markup showing how the theme styles them.</p>
<h2 id="header-two">Header two</h2>
<h3 id="header-three">Header three</h3>
<h4 id="header-four">Header four</h4>
<h5 id="header-five">Header five</h5>
<h6 id="header-six">Header six</h6>
<h2 id="blockquotes">Blockquotes</h2>
<p>Single line blockquote:</p>
<blockquote>
<p>Stay hungry. Stay foolish.</p>
</blockquote>
<p>Multi line blockquote with a cite reference:</p>
<blockquote>
<p>People think focus means saying yes to the thing you’ve got to focus on. But that’s not what it means at all. It means saying no to the hundred other good ideas that there are. You have to pick carefully. I’m actually as proud of the things we haven’t done as the things I have done. Innovation is saying no to 1,000 things.</p>
</blockquote>
<p class="small"><cite>Steve Jobs</cite> — Apple Worldwide Developers’ Conference, 1997</p>
<h2 id="tables">Tables</h2>
<table>
<thead>
<tr>
<th>Employee</th>
<th>Salary</th>
<th> </th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="#">John Doe</a></td>
<td>$1</td>
<td>Because that’s all Steve Jobs needed for a salary.</td>
</tr>
<tr>
<td><a href="#">Jane Doe</a></td>
<td>$100K</td>
<td>For all the blogging she does.</td>
</tr>
<tr>
<td><a href="#">Fred Bloggs</a></td>
<td>$100M</td>
<td>Pictures are worth a thousand words, right? So Jane × 1,000.</td>
</tr>
<tr>
<td><a href="#">Jane Bloggs</a></td>
<td>$100B</td>
<td>With hair like that?! Enough said.</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left">Header1</th>
<th style="text-align: center">Header2</th>
<th style="text-align: right">Header3</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">cell1</td>
<td style="text-align: center">cell2</td>
<td style="text-align: right">cell3</td>
</tr>
<tr>
<td style="text-align: left">cell4</td>
<td style="text-align: center">cell5</td>
<td style="text-align: right">cell6</td>
</tr>
</tbody>
<tbody>
<tr>
<td style="text-align: left">cell1</td>
<td style="text-align: center">cell2</td>
<td style="text-align: right">cell3</td>
</tr>
<tr>
<td style="text-align: left">cell4</td>
<td style="text-align: center">cell5</td>
<td style="text-align: right">cell6</td>
</tr>
</tbody>
<tfoot>
<tr>
<td style="text-align: left">Foot1</td>
<td style="text-align: center">Foot2</td>
<td style="text-align: right">Foot3</td>
</tr>
</tfoot>
</table>
<h2 id="definition-lists">Definition Lists</h2>
<dl>
<dt>Definition List Title</dt>
<dd>Definition list division.</dd>
<dt>Startup</dt>
<dd>A startup company or startup is a company or temporary organization designed to search for a repeatable and scalable business model.</dd>
<dt>#dowork</dt>
<dd>Coined by Rob Dyrdek and his personal body guard Christopher “Big Black” Boykins, “Do Work” works as a self motivator, to motivating your friends.</dd>
<dt>Do It Live</dt>
<dd>I’ll let Bill O’Reilly <a href="https://www.youtube.com/watch?v=O_HyZ5aW76c" title="We'll Do It Live">explain</a> this one.</dd>
</dl>
<h2 id="unordered-lists-nested">Unordered Lists (Nested)</h2>
<ul>
<li>List item one
<ul>
<li>List item one
<ul>
<li>List item one</li>
<li>List item two</li>
<li>List item three</li>
<li>List item four</li>
</ul>
</li>
<li>List item two</li>
<li>List item three</li>
<li>List item four</li>
</ul>
</li>
<li>List item two</li>
<li>List item three</li>
<li>List item four</li>
</ul>
<h2 id="ordered-list-nested">Ordered List (Nested)</h2>
<ol>
<li>List item one
<ol>
<li>List item one
<ol>
<li>List item one</li>
<li>List item two</li>
<li>List item three</li>
<li>List item four</li>
</ol>
</li>
<li>List item two</li>
<li>List item three</li>
<li>List item four</li>
</ol>
</li>
<li>List item two</li>
<li>List item three</li>
<li>List item four</li>
</ol>
<h2 id="forms">Forms</h2>
<form>
<fieldset>
<legend>Personalia:</legend>
Name: <input type="text" size="30" /><br />
Email: <input type="text" size="30" /><br />
Date of birth: <input type="text" size="10" />
</fieldset>
</form>
<h2 id="buttons">Buttons</h2>
<p>Make any link standout more when applying the <code class="language-plaintext highlighter-rouge">.btn</code> class.</p>
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><a</span> <span class="na">href=</span><span class="s">"#"</span> <span class="na">class=</span><span class="s">"btn--success"</span><span class="nt">></span>Success Button<span class="nt"></a></span>
</code></pre></div></div>
<p><a href="#" class="btn">Default Button</a>
<a href="#" class="btn btn--primary">Primary Button</a>
<a href="#" class="btn btn--success">Success Button</a>
<a href="#" class="btn btn--warning">Warning Button</a>
<a href="#" class="btn btn--danger">Danger Button</a>
<a href="#" class="btn btn--info">Info Button</a>
<a href="#" class="btn btn--inverse">Inverse Button</a>
<a href="#" class="btn btn--light-outline">Light Outline Button</a></p>
<div class="language-markdown highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">[</span><span class="nv">Default Button Text</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn}
<span class="p">[</span><span class="nv">Primary Button Text</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--primary}
<span class="p">[</span><span class="nv">Success Button Text</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--success}
<span class="p">[</span><span class="nv">Warning Button Text</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--warning}
<span class="p">[</span><span class="nv">Danger Button Text</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--danger}
<span class="p">[</span><span class="nv">Info Button Text</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--info}
<span class="p">[</span><span class="nv">Inverse Button</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--inverse}
<span class="p">[</span><span class="nv">Light Outline Button</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--light-outline}
</code></pre></div></div>
<p><a href="#" class="btn btn--primary btn--x-large">X-Large Button</a>
<a href="#" class="btn btn--primary btn--large">Large Button</a>
<a href="#" class="btn btn--primary">Default Button</a>
<a href="#" class="btn btn--primary btn--small">Small Button</a></p>
<div class="language-markdown highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">[</span><span class="nv">X-Large Button</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--primary .btn--x-large}
<span class="p">[</span><span class="nv">Large Button</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--primary .btn--large}
<span class="p">[</span><span class="nv">Default Button</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--primary }
<span class="p">[</span><span class="nv">Small Button</span><span class="p">](</span><span class="sx">#link</span><span class="p">)</span>{: .btn .btn--primary .btn--small}
</code></pre></div></div>
<h2 id="notices">Notices</h2>
<p class="notice"><strong>Watch out!</strong> This paragraph of text has been <a href="#">emphasized</a> with the <code class="language-plaintext highlighter-rouge">{: .notice}</code> class.</p>
<p class="notice--primary"><strong>Watch out!</strong> This paragraph of text has been <a href="#">emphasized</a> with the <code class="language-plaintext highlighter-rouge">{: .notice--primary}</code> class.</p>
<p class="notice--info"><strong>Watch out!</strong> This paragraph of text has been <a href="#">emphasized</a> with the <code class="language-plaintext highlighter-rouge">{: .notice--info}</code> class.</p>
<p class="notice--warning"><strong>Watch out!</strong> This paragraph of text has been <a href="#">emphasized</a> with the <code class="language-plaintext highlighter-rouge">{: .notice--warning}</code> class.</p>
<p class="notice--success"><strong>Watch out!</strong> This paragraph of text has been <a href="#">emphasized</a> with the <code class="language-plaintext highlighter-rouge">{: .notice--success}</code> class.</p>
<p class="notice--danger"><strong>Watch out!</strong> This paragraph of text has been <a href="#">emphasized</a> with the <code class="language-plaintext highlighter-rouge">{: .notice--danger}</code> class.</p>
<h2 id="html-tags">HTML Tags</h2>
<h3 id="address-tag">Address Tag</h3>
<address>
1 Infinite Loop<br /> Cupertino, CA 95014<br /> United States
</address>
<h3 id="anchor-tag-aka-link">Anchor Tag (aka. Link)</h3>
<p>This is an example of a <a href="http://apple.com" title="Apple">link</a>.</p>
<h3 id="abbreviation-tag">Abbreviation Tag</h3>
<p>The abbreviation <abbr title="Cascading Style Sheets">CSS</abbr> stands for “Cascading Style Sheets”.</p>
<h3 id="cite-tag">Cite Tag</h3>
<p>“Code is poetry.” —<cite>Automattic</cite></p>
<h3 id="code-tag">Code Tag</h3>
<p>You will learn later on in these tests that <code class="language-plaintext highlighter-rouge">word-wrap: break-word;</code> will be your best friend.</p>
<h3 id="strike-tag">Strike Tag</h3>
<p>This tag will let you <strike>strikeout text</strike>.</p>
<h3 id="emphasize-tag">Emphasize Tag</h3>
<p>The emphasize tag should <em>italicize</em> text.</p>
<h3 id="insert-tag">Insert Tag</h3>
<p>This tag should denote <ins>inserted</ins> text.</p>
<h3 id="keyboard-tag">Keyboard Tag</h3>
<p>This scarcely known tag emulates <kbd>keyboard text</kbd>, which is usually styled like the <code class="language-plaintext highlighter-rouge"><code></code> tag.</p>
<h3 id="preformatted-tag">Preformatted Tag</h3>
<p>This tag styles large blocks of code.</p>
<pre>
.post-title {
margin: 0 0 5px;
font-weight: bold;
font-size: 38px;
line-height: 1.2;
and here's a line of some really, really, really, really long text, just to see how the PRE tag handles it and to find out how it overflows;
}
</pre>
<h3 id="quote-tag">Quote Tag</h3>
<p><q>Developers, developers, developers…</q> –Steve Ballmer</p>
<h3 id="strong-tag">Strong Tag</h3>
<p>This tag shows <strong>bold text</strong>.</p>
<h3 id="subscript-tag">Subscript Tag</h3>
<p>Getting our science styling on with H<sub>2</sub>O, which should push the “2” down.</p>
<h3 id="superscript-tag">Superscript Tag</h3>
<p>Still sticking with science and Albert Einstein’s E = MC<sup>2</sup>, which should lift the 2 up.</p>
<h3 id="variable-tag">Variable Tag</h3>
<p>This allows you to denote <var>variables</var>.</p>Michael RoseA variety of common markup showing how the theme styles them.Markup: Image Alignment2013-01-10T00:00:00-05:002013-01-10T00:00:00-05:00https://mmistakes.github.io/minimal-mistakes/markup/markup-image-alignment<p>Welcome to image alignment! The best way to demonstrate the ebb and flow of the various image positioning options is to nestle them snuggly among an ocean of words. Grab a paddle and let’s get started.</p>
<p><img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-580x300.jpg" alt="image-center" class="align-center" /></p>
<p>The image above happens to be <strong>centered</strong>.</p>
<p><img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-150x150.jpg" alt="image-left" class="align-left" /> The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is <strong>left aligned</strong>.</p>
<p>As you can see there should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we’ll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it’s thing. Mission accomplished!</p>
<p>And now for a <strong>massively large image</strong>. It also has <strong>no alignment</strong>.</p>
<p><img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-1200x4002.jpg" alt="no-alignment" /></p>
<p>The image above, though 1200px wide, should not overflow the content area. It should remain contained with no visible disruption to the flow of content.</p>
<p><img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-300x200.jpg" alt="image-right" class="align-right" /></p>
<p>And now we’re going to shift things to the <strong>right align</strong>. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there — Hey guy! Way to rock that right side. I don’t care what the left aligned image says, you look great. Don’t let anyone else tell you differently.</p>
<p>In just a bit here, you should see the text start to wrap below the right aligned image and settle in nicely. There should still be plenty of room and everything should be sitting pretty. Yeah — Just like that. It never felt so good to be right.</p>
<p>And just when you thought we were done, we’re going to do them all over again with captions!</p>
<figure class="align-center">
<img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-580x300.jpg" alt="" />
<figcaption>Look at 580 x 300 getting some love.</figcaption>
</figure>
<p>The figure above happens to be <strong>centered</strong>. The caption also has a link in it, just to see if it does anything funky.</p>
<figure style="width: 150px" class="align-left">
<img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-150x150.jpg" alt="" />
<figcaption>Itty-bitty caption.</figcaption>
</figure>
<p>The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is <strong>left aligned</strong>.</p>
<p>As you can see there should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we’ll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it’s thing. Mission accomplished!</p>
<p>And now for a <strong>massively large image</strong>. It also has <strong>no alignment</strong>.</p>
<figure style="width: 1200px">
<img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-1200x4002.jpg" alt="" />
<figcaption>Massive image comment for your eyeballs.</figcaption>
</figure>
<p>The figure element above has an inline style of <code class="language-plaintext highlighter-rouge">width: 1200px</code> set which should break it outside of the normal content flow.</p>
<figure style="width: 300px" class="align-right">
<img src="https://mmistakes.github.io/minimal-mistakes/assets/images/image-alignment-300x200.jpg" alt="" />
<figcaption>Feels good to be right all the time.</figcaption>
</figure>
<p>And now we’re going to shift things to the <strong>right align</strong>. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there — Hey guy! Way to rock that right side. I don’t care what the left aligned image says, you look great. Don’t let anyone else tell you differently.</p>
<p>In just a bit here, you should see the text start to wrap below the right aligned image and settle in nicely. There should still be plenty of room and everything should be sitting pretty. Yeah — Just like that. It never felt so good to be right.</p>
<p>And that’s a wrap, yo! You survived the tumultuous waters of alignment. Image alignment achievement unlocked!</p>Michael RoseWelcome to image alignment! The best way to demonstrate the ebb and flow of the various image positioning options is to nestle them snuggly among an ocean of words. Grab a paddle and let’s get started.Markup: Text Alignment2013-01-09T00:00:00-05:002013-01-09T00:00:00-05:00https://mmistakes.github.io/minimal-mistakes/markup/markup-text-alignment<h3 id="default">Default</h3>
<p>This is a paragraph. It should not have any alignment of any kind. It should just flow like you would normally expect. Nothing fancy. Just straight up text, free flowing, with love. Completely neutral and not picking a side or sitting on the fence. It just is. It just freaking is. It likes where it is. It does not feel compelled to pick a side. Leave him be. It will just be better that way. Trust me.</p>
<h3 id="left-align">Left Align</h3>
<p style="text-align: left;">This is a paragraph. It is left aligned. Because of this, it is a bit more liberal in it’s views. It’s favorite color is green. Left align tends to be more eco-friendly, but it provides no concrete evidence that it really is. Even though it likes share the wealth evenly, it leaves the equal distribution up to justified alignment.</p>
<h3 id="center-align">Center Align</h3>
<p style="text-align: center;">This is a paragraph. It is center aligned. Center is, but nature, a fence sitter. A flip flopper. It has a difficult time making up its mind. It wants to pick a side. Really, it does. It has the best intentions, but it tends to complicate matters more than help. The best you can do is try to win it over and hope for the best. I hear center align does take bribes.</p>
<h3 id="right-align">Right Align</h3>
<p style="text-align: right;">This is a paragraph. It is right aligned. It is a bit more conservative in it’s views. It’s prefers to not be told what to do or how to do it. Right align totally owns a slew of guns and loves to head to the range for some practice. Which is cool and all. I mean, it’s a pretty good shot from at least four or five football fields away. Dead on. So boss.</p>
<h3 id="justify-align">Justify Align</h3>
<p style="text-align: justify;">This is a paragraph. It is justify aligned. It gets really mad when people associate it with Justin Timberlake. Typically, justified is pretty straight laced. It likes everything to be in it’s place and not all cattywampus like the rest of the aligns. I am not saying that makes it better than the rest of the aligns, but it does tend to put off more of an elitist attitude.</p>Michael RoseDefault