jekyll-docs 3.5.2 → 3.6.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (127) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +3 -3
  3. data/site/community/index.html +5 -5
  4. data/site/docs/assets/index.html +14 -22
  5. data/site/docs/code_of_conduct/index.html +730 -0
  6. data/site/docs/collections/index.html +65 -80
  7. data/site/docs/conduct/index.html +4 -4
  8. data/site/docs/configuration/index.html +130 -156
  9. data/site/docs/continuous-integration/buddyworks/index.html +14 -16
  10. data/site/docs/continuous-integration/circleci/index.html +13 -21
  11. data/site/docs/continuous-integration/index.html +5 -5
  12. data/site/docs/continuous-integration/travis-ci/index.html +45 -73
  13. data/site/docs/contributing/index.html +10 -10
  14. data/site/docs/datafiles/index.html +37 -53
  15. data/site/docs/deployment-methods/index.html +54 -64
  16. data/site/docs/drafts/index.html +6 -8
  17. data/site/docs/extras/index.html +8 -12
  18. data/site/docs/frontmatter/index.html +10 -14
  19. data/site/docs/github-pages/index.html +10 -14
  20. data/site/docs/history/index.html +539 -440
  21. data/site/docs/home/index.html +4 -4
  22. data/site/docs/includes/index.html +42 -70
  23. data/site/docs/installation/index.html +23 -37
  24. data/site/docs/maintaining/affinity-team-captain/index.html +4 -4
  25. data/site/docs/maintaining/avoiding-burnout/index.html +4 -4
  26. data/site/docs/maintaining/becoming-a-maintainer/index.html +4 -4
  27. data/site/docs/maintaining/index.html +4 -4
  28. data/site/docs/maintaining/merging-a-pull-request/index.html +6 -8
  29. data/site/docs/maintaining/reviewing-a-pull-request/index.html +4 -4
  30. data/site/docs/maintaining/special-labels/index.html +4 -4
  31. data/site/docs/maintaining/triaging-an-issue/index.html +4 -4
  32. data/site/docs/migrations/index.html +4 -4
  33. data/site/docs/pages/index.html +8 -12
  34. data/site/docs/pagination/index.html +13 -21
  35. data/site/docs/permalinks/index.html +43 -34
  36. data/site/docs/plugins/index.html +51 -79
  37. data/site/docs/posts/index.html +26 -48
  38. data/site/docs/quickstart/index.html +6 -8
  39. data/site/docs/resources/index.html +45 -21
  40. data/site/docs/sites/index.html +4 -4
  41. data/site/docs/static-files/index.html +12 -16
  42. data/site/docs/structure/index.html +6 -8
  43. data/site/docs/templates/index.html +36 -68
  44. data/site/docs/themes/index.html +32 -49
  45. data/site/docs/troubleshooting/index.html +44 -82
  46. data/site/docs/upgrading/0-to-2/index.html +7 -9
  47. data/site/docs/upgrading/2-to-3/index.html +19 -31
  48. data/site/docs/upgrading/index.html +4 -4
  49. data/site/docs/usage/index.html +20 -30
  50. data/site/docs/variables/index.html +26 -10
  51. data/site/docs/windows/index.html +36 -58
  52. data/site/feed.xml +47 -53
  53. data/site/help/index.html +3 -3
  54. data/site/index.html +3 -3
  55. data/site/latest_version.txt +1 -1
  56. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -8
  57. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +16 -8
  58. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +16 -8
  59. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +16 -8
  60. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +16 -8
  61. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -8
  62. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +16 -8
  63. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +16 -8
  64. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +16 -8
  65. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +16 -8
  66. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -8
  67. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +16 -8
  68. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +16 -8
  69. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +16 -8
  70. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -8
  71. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +16 -8
  72. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +16 -8
  73. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +16 -8
  74. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +16 -8
  75. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +16 -8
  76. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -8
  77. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -8
  78. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +16 -8
  79. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +16 -8
  80. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +16 -8
  81. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +16 -8
  82. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +16 -8
  83. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +16 -8
  84. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -8
  85. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +16 -8
  86. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -8
  87. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -8
  88. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -8
  89. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +17 -9
  90. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -8
  91. data/site/news/2015/10/26/jekyll-3-0-released/index.html +16 -8
  92. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +16 -8
  93. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +16 -8
  94. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +16 -8
  95. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +16 -8
  96. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +16 -8
  97. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +16 -8
  98. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -8
  99. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +20 -12
  100. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +16 -8
  101. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -8
  102. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +16 -8
  103. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +16 -8
  104. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +16 -8
  105. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -8
  106. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +16 -8
  107. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +16 -8
  108. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -8
  109. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +16 -8
  110. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +16 -8
  111. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +16 -8
  112. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -29
  113. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +23 -17
  114. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +20 -14
  115. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +21 -13
  116. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -10
  117. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +573 -0
  118. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +565 -0
  119. data/site/news/index.html +122 -48
  120. data/site/news/releases/index.html +122 -48
  121. data/site/sitemap.xml +64 -52
  122. data/site/tutorials/convert-site-to-jekyll/index.html +80 -138
  123. data/site/tutorials/custom-404-page/index.html +13 -21
  124. data/site/tutorials/home/index.html +4 -4
  125. data/site/tutorials/navigation/index.html +144 -180
  126. data/site/tutorials/orderofinterpretation/index.html +27 -45
  127. metadata +8 -5
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Maintaining Jekyll | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Maintaining Jekyll">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Maintaining Jekyll","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"This guide is for Jekyll contributors and maintainers. These special people contribute to one or more of Jekyll’s repositories or help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/"},"url":"https://jekyllrb.com/docs/maintaining/"}</script>
28
+ {"name":null,"description":"This guide is for Jekyll contributors and maintainers. These special people contribute to one or more of Jekyll’s repositories or help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","url":"https://jekyllrb.com/docs/maintaining/","headline":"Maintaining Jekyll","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Merging a Pull Request | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Merging a Pull Request">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/merging-a-pull-request/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Merging a Pull Request","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/"},"url":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/"}</script>
28
+ {"name":null,"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","url":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/","headline":"Merging a Pull Request","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/merging-a-pull-request/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -306,12 +306,10 @@
306
306
 
307
307
  <p>To merge a pull request, leave a comment thanking the contributor, then add the special merge request:</p>
308
308
 
309
- <div class="language-text highlighter-rouge">
310
- <pre class="highlight"><code>Thank you very much for your contribution. Folks like you make this project and community strong. :heart:
309
+ <div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Thank you very much for your contribution. Folks like you make this project and community strong. :heart:
311
310
 
312
311
  @jekyllbot: merge +dev
313
- </code></pre>
314
- </div>
312
+ </code></pre></div></div>
315
313
 
316
314
  <p>The merge request is made up of three things:</p>
317
315
 
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Reviewing a Pull Request | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Reviewing a Pull Request">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Reviewing a Pull Request","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/"},"url":"https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/"}</script>
28
+ {"name":null,"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","url":"https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/","headline":"Reviewing a Pull Request","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Special Labels | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Special Labels">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/special-labels/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Special Labels","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/special-labels/"},"url":"https://jekyllrb.com/docs/maintaining/special-labels/"}</script>
28
+ {"name":null,"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","url":"https://jekyllrb.com/docs/maintaining/special-labels/","headline":"Special Labels","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/special-labels/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Triaging an Issue | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Triaging an Issue">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/triaging-an-issue/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Triaging an Issue","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/triaging-an-issue/"},"url":"https://jekyllrb.com/docs/maintaining/triaging-an-issue/"}</script>
28
+ {"name":null,"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","url":"https://jekyllrb.com/docs/maintaining/triaging-an-issue/","headline":"Triaging an Issue","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/triaging-an-issue/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Blog migrations | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Blog migrations">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/migrations/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Blog migrations","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"If you’re switching to Jekyll from another blogging system, Jekyll’s importers can help you with the move. To learn more about importing your site to Jekyll, visit our jekyll-import docs site.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/migrations/"},"url":"https://jekyllrb.com/docs/migrations/"}</script>
28
+ {"name":null,"description":"If you’re switching to Jekyll from another blogging system, Jekyll’s importers can help you with the move. To learn more about importing your site to Jekyll, visit our jekyll-import docs site.","url":"https://jekyllrb.com/docs/migrations/","headline":"Blog migrations","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/migrations/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Creating pages | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Creating pages">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/pages/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Creating pages","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pages/"},"url":"https://jekyllrb.com/docs/pages/"}</script>
28
+ {"name":null,"description":"In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.","url":"https://jekyllrb.com/docs/pages/","headline":"Creating pages","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pages/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -327,8 +327,7 @@ directory with a suitable name for the page you want to create. For a site with
327
327
  a homepage, an about page, and a contact page, here’s what the root directory
328
328
  and associated URLs might look like:</p>
329
329
 
330
- <div class="language-sh highlighter-rouge">
331
- <pre class="highlight"><code>.
330
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">.</span>
332
331
  |-- _config.yml
333
332
  |-- _includes/
334
333
  |-- _layouts/
@@ -338,8 +337,7 @@ and associated URLs might look like:</p>
338
337
  |-- index.html <span class="c"># =&gt; http://example.com/</span>
339
338
  |-- other.md <span class="c"># =&gt; http://example.com/other.html</span>
340
339
  └── contact.html <span class="c"># =&gt; http://example.com/contact.html</span>
341
- </code></pre>
342
- </div>
340
+ </code></pre></div></div>
343
341
 
344
342
  <p>If you have a lot of pages, you can organize those pages into subfolders. The same subfolders that are used to group your pages in our project’s source will exist in the <code class="highlighter-rouge">_site</code> folder when your site builds.</p>
345
343
 
@@ -347,13 +345,11 @@ and associated URLs might look like:</p>
347
345
 
348
346
  <p>If you have pages organized into subfolders in your source folder and want to flatten them in the root folder on build, you must add the <a href="/docs/permalinks/">permalink</a> property directly in your page’s front matter like this:</p>
349
347
 
350
- <div class="highlighter-rouge">
351
- <pre class="highlight"><code>---
348
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
352
349
  title: My page
353
350
  permalink: mypageurl.html
354
351
  ---
355
- </code></pre>
356
- </div>
352
+ </code></pre></div></div>
357
353
 
358
354
  <h3 id="named-folders-containing-index-html-files">Named folders containing index HTML files</h3>
359
355
 
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Pagination | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Pagination">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/pagination/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Pagination","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"With many websites — especially blogs — it’s very common to break the main listing of posts up into smaller lists and display them over multiple pages. Jekyll offers a pagination plugin, so you can automatically generate the appropriate files and folders you need for paginated listings.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pagination/"},"url":"https://jekyllrb.com/docs/pagination/"}</script>
28
+ {"name":null,"description":"With many websites — especially blogs — it’s very common to break the main listing of posts up into smaller lists and display them over multiple pages. Jekyll offers a pagination plugin, so you can automatically generate the appropriate files and folders you need for paginated listings.","url":"https://jekyllrb.com/docs/pagination/","headline":"Pagination","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pagination/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -293,7 +293,7 @@ multiple pages. Jekyll offers a pagination plugin, so you can automatically
293
293
  generate the appropriate files and folders you need for paginated listings.</p>
294
294
 
295
295
  <p>For Jekyll 3, include the <code class="highlighter-rouge">jekyll-paginate</code> plugin in your Gemfile and in
296
- your <code class="highlighter-rouge">_config.yml</code> under <code class="highlighter-rouge">gems</code>. For Jekyll 2, this is standard.</p>
296
+ your <code class="highlighter-rouge">_config.yml</code> under <code class="highlighter-rouge">plugins</code>. For Jekyll 2, this is standard.</p>
297
297
 
298
298
  <div class="note info">
299
299
  <h5>Pagination only works within HTML files</h5>
@@ -311,20 +311,16 @@ your <code class="highlighter-rouge">_config.yml</code> under <code class="highl
311
311
  <p>To enable pagination for your blog, add a line to the <code class="highlighter-rouge">_config.yml</code> file that
312
312
  specifies how many items should be displayed per page:</p>
313
313
 
314
- <div class="language-yaml highlighter-rouge">
315
- <pre class="highlight"><code><span class="s">paginate</span><span class="pi">:</span> <span class="s">5</span>
316
- </code></pre>
317
- </div>
314
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">paginate</span><span class="pi">:</span> <span class="s">5</span>
315
+ </code></pre></div></div>
318
316
 
319
317
  <p>The number should be the maximum number of Posts you’d like to be displayed
320
318
  per-page in the generated site.</p>
321
319
 
322
320
  <p>You may also specify the destination of the pagination pages:</p>
323
321
 
324
- <div class="language-yaml highlighter-rouge">
325
- <pre class="highlight"><code><span class="s">paginate_path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">/blog/page:num/"</span>
326
- </code></pre>
327
- </div>
322
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">paginate_path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">/blog/page:num/"</span>
323
+ </code></pre></div></div>
328
324
 
329
325
  <p>This will read in <code class="highlighter-rouge">blog/index.html</code>, send it each pagination page in Liquid as
330
326
  <code class="highlighter-rouge">paginator</code> and write the output to <code class="highlighter-rouge">blog/page:num/</code>, where <code class="highlighter-rouge">:num</code> is the
@@ -431,8 +427,7 @@ the <code class="highlighter-rouge">paginator</code> variable that will now be a
431
427
  want to do this in one of the main pages of your site. Here’s one example of a
432
428
  simple way of rendering paginated Posts in a HTML file:</p>
433
429
 
434
- <div class="language-html highlighter-rouge">
435
- <pre class="highlight"><code>
430
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
436
431
  ---
437
432
  layout: default
438
433
  title: My Blog
@@ -464,8 +459,7 @@ title: My Blog
464
459
  {% endif %}
465
460
  <span class="nt">&lt;/div&gt;</span>
466
461
 
467
- </code></pre>
468
- </div>
462
+ </code></pre></div></div>
469
463
 
470
464
  <div class="note warning">
471
465
  <h5>Beware the page one edge-case</h5>
@@ -479,8 +473,7 @@ title: My Blog
479
473
  <p>The following HTML snippet should handle page one, and render a list of each
480
474
  page with links to all but the current page.</p>
481
475
 
482
- <div class="language-html highlighter-rouge">
483
- <pre class="highlight"><code>
476
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
484
477
  {% if paginator.total_pages &gt; 1 %}
485
478
  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"pagination"</span><span class="nt">&gt;</span>
486
479
  {% if paginator.previous_page %}
@@ -507,8 +500,7 @@ page with links to all but the current page.</p>
507
500
  <span class="nt">&lt;/div&gt;</span>
508
501
  {% endif %}
509
502
 
510
- </code></pre>
511
- </div>
503
+ </code></pre></div></div>
512
504
 
513
505
 
514
506
 
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <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
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Permalinks | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Permalinks">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/permalinks/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Permalinks","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","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.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/permalinks/"},"url":"https://jekyllrb.com/docs/permalinks/"}</script>
28
+ {"name":null,"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.","url":"https://jekyllrb.com/docs/permalinks/","headline":"Permalinks","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/permalinks/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -298,41 +298,33 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
298
298
 
299
299
  <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>
300
300
 
301
- <div class="language-yaml highlighter-rouge">
302
- <pre class="highlight"><code><span class="s">permalink</span><span class="pi">:</span> <span class="s">/:categories/:year/:month/:day/:title.html</span>
303
- </code></pre>
304
- </div>
301
+ <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.html</span>
302
+ </code></pre></div></div>
305
303
 
306
304
  <p>If you don’t specify any permalink setting, Jekyll uses the above pattern as the default.</p>
307
305
 
308
306
  <p>The permalink can also be set using a built-in permalink style:</p>
309
307
 
310
- <div class="language-yaml highlighter-rouge">
311
- <pre class="highlight"><code><span class="s">permalink</span><span class="pi">:</span> <span class="s">date</span>
312
- </code></pre>
313
- </div>
308
+ <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>
309
+ </code></pre></div></div>
314
310
 
315
311
  <p><code class="highlighter-rouge">date</code> is the same as <code class="highlighter-rouge">:categories/:year/:month/:day/:title.html</code>, the default. See <a href="#builtinpermalinkstyles">Built-in Permalink Styles</a> below for more options.</p>
316
312
 
317
313
  <p>Setting the permalink in your post, page, or collection’s front matter overrides any global settings. Here’s an example:</p>
318
314
 
319
- <div class="language-yaml highlighter-rouge">
320
- <pre class="highlight"><code><span class="nn">---</span>
321
- <span class="s">title</span><span class="pi">:</span> <span class="s">My page title</span>
322
- <span class="s">permalink</span><span class="pi">:</span> <span class="s">/mypageurl/</span>
315
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
316
+ <span class="na">title</span><span class="pi">:</span> <span class="s">My page title</span>
317
+ <span class="na">permalink</span><span class="pi">:</span> <span class="s">/mypageurl/</span>
323
318
  <span class="nn">---</span>
324
- </code></pre>
325
- </div>
319
+ </code></pre></div></div>
326
320
 
327
321
  <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>
328
322
 
329
323
  <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>
330
324
 
331
- <div class="highlighter-rouge">
332
- <pre class="highlight"><code>├── mypageurl
325
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── mypageurl
333
326
  │   └── index.html
334
- </code></pre>
335
- </div>
327
+ </code></pre></div></div>
336
328
 
337
329
  <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>
338
330
 
@@ -354,7 +346,10 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
354
346
  <p><code>year</code></p>
355
347
  </td>
356
348
  <td>
357
- <p>Year from the post's filename</p>
349
+ <p>
350
+ Year from the post's filename. May be overridden via the document’s
351
+ <code>date</code> YAML front matter
352
+ </p>
358
353
  </td>
359
354
  </tr>
360
355
  <tr>
@@ -362,7 +357,10 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
362
357
  <p><code>month</code></p>
363
358
  </td>
364
359
  <td>
365
- <p>Month from the post's filename</p>
360
+ <p>
361
+ Month from the post's filename. May be overridden via the document’s
362
+ <code>date</code> YAML front matter
363
+ </p>
366
364
  </td>
367
365
  </tr>
368
366
  <tr>
@@ -370,7 +368,10 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
370
368
  <p><code>i_month</code></p>
371
369
  </td>
372
370
  <td>
373
- <p>Month from the post's filename without leading zeros.</p>
371
+ <p>
372
+ Month without leading zeros from the post's filename. May be
373
+ overridden via the document’s <code>date</code> YAML front matter
374
+ </p>
374
375
  </td>
375
376
  </tr>
376
377
  <tr>
@@ -378,7 +379,10 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
378
379
  <p><code>day</code></p>
379
380
  </td>
380
381
  <td>
381
- <p>Day from the post's filename</p>
382
+ <p>
383
+ Day from the post's filename. May be overridden via the document’s
384
+ <code>date</code> YAML front matter
385
+ </p>
382
386
  </td>
383
387
  </tr>
384
388
  <tr>
@@ -386,7 +390,10 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
386
390
  <p><code>i_day</code></p>
387
391
  </td>
388
392
  <td>
389
- <p>Day from the post's filename without leading zeros.</p>
393
+ <p>
394
+ Day without leading zeros from the post's filename. May be overridden
395
+ via the document’s <code>date</code> YAML front matter
396
+ </p>
390
397
  </td>
391
398
  </tr>
392
399
  <tr>
@@ -394,7 +401,10 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
394
401
  <p><code>short_year</code></p>
395
402
  </td>
396
403
  <td>
397
- <p>Year from the post's filename without the century.</p>
404
+ <p>
405
+ Year without the century from the post's filename. May be overridden
406
+ via the document’s <code>date</code> YAML front matter
407
+ </p>
398
408
  </td>
399
409
  </tr>
400
410
  <tr>
@@ -403,7 +413,8 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
403
413
  </td>
404
414
  <td>
405
415
  <p>
406
- Hour of the day, 24-hour clock, zero-padded from the post's <code>date</code> front matter. (00..23)
416
+ Hour of the day, 24-hour clock, zero-padded from the post's
417
+ <code>date</code> front matter. (00..23)
407
418
  </p>
408
419
  </td>
409
420
  </tr>
@@ -592,7 +603,7 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
592
603
  <p>For example:</p>
593
604
 
594
605
  <ul>
595
- <li>A permalink style of <code class="highlighter-rouge">/:categories/:year/:month/:day/:title.html</code> for posts becomes <code class="highlighter-rouge">/:title.html</code> for pages and collections.</li>
606
+ <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>
596
607
  <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>
597
608
  <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>
598
609
  </ul>
@@ -623,13 +634,11 @@ Jekyll supports a flexible way to build permalinks, allowing you to leverage var
623
634
 
624
635
  <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>
625
636
 
626
- <div class="highlighter-rouge">
627
- <pre class="highlight"><code>---
637
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
628
638
  title: My page
629
639
  permalink: mypageurl.html
630
640
  ---
631
- </code></pre>
632
- </div>
641
+ </code></pre></div></div>
633
642
 
634
643
  <h2 id="extensionless-permalinks">Extensionless permalinks with no trailing slashes</h2>
635
644