jekyll-docs 3.5.2 → 3.6.0

data/site/news/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>News | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="News">
 <meta name="author" content="all">
@@ -25,7 +25,7 @@
 <meta name="twitter:creator" content="@all">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
 <script type="application/ld+json">
-{"@context":"http://schema.org","@type":"WebPage","headline":"News","author":{"@type":"Person","name":"all"},"description":"Transform your plain text into static websites and blogs","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"url":"https://jekyllrb.com/news/"}</script>
+{"name":null,"description":"Transform your plain text into static websites and blogs","url":"https://jekyllrb.com/news/","headline":"News","dateModified":null,"datePublished":null,"sameAs":null,"@type":"WebPage","author":{"@type":"Person","name":"all"},"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"mainEntityOfPage":null,"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -105,6 +105,10 @@
     <option value="/news/">Home</option>
     <optgroup label="v1.x">
       
+      <option value="/news/2017/09/21/jekyll-3-6-0-released/">Jekyll turns 3.6!</option>
+      
+      <option value="/news/2017/08/12/jekyll-3-5-2-released/">Jekyll 3.5.2 Released</option>
+      
       <option value="/news/2017/07/17/jekyll-3-5-1-released/">Jekyll 3.5.1 Released</option>
       
       <option value="/news/2017/06/15/jekyll-3-5-0-released/">Jekyll turns 3.5, oh my!</option>
@@ -234,6 +238,86 @@
 
       <div class="unit four-fifths">
         
+  <article>
+  <h2>
+    <a href="/news/2017/09/21/jekyll-3-6-0-released/">
+      Jekyll turns 3.6!
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      21 Sep 2017
+    </span>
+    <a href="https://github.com/parkr" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      parkr
+    </a>
+  </div>
+  <div class="post-content">
+    <p>Another much-anticipated release of Jekyll. This release comes with it Rouge 2 support, but note you can continue to use Rouge 1 if you’d prefer. We also now require Ruby 2.1.0 as 2.0.x is no longer supported by the Ruby team.</p>
+
+<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
+
+<p>Please let us know if you find any bugs! You can see <a href="/docs/history/#v3-6-0">the full history here</a>.</p>
+
+<p>Many thanks to our contributors who helped make this release possible: Aleksander Kuś, André Jaenisch, Antonio Argote, ashmaroli, Ben Balter, Bogdan, Bradley Meck, David Zhang, Florian Thomas, Frank Taillandier, Jordon Bedwell, Joshua Byrd, Kyle Zhao, lymaconsulting, Maciej Bembenista, Matt Sturgeon, Natanael Arndt, Ohad Schneider, Pat Hawks, Pedro Lamas, and Sid Verma.</p>
+
+<p>As always, Happy Jekylling!</p>
+
+  </div>
+</article>
+
+
+  <article>
+  <h2>
+    <a href="/news/2017/08/12/jekyll-3-5-2-released/">
+      Jekyll 3.5.2 Released
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      12 Aug 2017
+    </span>
+    <a href="https://github.com/parkr" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      parkr
+    </a>
+  </div>
+  <div class="post-content">
+    <p>3.5.2 is out with 6 great bug fixes, most notably one which should dramatically speed up generation of your site! In testing #6266, jekyllrb.com generation when from 18 seconds down to 8! Here is the full line-up of fixes:</p>
+
+<ul>
+  <li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
+  <li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
+  <li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
+  <li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
+  <li>Backport #6273 for v3.5.x: delegate <code class="highlighter-rouge">StaticFile#to_json</code> to <code class="highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
+  <li>Backport #6226 for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
+</ul>
+
+<p>A <a href="/docs/history/#v3-5-2">full history</a> is available for your perusal. As always, please file bugs if you encounter them! Opening a pull request with a failing test for your expected behaviour is the easiest way for us to address the issue since we have a reproducible example to test again. Short of that, please fill out our issue template to the best of your ability and we’ll try to get to it quickly!</p>
+
+<p>Many thanks to our contributors without whom this release could not be
+possible: Ben Balter &amp; Kyle Zhao.</p>
+
+<p>Happy Jekylling!</p>
+
+  </div>
+</article>
+
+
   <article>
   <h2>
     <a href="/news/2017/07/17/jekyll-3-5-1-released/">
@@ -300,13 +384,13 @@
 the wild. Some new shiny things you might want to test out:</p>
 
 <ul>
-  <li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> annd <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
+  <li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> and <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
 </li>
   <li>Themes can specify runtime dependencies (in their gemspecs) and we’ll require those. This makes it easier for theme writers to use plugins.</li>
   <li>Speaking of themes, we’ll properly handle the discrepancy between a convertible file in the local site and a static file in the theme. Overriding a file locally now doesn’t matter if it’s convertible or static.</li>
-  <li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">layout</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>.</li>
+  <li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
   <li>The <code class="highlighter-rouge">gems</code> key in the <code class="highlighter-rouge">_config.yml</code> is now <code class="highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="highlighter-rouge">gems</code> to <code class="highlighter-rouge">plugins</code> if you use the former.</li>
-  <li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge"><span class="p">{</span><span class="err">%</span><span class="w"> </span><span class="err">assign</span><span class="w"> </span><span class="err">sorted</span><span class="w"> </span><span class="err">=</span><span class="w"> </span><span class="err">site.posts</span><span class="w"> </span><span class="err">|</span><span class="w"> </span><span class="err">sort:</span><span class="w"> </span><span class="nt">"image.alt_text"</span><span class="w"> </span><span class="err">%}</span></code>.</li>
+  <li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
   <li>You can now create tab-separated data files.</li>
   <li>Using <code class="highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="highlighter-rouge">layout: null</code>, with the exception that <code class="highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
   <li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
@@ -381,10 +465,8 @@ relative URI, without the slash it cannot figure out how to turn
 objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
 but breaking in 3.4.0:</p>
 
-<div class="language-liquid highlighter-rouge">
-<pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"example :page"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">uri_escape</span><span class="w"> </span><span class="p">}}</span>
-</code></pre>
-</div>
+<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"example :page"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">uri_escape</span><span class="w"> </span><span class="p">}}</span>
+</code></pre></div></div>
 
 <p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
 
@@ -447,15 +529,13 @@ So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
 <p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
 defaults</a> for static files:</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">pdfs/"</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">sitemap</span><span class="pi">:</span> <span class="s">false</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">pdfs/"</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
+</code></pre></div></div>
 
 <p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
 folder <code class="highlighter-rouge">pdfs/</code>, you’ll see <code class="highlighter-rouge">sitemap</code> equal to <code class="highlighter-rouge">false</code>.</p>
@@ -509,19 +589,15 @@ functionality, which naturally goes untested.</p>
 <p>In our documentation, we tell users to name their posts with the following
 format:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>YYYY-MM-DD-title.extension
-</code></pre>
-</div>
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>YYYY-MM-DD-title.extension
+</code></pre></div></div>
 
 <p>That format specifies exactly four numbers for the year, e.g. 2017, two
 letters for the month, e.g. 03, and two letters for the day, e.g. 02. To
 match this, we had the following regular expression:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+)-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+)-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
+</code></pre></div></div>
 
 <p>You might already see the punchline. While our documentation specifies the
 exact number of numbers that is required for each section of the date, our
@@ -531,10 +607,8 @@ doesn’t conform to our documentation?</p>
 <p>We recently <a href="https://github.com/jekyll/jekyll/issues/5603">received a bug report</a>
 that detailed how the following file was considered a post:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>84093135-42842323-42000001-b890-136270f7e5f1.md
-</code></pre>
-</div>
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>84093135-42842323-42000001-b890-136270f7e5f1.md
+</code></pre></div></div>
 
 <p>Of course! It matches the above regular expression, but doesn’t satisfy
 other requirements about those numbers being a valid date (unless you’re
@@ -542,10 +616,8 @@ living in a world that has 43 million months, and 42 million (and one)
 days). So, we <a href="https://github.com/jekyll/jekyll/pull/5609">modified the regular expression to match our
 documentation</a>:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{4}-</span><span class="se">\d</span><span class="sr">{2}-</span><span class="se">\d</span><span class="sr">{2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{4}-</span><span class="se">\d</span><span class="sr">{2}-</span><span class="se">\d</span><span class="sr">{2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
+</code></pre></div></div>
 
 <p>Our tests all passed and we were properly excluding this crazy date with 43
 million months and days. This change shipped in Jekyll v3.4.0 and all was
@@ -570,10 +642,8 @@ in-hand from <a href="https://github.com/andrewbanchich" class="user-mention">@a
 and <a href="https://github.com/jekyll/jekyll/pull/5920">reintroduced</a> a proper
 minimum number of digits for each segment:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{2,4}-</span><span class="se">\d</span><span class="sr">{1,2}-</span><span class="se">\d</span><span class="sr">{1,2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{2,4}-</span><span class="se">\d</span><span class="sr">{1,2}-</span><span class="se">\d</span><span class="sr">{1,2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
+</code></pre></div></div>
 
 <p>And, I wrote a test.</p>
 
@@ -1313,10 +1383,10 @@ we think you’ll love.</p>
   <li>Configuration for the posts permalink might be borked when a user specified a value for <code class="highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
 </ul>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><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>
-    <span class="s">permalink</span><span class="pi">:</span> <span class="s">/blog/:year/:title/</span></code></pre></figure>
+<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><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="na">permalink</span><span class="pi">:</span> <span class="s">/blog/:year/:title/</span></code></pre></figure>
 
 <p>Both of these issues have been resolved. For more information, check out <a href="/docs/history/#v3-0-4">the full history</a>.</p>
 
@@ -1794,7 +1864,7 @@ improved problematic code that caused slow-downs.</li>
 
 <p>To install just run:</p>
 
-<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="gp">$ </span>gem install jekyll --pre</code></pre></figure>
+<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nv">$ </span>gem install jekyll <span class="nt">--pre</span></code></pre></figure>
 
 <p>Future versions will include <a href="https://github.com/jekyll/jekyll/issues/3324">some awesome new
 features</a> that we haven’t
@@ -3262,23 +3332,23 @@ examples and for compiling this list):</p>
     <ul>
       
       <li class="">
-        <a href="/news/2017/07/17/jekyll-3-5-1-released/">Version 3.5.1</a>
+        <a href="/news/2017/09/21/jekyll-3-6-0-released/">Version 3.6.0</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
+        <a href="/news/2017/08/12/jekyll-3-5-2-released/">Version 3.5.2</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
+        <a href="/news/2017/07/17/jekyll-3-5-1-released/">Version 3.5.1</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/03/09/jekyll-3-4-2-released/">Version 3.4.2</a>
+        <a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/03/02/jekyll-3-4-1-released/">Version 3.4.1</a>
+        <a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
       </li>
       
       <li>
@@ -3303,6 +3373,10 @@ examples and for compiling this list):</p>
         
         
         
+        
+        
+        
+        
         
         
         <li class="">

data/site/news/releases/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>Releases | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Releases">
 <meta name="author" content="all">
@@ -25,7 +25,7 @@
 <meta name="twitter:creator" content="@all">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
 <script type="application/ld+json">
-{"@context":"http://schema.org","@type":"WebPage","headline":"Releases","author":{"@type":"Person","name":"all"},"description":"Transform your plain text into static websites and blogs","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"url":"https://jekyllrb.com/news/releases/"}</script>
+{"name":null,"description":"Transform your plain text into static websites and blogs","url":"https://jekyllrb.com/news/releases/","headline":"Releases","dateModified":null,"datePublished":null,"sameAs":null,"@type":"WebPage","author":{"@type":"Person","name":"all"},"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"mainEntityOfPage":null,"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -105,6 +105,10 @@
     <option value="/news/">Home</option>
     <optgroup label="v1.x">
       
+      <option value="/news/2017/09/21/jekyll-3-6-0-released/">Jekyll turns 3.6!</option>
+      
+      <option value="/news/2017/08/12/jekyll-3-5-2-released/">Jekyll 3.5.2 Released</option>
+      
       <option value="/news/2017/07/17/jekyll-3-5-1-released/">Jekyll 3.5.1 Released</option>
       
       <option value="/news/2017/06/15/jekyll-3-5-0-released/">Jekyll turns 3.5, oh my!</option>
@@ -234,6 +238,86 @@
 
       <div class="unit four-fifths">
         
+  <article>
+  <h2>
+    <a href="/news/2017/09/21/jekyll-3-6-0-released/">
+      Jekyll turns 3.6!
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      21 Sep 2017
+    </span>
+    <a href="https://github.com/parkr" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      parkr
+    </a>
+  </div>
+  <div class="post-content">
+    <p>Another much-anticipated release of Jekyll. This release comes with it Rouge 2 support, but note you can continue to use Rouge 1 if you’d prefer. We also now require Ruby 2.1.0 as 2.0.x is no longer supported by the Ruby team.</p>
+
+<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
+
+<p>Please let us know if you find any bugs! You can see <a href="/docs/history/#v3-6-0">the full history here</a>.</p>
+
+<p>Many thanks to our contributors who helped make this release possible: Aleksander Kuś, André Jaenisch, Antonio Argote, ashmaroli, Ben Balter, Bogdan, Bradley Meck, David Zhang, Florian Thomas, Frank Taillandier, Jordon Bedwell, Joshua Byrd, Kyle Zhao, lymaconsulting, Maciej Bembenista, Matt Sturgeon, Natanael Arndt, Ohad Schneider, Pat Hawks, Pedro Lamas, and Sid Verma.</p>
+
+<p>As always, Happy Jekylling!</p>
+
+  </div>
+</article>
+
+
+  <article>
+  <h2>
+    <a href="/news/2017/08/12/jekyll-3-5-2-released/">
+      Jekyll 3.5.2 Released
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      12 Aug 2017
+    </span>
+    <a href="https://github.com/parkr" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      parkr
+    </a>
+  </div>
+  <div class="post-content">
+    <p>3.5.2 is out with 6 great bug fixes, most notably one which should dramatically speed up generation of your site! In testing #6266, jekyllrb.com generation when from 18 seconds down to 8! Here is the full line-up of fixes:</p>
+
+<ul>
+  <li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
+  <li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
+  <li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
+  <li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
+  <li>Backport #6273 for v3.5.x: delegate <code class="highlighter-rouge">StaticFile#to_json</code> to <code class="highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
+  <li>Backport #6226 for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
+</ul>
+
+<p>A <a href="/docs/history/#v3-5-2">full history</a> is available for your perusal. As always, please file bugs if you encounter them! Opening a pull request with a failing test for your expected behaviour is the easiest way for us to address the issue since we have a reproducible example to test again. Short of that, please fill out our issue template to the best of your ability and we’ll try to get to it quickly!</p>
+
+<p>Many thanks to our contributors without whom this release could not be
+possible: Ben Balter &amp; Kyle Zhao.</p>
+
+<p>Happy Jekylling!</p>
+
+  </div>
+</article>
+
+
   <article>
   <h2>
     <a href="/news/2017/07/17/jekyll-3-5-1-released/">
@@ -300,13 +384,13 @@
 the wild. Some new shiny things you might want to test out:</p>
 
 <ul>
-  <li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> annd <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
+  <li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> and <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
 </li>
   <li>Themes can specify runtime dependencies (in their gemspecs) and we’ll require those. This makes it easier for theme writers to use plugins.</li>
   <li>Speaking of themes, we’ll properly handle the discrepancy between a convertible file in the local site and a static file in the theme. Overriding a file locally now doesn’t matter if it’s convertible or static.</li>
-  <li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">layout</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>.</li>
+  <li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
   <li>The <code class="highlighter-rouge">gems</code> key in the <code class="highlighter-rouge">_config.yml</code> is now <code class="highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="highlighter-rouge">gems</code> to <code class="highlighter-rouge">plugins</code> if you use the former.</li>
-  <li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge"><span class="p">{</span><span class="err">%</span><span class="w"> </span><span class="err">assign</span><span class="w"> </span><span class="err">sorted</span><span class="w"> </span><span class="err">=</span><span class="w"> </span><span class="err">site.posts</span><span class="w"> </span><span class="err">|</span><span class="w"> </span><span class="err">sort:</span><span class="w"> </span><span class="nt">"image.alt_text"</span><span class="w"> </span><span class="err">%}</span></code>.</li>
+  <li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
   <li>You can now create tab-separated data files.</li>
   <li>Using <code class="highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="highlighter-rouge">layout: null</code>, with the exception that <code class="highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
   <li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
@@ -381,10 +465,8 @@ relative URI, without the slash it cannot figure out how to turn
 objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
 but breaking in 3.4.0:</p>
 
-<div class="language-liquid highlighter-rouge">
-<pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"example :page"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">uri_escape</span><span class="w"> </span><span class="p">}}</span>
-</code></pre>
-</div>
+<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"example :page"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">uri_escape</span><span class="w"> </span><span class="p">}}</span>
+</code></pre></div></div>
 
 <p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
 
@@ -447,15 +529,13 @@ So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
 <p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
 defaults</a> for static files:</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">pdfs/"</span>
-    <span class="s">values</span><span class="pi">:</span>
-      <span class="s">sitemap</span><span class="pi">:</span> <span class="s">false</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">pdfs/"</span>
+    <span class="na">values</span><span class="pi">:</span>
+      <span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
+</code></pre></div></div>
 
 <p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
 folder <code class="highlighter-rouge">pdfs/</code>, you’ll see <code class="highlighter-rouge">sitemap</code> equal to <code class="highlighter-rouge">false</code>.</p>
@@ -509,19 +589,15 @@ functionality, which naturally goes untested.</p>
 <p>In our documentation, we tell users to name their posts with the following
 format:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>YYYY-MM-DD-title.extension
-</code></pre>
-</div>
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>YYYY-MM-DD-title.extension
+</code></pre></div></div>
 
 <p>That format specifies exactly four numbers for the year, e.g. 2017, two
 letters for the month, e.g. 03, and two letters for the day, e.g. 02. To
 match this, we had the following regular expression:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+)-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+-</span><span class="se">\d</span><span class="sr">+)-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
+</code></pre></div></div>
 
 <p>You might already see the punchline. While our documentation specifies the
 exact number of numbers that is required for each section of the date, our
@@ -531,10 +607,8 @@ doesn’t conform to our documentation?</p>
 <p>We recently <a href="https://github.com/jekyll/jekyll/issues/5603">received a bug report</a>
 that detailed how the following file was considered a post:</p>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>84093135-42842323-42000001-b890-136270f7e5f1.md
-</code></pre>
-</div>
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>84093135-42842323-42000001-b890-136270f7e5f1.md
+</code></pre></div></div>
 
 <p>Of course! It matches the above regular expression, but doesn’t satisfy
 other requirements about those numbers being a valid date (unless you’re
@@ -542,10 +616,8 @@ living in a world that has 43 million months, and 42 million (and one)
 days). So, we <a href="https://github.com/jekyll/jekyll/pull/5609">modified the regular expression to match our
 documentation</a>:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{4}-</span><span class="se">\d</span><span class="sr">{2}-</span><span class="se">\d</span><span class="sr">{2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{4}-</span><span class="se">\d</span><span class="sr">{2}-</span><span class="se">\d</span><span class="sr">{2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
+</code></pre></div></div>
 
 <p>Our tests all passed and we were properly excluding this crazy date with 43
 million months and days. This change shipped in Jekyll v3.4.0 and all was
@@ -570,10 +642,8 @@ in-hand from <a href="https://github.com/andrewbanchich" class="user-mention">@a
 and <a href="https://github.com/jekyll/jekyll/pull/5920">reintroduced</a> a proper
 minimum number of digits for each segment:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{2,4}-</span><span class="se">\d</span><span class="sr">{1,2}-</span><span class="se">\d</span><span class="sr">{1,2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="sr">%r!^(?:.+/)*(</span><span class="se">\d</span><span class="sr">{2,4}-</span><span class="se">\d</span><span class="sr">{1,2}-</span><span class="se">\d</span><span class="sr">{1,2})-(.*)(</span><span class="se">\.</span><span class="sr">[^.]+)$!</span>
+</code></pre></div></div>
 
 <p>And, I wrote a test.</p>
 
@@ -1238,10 +1308,10 @@ we think you’ll love.</p>
   <li>Configuration for the posts permalink might be borked when a user specified a value for <code class="highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
 </ul>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><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>
-    <span class="s">permalink</span><span class="pi">:</span> <span class="s">/blog/:year/:title/</span></code></pre></figure>
+<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><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="na">permalink</span><span class="pi">:</span> <span class="s">/blog/:year/:title/</span></code></pre></figure>
 
 <p>Both of these issues have been resolved. For more information, check out <a href="/docs/history/#v3-0-4">the full history</a>.</p>
 
@@ -1649,7 +1719,7 @@ improved problematic code that caused slow-downs.</li>
 
 <p>To install just run:</p>
 
-<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="gp">$ </span>gem install jekyll --pre</code></pre></figure>
+<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nv">$ </span>gem install jekyll <span class="nt">--pre</span></code></pre></figure>
 
 <p>Future versions will include <a href="https://github.com/jekyll/jekyll/issues/3324">some awesome new
 features</a> that we haven’t
@@ -2997,23 +3067,23 @@ examples and for compiling this list):</p>
     <ul>
       
       <li class="">
-        <a href="/news/2017/07/17/jekyll-3-5-1-released/">Version 3.5.1</a>
+        <a href="/news/2017/09/21/jekyll-3-6-0-released/">Version 3.6.0</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
+        <a href="/news/2017/08/12/jekyll-3-5-2-released/">Version 3.5.2</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
+        <a href="/news/2017/07/17/jekyll-3-5-1-released/">Version 3.5.1</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/03/09/jekyll-3-4-2-released/">Version 3.4.2</a>
+        <a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/03/02/jekyll-3-4-1-released/">Version 3.4.1</a>
+        <a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
       </li>
       
       <li>
@@ -3038,6 +3108,10 @@ examples and for compiling this list):</p>
         
         
         
+        
+        
+        
+        
         
         
         <li class="">