jekyll-docs 3.5.2 → 3.6.0

data/site/docs/collections/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>Collections | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Collections">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/collections/">
 <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":"Collections","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Not everything is a post or a page. Maybe you want to document the various methods in your open source project, members of a team, or talks at a conference. Collections allow you to define a new type of document that behave like Pages or Posts do normally, but also have their own unique properties and namespace.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/collections/"},"url":"https://jekyllrb.com/docs/collections/"}</script>
+{"name":null,"description":"Not everything is a post or a page. Maybe you want to document the various methods in your open source project, members of a team, or talks at a conference. Collections allow you to define a new type of document that behave like Pages or Posts do normally, but also have their own unique properties and namespace.","url":"https://jekyllrb.com/docs/collections/","headline":"Collections","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/collections/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -308,32 +308,26 @@ namespace.</p>
 <p>Add the following to your site’s <code class="highlighter-rouge">_config.yml</code> file, replacing <code class="highlighter-rouge">my_collection</code>
 with the name of your collection:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
 <span class="pi">-</span> <span class="s">my_collection</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>You can optionally specify metadata for your collection in the configuration:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
-  <span class="s">my_collection</span><span class="pi">:</span>
-    <span class="s">foo</span><span class="pi">:</span> <span class="s">bar</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
+  <span class="na">my_collection</span><span class="pi">:</span>
+    <span class="na">foo</span><span class="pi">:</span> <span class="s">bar</span>
+</code></pre></div></div>
 
 <p>Default attributes can also be set for a collection:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">defaults</span><span class="pi">:</span>
-  <span class="pi">-</span> <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
-      <span class="s">type</span><span class="pi">:</span> <span class="s">my_collection</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s">page</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
+  <span class="pi">-</span> <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
+      <span class="na">type</span><span class="pi">:</span> <span class="s">my_collection</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s">page</span>
+</code></pre></div></div>
 
 <h3 id="step2">Step 2: Add your content</h3>
 
@@ -356,12 +350,10 @@ your <code>_config.yml</code> file, with the addition of the preceding <code>_</
 document in your collection, set the <code class="highlighter-rouge">output</code> key to <code class="highlighter-rouge">true</code> in your collection
 metadata in your <code class="highlighter-rouge">_config.yml</code>:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
-  <span class="s">my_collection</span><span class="pi">:</span>
-    <span class="s">output</span><span class="pi">:</span> <span class="s">true</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
+  <span class="na">my_collection</span><span class="pi">:</span>
+    <span class="na">output</span><span class="pi">:</span> <span class="no">true</span>
+</code></pre></div></div>
 
 <p>This will produce a file for each document in the collection.
 For example, if you have <code class="highlighter-rouge">_my_collection/some_subdir/some_doc.md</code>,
@@ -382,24 +374,20 @@ choice and written out to <code class="highlighter-rouge">&lt;dest&gt;/my_collec
 <p>If you wish to specify a custom pattern for the URLs where your Collection pages
 will reside, you may do so with the <a href="../permalinks/"><code class="highlighter-rouge">permalink</code> property</a>:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
-  <span class="s">my_collection</span><span class="pi">:</span>
-    <span class="s">output</span><span class="pi">:</span> <span class="s">true</span>
-    <span class="s">permalink</span><span class="pi">:</span> <span class="s">/:collection/:name</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
+  <span class="na">my_collection</span><span class="pi">:</span>
+    <span class="na">output</span><span class="pi">:</span> <span class="no">true</span>
+    <span class="na">permalink</span><span class="pi">:</span> <span class="s">/:collection/:name</span>
+</code></pre></div></div>
 
 <h3 id="examples">Examples</h3>
 
 <p>For a collection with the following source file structure,</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>_my_collection/
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_my_collection/
 └── some_subdir
     └── some_doc.md
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>each of the following <code class="highlighter-rouge">permalink</code> configurations will produce the document structure shown below it.</p>
 
@@ -409,60 +397,55 @@ will reside, you may do so with the <a href="../permalinks/"><code class="highli
 Same as <code class="highlighter-rouge">permalink: /:collection/:path</code>.</p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code>_site/
+<div class="highlight"><pre class="highlight"><code>_site/
 ├── my_collection
 │   └── some_subdir
 │       └── some_doc.html
 ...
-</code></pre>
-    </div>
+</code></pre></div>    </div>
   </li>
   <li>
     <p><code class="highlighter-rouge">permalink: pretty</code><br>
 Same as <code class="highlighter-rouge">permalink: /:collection/:path/</code>.</p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code>_site/
+<div class="highlight"><pre class="highlight"><code>_site/
 ├── my_collection
 │   └── some_subdir
 │       └── some_doc
 │           └── index.html
 ...
-</code></pre>
-    </div>
+</code></pre></div>    </div>
   </li>
   <li>
     <p><code class="highlighter-rouge">permalink: /doc/:path</code></p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code>_site/
+<div class="highlight"><pre class="highlight"><code>_site/
 ├── doc
 │   └── some_subdir
 │       └── some_doc.html
 ...
-</code></pre>
-    </div>
+</code></pre></div>    </div>
   </li>
   <li>
     <p><code class="highlighter-rouge">permalink: /doc/:name</code></p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code>_site/
+<div class="highlight"><pre class="highlight"><code>_site/
 ├── doc
 │   └── some_doc.html
 ...
-</code></pre>
-    </div>
+</code></pre></div>    </div>
   </li>
   <li>
     <p><code class="highlighter-rouge">permalink: /:name</code></p>
 
     <div class="highlighter-rouge">
-<pre class="highlight"><code>_site/
+<div class="highlight"><pre class="highlight"><code>_site/
 ├── some_doc.html
 ...
-</code></pre>
-    </div>
+</code></pre></div>    </div>
   </li>
 </ul>
 
@@ -507,7 +490,13 @@ Same as <code class="highlighter-rouge">permalink: /:collection/:path/</code>.</
         <p><code>:title</code></p>
       </td>
       <td>
-        <p>The document's lowercase title (as defined in its <a href="/docs/frontmatter/">front matter</a>), with every sequence of spaces and non-alphanumeric characters replaced by a hyphen. If the document does not define a title in its <a href="/docs/frontmatter/">front matter</a>, this is equivalent to <code>name</code>.</p>
+        <p>
+          The <code>:title</code> template variable will take the
+          <code>slug</code> <a href="/docs/frontmatter/">front matter</a>
+          variable value if any is present in the document; if none is
+          defined then <code>:title</code> will be equivalent to
+          <code>:name</code>, aka the slug generated from the filename.
+        </p>
       </td>
     </tr>
     <tr>
@@ -723,31 +712,28 @@ you might have front matter in an individual file structured as follows (which
 must use a supported markup format, and cannot be saved with a <code class="highlighter-rouge">.yaml</code>
 extension):</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin:</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">De</span><span class="nv"> </span><span class="s">beata</span><span class="nv"> </span><span class="s">virgine</span><span class="nv"> </span><span class="s">and</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">Ave</span><span class="nv"> </span><span class="s">maris</span><span class="nv"> </span><span class="s">stella"</span>
-<span class="s">artist</span><span class="pi">:</span> <span class="s2">"</span><span class="s">The</span><span class="nv"> </span><span class="s">Tallis</span><span class="nv"> </span><span class="s">Scholars"</span>
-<span class="s">director</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Peter</span><span class="nv"> </span><span class="s">Phillips"</span>
-<span class="s">works</span><span class="pi">:</span>
-  <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Missa</span><span class="nv"> </span><span class="s">De</span><span class="nv"> </span><span class="s">beata</span><span class="nv"> </span><span class="s">virgine"</span>
-    <span class="s">composer</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin</span><span class="nv"> </span><span class="s">des</span><span class="nv"> </span><span class="s">Prez"</span>
-    <span class="s">tracks</span><span class="pi">:</span>
-      <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Kyrie"</span>
-        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">4:25"</span>
-      <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Gloria"</span>
-        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">9:53"</span>
-      <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Credo"</span>
-        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">9:09"</span>
-      <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Sanctus</span><span class="nv"> </span><span class="s">&amp;</span><span class="nv"> </span><span class="s">Benedictus"</span>
-        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">7:47"</span>
-      <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Agnus</span><span class="nv"> </span><span class="s">Dei</span><span class="nv"> </span><span class="s">I,</span><span class="nv"> </span><span class="s">II</span><span class="nv"> </span><span class="s">&amp;</span><span class="nv"> </span><span class="s">III"</span>
-        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">6:49"</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin:</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">De</span><span class="nv"> </span><span class="s">beata</span><span class="nv"> </span><span class="s">virgine</span><span class="nv"> </span><span class="s">and</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">Ave</span><span class="nv"> </span><span class="s">maris</span><span class="nv"> </span><span class="s">stella"</span>
+<span class="na">artist</span><span class="pi">:</span> <span class="s2">"</span><span class="s">The</span><span class="nv"> </span><span class="s">Tallis</span><span class="nv"> </span><span class="s">Scholars"</span>
+<span class="na">director</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Peter</span><span class="nv"> </span><span class="s">Phillips"</span>
+<span class="na">works</span><span class="pi">:</span>
+  <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Missa</span><span class="nv"> </span><span class="s">De</span><span class="nv"> </span><span class="s">beata</span><span class="nv"> </span><span class="s">virgine"</span>
+    <span class="na">composer</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin</span><span class="nv"> </span><span class="s">des</span><span class="nv"> </span><span class="s">Prez"</span>
+    <span class="na">tracks</span><span class="pi">:</span>
+      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Kyrie"</span>
+        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">4:25"</span>
+      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Gloria"</span>
+        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">9:53"</span>
+      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Credo"</span>
+        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">9:09"</span>
+      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Sanctus</span><span class="nv"> </span><span class="s">&amp;</span><span class="nv"> </span><span class="s">Benedictus"</span>
+        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">7:47"</span>
+      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Agnus</span><span class="nv"> </span><span class="s">Dei</span><span class="nv"> </span><span class="s">I,</span><span class="nv"> </span><span class="s">II</span><span class="nv"> </span><span class="s">&amp;</span><span class="nv"> </span><span class="s">III"</span>
+        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">6:49"</span>
+</code></pre></div></div>
 
 <p>Every album in the collection could be listed on a single page with a template:</p>
 
-<div class="language-html highlighter-rouge">
-<pre class="highlight"><code>
+<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
 {% for album in site.albums %}
   <span class="nt">&lt;h2&gt;</span>{{ album.title }}<span class="nt">&lt;/h2&gt;</span>
   <span class="nt">&lt;p&gt;</span>Performed by {{ album.artist }}{% if album.director %}, directed by {{ album.director }}{% endif %}<span class="nt">&lt;/p&gt;</span>
@@ -762,8 +748,7 @@ extension):</p>
   {% endfor %}
 {% endfor %}
 
-</code></pre>
-</div>
+</code></pre></div></div>
 
           
 

data/site/docs/conduct/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>Code of Conduct | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Code of Conduct">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/conduct/">
 <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":"Code of Conduct","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/conduct/"},"url":"https://jekyllrb.com/docs/conduct/"}</script>
+{"name":null,"description":"As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.","url":"https://jekyllrb.com/docs/conduct/","headline":"Code of Conduct","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/conduct/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>

data/site/docs/configuration/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>Configuration | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Configuration">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/configuration/">
 <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":"Configuration","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a _config.yml file placed in your site’s root directory, or can be specified as flags for the jekyll executable in the terminal.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/configuration/"},"url":"https://jekyllrb.com/docs/configuration/"}</script>
+{"name":null,"description":"Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a _config.yml file placed in your site’s root directory, or can be specified as flags for the jekyll executable in the terminal.","url":"https://jekyllrb.com/docs/configuration/","headline":"Configuration","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/configuration/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -705,14 +705,12 @@ before your site is served.</p>
 
 <p>You can provide custom headers for your site by adding them to <code class="highlighter-rouge">_config.yml</code></p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="c1"># File: _config.yml</span>
-<span class="s">webrick</span><span class="pi">:</span>
-  <span class="s">headers</span><span class="pi">:</span>
-    <span class="s">My-Header</span><span class="pi">:</span> <span class="s">My-Value</span>
-    <span class="s">My-Other-Header</span><span class="pi">:</span> <span class="s">My-Other-Value</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># File: _config.yml</span>
+<span class="na">webrick</span><span class="pi">:</span>
+  <span class="na">headers</span><span class="pi">:</span>
+    <span class="na">My-Header</span><span class="pi">:</span> <span class="s">My-Value</span>
+    <span class="na">My-Other-Header</span><span class="pi">:</span> <span class="s">My-Other-Value</span>
+</code></pre></div></div>
 
 <h3 id="defaults">Defaults</h3>
 
@@ -727,25 +725,21 @@ aggressive caching when you are in development mode.</p>
 
 <p>For example, suppose you set this conditional statement in your code:</p>
 
-<div class="language-liquid highlighter-rouge">
-<pre class="highlight"><code>
+<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
 <span class="p">{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">jekyll</span><span class="p">.</span><span class="nv">environment</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"production"</span><span class="w"> </span><span class="p">%}</span>
    <span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="na">disqus</span><span class="p">.</span><span class="na">html</span><span class="w"> </span><span class="p">%}</span>
 <span class="p">{%</span><span class="w"> </span><span class="kr">endif</span><span class="w"> </span><span class="p">%}</span>
 
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>When you build your Jekyll site, the content inside the <code class="highlighter-rouge">if</code> statement won’t be run unless you also specify a <code class="highlighter-rouge">production</code> environment in the build command, like this:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="nv">JEKYLL_ENV</span><span class="o">=</span>production jekyll build
-</code></pre>
-</div>
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">JEKYLL_ENV</span><span class="o">=</span>production jekyll build
+</code></pre></div></div>
 
 <p>Specifying an environment value allows you to make certain content available only within specific environments.</p>
 
-<p>The default value for <code class="highlighter-rouge">JEKYLL_ENV</code> is <code class="highlighter-rouge">development</code>. Therefore if you omit <code class="highlighter-rouge">JEKYLL_ENV</code> from the build arguments, the default value will be <code class="highlighter-rouge">JEKYLL_ENV=development</code>. Any content inside <code class="highlighter-rouge"><span class="p">{</span><span class="err">%</span><span class="w"> </span><span class="err">if</span><span class="w"> </span><span class="err">jekyll.environment</span><span class="w"> </span><span class="err">==</span><span class="w"> </span><span class="nt">"development"</span><span class="w"> </span><span class="err">%}</span></code> tags will automatically appear in the build.</p>
+<p>The default value for <code class="highlighter-rouge">JEKYLL_ENV</code> is <code class="highlighter-rouge">development</code>. Therefore if you omit <code class="highlighter-rouge">JEKYLL_ENV</code> from the build arguments, the default value will be <code class="highlighter-rouge">JEKYLL_ENV=development</code>. Any content inside <code class="highlighter-rouge">{% if jekyll.environment == "development" %}</code> tags will automatically appear in the build.</p>
 
 <p>Your environment values can be anything you want (not just <code class="highlighter-rouge">development</code> or <code class="highlighter-rouge">production</code>). Some elements you might want to hide in development environments include Disqus comment forms or Google Analytics. Conversely, you might want to expose an “Edit me in GitHub” button in a development environment but not include it in production environments.</p>
 
@@ -763,15 +757,13 @@ aggressive caching when you are in development mode.</p>
 
 <p>Let’s say that you want to add a default layout to all pages and posts in your site. You would add this to your <code class="highlighter-rouge">_config.yml</code> file:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">defaults</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
   <span class="pi">-</span>
-    <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span> <span class="c1"># an empty string here means all files in the project</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">default"</span>
-</code></pre>
-</div>
+    <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span> <span class="c1"># an empty string here means all files in the project</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">default"</span>
+</code></pre></div></div>
 
 <div class="note info">
   <h5>Please stop and rerun `jekyll serve` command.</h5>
@@ -787,56 +779,50 @@ aggressive caching when you are in development mode.</p>
 
 <p>Here, we are scoping the <code class="highlighter-rouge">values</code> to any file that exists in the path <code class="highlighter-rouge">scope</code>. Since the path is set as an empty string, it will apply to <strong>all files</strong> in your project. You probably don’t want to set a layout on every file in your project - like css files, for example - so you can also specify a <code class="highlighter-rouge">type</code> value under the <code class="highlighter-rouge">scope</code> key.</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">defaults</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
   <span class="pi">-</span>
-    <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span> <span class="c1"># an empty string here means all files in the project</span>
-      <span class="s">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">posts"</span> <span class="c1"># previously `post` in Jekyll 2.2.</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">default"</span>
-</code></pre>
-</div>
+    <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span> <span class="c1"># an empty string here means all files in the project</span>
+      <span class="na">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">posts"</span> <span class="c1"># previously `post` in Jekyll 2.2.</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">default"</span>
+</code></pre></div></div>
 
 <p>Now, this will only set the layout for files where the type is <code class="highlighter-rouge">posts</code>.
 The different types that are available to you are <code class="highlighter-rouge">pages</code>, <code class="highlighter-rouge">posts</code>, <code class="highlighter-rouge">drafts</code> or any collection in your site. While <code class="highlighter-rouge">type</code> is optional, you must specify a value for <code class="highlighter-rouge">path</code> when creating a <code class="highlighter-rouge">scope/values</code> pair.</p>
 
 <p>As mentioned earlier, you can set multiple scope/values pairs for <code class="highlighter-rouge">defaults</code>.</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">defaults</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
   <span class="pi">-</span>
-    <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
-      <span class="s">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">posts"</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">my-site"</span>
+    <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
+      <span class="na">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">pages"</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">my-site"</span>
   <span class="pi">-</span>
-    <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">projects"</span>
-      <span class="s">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">pages"</span> <span class="c1"># previously `page` in Jekyll 2.2.</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">project"</span> <span class="c1"># overrides previous default layout</span>
-      <span class="s">author</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Mr.</span><span class="nv"> </span><span class="s">Hyde"</span>
-</code></pre>
-</div>
+    <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">projects"</span>
+      <span class="na">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">pages"</span> <span class="c1"># previously `page` in Jekyll 2.2.</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">project"</span> <span class="c1"># overrides previous default layout</span>
+      <span class="na">author</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Mr.</span><span class="nv"> </span><span class="s">Hyde"</span>
+</code></pre></div></div>
 
-<p>With these defaults, all posts would use the <code class="highlighter-rouge">my-site</code> layout. Any html files that exist in the <code class="highlighter-rouge">projects/</code> folder will use the <code class="highlighter-rouge">project</code> layout, if it exists. Those files will also have the <code class="highlighter-rouge">page.author</code> <a href="../variables/">liquid variable</a> set to <code class="highlighter-rouge">Mr. Hyde</code>.</p>
+<p>With these defaults, all pages would use the <code class="highlighter-rouge">my-site</code> layout. Any html files that exist in the <code class="highlighter-rouge">projects/</code> folder will use the <code class="highlighter-rouge">project</code> layout, if it exists. Those files will also have the <code class="highlighter-rouge">page.author</code> <a href="../variables/">liquid variable</a> set to <code class="highlighter-rouge">Mr. Hyde</code>.</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
-  <span class="s">my_collection</span><span class="pi">:</span>
-    <span class="s">output</span><span class="pi">:</span> <span class="s">true</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
+  <span class="na">my_collection</span><span class="pi">:</span>
+    <span class="na">output</span><span class="pi">:</span> <span class="no">true</span>
 
-<span class="s">defaults</span><span class="pi">:</span>
+<span class="na">defaults</span><span class="pi">:</span>
   <span class="pi">-</span>
-    <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
-      <span class="s">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">my_collection"</span> <span class="c1"># a collection in your site, in plural form</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">default"</span>
-</code></pre>
-</div>
+    <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
+      <span class="na">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">my_collection"</span> <span class="c1"># a collection in your site, in plural form</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">default"</span>
+</code></pre></div></div>
 
 <p>In this example, the <code class="highlighter-rouge">layout</code> is set to <code class="highlighter-rouge">default</code> inside the
 <a href="../collections/">collection</a> with the name <code class="highlighter-rouge">my_collection</code>.</p>
@@ -845,35 +831,31 @@ The different types that are available to you are <code class="highlighter-rouge
 
 <p>Jekyll will apply all of the configuration settings you specify in the <code class="highlighter-rouge">defaults</code> section of your <code class="highlighter-rouge">_config.yml</code> file. However, you can choose to override settings from other scope/values pair by specifying a more specific path for the scope.</p>
 
-<p>You can see that in the second to last example above. First, we set the default layout to <code class="highlighter-rouge">my-site</code>. Then, using a more specific path, we set the default layout for files in the <code class="highlighter-rouge">projects/</code> path to <code class="highlighter-rouge">project</code>. This can be done with any value that you would set in the page or post front matter.</p>
+<p>You can see that in the second to last example above. First, we set the default page layout to <code class="highlighter-rouge">my-site</code>. Then, using a more specific path, we set the default layout for pages in the <code class="highlighter-rouge">projects/</code> path to <code class="highlighter-rouge">project</code>. This can be done with any value that you would set in the page or post front matter.</p>
 
 <p>Finally, if you set defaults in the site configuration by adding a <code class="highlighter-rouge">defaults</code> section to your <code class="highlighter-rouge">_config.yml</code> file, you can override those settings in a post or page file. All you need to do is specify the settings in the post or page front matter. For example:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="c1"># In _config.yml</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># In _config.yml</span>
 <span class="nn">...</span>
-<span class="s">defaults</span><span class="pi">:</span>
+<span class="na">defaults</span><span class="pi">:</span>
   <span class="pi">-</span>
-    <span class="s">scope</span><span class="pi">:</span>
-      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">projects"</span>
-      <span class="s">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">pages"</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">project"</span>
-      <span class="s">author</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Mr.</span><span class="nv"> </span><span class="s">Hyde"</span>
-      <span class="s">category</span><span class="pi">:</span> <span class="s2">"</span><span class="s">project"</span>
+    <span class="na">scope</span><span class="pi">:</span>
+      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">projects"</span>
+      <span class="na">type</span><span class="pi">:</span> <span class="s2">"</span><span class="s">pages"</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">project"</span>
+      <span class="na">author</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Mr.</span><span class="nv"> </span><span class="s">Hyde"</span>
+      <span class="na">category</span><span class="pi">:</span> <span class="s2">"</span><span class="s">project"</span>
 <span class="nn">...</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="c1"># In projects/foo_project.md</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># In projects/foo_project.md</span>
 <span class="nn">---</span>
-<span class="s">author</span><span class="pi">:</span> <span class="s2">"</span><span class="s">John</span><span class="nv"> </span><span class="s">Smith"</span>
-<span class="s">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">foobar"</span>
+<span class="na">author</span><span class="pi">:</span> <span class="s2">"</span><span class="s">John</span><span class="nv"> </span><span class="s">Smith"</span>
+<span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">foobar"</span>
 <span class="nn">---</span>
 <span class="s">The post text goes here...</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>The <code class="highlighter-rouge">projects/foo_project.md</code> would have the <code class="highlighter-rouge">layout</code> set to <code class="highlighter-rouge">foobar</code> instead
 of <code class="highlighter-rouge">project</code> and the <code class="highlighter-rouge">author</code> set to <code class="highlighter-rouge">John Smith</code> instead of <code class="highlighter-rouge">Mr. Hyde</code> when
@@ -894,80 +876,78 @@ file or on the command-line.</p>
   </p>
 </div>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="c1"># Where things are</span>
-<span class="s">source</span><span class="pi">:</span>       <span class="s">.</span>
-<span class="s">destination</span><span class="pi">:</span>  <span class="s">./_site</span>
-<span class="s">plugins_dir</span><span class="pi">:</span>  <span class="s">_plugins</span>
-<span class="s">layouts_dir</span><span class="pi">:</span>  <span class="s">_layouts</span>
-<span class="s">data_dir</span><span class="pi">:</span>     <span class="s">_data</span>
-<span class="s">includes_dir</span><span class="pi">:</span> <span class="s">_includes</span>
-<span class="s">collections</span><span class="pi">:</span>
-  <span class="s">posts</span><span class="pi">:</span>
-    <span class="s">output</span><span class="pi">:</span>   <span class="s">true</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># Where things are</span>
+<span class="na">source</span><span class="pi">:</span>       <span class="s">.</span>
+<span class="na">destination</span><span class="pi">:</span>  <span class="s">./_site</span>
+<span class="na">plugins_dir</span><span class="pi">:</span>  <span class="s">_plugins</span>
+<span class="na">layouts_dir</span><span class="pi">:</span>  <span class="s">_layouts</span>
+<span class="na">data_dir</span><span class="pi">:</span>     <span class="s">_data</span>
+<span class="na">includes_dir</span><span class="pi">:</span> <span class="s">_includes</span>
+<span class="na">collections</span><span class="pi">:</span>
+  <span class="na">posts</span><span class="pi">:</span>
+    <span class="na">output</span><span class="pi">:</span>   <span class="no">true</span>
 
 <span class="c1"># Handling Reading</span>
-<span class="s">safe</span><span class="pi">:</span>                 <span class="s">false</span>
-<span class="s">include</span><span class="pi">:</span>              <span class="pi">[</span><span class="s2">"</span><span class="s">.htaccess"</span><span class="pi">]</span>
-<span class="s">exclude</span><span class="pi">:</span>              <span class="pi">[</span><span class="s2">"</span><span class="s">Gemfile"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">Gemfile.lock"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">node_modules"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/bundle/"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/cache/"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/gems/"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/ruby/"</span><span class="pi">]</span>
-<span class="s">keep_files</span><span class="pi">:</span>           <span class="pi">[</span><span class="s2">"</span><span class="s">.git"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">.svn"</span><span class="pi">]</span>
-<span class="s">encoding</span><span class="pi">:</span>             <span class="s2">"</span><span class="s">utf-8"</span>
-<span class="s">markdown_ext</span><span class="pi">:</span>         <span class="s2">"</span><span class="s">markdown,mkdown,mkdn,mkd,md"</span>
-<span class="s">strict_front_matter</span><span class="pi">:</span> <span class="s">false</span>
+<span class="na">safe</span><span class="pi">:</span>                 <span class="no">false</span>
+<span class="na">include</span><span class="pi">:</span>              <span class="pi">[</span><span class="s2">"</span><span class="s">.htaccess"</span><span class="pi">]</span>
+<span class="na">exclude</span><span class="pi">:</span>              <span class="pi">[</span><span class="s2">"</span><span class="s">Gemfile"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">Gemfile.lock"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">node_modules"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/bundle/"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/cache/"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/gems/"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">vendor/ruby/"</span><span class="pi">]</span>
+<span class="na">keep_files</span><span class="pi">:</span>           <span class="pi">[</span><span class="s2">"</span><span class="s">.git"</span><span class="pi">,</span> <span class="s2">"</span><span class="s">.svn"</span><span class="pi">]</span>
+<span class="na">encoding</span><span class="pi">:</span>             <span class="s2">"</span><span class="s">utf-8"</span>
+<span class="na">markdown_ext</span><span class="pi">:</span>         <span class="s2">"</span><span class="s">markdown,mkdown,mkdn,mkd,md"</span>
+<span class="na">strict_front_matter</span><span class="pi">:</span> <span class="no">false</span>
 
 <span class="c1"># Filtering Content</span>
-<span class="s">show_drafts</span><span class="pi">:</span> <span class="s">null</span>
-<span class="s">limit_posts</span><span class="pi">:</span> <span class="s">0</span>
-<span class="s">future</span><span class="pi">:</span>      <span class="s">false</span>
-<span class="s">unpublished</span><span class="pi">:</span> <span class="s">false</span>
+<span class="na">show_drafts</span><span class="pi">:</span> <span class="no">null</span>
+<span class="na">limit_posts</span><span class="pi">:</span> <span class="s">0</span>
+<span class="na">future</span><span class="pi">:</span>      <span class="no">false</span>
+<span class="na">unpublished</span><span class="pi">:</span> <span class="no">false</span>
 
 <span class="c1"># Plugins</span>
-<span class="s">whitelist</span><span class="pi">:</span> <span class="pi">[]</span>
-<span class="s">plugins</span><span class="pi">:</span>   <span class="pi">[]</span>
+<span class="na">whitelist</span><span class="pi">:</span> <span class="pi">[]</span>
+<span class="na">plugins</span><span class="pi">:</span>   <span class="pi">[]</span>
 
 <span class="c1"># Conversion</span>
-<span class="s">markdown</span><span class="pi">:</span>    <span class="s">kramdown</span>
-<span class="s">highlighter</span><span class="pi">:</span> <span class="s">rouge</span>
-<span class="s">lsi</span><span class="pi">:</span>         <span class="s">false</span>
-<span class="s">excerpt_separator</span><span class="pi">:</span> <span class="s2">"</span><span class="se">\n\n</span><span class="s">"</span>
-<span class="s">incremental</span><span class="pi">:</span> <span class="s">false</span>
+<span class="na">markdown</span><span class="pi">:</span>    <span class="s">kramdown</span>
+<span class="na">highlighter</span><span class="pi">:</span> <span class="s">rouge</span>
+<span class="na">lsi</span><span class="pi">:</span>         <span class="no">false</span>
+<span class="na">excerpt_separator</span><span class="pi">:</span> <span class="s2">"</span><span class="se">\n\n</span><span class="s">"</span>
+<span class="na">incremental</span><span class="pi">:</span> <span class="no">false</span>
 
 <span class="c1"># Serving</span>
-<span class="s">detach</span><span class="pi">:</span>  <span class="s">false</span>
-<span class="s">port</span><span class="pi">:</span>    <span class="s">4000</span>
-<span class="s">host</span><span class="pi">:</span>    <span class="s">127.0.0.1</span>
-<span class="s">baseurl</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span> <span class="c1"># does not include hostname</span>
-<span class="s">show_dir_listing</span><span class="pi">:</span> <span class="s">false</span>
+<span class="na">detach</span><span class="pi">:</span>  <span class="no">false</span>
+<span class="na">port</span><span class="pi">:</span>    <span class="s">4000</span>
+<span class="na">host</span><span class="pi">:</span>    <span class="s">127.0.0.1</span>
+<span class="na">baseurl</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span> <span class="c1"># does not include hostname</span>
+<span class="na">show_dir_listing</span><span class="pi">:</span> <span class="no">false</span>
 
 <span class="c1"># Outputting</span>
-<span class="s">permalink</span><span class="pi">:</span>     <span class="s">date</span>
-<span class="s">paginate_path</span><span class="pi">:</span> <span class="s">/page:num</span>
-<span class="s">timezone</span><span class="pi">:</span>      <span class="s">null</span>
+<span class="na">permalink</span><span class="pi">:</span>     <span class="s">date</span>
+<span class="na">paginate_path</span><span class="pi">:</span> <span class="s">/page:num</span>
+<span class="na">timezone</span><span class="pi">:</span>      <span class="no">null</span>
 
-<span class="s">quiet</span><span class="pi">:</span>    <span class="s">false</span>
-<span class="s">verbose</span><span class="pi">:</span>  <span class="s">false</span>
-<span class="s">defaults</span><span class="pi">:</span> <span class="pi">[]</span>
+<span class="na">quiet</span><span class="pi">:</span>    <span class="no">false</span>
+<span class="na">verbose</span><span class="pi">:</span>  <span class="no">false</span>
+<span class="na">defaults</span><span class="pi">:</span> <span class="pi">[]</span>
 
-<span class="s">liquid</span><span class="pi">:</span>
-  <span class="s">error_mode</span><span class="pi">:</span> <span class="s">warn</span>
+<span class="na">liquid</span><span class="pi">:</span>
+  <span class="na">error_mode</span><span class="pi">:</span> <span class="s">warn</span>
 
 <span class="c1"># Markdown Processors</span>
-<span class="s">rdiscount</span><span class="pi">:</span>
-  <span class="s">extensions</span><span class="pi">:</span> <span class="pi">[]</span>
-
-<span class="s">redcarpet</span><span class="pi">:</span>
-  <span class="s">extensions</span><span class="pi">:</span> <span class="pi">[]</span>
-
-<span class="s">kramdown</span><span class="pi">:</span>
-  <span class="s">auto_ids</span><span class="pi">:</span>       <span class="s">true</span>
-  <span class="s">entity_output</span><span class="pi">:</span>  <span class="s">as_char</span>
-  <span class="s">toc_levels</span><span class="pi">:</span>     <span class="s">1..6</span>
-  <span class="s">smart_quotes</span><span class="pi">:</span>   <span class="s">lsquo,rsquo,ldquo,rdquo</span>
-  <span class="s">input</span><span class="pi">:</span>          <span class="s">GFM</span>
-  <span class="s">hard_wrap</span><span class="pi">:</span>      <span class="s">false</span>
-  <span class="s">footnote_nr</span><span class="pi">:</span>    <span class="s">1</span>
-</code></pre>
-</div>
+<span class="na">rdiscount</span><span class="pi">:</span>
+  <span class="na">extensions</span><span class="pi">:</span> <span class="pi">[]</span>
+
+<span class="na">redcarpet</span><span class="pi">:</span>
+  <span class="na">extensions</span><span class="pi">:</span> <span class="pi">[]</span>
+
+<span class="na">kramdown</span><span class="pi">:</span>
+  <span class="na">auto_ids</span><span class="pi">:</span>       <span class="no">true</span>
+  <span class="na">entity_output</span><span class="pi">:</span>  <span class="s">as_char</span>
+  <span class="na">toc_levels</span><span class="pi">:</span>     <span class="s">1..6</span>
+  <span class="na">smart_quotes</span><span class="pi">:</span>   <span class="s">lsquo,rsquo,ldquo,rdquo</span>
+  <span class="na">input</span><span class="pi">:</span>          <span class="s">GFM</span>
+  <span class="na">hard_wrap</span><span class="pi">:</span>      <span class="no">false</span>
+  <span class="na">footnote_nr</span><span class="pi">:</span>    <span class="s">1</span>
+</code></pre></div></div>
 
 <h2 id="liquid-options">Liquid Options</h2>
 
@@ -1010,12 +990,10 @@ extension for disabling fenced code.</li>
 <p>Note that you can also specify a language for highlighting after the first
 delimiter:</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>    ```ruby
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>    ```ruby
     # ...ruby code
     ```
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>With both fenced code blocks and highlighter enabled, this will statically
 highlight the code; without any syntax highlighter, it will add a
@@ -1045,8 +1023,7 @@ extensions are:</p>
 
 <p>If you’re interested in creating a custom markdown processor, you’re in luck! Create a new class in the <code class="highlighter-rouge">Jekyll::Converters::Markdown</code> namespace:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="k">class</span> <span class="nc">Jekyll</span><span class="o">::</span><span class="no">Converters</span><span class="o">::</span><span class="no">Markdown</span><span class="o">::</span><span class="no">MyCustomProcessor</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">class</span> <span class="nc">Jekyll</span><span class="o">::</span><span class="no">Converters</span><span class="o">::</span><span class="no">Markdown</span><span class="o">::</span><span class="no">MyCustomProcessor</span>
   <span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">config</span><span class="p">)</span>
     <span class="nb">require</span> <span class="s1">'funky_markdown'</span>
     <span class="vi">@config</span> <span class="o">=</span> <span class="n">config</span>
@@ -1060,16 +1037,13 @@ extensions are:</p>
     <span class="o">::</span><span class="no">FunkyMarkdown</span><span class="p">.</span><span class="nf">new</span><span class="p">(</span><span class="n">content</span><span class="p">).</span><span class="nf">convert</span>
   <span class="k">end</span>
 <span class="k">end</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Once you’ve created your class and have it properly set up either as a plugin
 in the <code class="highlighter-rouge">_plugins</code> folder or as a gem, specify it in your <code class="highlighter-rouge">_config.yml</code>:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">markdown</span><span class="pi">:</span> <span class="s">MyCustomProcessor</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">markdown</span><span class="pi">:</span> <span class="s">MyCustomProcessor</span>
+</code></pre></div></div>
 
 <h2 id="incremental-regeneration">Incremental Regeneration</h2>
 <div class="note warning">
@@ -1090,7 +1064,7 @@ track of both file modification times and inter-document dependencies in the
 <p>Under the current implementation, incremental regeneration will only generate a
 document or page if either it, or one of its dependencies, is modified. Currently,
 the only types of dependencies tracked are includes (using the
-<code class="highlighter-rouge"><span class="p">{</span><span class="err">%</span><span class="w"> </span><span class="err">include</span><span class="w"> </span><span class="err">%</span><span class="p">}</span></code> tag) and layouts. This means that plain
+<code class="highlighter-rouge">{% include %}</code> tag) and layouts. This means that plain
 references to other documents (for example, the common case of iterating over
 <code class="highlighter-rouge">site.posts</code> in a post listings page) will not be detected as a dependency.</p>