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/permalinks/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>Permalinks | 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="Permalinks" />
 <meta property="og:locale" content="en_US" />
-<meta name="description" content="Permalinks refer to the URLs (excluding the domain name or directory folder) for your pages, posts, or collections. Jekyll supports a flexible way to build permalinks, allowing you to leverage various template variables or choose built-in permalink styles (such as date) that automatically use a template-variable pattern." />
-<meta property="og:description" content="Permalinks refer to the URLs (excluding the domain name or directory folder) for your pages, posts, or collections. Jekyll supports a flexible way to build permalinks, allowing you to leverage various template variables or choose built-in permalink styles (such as date) that automatically use a template-variable pattern." />
+<meta name="description" content="Permalinks are the output path for your pages, posts, or collections. They allow you to structure the directories of your source code different from the directories in your output." />
+<meta property="og:description" content="Permalinks are the output path for your pages, posts, or collections. They allow you to structure the directories of your source code different from the directories in your output." />
 <link rel="canonical" href="https://jekyllrb.com/docs/permalinks/" />
 <meta property="og:url" content="https://jekyllrb.com/docs/permalinks/" />
 <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="Permalinks" />
 <meta name="twitter:site" content="@jekyllrb" />
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
 <script type="application/ld+json">
-{"url":"https://jekyllrb.com/docs/permalinks/","headline":"Permalinks","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":"Permalinks refer to the URLs (excluding the domain name or directory folder) for your pages, posts, or collections. Jekyll supports a flexible way to build permalinks, allowing you to leverage various template variables or choose built-in permalink styles (such as date) that automatically use a template-variable pattern.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/permalinks/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
+{"description":"Permalinks are the output path for your pages, posts, or collections. They allow you to structure the directories of your source code different from the directories in your output.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/permalinks/"},"headline":"Permalinks","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/permalinks/","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,53 +286,48 @@
       <div class="unit four-fifths">
         <article>
           <div class="improve right hide-on-mobiles">
-            <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/permalinks.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/permalinks.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
           </div>
           <h1>Permalinks</h1>
-          <p>Permalinks refer to the URLs (excluding the domain name or directory folder) for your pages, posts, or collections.
-Jekyll supports a flexible way to build permalinks, allowing you to leverage various template variables or choose built-in permalink styles (such as <code class="language-plaintext highlighter-rouge">date</code>) that automatically use a template-variable pattern.</p>
-<p>You construct permalinks by creating a template URL where dynamic elements are represented by colon-prefixed keywords. The default template permalink is <code class="language-plaintext highlighter-rouge">/:categories/:year/:month/:day/:title:output_ext</code>. Each of the colon-prefixed keywords is a template variable.</p>
+          <p>Permalinks are the output path for your pages, posts, or collections. They
+allow you to structure the directories of your source code different from the
+directories in your output.</p>
-<h2 id="where-to-configure-permalinks">Where to configure permalinks</h2>
+<h2 id="front-matter">Front Matter</h2>
-<p>You can configure your site’s permalinks through the <a href="/docs/configuration/">Configuration</a> file or in the <a href="/docs/frontmatter/">Front Matter</a> for each post, page, or collection.</p>
+<p>The simplest way to set a permalink is using front matter. You set the
+<code class="highlighter-rouge">permalink</code> variable in front matter to the output path you’d like.</p>
-<p>Setting permalink styles in your configuration file applies the setting globally in your project. You configure permalinks in your <code class="language-plaintext highlighter-rouge">_config.yml</code> file like this:</p>
+<p>For example, you might have a page on your site located at
+<code class="highlighter-rouge">/my_pages/about-me.html</code> and you want the output url to be <code class="highlighter-rouge">/about/</code>. In
+front matter of the page you would set:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">permalink</span><span class="pi">:</span> <span class="s">/:categories/:year/:month/:day/:title:output_ext</span>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
+permalink: /about/
+---
 </code></pre></div></div>
-<p>If you don’t specify any permalink setting, Jekyll uses the above pattern as the default.</p>
-<p>The permalink can also be set using a built-in permalink style:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">permalink</span><span class="pi">:</span> <span class="s">date</span>
-</code></pre></div></div>
+<h2 id="global">Global</h2>
-<p><code class="language-plaintext highlighter-rouge">date</code> is the same as <code class="language-plaintext highlighter-rouge">:categories/:year/:month/:day/:title:output_ext</code>, the default. See <a href="#builtinpermalinkstyles">Built-in Permalink Styles</a> below for more options.</p>
+<p>Setting a permalink in front matter for every page on your site is no fun.
+Luckily, Jekyll lets you set the permalink structure globally in your <code class="highlighter-rouge">_config.yml</code>.</p>
-<p>Setting the permalink in your post, page, or collection’s front matter overrides any global settings. Here’s an example:</p>
+<p>To set a global permalink, you use the <code class="highlighter-rouge">permalink</code> variable in <code class="highlighter-rouge">_config.yml</code>.
+You can use placeholders to your desired output. For example:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
-<span class="na">title</span><span class="pi">:</span> <span class="s">My page title</span>
-<span class="na">permalink</span><span class="pi">:</span> <span class="s">/mypageurl/</span>
-<span class="nn">---</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">permalink</span><span class="pi">:</span> <span class="s">/:categories/:year/:month/:day/:title:output_ext</span>
 </code></pre></div></div>
-<p>Even if your configuration file specifies the <code class="language-plaintext highlighter-rouge">date</code> style, the URL for this page would be <code class="language-plaintext highlighter-rouge">http://somedomain.com/mypageurl/</code>.</p>
-<p>When you use permalinks that omit the <code class="language-plaintext highlighter-rouge">.html</code> file extension (called “pretty URLs”) Jekyll builds the file as index.html placed inside a folder with the page’s name. For example:</p>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── mypageurl
-│   └── index.html
-</code></pre></div></div>
+<p>Note that pages and collections don’t have time or categories, these aspects of
+the permalink style are ignored for the output.</p>
-<p>With a URL such as <code class="language-plaintext highlighter-rouge">/mypageurl/</code>, servers automatically load the index.html file inside the folder, so users can simply navigate to <code class="language-plaintext highlighter-rouge">http://somedomain.com/mypageurl/</code> to get to <code class="language-plaintext highlighter-rouge">mypageurl/index.html</code>.</p>
+<p>For example, a permalink style of
+<code class="highlighter-rouge">/:categories/:year/:month/:day/:title:output_ext</code> for posts becomes
+<code class="highlighter-rouge">/:title.html</code> for pages and collections.</p>
-<h2 id="template-variables">Template variables for permalinks</h2>
+<h3 id="placeholders">Placeholders</h3>
-<p>The following table lists the template variables available for permalinks. You can use these variables in the <code class="language-plaintext highlighter-rouge">permalink</code> property in your config file.</p>
+<p>Here’s the full list of placeholders available:</p>
 <div class="mobile-side-scroller">
 <table>
@@ -355,8 +344,19 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Year from the post's filename. May be overridden via the document’s
-          <code>date</code> YAML front matter
+          Year from the post’s filename with four digits.
+          May be overridden via the document’s <code>date</code> front matter.
+        </p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>short_year</code></p>
+      </td>
+      <td>
+        <p>
+          Year from the post’s filename without the century. (00..99)
+          May be overridden via the document’s <code>date</code> front matter.
         </p>
       </td>
     </tr>
@@ -366,8 +366,8 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Month from the post's filename. May be overridden via the document’s
-          <code>date</code> YAML front matter
+          Month from the post’s filename. (01..12)
+          May be overridden via the document’s <code>date</code> front matter.
         </p>
       </td>
     </tr>
@@ -377,19 +377,37 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Month without leading zeros from the post's filename. May be
-          overridden via the document’s <code>date</code> YAML front matter
+          Month without leading zeros from the post’s filename. May be
+          overridden via the document’s <code>date</code> front matter.
         </p>
       </td>
     </tr>
+    <tr>
+      <td>
+        <p><code>short_month</code></p>
+      </td>
+      <td>
+        <p>Three-letter month abbreviation, e.g. “Jan”.</p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>long_month</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
+      </td>
+      <td>
+        <p>Full month name, e.g. “January”.</p>
+      </td>
+    </tr>
     <tr>
       <td>
         <p><code>day</code></p>
       </td>
       <td>
         <p>
-          Day from the post's filename. May be overridden via the document’s
-          <code>date</code> YAML front matter
+          Day of the month from the post’s filename. (01..31)
+          May be overridden via the document’s <code>date</code> front matter.
         </p>
       </td>
     </tr>
@@ -399,28 +417,67 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Day without leading zeros from the post's filename. May be overridden
-          via the document’s <code>date</code> YAML front matter
+          Day of the month without leading zeros from the post’s filename.
+          May be overridden via the document’s <code>date</code> front matter.
         </p>
       </td>
     </tr>
     <tr>
       <td>
         <p><code>y_day</code></p>
-      </td>_
+      </td>
       <td>
-        <p>Day of the year from the post's filename, with leading zeros.</p>
+        <p>Ordinal day of the year from the post’s filename, with leading zeros. (001..366)</p>
       </td>
     </tr>
     <tr>
       <td>
-        <p><code>short_year</code></p>
+        <p><code>w_year</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
       </td>
       <td>
-        <p>
-          Year without the century from the post's filename. May be overridden
-          via the document’s <code>date</code> YAML front matter
-        </p>
+        <p>Week year which may differ from the month year for up to three days at the start of January and end of December</p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>week</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
+      </td>
+      <td>
+        <p>Week number of the current year, starting with the first week having a majority of its days in January. (01..53)</p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>w_day</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
+      </td>
+      <td>
+        <p>Day of the week, starting with Monday. (1..7)</p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>short_day</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
+      </td>
+      <td>
+        <p>Three-letter weekday abbreviation, e.g. “Sun”.</p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>long_day</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
+      </td>
+      <td>
+        <p>Weekday name, e.g. “Sunday”.</p>
       </td>
     </tr>
     <tr>
@@ -429,7 +486,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Hour of the day, 24-hour clock, zero-padded from the post's
+          Hour of the day, 24-hour clock, zero-padded from the post’s
           <code>date</code> front matter. (00..23)
         </p>
       </td>
@@ -440,7 +497,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Minute of the hour from the post's <code>date</code> front matter. (00..59)
+          Minute of the hour from the post’s <code>date</code> front matter. (00..59)
         </p>
       </td>
     </tr>
@@ -450,7 +507,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       </td>
       <td>
         <p>
-          Second of the minute from the post's <code>date</code> front matter. (00..59)
+          Second of the minute from the post’s <code>date</code> front matter. (00..59)
         </p>
       </td>
     </tr>
@@ -461,7 +518,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
       <td>
         <p>
             Title from the document’s filename. May be overridden via
-            the document’s <code>slug</code> YAML front matter.
+            the document’s <code>slug</code> front matter.
         </p>
       </td>
     </tr>
@@ -473,7 +530,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
         <p>
             Slugified title from the document’s filename (any character
             except numbers and letters is replaced as hyphen). May be
-            overridden via the document’s <code>slug</code> YAML front matter.
+            overridden via the document’s <code>slug</code> front matter.
         </p>
       </td>
     </tr>
@@ -494,11 +551,9 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
 </table>
 </div>
-<p>Note that all template variables relating to time or categories are available to posts only.</p>
-<h2 id="builtinpermalinkstyles">Built-in permalink styles</h2>
+<h3 id="built-in-formats">Built-in formats</h3>
-<p>Although you can specify a custom permalink pattern using <a href="#template-variables">template variables</a>, Jekyll also provides the following built-in styles for convenience.</p>
+<p>For posts, Jekyll also provides the following built-in styles for convenience:</p>
 <div class="mobile-side-scroller">
 <table>
@@ -533,6 +588,16 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
         <p><code>/:categories/:year/:y_day/:title:output_ext</code></p>
       </td>
     </tr>
+    <tr>
+      <td>
+        <p><code>weekdate</code></p>
+        <small><span class="version-badge" title="This feature is available starting version 4.0">4.0</span>
+</small>
+      </td>
+      <td>
+        <p><code>/:categories/:year/W:week/:short_day/:title:output_ext</code></p>
+      </td>
+    </tr>
     <tr>
       <td>
         <p><code>none</code></p>
@@ -545,407 +610,298 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
 </table>
 </div>
-<p>Rather than typing <code class="language-plaintext highlighter-rouge">permalink: /:categories/:year/:month/:day/:title/</code>, you can just type <code class="language-plaintext highlighter-rouge">permalink: pretty</code>.</p>
+<p>Rather than typing <code class="highlighter-rouge">permalink: /:categories/:year/:month/:day/:title/</code>, you can just type <code class="highlighter-rouge">permalink: pretty</code>.</p>
 <div class="note info">
-<h5>Specifying permalinks through the YAML Front Matter</h5>
-<p>Built-in permalink styles are not recognized in YAML Front Matter. As a result, <code>permalink: pretty</code> will not work.</p>
+<h5>Specifying permalinks through the front matter</h5>
+<p>Built-in permalink styles are not recognized in front matter. As a result, <code>permalink: pretty</code> will not work.</p>
 </div>
-<h2 id="permalink-style-examples">Permalink style examples with posts</h2>
+<h3 id="collections">Collections</h3>
+<p>For collections, you have the option to override the global permalink in the
+collection configuration in <code class="highlighter-rouge">_config.yml</code>:</p>
-<p>Here are a few examples to clarify how permalink styles get applied with posts.</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">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>Given a post named: <code class="language-plaintext highlighter-rouge">/2009-04-29-slap-chop.md</code></p>
+<p>Collections have the following placeholders available:</p>
 <div class="mobile-side-scroller">
 <table>
   <thead>
     <tr>
-      <th>URL Template</th>
-      <th>Resulting Permalink URL</th>
+      <th>Variable</th>
+      <th>Description</th>
     </tr>
   </thead>
   <tbody>
     <tr>
       <td>
-        <p>None specified, or <code>permalink: date</code></p>
+        <p><code>:collection</code></p>
       </td>
       <td>
-        <p><code>/2009/04/29/slap-chop.html</code></p>
+        <p>Label of the containing collection.</p>
       </td>
     </tr>
     <tr>
       <td>
-        <p><code>pretty</code></p>
+        <p><code>:path</code></p>
       </td>
       <td>
-        <p><code>/2009/04/29/slap-chop/</code></p>
+        <p>Path to the document relative to the collection's directory.</p>
       </td>
     </tr>
     <tr>
       <td>
-        <p><code>/:month-:day-:year/:title:output_ext</code></p>
+        <p><code>:name</code></p>
       </td>
       <td>
-        <p><code>/04-29-2009/slap-chop.html</code></p>
+        <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>/blog/:year/:month/:day/:title/</code></p>
+        <p><code>:title</code></p>
       </td>
       <td>
-        <p><code>/blog/2009/04/29/slap-chop/</code></p>
+        <p>
+          The <code>:title</code> template variable will take the
+          <code>slug</code> <a href="/docs/front-matter/">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>/:year/:month/:title</code></p>
-        <p>See <a href="#extensionless-permalinks">Extensionless permalinks with no trailing slashes</a> for details.</p>
+        <p><code>:output_ext</code></p>
       </td>
       <td>
-        <p><code>/2009/04/slap-chop</code></p>
+        <p>Extension of the output file. (Included by default and usually unnecessary.)</p>
       </td>
     </tr>
   </tbody>
 </table>
 </div>
-<h2 id="pages-and-collections">Permalink settings for pages and collections</h2>
-<p>The permalink setting in your configuration file specifies the permalink style used for posts, pages, and collections. However, because pages and collections don’t have time or categories, these aspects of the permalink style are ignored with pages and collections.</p>
-<p>For example:</p>
-<ul>
-  <li>A permalink style of <code class="language-plaintext highlighter-rouge">/:categories/:year/:month/:day/:title:output_ext</code> for posts becomes <code class="language-plaintext highlighter-rouge">/:title.html</code> for pages and collections.</li>
-  <li>A permalink style of <code class="language-plaintext highlighter-rouge">pretty</code> (or <code class="language-plaintext highlighter-rouge">/:categories/:year/:month/:day/:title/</code>), which omits the file extension and contains a trailing slash, will update page and collection permalinks to also omit the file extension and contain a trailing slash: <code class="language-plaintext highlighter-rouge">/:title/</code>.</li>
-  <li>A permalink style of <code class="language-plaintext highlighter-rouge">date</code>, which contains a trailing file extension, will update page permalinks to also contain a trailing file extension: <code class="language-plaintext highlighter-rouge">/:title.html</code>. But no time or category information will be included.</li>
-</ul>
-<h2 id="permalinks-and-default-paths">Permalinks and default paths</h2>
-<p>The path to the post or page in the built site differs for posts, pages, and collections:</p>
-<h3 id="posts">Posts</h3>
-<p>The subfolders into which you may have organized your posts inside the <code class="language-plaintext highlighter-rouge">_posts</code> directory will not be part of the permalink.</p>
-<p>If you use a permalink style that omits the <code class="language-plaintext highlighter-rouge">.html</code> file extension, each post is rendered as an <code class="language-plaintext highlighter-rouge">index.html</code> file inside a folder with the post’s name (for example, <code class="language-plaintext highlighter-rouge">categoryname/2016/12/01/mypostname/index.html</code>).</p>
-<h3 id="pages">Pages</h3>
-<p>Unlike posts, pages by default mimic the source directory structure exactly. (The only exception is if your page has a <code class="language-plaintext highlighter-rouge">permalink</code> declared its front matter — in that case, the structure honors the permalink setting instead of the source folder structure.)</p>
-<p>As with posts, if you use a permalink style that omits the <code class="language-plaintext highlighter-rouge">.html</code> file extension, each page is rendered as an <code class="language-plaintext highlighter-rouge">index.html</code> file inserted inside a folder with the page’s name (for example, <code class="language-plaintext highlighter-rouge">mypage/index.html</code>).</p>
-<h3 id="collections">Collections</h3>
-<p>By default, collections follow a similar structure in the <code class="language-plaintext highlighter-rouge">_site</code> folder as pages, except that the path is prefaced by the collection name. For example: <code class="language-plaintext highlighter-rouge">collectionname/mypage.html</code>. For permalink settings that omit the file extension, the path would be <code class="language-plaintext highlighter-rouge">collection_name/mypage/index.html</code>.</p>
-<p>Collections have their own way of setting permalinks. Additionally, collections have unique template variables available (such as <code class="language-plaintext highlighter-rouge">path</code> and <code class="language-plaintext highlighter-rouge">output_ext</code>). See the <a href="../collections/#permalinks">Configuring permalinks for collections</a> in Collections for more information.</p>
-<h2 id="flattening-pages-in-_site-on-build">Flattening pages in _site on build</h2>
-<p>If you want to flatten your pages (pull them out of subfolders) in the <code class="language-plaintext highlighter-rouge">_site</code> directory when your site builds (similar to posts), add the <code class="language-plaintext highlighter-rouge">permalink</code> property to the front matter of each page, with no path specified:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
-<span class="na">title</span><span class="pi">:</span> <span class="s">My page</span>
-<span class="na">permalink</span><span class="pi">:</span> <span class="s">mypageurl.html</span>
-<span class="nn">---</span>
-</code></pre></div></div>
-<h2 id="extensionless-permalinks">Extensionless permalinks with no trailing slashes</h2>
-<p>Jekyll supports permalinks that contain neither a trailing slash nor a file extension, but this requires additional support from the web server to properly serve. When using these types of permalinks, output files written to disk will still have the proper file extension (typically <code class="language-plaintext highlighter-rouge">.html</code>), so the web server must be able to map requests without file extensions to these files.</p>
-<p>Both <a href="../github-pages/">GitHub Pages</a> and the Jekyll’s built-in WEBrick server handle these requests properly without any additional work.</p>
-<h3 id="apache">Apache</h3>
-<p>The Apache web server has extensive support for content negotiation and can handle extensionless URLs by setting the <a href="https://httpd.apache.org/docs/current/content-negotiation.html#multiviews">multiviews</a> option in your <code class="language-plaintext highlighter-rouge">httpd.conf</code> or <code class="language-plaintext highlighter-rouge">.htaccess</code> file:</p>
-<figure class="highlight"><pre><code class="language-apache" data-lang="apache"><span class="nc">Options</span> +MultiViews</code></pre></figure>
-<h3 id="nginx">Nginx</h3>
-<p>The <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#try_files">try_files</a> directive allows you to specify a list of files to search for to process a request. The following configuration will instruct nginx to search for a file with an <code class="language-plaintext highlighter-rouge">.html</code> extension if an exact match for the requested URI is not found.</p>
-<figure class="highlight"><pre><code class="language-nginx" data-lang="nginx"><span class="k">try_files</span> <span class="nv">$uri</span> <span class="nv">$uri</span><span class="s">.html</span> <span class="nv">$uri</span><span class="n">/</span> <span class="p">=</span><span class="mi">404</span><span class="p">;</span></code></pre></figure>
-<h2 id="linking-without-regard-to-permalink-styles">Linking without regard to permalink styles</h2>
-<p>You can create links in your topics to other posts, pages, or collection items in a way that is valid no matter what permalink configuration you choose. By using the <code class="language-plaintext highlighter-rouge">link</code> tag, if you change your permalinks, your links won’t break. See <a href="../templates#link">Linking to pages</a> in Templates for more details.</p>
+        </article>
+      </div>
+      <div class="unit one-fifth hide-on-mobiles">
+  <aside>
+      <h4>Getting Started</h4>
+      <ul>
-    <div class="section-nav">
-      <div class="left align-right">
+          <li>
+            <a href="/docs/">
+              Quickstart
+            </a>
+          </li>
-            <a href="/docs/includes/" class="prev">Back</a>
+          <li>
+            <a href="/docs/ruby-101/">
+              Ruby 101
+            </a>
+          </li>
-      </div>
-      <div class="right align-left">
+          <li>
+            <a href="/docs/installation/">
+              Installation
+            </a>
+          </li>
-            <a href="/docs/pagination/" class="next">Next</a>
+          <li>
+            <a href="/docs/community/">
+              Community
+            </a>
+          </li>
-      </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>
+          <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="current"><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=""><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 class="current">
+            <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>
@@ -960,7 +916,8 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
   <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>
@@ -970,6 +927,14 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
         </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>