jekyll-docs 3.7.0 → 3.7.2

data/site/news/index.html

@@ -4,7 +4,7 @@
 <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.7.0">
+  <meta name="generator" content="Jekyll v3.7.2">
   <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">
@@ -13,7 +13,7 @@
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <!-- Begin Jekyll SEO tag v2.4.0 -->
 <title>News | Jekyll • Simple, blog-aware, static sites</title>
-<meta name="generator" content="Jekyll v3.7.0">
+<meta name="generator" content="Jekyll v3.7.2">
 <meta property="og:title" content="News">
 <meta name="author" content="all">
 <meta property="og:locale" content="en_US">
@@ -27,7 +27,7 @@
 <meta name="twitter:creator" content="@all">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
 <script type="application/ld+json">
-{"headline":"News","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"url":"https://jekyllrb.com/news/","description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"http://schema.org"}</script>
+{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"author":{"@type":"Person","name":"all"},"description":"Transform your plain text into static websites and blogs","headline":"News","url":"https://jekyllrb.com/news/","@type":"WebPage","@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -72,7 +72,7 @@
     <div class="meta hide-on-mobiles">
       <ul>
         <li>
-          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a>
+          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
         </li>
         <li>
           <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -112,6 +112,10 @@
     <option value="/news/">Home</option>
     <optgroup label="v1.x">
       
+      <option value="/news/2018/01/25/jekyll-3-7-1-released/">Jekyll 3.7.1 Released</option>
+      
+      <option value="/news/2018/01/02/jekyll-3-7-0-released/">Jekyll 3.7.0 Released</option>
+      
       <option value="/news/2017/10/21/jekyll-3-6-2-released/">Jekyll 3.6.2 Released</option>
       
       <option value="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</option>
@@ -132,8 +136,6 @@
       
       <option value="/news/2017/01/18/jekyll-3-4-0-released/">Jekyll turns 3.4.0</option>
       
-      <option value="/news/2017/01/02/jekyll-3-7-0-released/">Jekyll 3.7.0 Released</option>
-      
       <option value="/news/2016/11/14/jekyll-3-3-1-released/">Jekyll 3.3.1 Released</option>
       
       <option value="/news/2016/10/06/jekyll-3-3-is-here/">Jekyll 3.3 is here with better theme support, new URL filters, and tons more</option>
@@ -251,6 +253,158 @@
 
       <div class="unit four-fifths">
         
+  <article>
+  <h2>
+    <a href="/news/2018/01/25/jekyll-3-7-1-released/">
+      Jekyll 3.7.1 Released
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      25 Jan 2018
+    </span>
+    <a href="https://github.com/ashmaroli" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24" alt="ashmaroli" srcset="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      ashmaroli
+    </a>
+  </div>
+  <div class="post-content">
+    <p>Close on the heels of shipping 3.7.0, we were informed of a couple of
+regressions due to the changes made in that release. In due time, Team Jekyll
+set out to address those issues as early as possible.</p>
+
+<p>Days later here we’re, announcing 3.7.1 that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f389.png" height="20" width="20">
+The highlights being:</p>
+
+<ul>
+  <li>
+    <p>A major regression in 3.7.0 was that when a Front Matter Default was
+configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
+that directory for any subfolders and files, for each document in that
+<code class="highlighter-rouge">path</code>.
+Though this is intended, it increases build times in proportion to the size
+of the directory.</p>
+
+    <p>We addressed this by having Jekyll scan the directory path only if the user
+explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
+
+    <p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
+for more details.</p>
+
+    <p>A huge shout-out to <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> for bringing this to our notice and
+additionally providing us with a test repository to aid in resolving the issue.</p>
+  </li>
+  <li>
+    <p>Another regression reported was related to our “Custom collections
+directory” feature introduced in 3.7.0.</p>
+
+    <p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
+paths to their posts still at the root of their site’s source. This
+roughly translated to 404 errors on URLs to their posts.</p>
+
+    <p>Props to <a href="https://github.com/localheinz" class="user-mention">@localheinz</a> for bringing this regression to our notice.</p>
+
+    <p>We decided to resolve this by having Jekyll ignore posts and drafts at the
+root of the site’s source directory if the user customizes the
+<code class="highlighter-rouge">collection_dir</code> setting.</p>
+
+    <p>Ergo, if you set a custom location for your collections, please ensure you
+move all of your collections into that directory. <strong>This includes posts and
+drafts as well</strong>. Your links generated by
+<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
+will adapt automatically.</p>
+  </li>
+  <li>
+    <p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
+being watched on Windows. So we recommend having it included in your Gemfile
+for a better development experience on Windows. (Newly generated Gemfiles
+will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f609.png" height="20" width="20">)</p>
+  </li>
+</ul>
+
+<p>In addition to the above, numerous other minor fixes and documentation updates
+have been made that should improve your Jekyll experience. All of which, would
+not have been possible without our wonderful contributors:</p>
+
+<p>Alexandr, Andreas Möller, Ashwin Maroli, Chayoung You, Florian Thomas,
+Frank Taillandier, Hendrik Schneider, Kacper Duras, Olivia, Parker Moore and
+Paul Robert Lloyd.</p>
+
+<p>As always, you can see our full changelog on <a href="/docs/history/">the History page</a>.</p>
+
+<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
+
+  </div>
+</article>
+
+
+  <article>
+  <h2>
+    <a href="/news/2018/01/02/jekyll-3-7-0-released/">
+      Jekyll 3.7.0 Released
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      02 Jan 2018
+    </span>
+    <a href="https://github.com/DirtyF" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24" alt="DirtyF" srcset="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24 1x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=48 2x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=72 3x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      DirtyF
+    </a>
+  </div>
+  <div class="post-content">
+    <p>We’re happy to release a new minor for the new year.
+Here are a few of the latest additions from our contributors:</p>
+
+<ul>
+  <li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
+  <li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
+  <li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
+  <li>Jekyll will now check to determine whether host machine has internet connection.</li>
+  <li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
+  <li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
+  <li>
+<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
+</ul>
+
+<p>This release wouldn’t have been possible without all the following people:</p>
+
+<p>Aaron Borden, Alex Tsui, Alex Wood, Alexey Pelykh, Andrew Dassonville, Angelika Tyborska, Ankit Singhaniya, Ashwin Maroli, bellvat, Brandon Dusseau, Chris Finazzo, Doug Beney, Dr. Wolfram Schroers, Edward Shen, Florian Thomas, Frank Taillandier, Gert-jan Theunissen, Goulven Champenois, János Rusiczki, Jed Fox, Johannes Müller, Jon Anning, Jonathan Hooper, Jordon Bedwell, Junko Suzuki, Kacper Duras, Kenton Hansen, Kewin Dousse, Matt Rogers, Maximiliano Kotvinsky, mrHoliday, Olivia, Parker Moore, Pat Hawks, Sebastian Kulig, Vishesh Ruparelia, Xiaoiver and Yashu Mittal.</p>
+
+<p>A big thanks to everyone!</p>
+
+<p>Oh, one last thing…</p>
+
+<h3 id="pray-upgrade-your-ruby">
+<img class="emoji" title=":pray:" alt=":pray:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
+
+<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
+
+<blockquote>
+  <p>Ruby 2.2 is now under the state of the security maintenance phase, until the end of the March of 2018. After the date, maintenance of Ruby 2.2 will be ended. We recommend you start planning migration to newer versions of Ruby, such as 2.4 or 2.3. — <a href="https://www.ruby-lang.org/en/news/2017/12/14/ruby-2-2-9-released/">Ruby Core Team</a></p>
+</blockquote>
+
+<p>We strongly encourage you to upgrade to at least Ruby 2.4.x <a href="https://pages.github.com/versions/">like our friends at GitHub Pages</a> or even go with <a href="https://www.ruby-lang.org/en/news/2017/12/25/ruby-2-5-0-released/">Ruby 2.5</a>.</p>
+
+<p>Happy new year to all from the Jekyll team!</p>
+
+  </div>
+</article>
+
+
   <article>
   <h2>
     <a href="/news/2017/10/21/jekyll-3-6-2-released/">
@@ -876,67 +1030,6 @@ those already.</p>
 </article>
 
 
-  <article>
-  <h2>
-    <a href="/news/2017/01/02/jekyll-3-7-0-released/">
-      Jekyll 3.7.0 Released
-    </a>
-  </h2>
-  <span class="post-category">
-    <span class="label">
-      release
-    </span>
-  </span>
-  <div class="post-meta">
-    <span class="post-date">
-      02 Jan 2017
-    </span>
-    <a href="https://github.com/DirtyF" class="post-author">
-      
-      <img class="avatar avatar-small" src="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24" alt="DirtyF" srcset="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24 1x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=48 2x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=72 3x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
-      DirtyF
-    </a>
-  </div>
-  <div class="post-content">
-    <p>We’re happy to release a new minor for the new year.
-Here are a few of the latest additions from our contributors:</p>
-
-<ul>
-  <li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
-  <li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
-  <li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
-  <li>Jekyll will now check to determine whether host machine has internet connection.</li>
-  <li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
-  <li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
-  <li>
-<a href="(/docs/history/#v3-7-0)">Full history is here</a>.</li>
-</ul>
-
-<p>This release wouldn’t have been possible without all the following people:</p>
-
-<p>Aaron Borden, Alex Tsui, Alex Wood, Alexey Pelykh, Andrew Dassonville, Angelika Tyborska, Ankit Singhaniya, Ashwin Maroli, bellvat, Brandon Dusseau, Chris Finazzo, Doug Beney, Dr. Wolfram Schroers, Edward Shen, Florian Thomas, Frank Taillandier, Gert-jan Theunissen, Goulven Champenois, János Rusiczki, Jed Fox, Johannes Müller, Jon Anning, Jonathan Hooper, Jordon Bedwell, Junko Suzuki, Kacper Duras, Kenton Hansen, Kewin Dousse, Matt Rogers, Maximiliano Kotvinsky, mrHoliday, Olivia, Parker Moore, Pat Hawks, Sebastian Kulig, Vishesh Ruparelia, Xiaoiver and Yashu Mittal.</p>
-
-<p>A big thanks to everyone!</p>
-
-<p>Oh, one last thing…</p>
-
-<h3 id="pray-upgrade-your-ruby">
-<img class="emoji" title=":pray:" alt=":pray:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
-
-<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
-
-<blockquote>
-  <p>Ruby 2.2 is now under the state of the security maintenance phase, until the end of the March of 2018. After the date, maintenance of Ruby 2.2 will be ended. We recommend you start planning migration to newer versions of Ruby, such as 2.4 or 2.3. — <a href="https://www.ruby-lang.org/en/news/2017/12/14/ruby-2-2-9-released/">Ruby Core Team</a></p>
-</blockquote>
-
-<p>We strongly encourage you to upgrade to at least Ruby 2.4.x <a href="https://pages.github.com/versions/">like our friends at GitHub Pages</a> or even go with <a href="https://www.ruby-lang.org/en/news/2017/12/25/ruby-2-5-0-released/">Ruby 2.5</a>.</p>
-
-<p>Happy new year to all from the Jekyll team!</p>
-
-  </div>
-</article>
-
-
   <article>
   <h2>
     <a href="/news/2016/11/14/jekyll-3-3-1-released/">
@@ -2625,7 +2718,7 @@ things to look forward to:</p>
     </a>
   </div>
   <div class="post-content">
-    <p><img src="/img/jekyll-sticker.jpg" alt="Jekyll Sticker"></p>
+    <p><img src="/img/jekyll-sticker.png" alt="Jekyll Sticker"></p>
 
 <p>You may have heard that <a href="https://github.com/cobyism">@cobyism</a>’s excellent
 Jekyll logo has been made into a sticker. You may have sat idly by, wishing
@@ -3534,23 +3627,23 @@ examples and for compiling this list):</p>
     <ul>
       
       <li class="">
-        <a href="/news/2017/10/21/jekyll-3-6-2-released/">Version 3.6.2</a>
+        <a href="/news/2018/01/25/jekyll-3-7-1-released/">Version 3.7.1</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/09/21/jekyll-3-6-0-released/">Version 3.6.0</a>
+        <a href="/news/2018/01/02/jekyll-3-7-0-released/">Version 3.7.0</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/08/12/jekyll-3-5-2-released/">Version 3.5.2</a>
+        <a href="/news/2017/10/21/jekyll-3-6-2-released/">Version 3.6.2</a>
       </li>
       
       <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>
@@ -3563,6 +3656,10 @@ examples and for compiling this list):</p>
         
         
         
+        
+        
+        
+        
         <li class="">
           <a href="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</a>
         </li>
@@ -3586,8 +3683,6 @@ examples and for compiling this list):</p>
         
         
         
-        
-        
         
         
         

data/site/news/releases/index.html

@@ -4,7 +4,7 @@
 <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.7.0">
+  <meta name="generator" content="Jekyll v3.7.2">
   <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">
@@ -13,7 +13,7 @@
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <!-- Begin Jekyll SEO tag v2.4.0 -->
 <title>Releases | Jekyll • Simple, blog-aware, static sites</title>
-<meta name="generator" content="Jekyll v3.7.0">
+<meta name="generator" content="Jekyll v3.7.2">
 <meta property="og:title" content="Releases">
 <meta name="author" content="all">
 <meta property="og:locale" content="en_US">
@@ -27,7 +27,7 @@
 <meta name="twitter:creator" content="@all">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
 <script type="application/ld+json">
-{"headline":"Releases","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"url":"https://jekyllrb.com/news/releases/","description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"http://schema.org"}</script>
+{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"author":{"@type":"Person","name":"all"},"description":"Transform your plain text into static websites and blogs","headline":"Releases","url":"https://jekyllrb.com/news/releases/","@type":"WebPage","@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -72,7 +72,7 @@
     <div class="meta hide-on-mobiles">
       <ul>
         <li>
-          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a>
+          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
         </li>
         <li>
           <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -112,6 +112,10 @@
     <option value="/news/">Home</option>
     <optgroup label="v1.x">
       
+      <option value="/news/2018/01/25/jekyll-3-7-1-released/">Jekyll 3.7.1 Released</option>
+      
+      <option value="/news/2018/01/02/jekyll-3-7-0-released/">Jekyll 3.7.0 Released</option>
+      
       <option value="/news/2017/10/21/jekyll-3-6-2-released/">Jekyll 3.6.2 Released</option>
       
       <option value="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</option>
@@ -132,8 +136,6 @@
       
       <option value="/news/2017/01/18/jekyll-3-4-0-released/">Jekyll turns 3.4.0</option>
       
-      <option value="/news/2017/01/02/jekyll-3-7-0-released/">Jekyll 3.7.0 Released</option>
-      
       <option value="/news/2016/11/14/jekyll-3-3-1-released/">Jekyll 3.3.1 Released</option>
       
       <option value="/news/2016/10/06/jekyll-3-3-is-here/">Jekyll 3.3 is here with better theme support, new URL filters, and tons more</option>
@@ -251,6 +253,158 @@
 
       <div class="unit four-fifths">
         
+  <article>
+  <h2>
+    <a href="/news/2018/01/25/jekyll-3-7-1-released/">
+      Jekyll 3.7.1 Released
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      25 Jan 2018
+    </span>
+    <a href="https://github.com/ashmaroli" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24" alt="ashmaroli" srcset="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      ashmaroli
+    </a>
+  </div>
+  <div class="post-content">
+    <p>Close on the heels of shipping 3.7.0, we were informed of a couple of
+regressions due to the changes made in that release. In due time, Team Jekyll
+set out to address those issues as early as possible.</p>
+
+<p>Days later here we’re, announcing 3.7.1 that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f389.png" height="20" width="20">
+The highlights being:</p>
+
+<ul>
+  <li>
+    <p>A major regression in 3.7.0 was that when a Front Matter Default was
+configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
+that directory for any subfolders and files, for each document in that
+<code class="highlighter-rouge">path</code>.
+Though this is intended, it increases build times in proportion to the size
+of the directory.</p>
+
+    <p>We addressed this by having Jekyll scan the directory path only if the user
+explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
+
+    <p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
+for more details.</p>
+
+    <p>A huge shout-out to <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> for bringing this to our notice and
+additionally providing us with a test repository to aid in resolving the issue.</p>
+  </li>
+  <li>
+    <p>Another regression reported was related to our “Custom collections
+directory” feature introduced in 3.7.0.</p>
+
+    <p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
+paths to their posts still at the root of their site’s source. This
+roughly translated to 404 errors on URLs to their posts.</p>
+
+    <p>Props to <a href="https://github.com/localheinz" class="user-mention">@localheinz</a> for bringing this regression to our notice.</p>
+
+    <p>We decided to resolve this by having Jekyll ignore posts and drafts at the
+root of the site’s source directory if the user customizes the
+<code class="highlighter-rouge">collection_dir</code> setting.</p>
+
+    <p>Ergo, if you set a custom location for your collections, please ensure you
+move all of your collections into that directory. <strong>This includes posts and
+drafts as well</strong>. Your links generated by
+<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
+will adapt automatically.</p>
+  </li>
+  <li>
+    <p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
+being watched on Windows. So we recommend having it included in your Gemfile
+for a better development experience on Windows. (Newly generated Gemfiles
+will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f609.png" height="20" width="20">)</p>
+  </li>
+</ul>
+
+<p>In addition to the above, numerous other minor fixes and documentation updates
+have been made that should improve your Jekyll experience. All of which, would
+not have been possible without our wonderful contributors:</p>
+
+<p>Alexandr, Andreas Möller, Ashwin Maroli, Chayoung You, Florian Thomas,
+Frank Taillandier, Hendrik Schneider, Kacper Duras, Olivia, Parker Moore and
+Paul Robert Lloyd.</p>
+
+<p>As always, you can see our full changelog on <a href="/docs/history/">the History page</a>.</p>
+
+<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
+
+  </div>
+</article>
+
+
+  <article>
+  <h2>
+    <a href="/news/2018/01/02/jekyll-3-7-0-released/">
+      Jekyll 3.7.0 Released
+    </a>
+  </h2>
+  <span class="post-category">
+    <span class="label">
+      release
+    </span>
+  </span>
+  <div class="post-meta">
+    <span class="post-date">
+      02 Jan 2018
+    </span>
+    <a href="https://github.com/DirtyF" class="post-author">
+      
+      <img class="avatar avatar-small" src="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24" alt="DirtyF" srcset="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24 1x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=48 2x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=72 3x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
+      DirtyF
+    </a>
+  </div>
+  <div class="post-content">
+    <p>We’re happy to release a new minor for the new year.
+Here are a few of the latest additions from our contributors:</p>
+
+<ul>
+  <li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
+  <li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
+  <li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
+  <li>Jekyll will now check to determine whether host machine has internet connection.</li>
+  <li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
+  <li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
+  <li>
+<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
+</ul>
+
+<p>This release wouldn’t have been possible without all the following people:</p>
+
+<p>Aaron Borden, Alex Tsui, Alex Wood, Alexey Pelykh, Andrew Dassonville, Angelika Tyborska, Ankit Singhaniya, Ashwin Maroli, bellvat, Brandon Dusseau, Chris Finazzo, Doug Beney, Dr. Wolfram Schroers, Edward Shen, Florian Thomas, Frank Taillandier, Gert-jan Theunissen, Goulven Champenois, János Rusiczki, Jed Fox, Johannes Müller, Jon Anning, Jonathan Hooper, Jordon Bedwell, Junko Suzuki, Kacper Duras, Kenton Hansen, Kewin Dousse, Matt Rogers, Maximiliano Kotvinsky, mrHoliday, Olivia, Parker Moore, Pat Hawks, Sebastian Kulig, Vishesh Ruparelia, Xiaoiver and Yashu Mittal.</p>
+
+<p>A big thanks to everyone!</p>
+
+<p>Oh, one last thing…</p>
+
+<h3 id="pray-upgrade-your-ruby">
+<img class="emoji" title=":pray:" alt=":pray:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
+
+<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
+
+<blockquote>
+  <p>Ruby 2.2 is now under the state of the security maintenance phase, until the end of the March of 2018. After the date, maintenance of Ruby 2.2 will be ended. We recommend you start planning migration to newer versions of Ruby, such as 2.4 or 2.3. — <a href="https://www.ruby-lang.org/en/news/2017/12/14/ruby-2-2-9-released/">Ruby Core Team</a></p>
+</blockquote>
+
+<p>We strongly encourage you to upgrade to at least Ruby 2.4.x <a href="https://pages.github.com/versions/">like our friends at GitHub Pages</a> or even go with <a href="https://www.ruby-lang.org/en/news/2017/12/25/ruby-2-5-0-released/">Ruby 2.5</a>.</p>
+
+<p>Happy new year to all from the Jekyll team!</p>
+
+  </div>
+</article>
+
+
   <article>
   <h2>
     <a href="/news/2017/10/21/jekyll-3-6-2-released/">
@@ -810,67 +964,6 @@ those already.</p>
 </article>
 
 
-  <article>
-  <h2>
-    <a href="/news/2017/01/02/jekyll-3-7-0-released/">
-      Jekyll 3.7.0 Released
-    </a>
-  </h2>
-  <span class="post-category">
-    <span class="label">
-      release
-    </span>
-  </span>
-  <div class="post-meta">
-    <span class="post-date">
-      02 Jan 2017
-    </span>
-    <a href="https://github.com/DirtyF" class="post-author">
-      
-      <img class="avatar avatar-small" src="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24" alt="DirtyF" srcset="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24 1x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=48 2x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=72 3x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
-      DirtyF
-    </a>
-  </div>
-  <div class="post-content">
-    <p>We’re happy to release a new minor for the new year.
-Here are a few of the latest additions from our contributors:</p>
-
-<ul>
-  <li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
-  <li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
-  <li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
-  <li>Jekyll will now check to determine whether host machine has internet connection.</li>
-  <li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
-  <li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
-  <li>
-<a href="(/docs/history/#v3-7-0)">Full history is here</a>.</li>
-</ul>
-
-<p>This release wouldn’t have been possible without all the following people:</p>
-
-<p>Aaron Borden, Alex Tsui, Alex Wood, Alexey Pelykh, Andrew Dassonville, Angelika Tyborska, Ankit Singhaniya, Ashwin Maroli, bellvat, Brandon Dusseau, Chris Finazzo, Doug Beney, Dr. Wolfram Schroers, Edward Shen, Florian Thomas, Frank Taillandier, Gert-jan Theunissen, Goulven Champenois, János Rusiczki, Jed Fox, Johannes Müller, Jon Anning, Jonathan Hooper, Jordon Bedwell, Junko Suzuki, Kacper Duras, Kenton Hansen, Kewin Dousse, Matt Rogers, Maximiliano Kotvinsky, mrHoliday, Olivia, Parker Moore, Pat Hawks, Sebastian Kulig, Vishesh Ruparelia, Xiaoiver and Yashu Mittal.</p>
-
-<p>A big thanks to everyone!</p>
-
-<p>Oh, one last thing…</p>
-
-<h3 id="pray-upgrade-your-ruby">
-<img class="emoji" title=":pray:" alt=":pray:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
-
-<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
-
-<blockquote>
-  <p>Ruby 2.2 is now under the state of the security maintenance phase, until the end of the March of 2018. After the date, maintenance of Ruby 2.2 will be ended. We recommend you start planning migration to newer versions of Ruby, such as 2.4 or 2.3. — <a href="https://www.ruby-lang.org/en/news/2017/12/14/ruby-2-2-9-released/">Ruby Core Team</a></p>
-</blockquote>
-
-<p>We strongly encourage you to upgrade to at least Ruby 2.4.x <a href="https://pages.github.com/versions/">like our friends at GitHub Pages</a> or even go with <a href="https://www.ruby-lang.org/en/news/2017/12/25/ruby-2-5-0-released/">Ruby 2.5</a>.</p>
-
-<p>Happy new year to all from the Jekyll team!</p>
-
-  </div>
-</article>
-
-
   <article>
   <h2>
     <a href="/news/2016/11/14/jekyll-3-3-1-released/">
@@ -3203,23 +3296,23 @@ examples and for compiling this list):</p>
     <ul>
       
       <li class="">
-        <a href="/news/2017/10/21/jekyll-3-6-2-released/">Version 3.6.2</a>
+        <a href="/news/2018/01/25/jekyll-3-7-1-released/">Version 3.7.1</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/09/21/jekyll-3-6-0-released/">Version 3.6.0</a>
+        <a href="/news/2018/01/02/jekyll-3-7-0-released/">Version 3.7.0</a>
       </li>
       
       <li class="">
-        <a href="/news/2017/08/12/jekyll-3-5-2-released/">Version 3.5.2</a>
+        <a href="/news/2017/10/21/jekyll-3-6-2-released/">Version 3.6.2</a>
       </li>
       
       <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>
@@ -3232,6 +3325,10 @@ examples and for compiling this list):</p>
         
         
         
+        
+        
+        
+        
         <li class="">
           <a href="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</a>
         </li>
@@ -3255,8 +3352,6 @@ examples and for compiling this list):</p>
         
         
         
-        
-