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

jekyll-docs 3.9.0 → 4.0.0

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>