RubyGems - jekyll-docs - Versions diffs - 3.9.0 → 4.0.0 - Mend

jekyll-docs 3.9.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (225) hide show

checksums.yaml +4 -4
data/lib/jekyll-docs.rb +3 -3
data/site/404.html +10 -7
data/site/css/screen.css +3 -1
data/site/css/screen.css.map +28 -0
data/site/docs/assets/index.html +412 -453
data/site/docs/code_of_conduct/index.html +447 -501
data/site/docs/collections/index.html +487 -674
data/site/docs/community/bug/index.html +603 -0
data/site/docs/community/index.html +635 -0
data/site/docs/conduct/index.html +447 -515
data/site/docs/configuration/default/index.html +682 -0
data/site/docs/configuration/environments/index.html +641 -0
data/site/docs/configuration/front-matter-defaults/index.html +738 -0
data/site/docs/configuration/incremental-regeneration/index.html +631 -0
data/site/docs/configuration/index.html +405 -1230
data/site/docs/configuration/liquid/index.html +616 -0
data/site/docs/configuration/markdown/index.html +766 -0
data/site/docs/configuration/options/index.html +1011 -0
data/site/docs/configuration/webrick/index.html +615 -0
data/site/docs/continuous-integration/buddyworks/index.html +393 -479
data/site/docs/continuous-integration/circleci/index.html +465 -481
data/site/docs/continuous-integration/travis-ci/index.html +450 -507
data/site/docs/contributing/index.html +425 -514
data/site/docs/datafiles/index.html +411 -453
data/site/docs/deployment-methods/index.html +9 -871
data/site/docs/deployment/automated/index.html +663 -0
data/site/docs/deployment/index.html +607 -0
data/site/docs/deployment/manual/index.html +631 -0
data/site/docs/deployment/third-party/index.html +639 -0
data/site/docs/drafts/index.html +9 -634
data/site/docs/extras/index.html +9 -687
data/site/docs/front-matter/index.html +799 -0
data/site/docs/frontmatter/index.html +9 -819
data/site/docs/github-pages/index.html +407 -475
data/site/docs/history/index.html +1370 -1154
data/site/docs/home/index.html +9 -627
data/site/docs/includes/index.html +425 -501
data/site/docs/index.html +630 -9
data/site/docs/installation/index.html +403 -540
data/site/docs/installation/macos/index.html +716 -0
data/site/docs/installation/other-linux/index.html +613 -0
data/site/docs/installation/ubuntu/index.html +623 -0
data/site/docs/installation/windows/index.html +733 -0
data/site/docs/layouts/index.html +726 -0
data/site/docs/liquid/filters/index.html +1169 -0
data/site/docs/liquid/index.html +615 -0
data/site/docs/liquid/tags/index.html +728 -0
data/site/docs/maintaining/affinity-team-captain/index.html +395 -479
data/site/docs/maintaining/avoiding-burnout/index.html +391 -475
data/site/docs/maintaining/becoming-a-maintainer/index.html +391 -475
data/site/docs/maintaining/index.html +391 -486
data/site/docs/maintaining/merging-a-pull-request/index.html +406 -490
data/site/docs/maintaining/releasing-a-new-version/index.html +409 -485
data/site/docs/maintaining/reviewing-a-pull-request/index.html +392 -476
data/site/docs/maintaining/special-labels/index.html +397 -481
data/site/docs/maintaining/triaging-an-issue/index.html +394 -478
data/site/docs/markdown-101/index.html +601 -0
data/site/docs/migrations/index.html +396 -440
data/site/docs/pages/index.html +408 -482
data/site/docs/pagination/index.html +450 -509
data/site/docs/permalinks/index.html +552 -587
data/site/docs/plugins/commands/index.html +656 -0
data/site/docs/plugins/converters/index.html +685 -0
data/site/docs/plugins/filters/index.html +624 -0
data/site/docs/plugins/generators/index.html +697 -0
data/site/docs/plugins/hooks/index.html +838 -0
data/site/docs/plugins/index.html +415 -1565
data/site/docs/plugins/installation/index.html +681 -0
data/site/docs/plugins/tags/index.html +699 -0
data/site/docs/plugins/your-first-plugin/index.html +741 -0
data/site/docs/posts/index.html +491 -627
data/site/docs/quickstart/index.html +9 -645
data/site/docs/resources/index.html +9 -761
data/site/docs/ruby-101/index.html +640 -0
data/site/docs/sites/index.html +9 -696
data/site/docs/static-files/index.html +401 -433
data/site/docs/step-by-step/01-setup/index.html +771 -0
data/site/docs/step-by-step/02-liquid/index.html +756 -0
data/site/docs/step-by-step/03-front-matter/index.html +730 -0
data/site/docs/step-by-step/04-layouts/index.html +770 -0
data/site/docs/step-by-step/05-includes/index.html +768 -0
data/site/docs/step-by-step/06-data-files/index.html +738 -0
data/site/docs/step-by-step/07-assets/index.html +773 -0
data/site/docs/step-by-step/08-blogging/index.html +835 -0
data/site/docs/step-by-step/09-collections/index.html +932 -0
data/site/docs/step-by-step/10-deployment/index.html +842 -0
data/site/docs/structure/index.html +411 -430
data/site/docs/support/index.html +392 -476
data/site/docs/templates/index.html +9 -1232
data/site/docs/themes/index.html +487 -521
data/site/docs/troubleshooting/index.html +443 -520
data/site/docs/upgrading/0-to-2/index.html +437 -523
data/site/docs/upgrading/2-to-3/index.html +422 -507
data/site/docs/upgrading/3-to-4/index.html +765 -0
data/site/docs/upgrading/index.html +395 -478
data/site/docs/usage/index.html +409 -506
data/site/docs/variables/index.html +504 -652
data/site/docs/windows/index.html +9 -784
data/site/feed.xml +269 -188
data/site/feed/release.xml +324 -0
data/site/fonts/lato-v14-latin-300.woff +0 -0
data/site/fonts/lato-v14-latin-300.woff2 +0 -0
data/site/fonts/lato-v14-latin-300italic.woff +0 -0
data/site/fonts/lato-v14-latin-300italic.woff2 +0 -0
data/site/fonts/lato-v14-latin-700.woff +0 -0
data/site/fonts/lato-v14-latin-700.woff2 +0 -0
data/site/fonts/lato-v14-latin-700italic.woff +0 -0
data/site/fonts/lato-v14-latin-700italic.woff2 +0 -0
data/site/fonts/lato-v14-latin-900.woff +0 -0
data/site/fonts/lato-v14-latin-900.woff2 +0 -0
data/site/fonts/lato-v14-latin-900italic.woff +0 -0
data/site/fonts/lato-v14-latin-900italic.woff2 +0 -0
data/site/fonts/lato-v14-latin-italic.woff +0 -0
data/site/fonts/lato-v14-latin-italic.woff2 +0 -0
data/site/fonts/lato-v14-latin-regular.woff +0 -0
data/site/fonts/lato-v14-latin-regular.woff2 +0 -0
data/site/help/index.html +9 -247
data/site/img/forestry-logo.svg +19 -0
data/site/img/jekyll-og.png +0 -0
data/site/img/spacer.gif +0 -0
data/site/index.html +56 -29
data/site/jekyllconf/index.html +62 -35
data/site/latest_version.txt +1 -1
data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +180 -115
data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +182 -117
data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +183 -118
data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +184 -119
data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +183 -118
data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +180 -115
data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +182 -117
data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +182 -117
data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +185 -120
data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +183 -118
data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +180 -115
data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +189 -124
data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +181 -116
data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +181 -116
data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +180 -115
data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +182 -117
data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +181 -116
data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +181 -116
data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +181 -116
data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +184 -119
data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +180 -115
data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +181 -116
data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +185 -120
data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +182 -117
data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +181 -116
data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +189 -124
data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +187 -122
data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +188 -123
data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +180 -115
data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +182 -117
data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +179 -114
data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +180 -115
data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +179 -114
data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +180 -115
data/site/news/2015/02/26/introducing-jekyll-talk/index.html +180 -115
data/site/news/2015/10/26/jekyll-3-0-released/index.html +185 -120
data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +184 -119
data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +182 -117
data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +186 -121
data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +183 -118
data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +181 -116
data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +182 -117
data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +179 -114
data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +181 -116
data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +181 -116
data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +180 -115
data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +186 -121
data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +181 -116
data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +181 -116
data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +179 -114
data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +184 -119
data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +180 -115
data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +179 -114
data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +207 -142
data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +181 -116
data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +183 -118
data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +181 -116
data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +189 -124
data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +190 -125
data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +187 -122
data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +182 -117
data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +185 -120
data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +181 -116
data/site/news/2017/10/19/diversity-open-source/index.html +181 -116
data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +183 -118
data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +184 -119
data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +189 -124
data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +180 -115
data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +185 -120
data/site/news/2018/04/19/development-update/index.html +699 -0
data/site/news/2018/04/19/jekyll-3-8-0-released/index.html +715 -0
data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +182 -117
data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +181 -116
data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +183 -118
data/site/news/2018/08/01/jekyll-sponsoring/index.html +748 -0
data/site/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/index.html +692 -0
data/site/news/2018/11/04/jekyll-3-8-5-released/index.html +682 -0
data/site/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/index.html +710 -0
data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +180 -115
data/site/news/2019/07/20/jekyll-4-0-0-pre-beta1-released/index.html +11 -0
data/site/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/index.html +708 -0
data/site/news/2019/08/20/jekyll-4-0-0-released/index.html +809 -0
data/site/news/index.html +976 -326
data/site/news/releases/index.html +820 -321
data/site/{philosophy.html → philosophy/index.html} +1 -1
data/site/redirects.json +1 -1
data/site/resources/index.html +332 -0
data/site/showcase/index.html +844 -0
data/site/sitemap.xml +256 -81
data/site/team/index.html +63 -77
data/site/tutorials/cache-api/index.html +418 -0
data/site/tutorials/convert-site-to-jekyll/index.html +155 -124
data/site/tutorials/custom-404-page/index.html +76 -43
data/site/tutorials/home/index.html +64 -37
data/site/tutorials/navigation/index.html +186 -103
data/site/tutorials/orderofinterpretation/index.html +80 -53
data/site/tutorials/using-jekyll-with-bundler/index.html +80 -51
data/site/tutorials/video-walkthroughs/index.html +62 -35
metadata +102 -13
data/site/community/index.html +0 -11
data/site/docs/continuous-integration/index.html +0 -681

data/site/docs/collections/index.html CHANGED

@@ -3,32 +3,35 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="generator" content="Jekyll v3.9.0">
+  <meta name="generator" content="Jekyll v4.0.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
+  <link type="application/atom+xml" rel="alternate" href="/feed/release.xml" title="Jekyll releases posts" />
   <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="preconnect" href="https://fonts.gstatic.com/" crossorigin>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
+  <link rel="preload" href="/fonts/lato-v14-latin-300.woff2" as="font" type="font/woff2" crossorigin />
+  <link rel="preload" href="/fonts/lato-v14-latin-700.woff2" as="font" type="font/woff2" crossorigin />
+  <link rel="preload" href="/css/screen.css" as="style">
   <link rel="stylesheet" href="/css/screen.css">
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <!-- Begin Jekyll SEO tag v2.6.1 -->
 <title>Collections | Jekyll • Simple, blog-aware, static sites</title>
-<meta name="generator" content="Jekyll v3.9.0" />
+<meta name="generator" content="Jekyll v4.0.0" />
 <meta property="og:title" content="Collections" />
 <meta property="og:locale" content="en_US" />
-<meta name="description" content="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." />
-<meta property="og:description" content="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." />
+<meta name="description" content="Collections are a great way to group related content like members of a team or talks at a conference." />
+<meta property="og:description" content="Collections are a great way to group related content like members of a team or talks at a conference." />
 <link rel="canonical" href="https://jekyllrb.com/docs/collections/" />
 <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:image" content="https://jekyllrb.com/img/jekyll-og.png" />
 <meta property="og:type" content="article" />
-<meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
-<meta name="twitter:card" content="summary" />
+<meta property="article:published_time" content="2019-09-11T07:30:27-07:00" />
+<meta name="twitter:card" content="summary_large_image" />
+<meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
 <meta property="twitter:title" content="Collections" />
 <meta name="twitter:site" content="@jekyllrb" />
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
 <script type="application/ld+json">
-{"url":"https://jekyllrb.com/docs/collections/","headline":"Collections","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"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.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/collections/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
+{"description":"Collections are a great way to group related content like members of a team or talks at a conference.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/collections/"},"headline":"Collections","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/collections/","datePublished":"2019-09-11T07:30:27-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@context":"https://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
   <!--[if lt IE 9]>
@@ -51,18 +54,27 @@
     </div>
     <nav class="main-nav hide-on-mobiles">
       <ul>
-  <li class="">
+  <li>
     <a href="/">Home</a>
   </li>
   <li class="current">
-    <a href="/docs/home/">Docs</a>
+    <a href="/docs/">Docs</a>
   </li>
-  <li class="">
-    <a href="/news/">News</a>
+  <li>
+    <a href="/resources/">Resources</a>
+  </li>
+  <li>
+    <a href="/showcase/">Showcase</a>
   </li>
-  <li class="">
-    <a href="/help/">Help</a>
+  <li>
+    <a href="/news/">News</a>
   </li>
 </ul>
     </nav>
@@ -73,7 +85,7 @@
     <div class="meta hide-on-mobiles">
       <ul>
         <li>
-          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
+          <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
         </li>
         <li>
           <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -83,18 +95,24 @@
   </div>
   <nav class="mobile-nav show-on-mobiles">
     <ul>
-  <li class="">
-    <a href="/">Home</a>
-  </li>
-  <li class="current">
-    <a href="/docs/home/">Docs</a>
-  </li>
-  <li class="">
-    <a href="/news/">News</a>
-  </li>
-  <li class="">
-    <a href="/help/">Help</a>
-  </li>
+    <li>
+      <a href="/">Home</a>
+    </li>
+    <li class="current">
+      <a href="/docs/">Docs</a>
+    </li>
+    <li>
+      <a href="/resources/">Resources</a>
+    </li>
+    <li>
+      <a href="/news/">News</a>
+    </li>
   <li>
     <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
@@ -113,176 +131,152 @@
     <optgroup label="Getting Started">
-  <option value="/docs/home/">Welcome</option>
-  <option value="/docs/quickstart/">Quick-start guide</option>
-  <option value="/docs/installation/">Installation</option>
-  <option value="/docs/windows/">Jekyll on Windows</option>
-  <option value="/docs/usage/">Basic Usage</option>
-  <option value="/docs/structure/">Directory structure</option>
-  <option value="/docs/configuration/">Configuration</option>
-    </optgroup>
-    <optgroup label="Your Content">
+        <option value="/docs/">
+          Quickstart
+        </option>
+        <option value="/docs/ruby-101/">
+          Ruby 101
+        </option>
+        <option value="/docs/installation/">
+          Installation
+        </option>
+        <option value="/docs/community/">
+          Community
+        </option>
+        <option value="/docs/step-by-step/01-setup/">
+          Step by Step Tutorial
+        </option>
-  <option value="/docs/frontmatter/">Front Matter</option>
-  <option value="/docs/posts/">Writing posts</option>
-  <option value="/docs/drafts/">Working with drafts</option>
-  <option value="/docs/pages/">Creating pages</option>
-  <option value="/docs/static-files/">Static Files</option>
-  <option value="/docs/variables/">Variables</option>
-  <option value="/docs/collections/">Collections</option>
-  <option value="/docs/datafiles/">Data Files</option>
-  <option value="/docs/assets/">Assets</option>
-  <option value="/docs/migrations/">Blog migrations</option>
     </optgroup>
-    <optgroup label="Customization">
+    <optgroup label="Build">
+        <option value="/docs/usage/">
+          Command Line Usage
+        </option>
+        <option value="/docs/configuration/">
+          Configuration
+        </option>
-  <option value="/docs/templates/">Templates</option>
-  <option value="/docs/includes/">Includes</option>
-  <option value="/docs/permalinks/">Permalinks</option>
-  <option value="/docs/pagination/">Pagination</option>
-  <option value="/docs/plugins/">Plugins</option>
-  <option value="/docs/themes/">Themes</option>
-  <option value="/docs/extras/">Extras</option>
     </optgroup>
-    <optgroup label="Deployment">
+    <optgroup label="Content">
+        <option value="/docs/pages/">
+          Pages
+        </option>
+        <option value="/docs/posts/">
+          Posts
+        </option>
+        <option value="/docs/front-matter/">
+          Front Matter
+        </option>
+        <option value="/docs/collections/">
+          Collections
+        </option>
+        <option value="/docs/datafiles/">
+          Data Files
+        </option>
+        <option value="/docs/assets/">
+          Assets
+        </option>
+        <option value="/docs/static-files/">
+          Static Files
+        </option>
-  <option value="/docs/github-pages/">GitHub Pages</option>
-  <option value="/docs/deployment-methods/">Deployment methods</option>
-  <option value="/docs/continuous-integration/">Continuous Integration</option>
     </optgroup>
-    <optgroup label="Miscellaneous">
+    <optgroup label="Site Structure">
+        <option value="/docs/structure/">
+          Directory Structure
+        </option>
+        <option value="/docs/liquid/">
+          Liquid
+        </option>
+        <option value="/docs/variables/">
+          Variables
+        </option>
+        <option value="/docs/includes/">
+          Includes
+        </option>
+        <option value="/docs/layouts/">
+          Layouts
+        </option>
+        <option value="/docs/permalinks/">
+          Permalinks
+        </option>
+        <option value="/docs/themes/">
+          Themes
+        </option>
+        <option value="/docs/pagination/">
+          Pagination
+        </option>
-  <option value="/docs/troubleshooting/">Troubleshooting</option>
-  <option value="/docs/sites/">Sites using Jekyll</option>
-  <option value="/docs/resources/">Resources</option>
-  <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
-  <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
     </optgroup>
-    <optgroup label="Meta">
+    <optgroup label="Guides">
+        <option value="/docs/plugins/">
+          Plugins
+        </option>
+        <option value="/docs/migrations/">
+          Blog Migrations
+        </option>
+        <option value="/docs/upgrading/">
+          Upgrading
+        </option>
+        <option value="/docs/deployment/">
+          Deployment
+        </option>
-  <option value="/docs/contributing/">Contributing</option>
-  <option value="/docs/maintaining/">Maintaining Jekyll</option>
-  <option value="/docs/conduct/">Code of Conduct</option>
-  <option value="/docs/history/">History</option>
     </optgroup>
   </select>
@@ -292,49 +286,26 @@
       <div class="unit four-fifths">
         <article>
           <div class="improve right hide-on-mobiles">
-            <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/collections.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
+            <a data-proofer-ignore href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/collections.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
           </div>
           <h1>Collections</h1>
-          <p>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.</p>
-<h2 id="using-collections">Using Collections</h2>
+          <p>Collections are a great way to group related content like members of a team or
+talks at a conference.</p>
-<p>To start using collections, follow these 3 steps:</p>
+<h2 id="setup">Setup</h2>
-<ul>
-  <li><a href="#step1">Step 1: Tell Jekyll to read in your collection</a></li>
-  <li><a href="#step2">Step 2: Add your content</a></li>
-  <li><a href="#step3">Step 3: Optionally render your collection’s documents into independent files</a></li>
-</ul>
-<h3 id="step1">Step 1: Tell Jekyll to read in your collection</h3>
-<p>Add the following to your site’s <code class="language-plaintext highlighter-rouge">_config.yml</code> file, replacing <code class="language-plaintext highlighter-rouge">my_collection</code>
-with the name of your collection:</p>
+<p>To use a Collection you first need to define it in your <code class="highlighter-rouge">_config.yml</code>. For
+example here’s a collection of staff members:</p>
 <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>
+  <span class="pi">-</span> <span class="s">staff_members</span>
 </code></pre></div></div>
 <p>You can optionally specify metadata for your collection in the configuration:</p>
 <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"><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>
+  <span class="na">staff_members</span><span class="pi">:</span>
+    <span class="na">people</span><span class="pi">:</span> <span class="no">true</span>
 </code></pre></div></div>
 <div class="note">
@@ -348,17 +319,30 @@ with the name of your collection:</p>
 </div>
 <div class="note warning">
-  <h5>Be sure to move posts into custom collections directory</h5>
+  <h5>Be sure to move drafts and posts into custom collections directory</h5>
-  <p>If you specify a directory to store all your collections in the same place with <code>collections_dir: my_collections</code>, then you will need to move your <code>_posts</code> directory to <code>my_collections/_posts</code>. Note that, the name of your collections directory cannot start with an underscore (`_`).</p>
+  <p>If you specify a directory to store all your collections in the same place with <code>collections_dir: my_collections</code>, then you will need to move your <code>_drafts</code> and <code>_posts</code> directory to <code>my_collections/_drafts</code> and <code>my_collections/_posts</code>. Note that, the name of your collections directory cannot start with an underscore (`_`).</p>
 </div>
-<h3 id="step2">Step 2: Add your content</h3>
+<h2 id="add-content">Add content</h2>
-<p>Create a corresponding folder (e.g. <code class="language-plaintext highlighter-rouge">&lt;source&gt;/_my_collection</code>) and add
-documents. YAML front matter is processed if the front matter exists, and everything
-after the front matter is pushed into the document’s <code class="language-plaintext highlighter-rouge">content</code> attribute. If no YAML front
-matter is provided, Jekyll will not generate the file in your collection.</p>
+<p>Create a corresponding folder (e.g. <code class="highlighter-rouge">&lt;source&gt;/_staff_members</code>) and add
+documents. Front matter is processed if the front matter exists, and everything
+after the front matter is pushed into the document’s <code class="highlighter-rouge">content</code> attribute. If no front
+matter is provided, Jekyll will consider it to be a <a href="/docs/static-files/">static file</a>
+and copy it to the destination (e.g. <code class="highlighter-rouge">_site</code>) without processing. If front matter
+is provided, Jekyll will process the file in your collection but will not write to disk
+unless <code class="highlighter-rouge">output: true</code> is set in the collection’s metadata.</p>
+<p>For example here’s how you would add a staff member to the collection set above.
+The filename is <code class="highlighter-rouge">./_staff_members/jane.md</code> with the following content:</p>
+<div class="language-markdown highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
+<span class="na">name</span><span class="pi">:</span> <span class="s">Jane Doe</span>
+<span class="na">position</span><span class="pi">:</span> <span class="s">Developer</span>
+<span class="nn">---</span>
+Jane has worked on Jekyll for the past <span class="ge">*five years*</span>.
+</code></pre></div></div>
 <div class="note info">
   <h5>Be sure to name your directories correctly</h5>
@@ -368,192 +352,96 @@ your <code>_config.yml</code> file, with the addition of the preceding <code>_</
   </p>
 </div>
-<h3 id="step3">Step 3: Optionally render your collection’s documents into independent files</h3>
+<h2 id="output">Output</h2>
+<p>Now you can iterate over <code class="highlighter-rouge">site.staff_members</code> on a page and output the content
+for each staff member. Similar to posts, the body of the document is accessed
+using the <code class="highlighter-rouge">content</code> variable:</p>
-<p>If you’d like Jekyll to create a public-facing, rendered version of each
-document in your collection, set the <code class="language-plaintext highlighter-rouge">output</code> key to <code class="language-plaintext highlighter-rouge">true</code> in your collection
-metadata in your <code class="language-plaintext highlighter-rouge">_config.yml</code>:</p>
+<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">staff_member</span><span class="w"> </span><span class="kr">in</span><span class="w"> </span><span class="nv">site.staff_members</span><span class="w"> </span><span class="p">%}</span>
+  &lt;h2&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">name</span><span class="w"> </span><span class="p">}}</span> - <span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">position</span><span class="w"> </span><span class="p">}}</span>&lt;/h2&gt;
+  &lt;p&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">content</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">markdownify</span><span class="w"> </span><span class="p">}}</span>&lt;/p&gt;
+<span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
+</code></pre></div></div>
+<p>If you’d like Jekyll to create a rendered page for each document in your
+collection, you can set the <code class="highlighter-rouge">output</code> key to <code class="highlighter-rouge">true</code> in your collection
+metadata in <code class="highlighter-rouge">_config.yml</code>:</p>
 <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">staff_members</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="language-plaintext highlighter-rouge">_my_collection/some_subdir/some_doc.md</code>,
-it will be rendered using Liquid and the Markdown converter of your
-choice and written out to <code class="language-plaintext highlighter-rouge">&lt;dest&gt;/my_collection/some_subdir/some_doc.html</code>.</p>
-<p>If you wish a specific page to be shown when accessing <code class="language-plaintext highlighter-rouge">/my_collection/</code>,
-simply add <code class="language-plaintext highlighter-rouge">permalink: /my_collection/index.html</code> to a page.
-To list items from the collection, on that page or any other, you can use:</p>
+<p>You can link to the generated page using the <code class="highlighter-rouge">url</code> attribute:</p>
-<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">item</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">site.my_collection</span><span class="w"> </span><span class="p">%}</span>
-  &lt;h2&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span>&lt;/h2&gt;
-  &lt;p&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">description</span><span class="w"> </span><span class="p">}}</span>&lt;/p&gt;
-  &lt;p&gt;&lt;a href="<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">url</span><span class="w"> </span><span class="p">}}</span>"&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span>&lt;/a&gt;&lt;/p&gt;
+<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">staff_member</span><span class="w"> </span><span class="kr">in</span><span class="w"> </span><span class="nv">site.staff_members</span><span class="w"> </span><span class="p">%}</span>
+  &lt;h2&gt;
+    &lt;a href="<span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">url</span><span class="w"> </span><span class="p">}}</span>"&gt;
+      <span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">name</span><span class="w"> </span><span class="p">}}</span> - <span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">position</span><span class="w"> </span><span class="p">}}</span>
+    &lt;/a&gt;
+  &lt;/h2&gt;
+  &lt;p&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">staff_member</span><span class="p">.</span><span class="nv">content</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">markdownify</span><span class="w"> </span><span class="p">}}</span>&lt;/p&gt;
 <span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
 </code></pre></div></div>
-<div class="note info">
-  <h5>Don't forget to add YAML for processing</h5>
-  <p>
-  Files in collections that do not have front matter are treated as
-  <a href="/docs/static-files">static files</a> and simply copied to their
-  output location without processing.
-  </p>
-</div>
+<h2 id="permalinks">Permalinks</h2>
-<h2 id="permalinks">Configuring permalinks for collections</h2>
+<p>There are special <a href="/docs/permalinks/">permalink variables for collections</a> to
+help you control the output url for the entire collection.</p>
-<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="language-plaintext highlighter-rouge">permalink</code> property</a>:</p>
+<h2 id="custom-sorting-of-documents">Custom Sorting of Documents</h2>
-<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>
+<p>By default, documents in a collection are sorted by their paths. But you can control this sorting via the collection’s metadata.</p>
-<h3 id="examples">Examples</h3>
+<h3 id="sort-by-front-matter-key">Sort By Front Matter Key</h3>
-<p>For a collection with the following source file structure,</p>
+<p>Documents can be sorted based on a front matter key by setting a <code class="highlighter-rouge">sort_by</code> metadata to the front matter key string. For example,
+to sort a collection of tutorials based on key <code class="highlighter-rouge">lesson</code>, the configuration would be:</p>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_my_collection/
-└── some_subdir
-    └── some_doc.md
+<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">tutorials</span><span class="pi">:</span>
+    <span class="na">sort_by</span><span class="pi">:</span> <span class="s">lesson</span>
 </code></pre></div></div>
-<p>each of the following <code class="language-plaintext highlighter-rouge">permalink</code> configurations will produce the document structure shown below it.</p>
+<p>The documents are arranged in the increasing order of the key’s value. If a document does not have the front matter key defined
+then that document is placed immediately after sorted documents. When multiple documents do not have the front matter key defined,
+those documents are sorted by their dates or paths and then placed immediately after the sorted documents.</p>
-<ul>
-  <li>
-    <p><strong>Default</strong>
-Same as <code class="language-plaintext highlighter-rouge">permalink: /:collection/:path</code>.</p>
-    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_site/
-├── my_collection
-│   └── some_subdir
-│       └── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="language-plaintext highlighter-rouge">permalink: pretty</code>
-Same as <code class="language-plaintext highlighter-rouge">permalink: /:collection/:path/</code>.</p>
-    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_site/
-├── my_collection
-│   └── some_subdir
-│       └── some_doc
-│           └── index.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="language-plaintext highlighter-rouge">permalink: /doc/:path</code></p>
-    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_site/
-├── doc
-│   └── some_subdir
-│       └── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="language-plaintext highlighter-rouge">permalink: /doc/:name</code></p>
+<h3 id="manually-ordering-documents">Manually Ordering Documents</h3>
-    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_site/
-├── doc
-│   └── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="language-plaintext highlighter-rouge">permalink: /:name</code></p>
+<p>You can also manually order the documents by setting an <code class="highlighter-rouge">order</code> metadata with <strong>the filenames listed</strong> in the desired order.
+For example, a collection of tutorials would be configured as:</p>
-    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_site/
-├── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-</ul>
+<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">tutorials</span><span class="pi">:</span>
+    <span class="na">order</span><span class="pi">:</span>
+      <span class="pi">-</span> <span class="s">hello-world.md</span>
+      <span class="pi">-</span> <span class="s">introduction.md</span>
+      <span class="pi">-</span> <span class="s">basic-concepts.md</span>
+      <span class="pi">-</span> <span class="s">advanced-concepts.md</span>
+</code></pre></div></div>
-<h3 id="template-variables">Template Variables</h3>
+<p>Any documents with filenames that do not match the list entry simply gets placed after the rearranged documents. If a document is
+nested under subdirectories, include them in entries as well:</p>
-<div class="mobile-side-scroller">
-<table>
-  <thead>
-    <tr>
-      <th>Variable</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p><code>:collection</code></p>
-      </td>
-      <td>
-        <p>Label of the containing collection.</p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:path</code></p>
-      </td>
-      <td>
-        <p>Path to the document relative to the collection's directory.</p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:name</code></p>
-      </td>
-      <td>
-        <p>The document's base filename, with every sequence of spaces
-        and non-alphanumeric characters replaced by a hyphen.</p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:title</code></p>
-      </td>
-      <td>
-        <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>
-      <td>
-        <p><code>:output_ext</code></p>
-      </td>
-      <td>
-        <p>Extension of the output file. (Included by default and usually unnecessary.)</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-</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">tutorials</span><span class="pi">:</span>
+    <span class="na">order</span><span class="pi">:</span>
+      <span class="pi">-</span> <span class="s">hello-world.md</span>
+      <span class="pi">-</span> <span class="s">introduction.md</span>
+      <span class="pi">-</span> <span class="s">concepts/basics.md</span>
+      <span class="pi">-</span> <span class="s">concepts/advanced.md</span>
+</code></pre></div></div>
+<p>If both metadata keys have been defined properly, <code class="highlighter-rouge">order</code> list takes precedence.</p>
 <h2 id="liquid-attributes">Liquid Attributes</h2>
 <h3 id="collections">Collections</h3>
-<p>Each collection is accessible as a field on the <code class="language-plaintext highlighter-rouge">site</code> variable. For example, if
-you want to access the <code class="language-plaintext highlighter-rouge">albums</code> collection found in <code class="language-plaintext highlighter-rouge">_albums</code>, you’d use
-<code class="language-plaintext highlighter-rouge">site.albums</code>.</p>
-<p>Each collection is itself an array of documents (e.g., <code class="language-plaintext highlighter-rouge">site.albums</code> is an array of documents, much like <code class="language-plaintext highlighter-rouge">site.pages</code> and
-<code class="language-plaintext highlighter-rouge">site.posts</code>). See the table below for how to access attributes of those documents.</p>
-<p>The collections are also available under <code class="language-plaintext highlighter-rouge">site.collections</code>, with the metadata
-you specified in your <code class="language-plaintext highlighter-rouge">_config.yml</code> (if present) and the following information:</p>
+<p>Collections are also available under <code class="highlighter-rouge">site.collections</code>, with the metadata
+you specified in your <code class="highlighter-rouge">_config.yml</code> (if present) and the following information:</p>
 <div class="mobile-side-scroller">
 <table>
@@ -646,7 +534,7 @@ you specified in your <code class="language-plaintext highlighter-rouge">_config
   <p>Except for documents in hard-coded default collection <code>posts</code>, all documents in collections
     you create, are accessible via Liquid irrespective of their assigned date, if any, and therefore renderable.
   </p>
-  <p>However documents are attempted to be written to disk only if the concerned collection
+  <p>Documents are attempted to be written to disk only if the concerned collection
     metadata has <code>output: true</code>. Additionally, future-dated documents are only written if
     <code>site.future</code> <em>is also true</em>.
   </p>
@@ -657,7 +545,7 @@ you specified in your <code class="language-plaintext highlighter-rouge">_config
 <h3 id="documents">Documents</h3>
-<p>In addition to any YAML Front Matter provided in the document’s corresponding
+<p>In addition to any front matter provided in the document’s corresponding
 file, each document has the following attributes:</p>
 <div class="mobile-side-scroller">
@@ -675,9 +563,9 @@ file, each document has the following attributes:</p>
       </td>
       <td>
         <p>
-          The (unrendered) content of the document. If no YAML Front Matter is
+          The (unrendered) content of the document. If no front matter is
           provided, Jekyll will not generate the file in your collection. If
-          YAML Front Matter is used, then this is all the contents of the file
+          front matter is used, then this is all the contents of the file
           after the terminating
           `---` of the front matter.
         </p>
@@ -748,302 +636,218 @@ file, each document has the following attributes:</p>
 </table>
 </div>
-<h2 id="accessing-collection-attributes">Accessing Collection Attributes</h2>
-<p>Attributes from the YAML front matter can be accessed as data anywhere in the
-site. Using the above example for configuring a collection as <code class="language-plaintext highlighter-rouge">site.albums</code>,
-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="language-plaintext highlighter-rouge">.yaml</code>
-extension):</p>
-<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-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
-<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">album</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">site.albums</span><span class="w"> </span><span class="p">%}</span>
-  &lt;h2&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">album</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span>&lt;/h2&gt;
-  &lt;p&gt;Performed by <span class="p">{{</span><span class="w"> </span><span class="nv">album</span><span class="p">.</span><span class="nv">artist</span><span class="w"> </span><span class="p">}}{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">album</span><span class="p">.</span><span class="nv">director</span><span class="w"> </span><span class="p">%}</span>, directed by <span class="p">{{</span><span class="w"> </span><span class="nv">album</span><span class="p">.</span><span class="nv">director</span><span class="w"> </span><span class="p">}}{%</span><span class="w"> </span><span class="kr">endif</span><span class="w"> </span><span class="p">%}</span>&lt;/p&gt;
-  <span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">work</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">album.works</span><span class="w"> </span><span class="p">%}</span>
-    &lt;h3&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">work</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span>&lt;/h3&gt;
-    &lt;p&gt;Composed by <span class="p">{{</span><span class="w"> </span><span class="nv">work</span><span class="p">.</span><span class="nv">composer</span><span class="w"> </span><span class="p">}}</span>&lt;/p&gt;
-    &lt;ul&gt;
-    <span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">track</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">work.tracks</span><span class="w"> </span><span class="p">%}</span>
-      &lt;li&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">track</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span> (<span class="p">{{</span><span class="w"> </span><span class="nv">track</span><span class="p">.</span><span class="nv">duration</span><span class="w"> </span><span class="p">}}</span>)&lt;/li&gt;
-    <span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
-    &lt;/ul&gt;
-  <span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
-<span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
-</code></pre></div></div>
-    <div class="section-nav">
-      <div class="left align-right">
-            <a href="/docs/variables/" class="prev">Back</a>
-      </div>
-      <div class="right align-left">
-            <a href="/docs/datafiles/" class="next">Next</a>
-      </div>
-    </div>
-    <div class="clear"></div>
         </article>
       </div>
       <div class="unit one-fifth hide-on-mobiles">
   <aside>
-    <h4>Getting Started</h4>
-    <ul>
-  <li class=""><a href="/docs/home/">Welcome</a></li>
-  <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
-  <li class=""><a href="/docs/installation/">Installation</a></li>
-  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
-  <li class=""><a href="/docs/usage/">Basic Usage</a></li>
-  <li class=""><a href="/docs/structure/">Directory structure</a></li>
-  <li class=""><a href="/docs/configuration/">Configuration</a></li>
-</ul>
-    <h4>Your Content</h4>
-    <ul>
-  <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
-  <li class=""><a href="/docs/posts/">Writing posts</a></li>
-  <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
-  <li class=""><a href="/docs/pages/">Creating pages</a></li>
-  <li class=""><a href="/docs/static-files/">Static Files</a></li>
-  <li class=""><a href="/docs/variables/">Variables</a></li>
-  <li class="current"><a href="/docs/collections/">Collections</a></li>
-  <li class=""><a href="/docs/datafiles/">Data Files</a></li>
-  <li class=""><a href="/docs/assets/">Assets</a></li>
-  <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
-</ul>
+      <h4>Getting Started</h4>
+      <ul>
+          <li>
+            <a href="/docs/">
+              Quickstart
+            </a>
+          </li>
+          <li>
+            <a href="/docs/ruby-101/">
+              Ruby 101
+            </a>
+          </li>
+          <li>
+            <a href="/docs/installation/">
+              Installation
+            </a>
+          </li>
+          <li>
+            <a href="/docs/community/">
+              Community
+            </a>
+          </li>
+          <li>
+            <a href="/docs/step-by-step/01-setup/">
+              Step by Step Tutorial
+            </a>
+          </li>
+      </ul>
-    <h4>Customization</h4>
-    <ul>
-  <li class=""><a href="/docs/templates/">Templates</a></li>
-  <li class=""><a href="/docs/includes/">Includes</a></li>
-  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
-  <li class=""><a href="/docs/pagination/">Pagination</a></li>
-  <li class=""><a href="/docs/plugins/">Plugins</a></li>
-  <li class=""><a href="/docs/themes/">Themes</a></li>
-  <li class=""><a href="/docs/extras/">Extras</a></li>
-</ul>
+      <h4>Build</h4>
+      <ul>
+          <li>
+            <a href="/docs/usage/">
+              Command Line Usage
+            </a>
+          </li>
+          <li>
+            <a href="/docs/configuration/">
+              Configuration
+            </a>
+          </li>
+      </ul>
-    <h4>Deployment</h4>
-    <ul>
-  <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
-  <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
-  <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
-</ul>
+      <h4>Content</h4>
+      <ul>
+          <li>
+            <a href="/docs/pages/">
+              Pages
+            </a>
+          </li>
+          <li>
+            <a href="/docs/posts/">
+              Posts
+            </a>
+          </li>
+          <li>
+            <a href="/docs/front-matter/">
+              Front Matter
+            </a>
+          </li>
+          <li class="current">
+            <a href="/docs/collections/">
+              Collections
+            </a>
+          </li>
+          <li>
+            <a href="/docs/datafiles/">
+              Data Files
+            </a>
+          </li>
+          <li>
+            <a href="/docs/assets/">
+              Assets
+            </a>
+          </li>
+          <li>
+            <a href="/docs/static-files/">
+              Static Files
+            </a>
+          </li>
+      </ul>
-    <h4>Miscellaneous</h4>
-    <ul>
-  <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
-  <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
-  <li class=""><a href="/docs/resources/">Resources</a></li>
-  <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
-  <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
-</ul>
+      <h4>Site Structure</h4>
+      <ul>
+          <li>
+            <a href="/docs/structure/">
+              Directory Structure
+            </a>
+          </li>
+          <li>
+            <a href="/docs/liquid/">
+              Liquid
+            </a>
+          </li>
+          <li>
+            <a href="/docs/variables/">
+              Variables
+            </a>
+          </li>
+          <li>
+            <a href="/docs/includes/">
+              Includes
+            </a>
+          </li>
+          <li>
+            <a href="/docs/layouts/">
+              Layouts
+            </a>
+          </li>
+          <li>
+            <a href="/docs/permalinks/">
+              Permalinks
+            </a>
+          </li>
+          <li>
+            <a href="/docs/themes/">
+              Themes
+            </a>
+          </li>
+          <li>
+            <a href="/docs/pagination/">
+              Pagination
+            </a>
+          </li>
+      </ul>
-    <h4>Meta</h4>
-    <ul>
-  <li class=""><a href="/docs/contributing/">Contributing</a></li>
-  <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
-  <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
-  <li class=""><a href="/docs/history/">History</a></li>
-</ul>
+      <h4>Guides</h4>
+      <ul>
+          <li>
+            <a href="/docs/plugins/">
+              Plugins
+            </a>
+          </li>
+          <li>
+            <a href="/docs/migrations/">
+              Blog Migrations
+            </a>
+          </li>
+          <li>
+            <a href="/docs/upgrading/">
+              Upgrading
+            </a>
+          </li>
+          <li>
+            <a href="/docs/deployment/">
+              Deployment
+            </a>
+          </li>
+      </ul>
   </aside>
 </div>
@@ -1058,7 +862,8 @@ extension):</p>
   <footer>
   <div class="grid">
     <div class="unit one-third center-on-mobiles">
-      <p>The contents of this website are <br />&copy;&nbsp;2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
+      <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
+      <p>The contents of this website are <br />&copy;&nbsp;2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
     </div>
     <div class="unit two-thirds align-right center-on-mobiles">
       <p>
@@ -1068,6 +873,14 @@ extension):</p>
         </a>
       </p>
     </div>
+    <div class="unit two-thirds align-right center-on-mobiles">
+      <p>
+        Jekyll is funded thanks to its
+        <a href="https://github.com/jekyll/jekyll#sponsors">
+          sponsors!
+        </a>
+      </p>
+    </div>
   </div>
 </footer>