jekyll-docs 3.8.1 → 3.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (149) hide show
  1. checksums.yaml +5 -5
  2. data/site/404.html +5 -4
  3. data/site/community/index.html +1 -1
  4. data/site/conduct/index.html +1 -1
  5. data/site/docs/assets/index.html +35 -35
  6. data/site/docs/code_of_conduct/index.html +8 -7
  7. data/site/docs/collections/index.html +44 -43
  8. data/site/docs/conduct/index.html +8 -7
  9. data/site/docs/configuration/index.html +81 -81
  10. data/site/docs/continuous-integration/buddyworks/index.html +10 -9
  11. data/site/docs/continuous-integration/circleci/index.html +13 -12
  12. data/site/docs/continuous-integration/index.html +8 -7
  13. data/site/docs/continuous-integration/travis-ci/index.html +32 -31
  14. data/site/docs/contributing/index.html +47 -47
  15. data/site/docs/datafiles/index.html +24 -23
  16. data/site/docs/deployment-methods/index.html +30 -29
  17. data/site/docs/drafts/index.html +11 -10
  18. data/site/docs/extras/index.html +9 -8
  19. data/site/docs/frontmatter/index.html +8 -7
  20. data/site/docs/github-pages/index.html +32 -32
  21. data/site/docs/history/index.html +722 -656
  22. data/site/docs/home/index.html +8 -7
  23. data/site/docs/includes/index.html +44 -43
  24. data/site/docs/index.html +1 -1
  25. data/site/docs/installation/index.html +16 -15
  26. data/site/docs/maintaining/affinity-team-captain/index.html +24 -24
  27. data/site/docs/maintaining/avoiding-burnout/index.html +8 -7
  28. data/site/docs/maintaining/becoming-a-maintainer/index.html +22 -22
  29. data/site/docs/maintaining/index.html +8 -7
  30. data/site/docs/maintaining/merging-a-pull-request/index.html +36 -36
  31. data/site/docs/maintaining/releasing-a-new-version/index.html +32 -32
  32. data/site/docs/maintaining/reviewing-a-pull-request/index.html +23 -23
  33. data/site/docs/maintaining/special-labels/index.html +27 -27
  34. data/site/docs/maintaining/triaging-an-issue/index.html +25 -25
  35. data/site/docs/migrations/index.html +9 -8
  36. data/site/docs/pages/index.html +12 -11
  37. data/site/docs/pagination/index.html +25 -24
  38. data/site/docs/permalinks/index.html +33 -32
  39. data/site/docs/plugins/index.html +70 -70
  40. data/site/docs/posts/index.html +50 -50
  41. data/site/docs/quickstart/index.html +18 -17
  42. data/site/docs/resources/index.html +9 -8
  43. data/site/docs/sites/index.html +8 -7
  44. data/site/docs/static-files/index.html +14 -13
  45. data/site/docs/structure/index.html +8 -7
  46. data/site/docs/support/index.html +9 -8
  47. data/site/docs/templates/index.html +44 -43
  48. data/site/docs/themes/index.html +76 -76
  49. data/site/docs/troubleshooting/index.html +48 -47
  50. data/site/docs/upgrading/0-to-2/index.html +51 -50
  51. data/site/docs/upgrading/2-to-3/index.html +35 -34
  52. data/site/docs/upgrading/index.html +11 -10
  53. data/site/docs/usage/index.html +15 -14
  54. data/site/docs/variables/index.html +8 -7
  55. data/site/docs/windows/index.html +29 -28
  56. data/site/feed.xml +53 -65
  57. data/site/github.html +1 -1
  58. data/site/help/index.html +19 -19
  59. data/site/index.html +7 -6
  60. data/site/issues.html +1 -1
  61. data/site/jekyllconf/index.html +9 -8
  62. data/site/latest_version.txt +1 -1
  63. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +42 -29
  64. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +27 -13
  65. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +28 -14
  66. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +29 -15
  67. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +28 -14
  68. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +25 -11
  69. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +27 -13
  70. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +27 -13
  71. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +30 -16
  72. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +28 -14
  73. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +25 -11
  74. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +34 -20
  75. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +26 -12
  76. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +26 -12
  77. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +25 -11
  78. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +27 -13
  79. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +43 -30
  80. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +26 -12
  81. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +43 -30
  82. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +46 -33
  83. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +25 -11
  84. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +42 -29
  85. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +30 -16
  86. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +27 -13
  87. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +26 -12
  88. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +33 -19
  89. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +32 -18
  90. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +48 -35
  91. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +25 -11
  92. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +27 -13
  93. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +42 -29
  94. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +25 -11
  95. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +42 -29
  96. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +25 -11
  97. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +42 -29
  98. data/site/news/2015/10/26/jekyll-3-0-released/index.html +30 -16
  99. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +29 -15
  100. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +27 -13
  101. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +30 -16
  102. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +47 -34
  103. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +26 -12
  104. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +27 -13
  105. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +25 -11
  106. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +26 -12
  107. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +26 -12
  108. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +25 -11
  109. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +31 -17
  110. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +26 -12
  111. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +26 -12
  112. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +42 -29
  113. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +29 -15
  114. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +43 -30
  115. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +42 -29
  116. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +51 -37
  117. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +26 -12
  118. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +27 -13
  119. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +43 -30
  120. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +47 -34
  121. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +52 -39
  122. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +51 -38
  123. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +27 -13
  124. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +30 -16
  125. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +26 -12
  126. data/site/news/2017/10/19/diversity-open-source/index.html +27 -13
  127. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +45 -32
  128. data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +48 -35
  129. data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +53 -40
  130. data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +42 -29
  131. data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +50 -37
  132. data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +47 -34
  133. data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +620 -0
  134. data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +615 -0
  135. data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +623 -0
  136. data/site/news/index.html +351 -230
  137. data/site/news/releases/index.html +349 -228
  138. data/site/philosophy.html +1 -1
  139. data/site/sitemap.xml +72 -60
  140. data/site/team/index.html +19 -19
  141. data/site/tutorials/convert-site-to-jekyll/index.html +97 -96
  142. data/site/tutorials/custom-404-page/index.html +16 -15
  143. data/site/tutorials/home/index.html +10 -9
  144. data/site/tutorials/index.html +1 -1
  145. data/site/tutorials/navigation/index.html +102 -101
  146. data/site/tutorials/orderofinterpretation/index.html +32 -31
  147. data/site/tutorials/using-jekyll-with-bundler/index.html +19 -18
  148. data/site/tutorials/video-walkthroughs/index.html +8 -7
  149. metadata +13 -25
@@ -3,7 +3,7 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.8.1">
6
+ <meta name="generator" content="Jekyll v3.9.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
8
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
9
  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
@@ -11,9 +11,9 @@
11
11
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
12
12
  <link rel="stylesheet" href="/css/screen.css">
13
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
- <!-- Begin Jekyll SEO tag v2.4.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.6.1 -->
15
15
  <title>Permalinks | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.8.1" />
16
+ <meta name="generator" content="Jekyll v3.9.0" />
17
17
  <meta property="og:title" content="Permalinks" />
18
18
  <meta property="og:locale" content="en_US" />
19
19
  <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." />
@@ -22,12 +22,13 @@
22
22
  <meta property="og:url" content="https://jekyllrb.com/docs/permalinks/" />
23
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
24
24
  <meta property="og:type" content="article" />
25
- <meta property="article:published_time" content="2018-05-01T13:18:24-07:00" />
25
+ <meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
26
26
  <meta name="twitter:card" content="summary" />
27
+ <meta property="twitter:title" content="Permalinks" />
27
28
  <meta name="twitter:site" content="@jekyllrb" />
28
29
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
29
30
  <script type="application/ld+json">
30
- {"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.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/permalinks/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Permalinks","dateModified":"2018-05-01T13:18:24-07:00","datePublished":"2018-05-01T13:18:24-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/permalinks/"},"@context":"http://schema.org"}</script>
31
+ {"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>
31
32
  <!-- End Jekyll SEO tag -->
32
33
 
33
34
  <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
72
73
  <div class="meta hide-on-mobiles">
73
74
  <ul>
74
75
  <li>
75
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.1">v3.8.1</a>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
76
77
  </li>
77
78
  <li>
78
79
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -295,15 +296,15 @@
295
296
  </div>
296
297
  <h1>Permalinks</h1>
297
298
  <p>Permalinks refer to the URLs (excluding the domain name or directory folder) for your pages, posts, or collections.
298
- 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="highlighter-rouge">date</code>) that automatically use a template-variable pattern.</p>
299
+ 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>
299
300
 
300
- <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="highlighter-rouge">/:categories/:year/:month/:day/:title:output_ext</code>. Each of the colon-prefixed keywords is a template variable.</p>
301
+ <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>
301
302
 
302
303
  <h2 id="where-to-configure-permalinks">Where to configure permalinks</h2>
303
304
 
304
305
  <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>
305
306
 
306
- <p>Setting permalink styles in your configuration file applies the setting globally in your project. You configure permalinks in your <code class="highlighter-rouge">_config.yml</code> file like this:</p>
307
+ <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>
307
308
 
308
309
  <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>
309
310
  </code></pre></div></div>
@@ -315,7 +316,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
315
316
  <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>
316
317
  </code></pre></div></div>
317
318
 
318
- <p><code class="highlighter-rouge">date</code> is the same as <code class="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>
319
+ <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>
319
320
 
320
321
  <p>Setting the permalink in your post, page, or collection’s front matter overrides any global settings. Here’s an example:</p>
321
322
 
@@ -325,19 +326,19 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
325
326
  <span class="nn">---</span>
326
327
  </code></pre></div></div>
327
328
 
328
- <p>Even if your configuration file specifies the <code class="highlighter-rouge">date</code> style, the URL for this page would be <code class="highlighter-rouge">http://somedomain.com/mypageurl/</code>.</p>
329
+ <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>
329
330
 
330
- <p>When you use permalinks that omit the <code class="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>
331
+ <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>
331
332
 
332
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── mypageurl
333
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── mypageurl
333
334
  │   └── index.html
334
335
  </code></pre></div></div>
335
336
 
336
- <p>With a URL such as <code class="highlighter-rouge">/mypageurl/</code>, servers automatically load the index.html file inside the folder, so users can simply navigate to <code class="highlighter-rouge">http://somedomain.com/mypageurl/</code> to get to <code class="highlighter-rouge">mypageurl/index.html</code>.</p>
337
+ <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>
337
338
 
338
339
  <h2 id="template-variables">Template variables for permalinks</h2>
339
340
 
340
- <p>The following table lists the template variables available for permalinks. You can use these variables in the <code class="highlighter-rouge">permalink</code> property in your config file.</p>
341
+ <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>
341
342
 
342
343
  <div class="mobile-side-scroller">
343
344
  <table>
@@ -544,7 +545,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
544
545
  </table>
545
546
  </div>
546
547
 
547
- <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>
548
+ <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>
548
549
 
549
550
  <div class="note info">
550
551
  <h5>Specifying permalinks through the YAML Front Matter</h5>
@@ -555,7 +556,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
555
556
 
556
557
  <p>Here are a few examples to clarify how permalink styles get applied with posts.</p>
557
558
 
558
- <p>Given a post named: <code class="highlighter-rouge">/2009-04-29-slap-chop.md</code></p>
559
+ <p>Given a post named: <code class="language-plaintext highlighter-rouge">/2009-04-29-slap-chop.md</code></p>
559
560
 
560
561
  <div class="mobile-side-scroller">
561
562
  <table>
@@ -618,9 +619,9 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
618
619
  <p>For example:</p>
619
620
 
620
621
  <ul>
621
- <li>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.</li>
622
- <li>A permalink style of <code class="highlighter-rouge">pretty</code> (or <code class="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="highlighter-rouge">/:title/</code>.</li>
623
- <li>A permalink style of <code class="highlighter-rouge">date</code>, which contains a trailing file extension, will update page permalinks to also contain a trailing file extension: <code class="highlighter-rouge">/:title.html</code>. But no time or category information will be included.</li>
622
+ <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>
623
+ <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>
624
+ <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>
624
625
  </ul>
625
626
 
626
627
  <h2 id="permalinks-and-default-paths">Permalinks and default paths</h2>
@@ -629,25 +630,25 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
629
630
 
630
631
  <h3 id="posts">Posts</h3>
631
632
 
632
- <p>The subfolders into which you may have organized your posts inside the <code class="highlighter-rouge">_posts</code> directory will not be part of the permalink.</p>
633
+ <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>
633
634
 
634
- <p>If you use a permalink style that omits the <code class="highlighter-rouge">.html</code> file extension, each post is rendered as an <code class="highlighter-rouge">index.html</code> file inside a folder with the post’s name (for example, <code class="highlighter-rouge">categoryname/2016/12/01/mypostname/index.html</code>).</p>
635
+ <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>
635
636
 
636
637
  <h3 id="pages">Pages</h3>
637
638
 
638
- <p>Unlike posts, pages by default mimic the source directory structure exactly. (The only exception is if your page has a <code class="highlighter-rouge">permalink</code> declared its front matter — in that case, the structure honors the permalink setting instead of the source folder structure.)</p>
639
+ <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>
639
640
 
640
- <p>As with posts, if you use a permalink style that omits the <code class="highlighter-rouge">.html</code> file extension, each page is rendered as an <code class="highlighter-rouge">index.html</code> file inserted inside a folder with the page’s name (for example, <code class="highlighter-rouge">mypage/index.html</code>).</p>
641
+ <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>
641
642
 
642
643
  <h3 id="collections">Collections</h3>
643
644
 
644
- <p>By default, collections follow a similar structure in the <code class="highlighter-rouge">_site</code> folder as pages, except that the path is prefaced by the collection name. For example: <code class="highlighter-rouge">collectionname/mypage.html</code>. For permalink settings that omit the file extension, the path would be <code class="highlighter-rouge">collection_name/mypage/index.html</code>.</p>
645
+ <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>
645
646
 
646
- <p>Collections have their own way of setting permalinks. Additionally, collections have unique template variables available (such as <code class="highlighter-rouge">path</code> and <code class="highlighter-rouge">output_ext</code>). See the <a href="../collections/#permalinks">Configuring permalinks for collections</a> in Collections for more information.</p>
647
+ <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>
647
648
 
648
649
  <h2 id="flattening-pages-in-_site-on-build">Flattening pages in _site on build</h2>
649
650
 
650
- <p>If you want to flatten your pages (pull them out of subfolders) in the <code class="highlighter-rouge">_site</code> directory when your site builds (similar to posts), add the <code class="highlighter-rouge">permalink</code> property to the front matter of each page, with no path specified:</p>
651
+ <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>
651
652
 
652
653
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
653
654
  <span class="na">title</span><span class="pi">:</span> <span class="s">My page</span>
@@ -657,25 +658,25 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
657
658
 
658
659
  <h2 id="extensionless-permalinks">Extensionless permalinks with no trailing slashes</h2>
659
660
 
660
- <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="highlighter-rouge">.html</code>), so the web server must be able to map requests without file extensions to these files.</p>
661
+ <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>
661
662
 
662
663
  <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>
663
664
 
664
665
  <h3 id="apache">Apache</h3>
665
666
 
666
- <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="highlighter-rouge">httpd.conf</code> or <code class="highlighter-rouge">.htaccess</code> file:</p>
667
+ <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>
667
668
 
668
669
  <figure class="highlight"><pre><code class="language-apache" data-lang="apache"><span class="nc">Options</span> +MultiViews</code></pre></figure>
669
670
 
670
671
  <h3 id="nginx">Nginx</h3>
671
672
 
672
- <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="highlighter-rouge">.html</code> extension if an exact match for the requested URI is not found.</p>
673
+ <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>
673
674
 
674
675
  <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>
675
676
 
676
677
  <h2 id="linking-without-regard-to-permalink-styles">Linking without regard to permalink styles</h2>
677
678
 
678
- <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="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>
679
+ <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>
679
680
 
680
681
 
681
682
 
@@ -959,7 +960,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
959
960
  <footer>
960
961
  <div class="grid">
961
962
  <div class="unit one-third center-on-mobiles">
962
- <p>The contents of this website are <br />&copy;&nbsp;2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
963
+ <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>
963
964
  </div>
964
965
  <div class="unit two-thirds align-right center-on-mobiles">
965
966
  <p>
@@ -1,34 +1,34 @@
1
1
  <!DOCTYPE HTML>
2
2
  <html lang="en-US">
3
3
  <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
4
  <meta charset="UTF-8">
6
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.8.1">
8
- <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
6
+ <meta name="generator" content="Jekyll v3.9.0">
7
+ <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
9
8
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
9
  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
11
10
  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
12
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
11
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
13
12
  <link rel="stylesheet" href="/css/screen.css">
14
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
15
- <!-- Begin Jekyll SEO tag v2.4.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.6.1 -->
16
15
  <title>Plugins | Jekyll • Simple, blog-aware, static sites</title>
17
- <meta name="generator" content="Jekyll v3.8.1">
18
- <meta property="og:title" content="Plugins">
19
- <meta property="og:locale" content="en_US">
20
- <meta name="description" content="Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.">
21
- <meta property="og:description" content="Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.">
22
- <link rel="canonical" href="https://jekyllrb.com/docs/plugins/">
23
- <meta property="og:url" content="https://jekyllrb.com/docs/plugins/">
24
- <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
25
- <meta property="og:type" content="article">
26
- <meta property="article:published_time" content="2018-05-01T13:18:24-07:00">
27
- <meta name="twitter:card" content="summary">
28
- <meta name="twitter:site" content="@jekyllrb">
29
- <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
16
+ <meta name="generator" content="Jekyll v3.9.0" />
17
+ <meta property="og:title" content="Plugins" />
18
+ <meta property="og:locale" content="en_US" />
19
+ <meta name="description" content="Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself." />
20
+ <meta property="og:description" content="Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself." />
21
+ <link rel="canonical" href="https://jekyllrb.com/docs/plugins/" />
22
+ <meta property="og:url" content="https://jekyllrb.com/docs/plugins/" />
23
+ <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
24
+ <meta property="og:type" content="article" />
25
+ <meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
26
+ <meta name="twitter:card" content="summary" />
27
+ <meta property="twitter:title" content="Plugins" />
28
+ <meta name="twitter:site" content="@jekyllrb" />
29
+ <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
30
30
  <script type="application/ld+json">
31
- {"description":"Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/plugins/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Plugins","dateModified":"2018-05-01T13:18:24-07:00","datePublished":"2018-05-01T13:18:24-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/plugins/"},"@context":"http://schema.org"}</script>
31
+ {"url":"https://jekyllrb.com/docs/plugins/","headline":"Plugins","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":"Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/plugins/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
32
32
  <!-- End Jekyll SEO tag -->
33
33
 
34
34
  <!--[if lt IE 9]>
@@ -73,7 +73,7 @@
73
73
  <div class="meta hide-on-mobiles">
74
74
  <ul>
75
75
  <li>
76
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.1">v3.8.1</a>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
77
77
  </li>
78
78
  <li>
79
79
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -318,12 +318,12 @@ having to modify the Jekyll source itself.</p>
318
318
 
319
319
  <ol>
320
320
  <li>
321
- <p>In your site source root, make a <code class="highlighter-rouge">_plugins</code> directory. Place your plugins
322
- here. Any file ending in <code class="highlighter-rouge">*.rb</code> inside this directory will be loaded before
321
+ <p>In your site source root, make a <code class="language-plaintext highlighter-rouge">_plugins</code> directory. Place your plugins
322
+ here. Any file ending in <code class="language-plaintext highlighter-rouge">*.rb</code> inside this directory will be loaded before
323
323
  Jekyll generates your site.</p>
324
324
  </li>
325
325
  <li>
326
- <p>In your <code class="highlighter-rouge">_config.yml</code> file, add a new array with the key <code class="highlighter-rouge">plugins</code> (or <code class="highlighter-rouge">gems</code> for Jekyll &lt; <code class="highlighter-rouge">3.5.0</code>) and the
326
+ <p>In your <code class="language-plaintext highlighter-rouge">_config.yml</code> file, add a new array with the key <code class="language-plaintext highlighter-rouge">plugins</code> (or <code class="language-plaintext highlighter-rouge">gems</code> for Jekyll &lt; <code class="language-plaintext highlighter-rouge">3.5.0</code>) and the
327
327
  values of the gem names of the plugins you’d like to use. An example:</p>
328
328
 
329
329
  <div class="language-yaml highlighter-rouge">
@@ -335,10 +335,10 @@ values of the gem names of the plugins you’d like to use. An example:</p>
335
335
  <span class="pi">-</span> <span class="s">another-jekyll-plugin</span>
336
336
  </code></pre></div> </div>
337
337
 
338
- <p>Then install your plugins using <code class="highlighter-rouge">gem install jekyll-gist jekyll-coffeescript jekyll-assets another-jekyll-plugin</code></p>
338
+ <p>Then install your plugins using <code class="language-plaintext highlighter-rouge">gem install jekyll-gist jekyll-coffeescript jekyll-assets another-jekyll-plugin</code></p>
339
339
  </li>
340
340
  <li>
341
- <p>Add the relevant plugins to a Bundler group in your <code class="highlighter-rouge">Gemfile</code>. An
341
+ <p>Add the relevant plugins to a Bundler group in your <code class="language-plaintext highlighter-rouge">Gemfile</code>. An
342
342
  example:</p>
343
343
 
344
344
  <div class="language-ruby highlighter-rouge">
@@ -350,7 +350,7 @@ example:</p>
350
350
  <span class="k">end</span>
351
351
  </code></pre></div> </div>
352
352
 
353
- <p>Now you need to install all plugins from your Bundler group by running single command <code class="highlighter-rouge">bundle install</code>.</p>
353
+ <p>Now you need to install all plugins from your Bundler group by running single command <code class="language-plaintext highlighter-rouge">bundle install</code>.</p>
354
354
  </li>
355
355
  </ol>
356
356
 
@@ -368,12 +368,12 @@ example:</p>
368
368
 
369
369
  <h3 id="the-jekyll_plugins-group">The jekyll_plugins group</h3>
370
370
 
371
- <p>Jekyll gives this particular group of gems in your <code class="highlighter-rouge">Gemfile</code> a different
371
+ <p>Jekyll gives this particular group of gems in your <code class="language-plaintext highlighter-rouge">Gemfile</code> a different
372
372
  treatment. Any gem included in this group is loaded before Jekyll starts
373
373
  processing the rest of your source directory.</p>
374
374
 
375
375
  <p>A gem included here will be activated even if its not explicitly listed under
376
- the <code class="highlighter-rouge">plugins:</code> key in your site’s config file.</p>
376
+ the <code class="language-plaintext highlighter-rouge">plugins:</code> key in your site’s config file.</p>
377
377
 
378
378
  <div class="note warning">
379
379
  <p>
@@ -404,25 +404,25 @@ the <code class="highlighter-rouge">plugins:</code> key in your site’s config
404
404
  <p>You can create a generator when you need Jekyll to create additional content
405
405
  based on your own rules.</p>
406
406
 
407
- <p>A generator is a subclass of <code class="highlighter-rouge">Jekyll::Generator</code> that defines a <code class="highlighter-rouge">generate</code>
407
+ <p>A generator is a subclass of <code class="language-plaintext highlighter-rouge">Jekyll::Generator</code> that defines a <code class="language-plaintext highlighter-rouge">generate</code>
408
408
  method, which receives an instance of
409
- <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/site.rb"><code class="highlighter-rouge">Jekyll::Site</code></a>. The
410
- return value of <code class="highlighter-rouge">generate</code> is ignored.</p>
409
+ <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/site.rb"><code class="language-plaintext highlighter-rouge">Jekyll::Site</code></a>. The
410
+ return value of <code class="language-plaintext highlighter-rouge">generate</code> is ignored.</p>
411
411
 
412
412
  <p>Generators run after Jekyll has made an inventory of the existing content, and
413
413
  before the site is generated. Pages with YAML Front Matters are stored as
414
414
  instances of
415
- <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/page.rb"><code class="highlighter-rouge">Jekyll::Page</code></a>
416
- and are available via <code class="highlighter-rouge">site.pages</code>. Static files become instances of
417
- <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/static_file.rb"><code class="highlighter-rouge">Jekyll::StaticFile</code></a>
418
- and are available via <code class="highlighter-rouge">site.static_files</code>. See
415
+ <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/page.rb"><code class="language-plaintext highlighter-rouge">Jekyll::Page</code></a>
416
+ and are available via <code class="language-plaintext highlighter-rouge">site.pages</code>. Static files become instances of
417
+ <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/static_file.rb"><code class="language-plaintext highlighter-rouge">Jekyll::StaticFile</code></a>
418
+ and are available via <code class="language-plaintext highlighter-rouge">site.static_files</code>. See
419
419
  <a href="/docs/variables/">the Variables documentation page</a> and
420
- <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/site.rb"><code class="highlighter-rouge">Jekyll::Site</code></a>
420
+ <a href="https://github.com/jekyll/jekyll/blob/master/lib/jekyll/site.rb"><code class="language-plaintext highlighter-rouge">Jekyll::Site</code></a>
421
421
  for more details.</p>
422
422
 
423
423
  <p>For instance, a generator can inject values computed at build time for template
424
- variables. In the following example the template <code class="highlighter-rouge">reading.html</code> has two
425
- variables <code class="highlighter-rouge">ongoing</code> and <code class="highlighter-rouge">done</code> that we fill in the generator:</p>
424
+ variables. In the following example the template <code class="language-plaintext highlighter-rouge">reading.html</code> has two
425
+ variables <code class="language-plaintext highlighter-rouge">ongoing</code> and <code class="language-plaintext highlighter-rouge">done</code> that we fill in the generator:</p>
426
426
 
427
427
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">module</span> <span class="nn">Reading</span>
428
428
  <span class="k">class</span> <span class="nc">Generator</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Generator</span>
@@ -472,8 +472,8 @@ variables <code class="highlighter-rouge">ongoing</code> and <code class="highli
472
472
  </code></pre></div></div>
473
473
 
474
474
  <p>In this example, our generator will create a series of files under the
475
- <code class="highlighter-rouge">categories</code> directory for each category, listing the posts in each category
476
- using the <code class="highlighter-rouge">category_index.html</code> layout.</p>
475
+ <code class="language-plaintext highlighter-rouge">categories</code> directory for each category, listing the posts in each category
476
+ using the <code class="language-plaintext highlighter-rouge">category_index.html</code> layout.</p>
477
477
 
478
478
  <p>Generators are only required to implement one method:</p>
479
479
 
@@ -513,8 +513,8 @@ languages are implemented using this method.</p>
513
513
  </p>
514
514
  </div>
515
515
 
516
- <p>Below is a converter that will take all posts ending in <code class="highlighter-rouge">.upcase</code> and process
517
- them using the <code class="highlighter-rouge">UpcaseConverter</code>:</p>
516
+ <p>Below is a converter that will take all posts ending in <code class="language-plaintext highlighter-rouge">.upcase</code> and process
517
+ them using the <code class="language-plaintext highlighter-rouge">UpcaseConverter</code>:</p>
518
518
 
519
519
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
520
520
  <span class="k">class</span> <span class="nc">UpcaseConverter</span> <span class="o">&lt;</span> <span class="no">Converter</span>
@@ -580,25 +580,25 @@ them using the <code class="highlighter-rouge">UpcaseConverter</code>:</p>
580
580
  </table>
581
581
  </div>
582
582
 
583
- <p>In our example, <code class="highlighter-rouge">UpcaseConverter#matches</code> checks if our filename extension is
584
- <code class="highlighter-rouge">.upcase</code>, and will render using the converter if it is. It will call
585
- <code class="highlighter-rouge">UpcaseConverter#convert</code> to process the content. In our simple converter we’re
583
+ <p>In our example, <code class="language-plaintext highlighter-rouge">UpcaseConverter#matches</code> checks if our filename extension is
584
+ <code class="language-plaintext highlighter-rouge">.upcase</code>, and will render using the converter if it is. It will call
585
+ <code class="language-plaintext highlighter-rouge">UpcaseConverter#convert</code> to process the content. In our simple converter we’re
586
586
  simply uppercasing the entire content string. Finally, when it saves the page,
587
- it will do so with a <code class="highlighter-rouge">.html</code> extension.</p>
587
+ it will do so with a <code class="language-plaintext highlighter-rouge">.html</code> extension.</p>
588
588
 
589
589
  <h2 id="commands">Commands</h2>
590
590
 
591
591
  <p>As of version 2.5.0, Jekyll can be extended with plugins which provide
592
- subcommands for the <code class="highlighter-rouge">jekyll</code> executable. This is possible by including the
593
- relevant plugins in a <code class="highlighter-rouge">Gemfile</code> group called <code class="highlighter-rouge">:jekyll_plugins</code>:</p>
592
+ subcommands for the <code class="language-plaintext highlighter-rouge">jekyll</code> executable. This is possible by including the
593
+ relevant plugins in a <code class="language-plaintext highlighter-rouge">Gemfile</code> group called <code class="language-plaintext highlighter-rouge">:jekyll_plugins</code>:</p>
594
594
 
595
595
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">group</span> <span class="ss">:jekyll_plugins</span> <span class="k">do</span>
596
596
  <span class="n">gem</span> <span class="s2">"my_fancy_jekyll_plugin"</span>
597
597
  <span class="k">end</span>
598
598
  </code></pre></div></div>
599
599
 
600
- <p>Each <code class="highlighter-rouge">Command</code> must be a subclass of the <code class="highlighter-rouge">Jekyll::Command</code> class and must
601
- contain one class method: <code class="highlighter-rouge">init_with_program</code>. An example:</p>
600
+ <p>Each <code class="language-plaintext highlighter-rouge">Command</code> must be a subclass of the <code class="language-plaintext highlighter-rouge">Jekyll::Command</code> class and must
601
+ contain one class method: <code class="language-plaintext highlighter-rouge">init_with_program</code>. An example:</p>
602
602
 
603
603
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">class</span> <span class="nc">MyNewCommand</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Command</span>
604
604
  <span class="k">class</span> <span class="o">&lt;&lt;</span> <span class="nb">self</span>
@@ -649,7 +649,7 @@ contain one class method: <code class="highlighter-rouge">init_with_program</cod
649
649
 
650
650
  <p>If you’d like to include custom liquid tags in your site, you can do so by
651
651
  hooking into the tagging system. Built-in examples added by Jekyll include the
652
- <code class="highlighter-rouge">highlight</code> and <code class="highlighter-rouge">include</code> tags. Below is an example of a custom liquid tag that
652
+ <code class="language-plaintext highlighter-rouge">highlight</code> and <code class="language-plaintext highlighter-rouge">include</code> tags. Below is an example of a custom liquid tag that
653
653
  will output the time the page was rendered:</p>
654
654
 
655
655
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
@@ -815,10 +815,10 @@ hook like this:</p>
815
815
  <p>Jekyll provides hooks for <code>:site</code>, <code>:pages</code>,
816
816
  <code>:posts</code>, and <code>:documents</code>. In all cases, Jekyll calls
817
817
  your hooks with the container object as the first callback parameter. However,
818
- all <code class="highlighter-rouge">:pre_render</code> hooks and the<code class="highlighter-rouge">:site, :post_render</code> hook will also provide a
819
- payload hash as a second parameter. In the case of <code class="highlighter-rouge">:pre_render</code>, the payload
818
+ all <code class="language-plaintext highlighter-rouge">:pre_render</code> hooks and the<code class="language-plaintext highlighter-rouge">:site, :post_render</code> hook will also provide a
819
+ payload hash as a second parameter. In the case of <code class="language-plaintext highlighter-rouge">:pre_render</code>, the payload
820
820
  gives you full control over the variables that are available while rendering.
821
- In the case of <code class="highlighter-rouge">:site, :post_render</code>, the payload contains final values after
821
+ In the case of <code class="language-plaintext highlighter-rouge">:site, :post_render</code>, the payload contains final values after
822
822
  rendering all the site (useful for sitemaps, feeds, etc).</p>
823
823
 
824
824
  <p>The complete list of available hooks is below:</p>
@@ -1062,7 +1062,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1062
1062
  <li>
1063
1063
  <a href="https://github.com/mscharley/jekyll-compass">Compass integration for Jekyll</a>: Easily integrate Compass and Sass with your Jekyll website.</li>
1064
1064
  <li>
1065
- <a href="https://github.com/bbakersmith/jekyll-pages-directory">Pages Directory by Ben Baker-Smith</a>: Defines a <code class="highlighter-rouge">_pages</code> directory for page files which routes its output relative to the project root.</li>
1065
+ <a href="https://github.com/bbakersmith/jekyll-pages-directory">Pages Directory by Ben Baker-Smith</a>: Defines a <code class="language-plaintext highlighter-rouge">_pages</code> directory for page files which routes its output relative to the project root.</li>
1066
1066
  <li>
1067
1067
  <a href="https://github.com/jeffkole/jekyll-page-collections">Page Collections by Jeff Kolesky</a>: Generates collections of pages with functionality that resembles posts.</li>
1068
1068
  <li>
@@ -1096,7 +1096,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1096
1096
  <li>
1097
1097
  <a href="https://github.com/ibrado/jekyll-tweetsert">Tweetsert</a>: Imports tweets (Twitter statuses) as new posts. Features multiple timeline support, hashtag import, filtering, automatic category and/or tags, optional retweets and replies.</li>
1098
1098
  <li>
1099
- <a href="https://github.com/ibrado/jekyll-stickyposts">Stickyposts</a>: Moves or copies (pins) posts marked <code class="highlighter-rouge">sticky: true</code> to the top of the list. Perfect for keeping important announcements on the home page, or giving collections a descriptive entry. Paginator friendly.</li>
1099
+ <a href="https://github.com/ibrado/jekyll-stickyposts">Stickyposts</a>: Moves or copies (pins) posts marked <code class="language-plaintext highlighter-rouge">sticky: true</code> to the top of the list. Perfect for keeping important announcements on the home page, or giving collections a descriptive entry. Paginator friendly.</li>
1100
1100
  <li>
1101
1101
  <a href="https://github.com/ibrado/jekyll-paginate-content">Jekyll::Paginate::Content</a>: Content paginator in the style of jekyll-paginator-v2 that splits pages, posts, and collection entries into several pages. Specify a separator or use HTML &lt;h1&gt; etc. headers. Automatic splitting, single-page view, pager/trail, self-adjusting links, multipage TOC, SEO support.</li>
1102
1102
  <li>
@@ -1111,7 +1111,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1111
1111
  <li>
1112
1112
  <a href="http://jekyll-pug.dougie.io">Pug plugin by Doug Beney</a>: Use the popular Pug (previously Jade) templating language in Jekyll. Complete with caching, includes support, and much more.</li>
1113
1113
  <li>
1114
- <a href="https://github.com/jekyll/jekyll-textile-converter">Textile converter</a>: Convert <code class="highlighter-rouge">.textile</code> files into HTML. Also includes the <code class="highlighter-rouge">textilize</code> Liquid filter.</li>
1114
+ <a href="https://github.com/jekyll/jekyll-textile-converter">Textile converter</a>: Convert <code class="language-plaintext highlighter-rouge">.textile</code> files into HTML. Also includes the <code class="language-plaintext highlighter-rouge">textilize</code> Liquid filter.</li>
1115
1115
  <li>
1116
1116
  <a href="https://github.com/slim-template/jekyll-slim">Slim plugin</a>: Slim converter and includes for Jekyll with support for Liquid tags.</li>
1117
1117
  <li>
@@ -1187,7 +1187,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1187
1187
 
1188
1188
  <ul>
1189
1189
  <li>
1190
- <a href="https://github.com/jekyll/jekyll-gist">Jekyll-gist</a>: Use the <code class="highlighter-rouge">gist</code> tag to easily embed a GitHub Gist onto your site. This works with public or secret gists.</li>
1190
+ <a href="https://github.com/jekyll/jekyll-gist">Jekyll-gist</a>: Use the <code class="language-plaintext highlighter-rouge">gist</code> tag to easily embed a GitHub Gist onto your site. This works with public or secret gists.</li>
1191
1191
  <li>
1192
1192
  <a href="https://github.com/samrayner/jekyll-asset-path-plugin">Asset Path Tag</a> by <a href="http://www.samrayner.com/">Sam Rayner</a>: Allows organisation of assets into subdirectories by outputting a path for a given file relative to the current post or page.</li>
1193
1193
  <li>
@@ -1215,11 +1215,11 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1215
1215
  <li>
1216
1216
  <a href="https://github.com/sectore/jekyll-swfobject">Jekyll-swfobject</a>: Liquid plugin for embedding Adobe Flash files (.swf) using <a href="https://github.com/swfobject/swfobject">SWFObject</a>.</li>
1217
1217
  <li>
1218
- <a href="https://github.com/robwierzbowski/jekyll-picture-tag">Jekyll Picture Tag</a>: Easy responsive images for Jekyll. Based on the proposed <a href="https://html.spec.whatwg.org/multipage/embedded-content.html#the-picture-element"><code class="highlighter-rouge">&lt;picture&gt;</code></a> element, polyfilled with Scott Jehl’s <a href="https://github.com/scottjehl/picturefill">Picturefill</a>.</li>
1218
+ <a href="https://github.com/robwierzbowski/jekyll-picture-tag">Jekyll Picture Tag</a>: Easy responsive images for Jekyll. Based on the proposed <a href="https://html.spec.whatwg.org/multipage/embedded-content.html#the-picture-element"><code class="language-plaintext highlighter-rouge">&lt;picture&gt;</code></a> element, polyfilled with Scott Jehl’s <a href="https://github.com/scottjehl/picturefill">Picturefill</a>.</li>
1219
1219
  <li>
1220
1220
  <a href="https://github.com/robwierzbowski/jekyll-image-tag">Jekyll Image Tag</a>: Better images for Jekyll. Save image presets, generate resized images, and add classes, alt text, and other attributes.</li>
1221
1221
  <li>
1222
- <a href="https://github.com/wildlyinaccurate/jekyll-responsive-image">Jekyll Responsive Image</a>: Responsive images for Jekyll. Automatically resizes images, supports all responsive methods (<code class="highlighter-rouge">&lt;picture&gt;</code>, <code class="highlighter-rouge">srcset</code>, Imager.js, etc), super-flexible configuration.</li>
1222
+ <a href="https://github.com/wildlyinaccurate/jekyll-responsive-image">Jekyll Responsive Image</a>: Responsive images for Jekyll. Automatically resizes images, supports all responsive methods (<code class="language-plaintext highlighter-rouge">&lt;picture&gt;</code>, <code class="language-plaintext highlighter-rouge">srcset</code>, Imager.js, etc), super-flexible configuration.</li>
1223
1223
  <li>
1224
1224
  <a href="https://github.com/matze/jekyll-ditaa">Ditaa Tag</a> by <a href="https://github.com/matze">matze</a>: Renders ASCII diagram art into PNG images and inserts a figure tag.</li>
1225
1225
  <li>
@@ -1253,7 +1253,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1253
1253
  <li>
1254
1254
  <a href="https://github.com/Ezmyrelda/twa">twa</a>: Twemoji Awesome plugin for Jekyll. Liquid tag allowing you to use twitter emoji in your jekyll pages.</li>
1255
1255
  <li>
1256
- <a href="https://github.com/dimitri-koenig/jekyll-plugins">Fetch remote file content</a> by <a href="https://www.dimitrikoenig.net/">Dimitri König</a>: Using <code class="highlighter-rouge">remote_file_content</code> tag you can fetch the content of a remote file and include it as if you would put the content right into your markdown file yourself. Very useful for including code from github repo’s to always have a current repo version.</li>
1256
+ <a href="https://github.com/dimitri-koenig/jekyll-plugins">Fetch remote file content</a> by <a href="https://www.dimitrikoenig.net/">Dimitri König</a>: Using <code class="language-plaintext highlighter-rouge">remote_file_content</code> tag you can fetch the content of a remote file and include it as if you would put the content right into your markdown file yourself. Very useful for including code from github repo’s to always have a current repo version.</li>
1257
1257
  <li>
1258
1258
  <a href="https://github.com/mnuessler/jekyll-asciinema">jekyll-asciinema</a>: A tag for embedding asciicasts recorded with <a href="https://asciinema.org">asciinema</a> in your Jekyll pages.</li>
1259
1259
  <li>
@@ -1261,7 +1261,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1261
1261
  <li>
1262
1262
  <a href="https://github.com/lawmurray/indii-jekyll-flickr">Jekyll Flickr Plugin</a> by <a href="http://www.indii.org">Lawrence Murray</a>: Embeds Flickr photosets (albums) as a gallery of thumbnails, with lightbox links to larger images.</li>
1263
1263
  <li>
1264
- <a href="https://github.com/paulrobertlloyd/jekyll-figure">jekyll-figure</a>: A liquid tag for Jekyll that generates <code class="highlighter-rouge">&lt;figure&gt;</code> elements.</li>
1264
+ <a href="https://github.com/paulrobertlloyd/jekyll-figure">jekyll-figure</a>: A liquid tag for Jekyll that generates <code class="language-plaintext highlighter-rouge">&lt;figure&gt;</code> elements.</li>
1265
1265
  <li>
1266
1266
  <a href="https://github.com/eug/jekyll-video-embed">Jekyll Video Embed</a>: It provides several tags to easily embed videos (e.g. Youtube, Vimeo, UStream and Ted Talks)</li>
1267
1267
  <li>
@@ -1277,7 +1277,7 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
1277
1277
  <li>
1278
1278
  <a href="https://github.com/tnhu/jekyll-include-absolute-plugin">jekyll-include-absolute-plugin</a> by <a href="https://github.com/tnhu">Tan Nhu</a>: A Jekyll plugin to include a file from its path relative to Jekyll’s source folder.</li>
1279
1279
  <li>
1280
- <a href="https://github.com/mattg/jekyll-download-tag">Jekyll Download Tag</a>: A Liquid tag that acts like <code class="highlighter-rouge">include</code>, but for external resources.</li>
1280
+ <a href="https://github.com/mattg/jekyll-download-tag">Jekyll Download Tag</a>: A Liquid tag that acts like <code class="language-plaintext highlighter-rouge">include</code>, but for external resources.</li>
1281
1281
  <li>
1282
1282
  <a href="https://github.com/MediaComem/jekyll-brand-social-wall">Jekyll Brand Social Wall</a>: A jekyll plugin to generate a social wall with your favorite social networks</li>
1283
1283
  <li>
@@ -1318,7 +1318,7 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
1318
1318
  <li>
1319
1319
  <a href="https://github.com/rsim/blog.rayapps.com/blob/master/_plugins/pygments_cache_patch.rb">Pygments Cache Path by Raimonds Simanovskis</a>: Plugin to cache syntax-highlighted code from Pygments.</li>
1320
1320
  <li>
1321
- <a href="https://github.com/LawrenceWoodman/related_posts-jekyll_plugin">Related Posts by Lawrence Woodman</a>: Overrides <code class="highlighter-rouge">site.related_posts</code> to use categories to assess relationship.</li>
1321
+ <a href="https://github.com/LawrenceWoodman/related_posts-jekyll_plugin">Related Posts by Lawrence Woodman</a>: Overrides <code class="language-plaintext highlighter-rouge">site.related_posts</code> to use categories to assess relationship.</li>
1322
1322
  <li>
1323
1323
  <a href="https://github.com/toshimaru/jekyll-tagging-related_posts">jekyll-tagging-related_posts</a>: Jekyll related_posts function based on tags (works on Jekyll3).</li>
1324
1324
  <li>
@@ -1344,7 +1344,7 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
1344
1344
  <li>
1345
1345
  <a href="https://github.com/dannygarcia/grunt-jekyll">grunt-jekyll</a>: A straightforward <a href="http://gruntjs.com/">Grunt</a> plugin for Jekyll.</li>
1346
1346
  <li>
1347
- <a href="https://github.com/indirect/jekyll-postfiles">jekyll-postfiles</a>: Add <code class="highlighter-rouge">_postfiles</code> directory and <code class="highlighter-rouge">{{ postfile }}</code> tag so the files a post refers to will always be right there inside your repo.</li>
1347
+ <a href="https://github.com/indirect/jekyll-postfiles">jekyll-postfiles</a>: Add <code class="language-plaintext highlighter-rouge">_postfiles</code> directory and <code class="language-plaintext highlighter-rouge">{{ postfile }}</code> tag so the files a post refers to will always be right there inside your repo.</li>
1348
1348
  <li>
1349
1349
  <a href="http://jch.penibelst.de/">A layout that compresses HTML</a>: GitHub Pages compatible, configurable way to compress HTML files on site build.</li>
1350
1350
  <li>
@@ -1358,13 +1358,13 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
1358
1358
  <li>
1359
1359
  <a href="https://github.com/vwochnik/jekyll-language-plugin">Jekyll Language Plugin</a>: Jekyll 3.0-compatible multi-language plugin for posts, pages and includes.</li>
1360
1360
  <li>
1361
- <a href="https://github.com/vwochnik/jekyll-deploy">Jekyll Deploy</a>: Adds a <code class="highlighter-rouge">deploy</code> sub-command to Jekyll.</li>
1361
+ <a href="https://github.com/vwochnik/jekyll-deploy">Jekyll Deploy</a>: Adds a <code class="language-plaintext highlighter-rouge">deploy</code> sub-command to Jekyll.</li>
1362
1362
  <li>
1363
- <a href="https://github.com/contentful/jekyll-contentful-data-import">Official Contentful Jekyll Plugin</a>: Adds a <code class="highlighter-rouge">contentful</code> sub-command to Jekyll to import data from Contentful.</li>
1363
+ <a href="https://github.com/contentful/jekyll-contentful-data-import">Official Contentful Jekyll Plugin</a>: Adds a <code class="language-plaintext highlighter-rouge">contentful</code> sub-command to Jekyll to import data from Contentful.</li>
1364
1364
  <li>
1365
1365
  <a href="https://github.com/KrzysiekJ/jekyll-paspagon">jekyll-paspagon</a>: Sell your posts in various formats for cryptocurrencies.</li>
1366
1366
  <li>
1367
- <a href="https://github.com/awood/hawkins">Hawkins</a>: Adds a <code class="highlighter-rouge">liveserve</code> sub-command to Jekyll that incorporates <a href="http://livereload.com/">LiveReload</a> into your pages while you preview them. No more hitting the refresh button in your browser!</li>
1367
+ <a href="https://github.com/awood/hawkins">Hawkins</a>: Adds a <code class="language-plaintext highlighter-rouge">liveserve</code> sub-command to Jekyll that incorporates <a href="http://livereload.com/">LiveReload</a> into your pages while you preview them. No more hitting the refresh button in your browser!</li>
1368
1368
  <li>
1369
1369
  <a href="https://github.com/vwochnik/jekyll-autoprefixer">Jekyll Autoprefixer</a>: Autoprefixer integration for Jekyll</li>
1370
1370
  <li>
@@ -1380,7 +1380,7 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
1380
1380
  <li>
1381
1381
  <a href="https://github.com/snaptortoise/jekyll-pinboard-plugin">jekyll-pinboard</a>: Access your Pinboard bookmarks within your Jekyll theme.</li>
1382
1382
  <li>
1383
- <a href="https://github.com/mpchadwick/jekyll-migrate-permalink">jekyll-migrate-permalink</a>: Adds a <code class="highlighter-rouge">migrate-permalink</code> sub-command to help deal with side effects of changing your permalink.</li>
1383
+ <a href="https://github.com/mpchadwick/jekyll-migrate-permalink">jekyll-migrate-permalink</a>: Adds a <code class="language-plaintext highlighter-rouge">migrate-permalink</code> sub-command to help deal with side effects of changing your permalink.</li>
1384
1384
  <li>
1385
1385
  <a href="https://github.com/robcrocombe/jekyll-post">Jekyll-Post</a>: A CLI tool to easily draft, edit, and publish Jekyll posts.</li>
1386
1386
  <li>
@@ -1689,7 +1689,7 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
1689
1689
  <footer>
1690
1690
  <div class="grid">
1691
1691
  <div class="unit one-third center-on-mobiles">
1692
- <p>The contents of this website are <br>© 2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
1692
+ <p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
1693
1693
  </div>
1694
1694
  <div class="unit two-thirds align-right center-on-mobiles">
1695
1695
  <p>