jekyll-docs 3.5.2 → 3.6.0

data/site/docs/plugins/index.html

@@ -4,13 +4,13 @@
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="generator" content="Jekyll v3.5.2">
+  <meta name="generator" content="Jekyll v3.6.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
   <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
   <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
   <link rel="stylesheet" href="/css/screen.css">
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
-  <!-- Begin Jekyll SEO tag v2.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.0 -->
 <title>Plugins | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Plugins">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/plugins/">
 <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
 <meta property="og:type" content="article">
-<meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
+<meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
 <script type="application/ld+json">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Plugins","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/plugins/"},"url":"https://jekyllrb.com/docs/plugins/"}</script>
+{"name":null,"description":"Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.","url":"https://jekyllrb.com/docs/plugins/","headline":"Plugins","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/plugins/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -317,26 +317,30 @@ Jekyll generates your site.</li>
 values of the gem names of the plugins you’d like to use. An example:</p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code> plugins: [jekyll-coffeescript, jekyll-watch, jekyll-assets]
+<div class="highlight"><pre class="highlight"><code> plugins:
+   - jekyll-gist
+   - jekyll-coffeescript
+   - jekyll-assets
+   - another-jekyll-plugin
  # This will require each of these plugins automatically.
-</code></pre>
-    </div>
+</code></pre></div>    </div>
 
-    <p>Then install your plugins using <code class="highlighter-rouge">gem install jekyll-coffeescript jekyll-watch jekyll-assets</code></p>
+    <p>Then install your plugins using <code class="highlighter-rouge">gem install jekyll-gist jekyll-coffeescript jekyll-assets another-jekyll-plugin</code></p>
   </li>
   <li>
     <p>Add the relevant plugins to a Bundler group in your <code class="highlighter-rouge">Gemfile</code>. An
  example:</p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code> group :jekyll_plugins do
-   gem "my-jekyll-plugin"
+<div class="highlight"><pre class="highlight"><code> group :jekyll_plugins do
+   gem "jekyll-gist"
+   gem "jekyll-coffeescript"
+   gem "jekyll-assets"
    gem "another-jekyll-plugin"
  end
-</code></pre>
-    </div>
+</code></pre></div>    </div>
 
-    <p>Now you need to install all plugins from your Bundler group by running single command <code class="highlighter-rouge">bundle install</code></p>
+    <p>Now you need to install all plugins from your Bundler group by running single command <code class="highlighter-rouge">bundle install</code>.</p>
   </li>
 </ol>
 
@@ -352,7 +356,7 @@ values of the gem names of the plugins you’d like to use. An example:</p>
   </p>
 </div>
 
-<p>In general, plugins you make will fall into one of five categories:</p>
+<p>In general, plugins you make will fall broadly into one of five categories:</p>
 
 <ol>
   <li><a href="#generators">Generators</a></li>
@@ -362,6 +366,8 @@ values of the gem names of the plugins you’d like to use. An example:</p>
   <li><a href="#hooks">Hooks</a></li>
 </ol>
 
+<p>See the bottom of the page for a <a href="#available-plugins">list of available plugins</a></p>
+
 <h2 id="generators">Generators</h2>
 
 <p>You can create a generator when you need Jekyll to create additional content
@@ -387,8 +393,7 @@ for more details.</p>
 variables. In the following example the template <code class="highlighter-rouge">reading.html</code> has two
 variables <code class="highlighter-rouge">ongoing</code> and <code class="highlighter-rouge">done</code> that we fill in the generator:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">module</span> <span class="nn">Reading</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">module</span> <span class="nn">Reading</span>
   <span class="k">class</span> <span class="nc">Generator</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Generator</span>
     <span class="k">def</span> <span class="nf">generate</span><span class="p">(</span><span class="n">site</span><span class="p">)</span>
       <span class="n">ongoing</span><span class="p">,</span> <span class="n">done</span> <span class="o">=</span> <span class="no">Book</span><span class="p">.</span><span class="nf">all</span><span class="p">.</span><span class="nf">partition</span><span class="p">(</span><span class="o">&amp;</span><span class="ss">:ongoing?</span><span class="p">)</span>
@@ -399,13 +404,11 @@ variables <code class="highlighter-rouge">ongoing</code> and <code class="highli
     <span class="k">end</span>
   <span class="k">end</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>This is a more complex generator that generates new pages:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
+<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">CategoryPage</span> <span class="o">&lt;</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">category</span><span class="p">)</span>
@@ -437,8 +440,7 @@ variables <code class="highlighter-rouge">ongoing</code> and <code class="highli
   <span class="k">end</span>
 
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>In this example, our generator will create a series of files under the
 <code class="highlighter-rouge">categories</code> directory for each category, listing the posts in each category
@@ -485,8 +487,7 @@ languages are implemented using this method.</p>
 <p>Below is a converter that will take all posts ending in <code class="highlighter-rouge">.upcase</code> and process
 them using the <code class="highlighter-rouge">UpcaseConverter</code>:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
+<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">UpcaseConverter</span> <span class="o">&lt;</span> <span class="no">Converter</span>
     <span class="n">safe</span> <span class="kp">true</span>
     <span class="n">priority</span> <span class="ss">:low</span>
@@ -504,8 +505,7 @@ them using the <code class="highlighter-rouge">UpcaseConverter</code>:</p>
     <span class="k">end</span>
   <span class="k">end</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Converters should implement at a minimum 3 methods:</p>
 
@@ -563,18 +563,15 @@ it will do so with a <code class="highlighter-rouge">.html</code> extension.</p>
 subcommands for the <code class="highlighter-rouge">jekyll</code> executable. This is possible by including the
 relevant plugins in a <code class="highlighter-rouge">Gemfile</code> group called <code class="highlighter-rouge">:jekyll_plugins</code>:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="n">group</span> <span class="ss">:jekyll_plugins</span> <span class="k">do</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">group</span> <span class="ss">:jekyll_plugins</span> <span class="k">do</span>
   <span class="n">gem</span> <span class="s2">"my_fancy_jekyll_plugin"</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Each <code class="highlighter-rouge">Command</code> must be a subclass of the <code class="highlighter-rouge">Jekyll::Command</code> class and must
 contain one class method: <code class="highlighter-rouge">init_with_program</code>. An example:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">class</span> <span class="nc">MyNewCommand</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Command</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">class</span> <span class="nc">MyNewCommand</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Command</span>
   <span class="k">class</span> <span class="o">&lt;&lt;</span> <span class="nb">self</span>
     <span class="k">def</span> <span class="nf">init_with_program</span><span class="p">(</span><span class="n">prog</span><span class="p">)</span>
       <span class="n">prog</span><span class="p">.</span><span class="nf">command</span><span class="p">(</span><span class="ss">:new</span><span class="p">)</span> <span class="k">do</span> <span class="o">|</span><span class="n">c</span><span class="o">|</span>
@@ -590,8 +587,7 @@ contain one class method: <code class="highlighter-rouge">init_with_program</cod
     <span class="k">end</span>
   <span class="k">end</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Commands should implement this single class method:</p>
 
@@ -627,8 +623,7 @@ hooking into the tagging system. Built-in examples added by Jekyll include the
 <code class="highlighter-rouge">highlight</code> and <code class="highlighter-rouge">include</code> tags. Below is an example of a custom liquid tag that
 will output the time the page was rendered:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
+<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">RenderTimeTag</span> <span class="o">&lt;</span> <span class="no">Liquid</span><span class="o">::</span><span class="no">Tag</span>
 
     <span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">tag_name</span><span class="p">,</span> <span class="n">text</span><span class="p">,</span> <span class="n">tokens</span><span class="p">)</span>
@@ -643,8 +638,7 @@ will output the time the page was rendered:</p>
 <span class="k">end</span>
 
 <span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>At a minimum, liquid tags must implement:</p>
 
@@ -672,27 +666,21 @@ will output the time the page was rendered:</p>
 <p>You must also register the custom tag with the Liquid template engine as
 follows:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span>
+</code></pre></div></div>
 
 <p>In the example above, we can place the following tag anywhere in one of our
 pages:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
 <span class="o">&lt;</span><span class="nb">p</span><span class="o">&gt;</span><span class="p">{</span><span class="sx">% render_time </span><span class="n">page</span> <span class="n">rendered</span> <span class="ss">at: </span><span class="sx">%}&lt;/p&gt;
 
-</span></code></pre>
-</div>
+</span></code></pre></div></div>
 
 <p>And we would get something like this on the page:</p>
 
-<div class="language-html highlighter-rouge">
-<pre class="highlight"><code><span class="nt">&lt;p&gt;</span>page rendered at: Tue June 22 23:38:47 –0500 2010<span class="nt">&lt;/p&gt;</span>
-</code></pre>
-</div>
+<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;p&gt;</span>page rendered at: Tue June 22 23:38:47 –0500 2010<span class="nt">&lt;/p&gt;</span>
+</code></pre></div></div>
 
 <h3 id="liquid-filters">Liquid filters</h3>
 
@@ -701,8 +689,7 @@ add tags above. Filters are simply modules that export their methods to liquid.
 All methods will have to take at least one parameter which represents the input
 of the filter. The return value will be the output of the filter.</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
+<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">module</span> <span class="nn">AssetFilter</span>
     <span class="k">def</span> <span class="nf">asset_url</span><span class="p">(</span><span class="n">input</span><span class="p">)</span>
       <span class="s2">"http://www.example.com/</span><span class="si">#{</span><span class="n">input</span><span class="si">}</span><span class="s2">?</span><span class="si">#{</span><span class="no">Time</span><span class="p">.</span><span class="nf">now</span><span class="p">.</span><span class="nf">to_i</span><span class="si">}</span><span class="s2">"</span>
@@ -711,8 +698,7 @@ of the filter. The return value will be the output of the filter.</p>
 <span class="k">end</span>
 
 <span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_filter</span><span class="p">(</span><span class="no">Jekyll</span><span class="o">::</span><span class="no">AssetFilter</span><span class="p">)</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <div class="note">
   <h5>ProTip™: Access the site object using Liquid</h5>
@@ -773,16 +759,14 @@ of the filter. The return value will be the output of the filter.</p>
 <p>To use one of the example plugins above as an illustration, here is how you’d
 specify these two flags:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
+<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">UpcaseConverter</span> <span class="o">&lt;</span> <span class="no">Converter</span>
     <span class="n">safe</span> <span class="kp">true</span>
     <span class="n">priority</span> <span class="ss">:low</span>
-    <span class="p">.</span><span class="nf">.</span><span class="p">.</span>
-  <span class="nf">end</span>
+    <span class="o">...</span>
+  <span class="k">end</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <h2 id="hooks">Hooks</h2>
 
@@ -796,12 +780,10 @@ call whenever the hook is triggered. For example, if you want to execute some
 custom functionality every time Jekyll renders a post, you could register a
 hook like this:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="no">Jekyll</span><span class="o">::</span><span class="no">Hooks</span><span class="p">.</span><span class="nf">register</span> <span class="ss">:posts</span><span class="p">,</span> <span class="ss">:post_render</span> <span class="k">do</span> <span class="o">|</span><span class="n">post</span><span class="o">|</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="no">Jekyll</span><span class="o">::</span><span class="no">Hooks</span><span class="p">.</span><span class="nf">register</span> <span class="ss">:posts</span><span class="p">,</span> <span class="ss">:post_render</span> <span class="k">do</span> <span class="o">|</span><span class="n">post</span><span class="o">|</span>
   <span class="c1"># code to call after Jekyll renders a post</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Jekyll provides hooks for <code>:site</code>, <code>:pages</code>,
 <code>:posts</code>, and <code>:documents</code>. In all cases, Jekyll calls
@@ -1197,8 +1179,12 @@ LESS.js files during generation.</li>
 
 <h4 id="tags-1">Tags</h4>
 
+<p>You can find a few useful plugins at the following locations:</p>
+
 <ul>
   <li>
+<a href="https://github.com/jekyll/jekyll-gist">Jekyll-gist</a>: Use the <code class="highlighter-rouge">gist</code> tag to easily embed a GitHub Gist onto your site. This works with public or secret gists.</li>
+  <li>
 <a href="https://github.com/samrayner/jekyll-asset-path-plugin">Asset Path Tag</a> by <a href="http://www.samrayner.com/">Sam Rayner</a>: Allows organisation of assets into subdirectories by outputting a path for a given file relative to the current post or page.</li>
   <li>
 <a href="https://github.com/christianhellsten/jekyll-plugins">Delicious Plugin by Christian Hellsten</a>: Fetches and renders bookmarks from delicious.com.</li>
@@ -1389,7 +1375,7 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
   <li>
 <a href="https://github.com/dannygarcia/grunt-jekyll">grunt-jekyll</a>: A straightforward <a href="http://gruntjs.com/">Grunt</a> plugin for Jekyll.</li>
   <li>
-<a href="https://github.com/indirect/jekyll-postfiles">jekyll-postfiles</a>: Add <code class="highlighter-rouge">_postfiles</code> directory and <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">postfile</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code> tag so the files a post refers to will always be right there inside your repo.</li>
+<a href="https://github.com/indirect/jekyll-postfiles">jekyll-postfiles</a>: Add <code class="highlighter-rouge">_postfiles</code> directory and <code class="highlighter-rouge">{{ postfile }}</code> tag so the files a post refers to will always be right there inside your repo.</li>
   <li>
 <a href="http://jch.penibelst.de/">A layout that compresses HTML</a>: GitHub Pages compatible, configurable way to compress HTML files on site build.</li>
   <li>
@@ -1434,20 +1420,6 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
 <a href="https://github.com/mpchadwick/jekyll-pre-commit">jekyll-pre-commit</a>: A framework for running checks against your posts using a git pre-commit hook before you publish them.</li>
 </ul>
 
-<h4 id="editors">Editors</h4>
-
-<ul>
-  <li>
-<a href="https://github.com/23maverick23/sublime-jekyll">sublime-jekyll</a>: A Sublime Text package for Jekyll static sites. This package should help creating Jekyll sites and posts easier by providing access to key template tags and filters, as well as common completions and a current date/datetime command (for dating posts). You can install this package manually via GitHub, or via <a href="https://packagecontrol.io/packages/Jekyll">Package Control</a>.</li>
-  <li>
-<a href="https://github.com/parkr/vim-jekyll">vim-jekyll</a>: A vim plugin to generate
-new posts and run <code class="highlighter-rouge">jekyll build</code> all without leaving vim.</li>
-  <li>
-<a href="https://atom.io/packages/markdown-writer">markdown-writer</a>: An Atom package for Jekyll. It can create new posts/drafts, manage tags/categories, insert link/images and add many useful key mappings.</li>
-  <li>
-<a href="https://wordpress.org/plugins/wp2jekyll/">Wordpress2Jekyll</a>: A Wordpress plugin that allows you to use Wordpress as your editor and (automatically) export content in to Jekyll. WordPress2Jekyll attempts to marry these two systems together in order to make a site that can be easily managed from all devices.</li>
-</ul>
-
 <div class="note info">
   <h5>Jekyll Plugins Wanted</h5>
   <p>

data/site/docs/posts/index.html

@@ -4,13 +4,13 @@
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="generator" content="Jekyll v3.5.2">
+  <meta name="generator" content="Jekyll v3.6.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
   <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
   <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
   <link rel="stylesheet" href="/css/screen.css">
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
-  <!-- Begin Jekyll SEO tag v2.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.0 -->
 <title>Writing posts | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Writing posts">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/posts/">
 <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
 <meta property="og:type" content="article">
-<meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
+<meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
 <script type="application/ld+json">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Writing posts","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/posts/"},"url":"https://jekyllrb.com/docs/posts/"}</script>
+{"name":null,"description":"One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!","url":"https://jekyllrb.com/docs/posts/","headline":"Writing posts","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/posts/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -310,20 +310,16 @@ static site.</p>
 directory. How you name files in this folder is important. Jekyll requires blog
 post files to be named according to the following format:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code>YEAR-MONTH-DAY-title.MARKUP
-</code></pre>
-</div>
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>YEAR-MONTH-DAY-title.MARKUP
+</code></pre></div></div>
 
 <p>Where <code class="highlighter-rouge">YEAR</code> is a four-digit number, <code class="highlighter-rouge">MONTH</code> and <code class="highlighter-rouge">DAY</code> are both two-digit
 numbers, and <code class="highlighter-rouge">MARKUP</code> is the file extension representing the format used in the
 file. For example, the following are examples of valid post filenames:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code>2011-12-31-new-years-eve-is-awesome.md
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>2011-12-31-new-years-eve-is-awesome.md
 2012-09-12-how-to-write-a-blog.md
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <div class="note">
   <h5>ProTip™: Link to other posts</h5>
@@ -375,18 +371,14 @@ variable in a post.</p>
 
 <p>Including an image asset in a post:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>... which is shown in the screenshot below:
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>... which is shown in the screenshot below:
 ![My helpful screenshot]({{ site.url }}/assets/screenshot.jpg)
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Linking to a PDF for readers to download:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>... you can [get the PDF]({{ site.url }}/assets/mydoc.pdf) directly.
-</code></pre>
-</div>
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>... you can [get the PDF]({{ site.url }}/assets/mydoc.pdf) directly.
+</code></pre></div></div>
 
 <div class="note">
   <h5>ProTip™: Link using just the site root URL</h5>
@@ -402,8 +394,7 @@ variable in a post.</p>
 
 <p>Jekyll can handle many different iterations of the idea you might associate with a “post,” however a standard blog style post, including a Title, Layout, Publishing Date, and Categories might look like this:</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>---
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
 layout: post
 title:  "Welcome to Jekyll!"
 date:   2015-11-17 16:16:01 -0600
@@ -413,8 +404,7 @@ You’ll find this post in your `_posts` directory. Go ahead and edit it and re-
 
 To add new posts, simply add a file in the `_posts` directory that follows the convention `YYYY-MM-DD-name-of-post.ext` and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.
 
-</code></pre>
-</div>
+</code></pre></div></div>
 <p>Everything in between the first and second <code class="highlighter-rouge">---</code> are part of the YAML Front Matter, and everything after the second <code class="highlighter-rouge">---</code> will be rendered with Markdown and show up as “Content.”</p>
 
 <h2 id="displaying-an-index-of-posts">Displaying an index of posts</h2>
@@ -425,16 +415,14 @@ you have a list of posts somewhere. Creating an index of posts on another page
 language</a> and its tags. Here’s a
 basic example of how to create a list of links to your blog posts:</p>
 
-<div class="language-html highlighter-rouge">
-<pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
+<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
   {% for post in site.posts %}
     <span class="nt">&lt;li&gt;</span>
       <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"{{ post.url }}"</span><span class="nt">&gt;</span>{{ post.title }}<span class="nt">&lt;/a&gt;</span>
     <span class="nt">&lt;/li&gt;</span>
   {% endfor %}
 <span class="nt">&lt;/ul&gt;</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Of course, you have full control over how (and where) you display your posts,
 and how you structure your site. You should read more about <a href="../templates/">how templates
@@ -453,8 +441,7 @@ Take the above example of an index of posts. Perhaps you want to include
 a little hint about the post’s content by adding the first paragraph of each of
 your posts:</p>
 
-<div class="language-html highlighter-rouge">
-<pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
+<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
   {% for post in site.posts %}
     <span class="nt">&lt;li&gt;</span>
       <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"{{ post.url }}"</span><span class="nt">&gt;</span>{{ post.title }}<span class="nt">&lt;/a&gt;</span>
@@ -462,33 +449,28 @@ your posts:</p>
     <span class="nt">&lt;/li&gt;</span>
   {% endfor %}
 <span class="nt">&lt;/ul&gt;</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Because Jekyll grabs the first paragraph you will not need to wrap the excerpt
 in <code class="highlighter-rouge">p</code> tags, which is already done for you. These tags can be removed with the
 following if you’d prefer:</p>
 
-<div class="language-html highlighter-rouge">
-<pre class="highlight"><code>{{ post.excerpt | remove: '<span class="nt">&lt;p&gt;</span>' | remove: '<span class="nt">&lt;/p&gt;</span>' }}
-</code></pre>
-</div>
+<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{{ post.excerpt | remove: '<span class="nt">&lt;p&gt;</span>' | remove: '<span class="nt">&lt;/p&gt;</span>' }}
+</code></pre></div></div>
 
 <p>If you don’t like the automatically-generated post excerpt, it can be
 explicitly overridden by adding an <code class="highlighter-rouge">excerpt</code> value to your post’s YAML
 Front Matter. Alternatively, you can choose to define a custom
 <code class="highlighter-rouge">excerpt_separator</code> in the post’s YAML front matter:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>---
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
 excerpt_separator: &lt;!--more--&gt;
 ---
 
 Excerpt
 &lt;!--more--&gt;
 Out-of-excerpt
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>You can also set the <code class="highlighter-rouge">excerpt_separator</code> globally in your <code class="highlighter-rouge">_config.yml</code>
 configuration file.</p>
@@ -507,8 +489,7 @@ html tags along with the content is not desirable.</p>
 either Pygments or Rouge, and including a code snippet in any post is easy.
 Just use the dedicated Liquid tag as follows:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>{% highlight ruby %}
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{% highlight ruby %}
 def show
   @widget = Widget(params[:id])
   respond_to do |format|
@@ -517,21 +498,18 @@ def show
   end
 end
 {% endhighlight %}
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>And the output will look like this:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">def</span> <span class="nf">show</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">def</span> <span class="nf">show</span>
   <span class="vi">@widget</span> <span class="o">=</span> <span class="no">Widget</span><span class="p">(</span><span class="n">params</span><span class="p">[</span><span class="ss">:id</span><span class="p">])</span>
   <span class="n">respond_to</span> <span class="k">do</span> <span class="o">|</span><span class="nb">format</span><span class="o">|</span>
     <span class="nb">format</span><span class="p">.</span><span class="nf">html</span> <span class="c1"># show.html.erb</span>
     <span class="nb">format</span><span class="p">.</span><span class="nf">json</span> <span class="p">{</span> <span class="n">render</span> <span class="ss">json: </span><span class="vi">@widget</span> <span class="p">}</span>
   <span class="k">end</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <div class="note">
   <h5>ProTip™: Show line numbers</h5>