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/upgrading/2-to-3/index.html CHANGED

@@ -3,17 +3,18 @@
 <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>Upgrading from 2.x to 3.x | 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="Upgrading from 2.x to 3.x" />
 <meta property="og:locale" content="en_US" />
 <meta name="description" content="Upgrading from an older version of Jekyll? A few things have changed in Jekyll 3 that you’ll want to know about." />
@@ -21,14 +22,16 @@
 <link rel="canonical" href="https://jekyllrb.com/docs/upgrading/2-to-3/" />
 <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/2-to-3/" />
 <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="Upgrading from 2.x to 3.x" />
 <meta name="twitter:site" content="@jekyllrb" />
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
 <script type="application/ld+json">
-{"url":"https://jekyllrb.com/docs/upgrading/2-to-3/","headline":"Upgrading from 2.x to 3.x","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":"Upgrading from an older version of Jekyll? A few things have changed in Jekyll 3 that you’ll want to know about.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/2-to-3/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
+{"description":"Upgrading from an older version of Jekyll? A few things have changed in Jekyll 3 that you’ll want to know about.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/2-to-3/"},"headline":"Upgrading from 2.x to 3.x","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/upgrading/2-to-3/","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 class="">
-    <a href="/help/">Help</a>
+  <li>
+    <a href="/showcase/">Showcase</a>
   </li>
+  <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,7 +286,7 @@
       <div class="unit four-fifths">
         <article>
           <div class="improve right hide-on-mobiles">
-            <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/upgrading/2-to-3.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/upgrading/2-to-3.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
           </div>
           <h1>Upgrading from 2.x to 3.x</h1>
           <p>Upgrading from an older version of Jekyll? A few things have changed in Jekyll 3
@@ -314,26 +308,30 @@ that you’ll want to know about.</p>
 <h3 id="sitecollections-has-changed">site.collections has changed</h3>
-<p>In 2.x, your iterations over <code class="language-plaintext highlighter-rouge">site.collections</code> yielded an array with the collection
+<p>In 2.x, your iterations over <code class="highlighter-rouge">site.collections</code> yielded an array with the collection
 label and the collection object as the first and second items, respectively. In 3.x,
 this complication has been removed and iterations now yield simply the collection object.
 A simple conversion must be made in your templates:</p>
 <ul>
-  <li><code class="language-plaintext highlighter-rouge">collection[0]</code> becomes <code class="language-plaintext highlighter-rouge">collection.label</code></li>
-  <li><code class="language-plaintext highlighter-rouge">collection[1]</code> becomes <code class="language-plaintext highlighter-rouge">collection</code></li>
+  <li><code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code></li>
+  <li><code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code></li>
 </ul>
-<p>When iterating over <code class="language-plaintext highlighter-rouge">site.collections</code>, ensure the above conversions are made.</p>
+<p>When iterating over <code class="highlighter-rouge">site.collections</code>, ensure the above conversions are made.</p>
-<p>For <code class="language-plaintext highlighter-rouge">site.collections.myCollection</code> in Jekyll 2, you now do:</p>
+<p>For <code class="highlighter-rouge">site.collections.myCollection</code> in Jekyll 2, you now do:</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">assign</span><span class="w"> </span><span class="nv">myCollection</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">collections</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">where</span><span class="p">:</span><span class="w"> </span><span class="s2">"label"</span><span class="p">,</span><span class="w"> </span><span class="s2">"myCollection"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">first</span><span class="w"> </span><span class="p">%}</span>
 </code></pre></div></div>
-<p>This is a bit cumbersome at first, but is easier than a big <code class="language-plaintext highlighter-rouge">for</code> loop.</p>
+<p>This is a bit cumbersome at first, but is easier than a big <code class="highlighter-rouge">for</code> loop.</p>
+<h3 id="textile-support">Textile support</h3>
+<p>We dropped native support for Textile, from now on you have to install our  <a href="https://github.com/jekyll/jekyll-textile-converter">jekyll-textile-converter</a> plugin to work with Textile files.</p>
 <h3 id="dropped-dependencies">Dropped dependencies</h3>
@@ -342,21 +340,21 @@ A simple conversion must be made in your templates:</p>
 <ul>
   <li>jekyll-paginate – Jekyll’s pagination solution from days past</li>
   <li>jekyll-coffeescript – processing of CoffeeScript</li>
-  <li>jekyll-gist – the <code class="language-plaintext highlighter-rouge">gist</code> Liquid tag</li>
+  <li>jekyll-gist – the <code class="highlighter-rouge">gist</code> Liquid tag</li>
   <li>pygments.rb – the Pygments highlighter</li>
   <li>redcarpet – the Markdown processor</li>
   <li>toml – an alternative to YAML for configuration files</li>
-  <li>classifier-reborn – for <code class="language-plaintext highlighter-rouge">site.related_posts</code></li>
+  <li>classifier-reborn – for <code class="highlighter-rouge">site.related_posts</code></li>
 </ul>
 <h3 id="future-posts">Future posts</h3>
-<p>A seeming feature regression in 2.x, the <code class="language-plaintext highlighter-rouge">--future</code> flag was automatically <em>enabled</em>.
+<p>A seeming feature regression in 2.x, the <code class="highlighter-rouge">--future</code> flag was automatically <em>enabled</em>.
 The future flag allows post authors to give the post a date in the future and to have
 it excluded from the build until the system time is equal or after the post time.
-In Jekyll 3, this has been corrected. <strong>Now, <code class="language-plaintext highlighter-rouge">--future</code> is disabled by default.</strong>
-This means you will need to include <code class="language-plaintext highlighter-rouge">--future</code> if you want your future-dated posts to
-generate when running <code class="language-plaintext highlighter-rouge">jekyll build</code> or <code class="language-plaintext highlighter-rouge">jekyll serve</code>.</p>
+In Jekyll 3, this has been corrected. <strong>Now, <code class="highlighter-rouge">--future</code> is disabled by default.</strong>
+This means you will need to include <code class="highlighter-rouge">--future</code> if you want your future-dated posts to
+generate when running <code class="highlighter-rouge">jekyll build</code> or <code class="highlighter-rouge">jekyll serve</code>.</p>
 <div class="note info">
   <h5>Future Posts on GitHub Pages</h5>
@@ -368,21 +366,21 @@ generate when running <code class="language-plaintext highlighter-rouge">jekyll
 <h3 id="layout-metadata">Layout metadata</h3>
-<p>Introducing: <code class="language-plaintext highlighter-rouge">layout</code>. In Jekyll 2 and below, any metadata in the layout was merged onto
-the <code class="language-plaintext highlighter-rouge">page</code> variable in Liquid. This caused a lot of confusion in the way the data was
-merged and some unexpected behaviour. In Jekyll 3, all layout data is accessible via <code class="language-plaintext highlighter-rouge">layout</code>
-in Liquid. For example, if your layout has <code class="language-plaintext highlighter-rouge">class: my-layout</code> in its YAML front matter,
-then the layout can access that via <code class="language-plaintext highlighter-rouge">{{ layout.class }}</code>.</p>
+<p>Introducing: <code class="highlighter-rouge">layout</code>. In Jekyll 2 and below, any metadata in the layout was merged onto
+the <code class="highlighter-rouge">page</code> variable in Liquid. This caused a lot of confusion in the way the data was
+merged and some unexpected behaviour. In Jekyll 3, all layout data is accessible via <code class="highlighter-rouge">layout</code>
+in Liquid. For example, if your layout has <code class="highlighter-rouge">class: my-layout</code> in its front matter,
+then the layout can access that via <code class="highlighter-rouge">{{ layout.class }}</code>.</p>
 <h3 id="syntax-highlighter-changed">Syntax highlighter changed</h3>
 <p>For the first time, the default syntax highlighter has changed for the
-<code class="language-plaintext highlighter-rouge">highlight</code> tag and for backtick code blocks. Instead of <a href="https://github.com/tmm1/pygments.rb">Pygments.rb</a>,
-it’s now <a href="http://rouge.jneen.net/">Rouge</a>. If you were using the <code class="language-plaintext highlighter-rouge">highlight</code> tag with certain
-options, such as <code class="language-plaintext highlighter-rouge">hl_lines</code>, they may not be available when using Rouge. To
-go back to using Pygments, set <code class="language-plaintext highlighter-rouge">highlighter: pygments</code> in your
-<code class="language-plaintext highlighter-rouge">_config.yml</code> file and run <code class="language-plaintext highlighter-rouge">gem install pygments.rb</code> or add
-<code class="language-plaintext highlighter-rouge">gem 'pygments.rb'</code> to your project’s <code class="language-plaintext highlighter-rouge">Gemfile</code>.</p>
+<code class="highlighter-rouge">highlight</code> tag and for backtick code blocks. Instead of <a href="https://github.com/tmm1/pygments.rb">Pygments.rb</a>,
+it’s now <a href="http://rouge.jneen.net/">Rouge</a>. If you were using the <code class="highlighter-rouge">highlight</code> tag with certain
+options, such as <code class="highlighter-rouge">hl_lines</code>, they may not be available when using Rouge. To
+go back to using Pygments, set <code class="highlighter-rouge">highlighter: pygments</code> in your
+<code class="highlighter-rouge">_config.yml</code> file and run <code class="highlighter-rouge">gem install pygments.rb</code> or add
+<code class="highlighter-rouge">gem 'pygments.rb'</code> to your project’s <code class="highlighter-rouge">Gemfile</code>.</p>
 <h3 id="relative-permalink-support-removed">Relative Permalink support removed</h3>
@@ -395,18 +393,18 @@ source directory, not the parent directory. Check
 https://jekyllrb.com/docs/upgrading/ for more info.
 </code></pre></div></div>
-<p>This can be fixed by removing the following line from your <code class="language-plaintext highlighter-rouge">_config.yml</code> file:</p>
+<p>This can be fixed by removing the following line from your <code class="highlighter-rouge">_config.yml</code> file:</p>
 <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">relative_permalinks</span><span class="pi">:</span> <span class="no">true</span>
 </code></pre></div></div>
 <h3 id="permalinks-no-longer-automatically-add-a-trailing-slash">Permalinks no longer automatically add a trailing slash</h3>
-<p>In Jekyll 2, any URL constructed from the <code class="language-plaintext highlighter-rouge">permalink:</code> field had a trailing slash (<code class="language-plaintext highlighter-rouge">/</code>) added to it automatically.  Jekyll 3 no longer adds a trailing slash automatically to <code class="language-plaintext highlighter-rouge">permalink:</code> URLs. This can potentially result in old links to pages returning a 404 error. For example, suppose a page previously contained the YAML <code class="language-plaintext highlighter-rouge">permalink: /:year-:month-:day-:title</code> that resulted in the URL <code class="language-plaintext highlighter-rouge">example.com/2016-02-01-test/</code> (notice the trailing slash), Jekyll internally generates a folder named <code class="language-plaintext highlighter-rouge">2016-02-01-test</code>. In Jekyll 3, the same <code class="language-plaintext highlighter-rouge">permalink:</code> generate the file <code class="language-plaintext highlighter-rouge">2016-02-01-test.html</code> and the URL for the same page will be <code class="language-plaintext highlighter-rouge">example.com/2016-02-01-test</code>, and consequently any links to the old URL will result in a 404 error. In order to maintain the same URLs and avoid this problem, a trailing slash should be added to the <code class="language-plaintext highlighter-rouge">permalink:</code> field, for example <code class="language-plaintext highlighter-rouge">permalink: /:year-:month-:day-:title/</code>.</p>
+<p>In Jekyll 2, any URL constructed from the <code class="highlighter-rouge">permalink:</code> field had a trailing slash (<code class="highlighter-rouge">/</code>) added to it automatically. Jekyll 3 no longer adds a trailing slash automatically to <code class="highlighter-rouge">permalink:</code> URLs. This can potentially result in old links to pages returning a 404 error. For example, suppose a page previously contained the YAML <code class="highlighter-rouge">permalink: /:year-:month-:day-:title</code> that resulted in the URL <code class="highlighter-rouge">example.com/2016-02-01-test/</code> (notice the trailing slash), Jekyll internally generates a folder named <code class="highlighter-rouge">2016-02-01-test</code>. In Jekyll 3, the same <code class="highlighter-rouge">permalink:</code> generate the file <code class="highlighter-rouge">2016-02-01-test.html</code> and the URL for the same page will be <code class="highlighter-rouge">example.com/2016-02-01-test</code>, and consequently any links to the old URL will result in a 404 error. In order to maintain the same URLs and avoid this problem, a trailing slash should be added to the <code class="highlighter-rouge">permalink:</code> field, for example <code class="highlighter-rouge">permalink: /:year-:month-:day-:title/</code>.</p>
 <h3 id="all-my-posts-are-gone-whered-they-go">All my posts are gone! Where’d they go!</h3>
-<p>Try adding <code class="language-plaintext highlighter-rouge">future: true</code> to your <code class="language-plaintext highlighter-rouge">_config.yml</code> file. Are they showing up now? If they are, then you were ensnared by an issue with the way Ruby parses times. Each of your posts is being read in a different timezone than you might expect and, when compared to the computer’s current time, is “in the future.” The fix for this is to add <a href="https://en.wikipedia.org/wiki/List_of_UTC_time_offsets">a timezone offset</a> to each post (and make sure you remove <code class="language-plaintext highlighter-rouge">future: true</code> from your <code class="language-plaintext highlighter-rouge">_config.yml</code> file). If you’re writing from California, for example, you would change this:</p>
+<p>Try adding <code class="highlighter-rouge">future: true</code> to your <code class="highlighter-rouge">_config.yml</code> file. Are they showing up now? If they are, then you were ensnared by an issue with the way Ruby parses times. Each of your posts is being read in a different timezone than you might expect and, when compared to the computer’s current time, is “in the future.” The fix for this is to add <a href="https://en.wikipedia.org/wiki/List_of_UTC_time_offsets">a timezone offset</a> to each post (and make sure you remove <code class="highlighter-rouge">future: true</code> from your <code class="highlighter-rouge">_config.yml</code> file). If you’re writing from California, for example, you would change this:</p>
 <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
 <span class="na">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10</span>
@@ -422,314 +420,222 @@ https://jekyllrb.com/docs/upgrading/ for more info.
 <h3 id="my-categories-have-stopped-working">My categories have stopped working!</h3>
-<p>If you organized your categories as <code class="language-plaintext highlighter-rouge">/_posts/code/2008-12-24-closures.md</code>, you will need to restructure your directories to put the categories <em>above</em> the <code class="language-plaintext highlighter-rouge">_posts</code> directories, as follows: <code class="language-plaintext highlighter-rouge">/code/_posts/2008-12-24-closures.md</code>.</p>
+<p>If you organized your categories as <code class="highlighter-rouge">/_posts/code/2008-12-24-closures.md</code>, you will need to restructure your directories to put the categories <em>above</em> the <code class="highlighter-rouge">_posts</code> directories, as follows: <code class="highlighter-rouge">/code/_posts/2008-12-24-closures.md</code>.</p>
 <p><em>Did we miss something? Please click “Improve this page” above and add a section. Thanks!</em></p>
-    <div class="section-nav">
-      <div class="left align-right">
-            <a href="/docs/upgrading/0-to-2/" class="prev">Back</a>
-      </div>
-      <div class="right align-left">
-            <a href="/docs/contributing/" 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=""><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>
+            <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="current"><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>
@@ -744,7 +650,8 @@ https://jekyllrb.com/docs/upgrading/ for more info.
   <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>
@@ -754,6 +661,14 @@ https://jekyllrb.com/docs/upgrading/ for more info.
         </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>