jekyll-docs 3.9.0 → 4.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (225) hide show
  1. checksums.yaml +4 -4
  2. data/lib/jekyll-docs.rb +3 -3
  3. data/site/404.html +10 -7
  4. data/site/css/screen.css +3 -1
  5. data/site/css/screen.css.map +28 -0
  6. data/site/docs/assets/index.html +412 -453
  7. data/site/docs/code_of_conduct/index.html +447 -501
  8. data/site/docs/collections/index.html +487 -674
  9. data/site/docs/community/bug/index.html +603 -0
  10. data/site/docs/community/index.html +635 -0
  11. data/site/docs/conduct/index.html +447 -515
  12. data/site/docs/configuration/default/index.html +682 -0
  13. data/site/docs/configuration/environments/index.html +641 -0
  14. data/site/docs/configuration/front-matter-defaults/index.html +738 -0
  15. data/site/docs/configuration/incremental-regeneration/index.html +631 -0
  16. data/site/docs/configuration/index.html +405 -1230
  17. data/site/docs/configuration/liquid/index.html +616 -0
  18. data/site/docs/configuration/markdown/index.html +766 -0
  19. data/site/docs/configuration/options/index.html +1011 -0
  20. data/site/docs/configuration/webrick/index.html +615 -0
  21. data/site/docs/continuous-integration/buddyworks/index.html +393 -479
  22. data/site/docs/continuous-integration/circleci/index.html +465 -481
  23. data/site/docs/continuous-integration/travis-ci/index.html +450 -507
  24. data/site/docs/contributing/index.html +425 -514
  25. data/site/docs/datafiles/index.html +411 -453
  26. data/site/docs/deployment-methods/index.html +9 -871
  27. data/site/docs/deployment/automated/index.html +663 -0
  28. data/site/docs/deployment/index.html +607 -0
  29. data/site/docs/deployment/manual/index.html +631 -0
  30. data/site/docs/deployment/third-party/index.html +639 -0
  31. data/site/docs/drafts/index.html +9 -634
  32. data/site/docs/extras/index.html +9 -687
  33. data/site/docs/front-matter/index.html +799 -0
  34. data/site/docs/frontmatter/index.html +9 -819
  35. data/site/docs/github-pages/index.html +407 -475
  36. data/site/docs/history/index.html +1370 -1154
  37. data/site/docs/home/index.html +9 -627
  38. data/site/docs/includes/index.html +425 -501
  39. data/site/docs/index.html +630 -9
  40. data/site/docs/installation/index.html +403 -540
  41. data/site/docs/installation/macos/index.html +716 -0
  42. data/site/docs/installation/other-linux/index.html +613 -0
  43. data/site/docs/installation/ubuntu/index.html +623 -0
  44. data/site/docs/installation/windows/index.html +733 -0
  45. data/site/docs/layouts/index.html +726 -0
  46. data/site/docs/liquid/filters/index.html +1169 -0
  47. data/site/docs/liquid/index.html +615 -0
  48. data/site/docs/liquid/tags/index.html +728 -0
  49. data/site/docs/maintaining/affinity-team-captain/index.html +395 -479
  50. data/site/docs/maintaining/avoiding-burnout/index.html +391 -475
  51. data/site/docs/maintaining/becoming-a-maintainer/index.html +391 -475
  52. data/site/docs/maintaining/index.html +391 -486
  53. data/site/docs/maintaining/merging-a-pull-request/index.html +406 -490
  54. data/site/docs/maintaining/releasing-a-new-version/index.html +409 -485
  55. data/site/docs/maintaining/reviewing-a-pull-request/index.html +392 -476
  56. data/site/docs/maintaining/special-labels/index.html +397 -481
  57. data/site/docs/maintaining/triaging-an-issue/index.html +394 -478
  58. data/site/docs/markdown-101/index.html +601 -0
  59. data/site/docs/migrations/index.html +396 -440
  60. data/site/docs/pages/index.html +408 -482
  61. data/site/docs/pagination/index.html +450 -509
  62. data/site/docs/permalinks/index.html +552 -587
  63. data/site/docs/plugins/commands/index.html +656 -0
  64. data/site/docs/plugins/converters/index.html +685 -0
  65. data/site/docs/plugins/filters/index.html +624 -0
  66. data/site/docs/plugins/generators/index.html +697 -0
  67. data/site/docs/plugins/hooks/index.html +838 -0
  68. data/site/docs/plugins/index.html +415 -1565
  69. data/site/docs/plugins/installation/index.html +681 -0
  70. data/site/docs/plugins/tags/index.html +699 -0
  71. data/site/docs/plugins/your-first-plugin/index.html +741 -0
  72. data/site/docs/posts/index.html +491 -627
  73. data/site/docs/quickstart/index.html +9 -645
  74. data/site/docs/resources/index.html +9 -761
  75. data/site/docs/ruby-101/index.html +640 -0
  76. data/site/docs/sites/index.html +9 -696
  77. data/site/docs/static-files/index.html +401 -433
  78. data/site/docs/step-by-step/01-setup/index.html +771 -0
  79. data/site/docs/step-by-step/02-liquid/index.html +756 -0
  80. data/site/docs/step-by-step/03-front-matter/index.html +730 -0
  81. data/site/docs/step-by-step/04-layouts/index.html +770 -0
  82. data/site/docs/step-by-step/05-includes/index.html +768 -0
  83. data/site/docs/step-by-step/06-data-files/index.html +738 -0
  84. data/site/docs/step-by-step/07-assets/index.html +773 -0
  85. data/site/docs/step-by-step/08-blogging/index.html +835 -0
  86. data/site/docs/step-by-step/09-collections/index.html +932 -0
  87. data/site/docs/step-by-step/10-deployment/index.html +842 -0
  88. data/site/docs/structure/index.html +411 -430
  89. data/site/docs/support/index.html +392 -476
  90. data/site/docs/templates/index.html +9 -1232
  91. data/site/docs/themes/index.html +487 -521
  92. data/site/docs/troubleshooting/index.html +443 -520
  93. data/site/docs/upgrading/0-to-2/index.html +437 -523
  94. data/site/docs/upgrading/2-to-3/index.html +422 -507
  95. data/site/docs/upgrading/3-to-4/index.html +765 -0
  96. data/site/docs/upgrading/index.html +395 -478
  97. data/site/docs/usage/index.html +409 -506
  98. data/site/docs/variables/index.html +504 -652
  99. data/site/docs/windows/index.html +9 -784
  100. data/site/feed.xml +269 -188
  101. data/site/feed/release.xml +324 -0
  102. data/site/fonts/lato-v14-latin-300.woff +0 -0
  103. data/site/fonts/lato-v14-latin-300.woff2 +0 -0
  104. data/site/fonts/lato-v14-latin-300italic.woff +0 -0
  105. data/site/fonts/lato-v14-latin-300italic.woff2 +0 -0
  106. data/site/fonts/lato-v14-latin-700.woff +0 -0
  107. data/site/fonts/lato-v14-latin-700.woff2 +0 -0
  108. data/site/fonts/lato-v14-latin-700italic.woff +0 -0
  109. data/site/fonts/lato-v14-latin-700italic.woff2 +0 -0
  110. data/site/fonts/lato-v14-latin-900.woff +0 -0
  111. data/site/fonts/lato-v14-latin-900.woff2 +0 -0
  112. data/site/fonts/lato-v14-latin-900italic.woff +0 -0
  113. data/site/fonts/lato-v14-latin-900italic.woff2 +0 -0
  114. data/site/fonts/lato-v14-latin-italic.woff +0 -0
  115. data/site/fonts/lato-v14-latin-italic.woff2 +0 -0
  116. data/site/fonts/lato-v14-latin-regular.woff +0 -0
  117. data/site/fonts/lato-v14-latin-regular.woff2 +0 -0
  118. data/site/help/index.html +9 -247
  119. data/site/img/forestry-logo.svg +19 -0
  120. data/site/img/jekyll-og.png +0 -0
  121. data/site/img/spacer.gif +0 -0
  122. data/site/index.html +56 -29
  123. data/site/jekyllconf/index.html +62 -35
  124. data/site/latest_version.txt +1 -1
  125. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +180 -115
  126. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +182 -117
  127. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +183 -118
  128. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +184 -119
  129. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +183 -118
  130. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +180 -115
  131. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +182 -117
  132. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +182 -117
  133. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +185 -120
  134. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +183 -118
  135. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +180 -115
  136. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +189 -124
  137. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +181 -116
  138. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +181 -116
  139. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +180 -115
  140. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +182 -117
  141. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +181 -116
  142. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +181 -116
  143. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +181 -116
  144. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +184 -119
  145. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +180 -115
  146. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +181 -116
  147. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +185 -120
  148. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +182 -117
  149. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +181 -116
  150. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +189 -124
  151. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +187 -122
  152. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +188 -123
  153. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +180 -115
  154. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +182 -117
  155. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +179 -114
  156. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +180 -115
  157. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +179 -114
  158. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +180 -115
  159. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +180 -115
  160. data/site/news/2015/10/26/jekyll-3-0-released/index.html +185 -120
  161. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +184 -119
  162. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +182 -117
  163. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +186 -121
  164. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +183 -118
  165. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +181 -116
  166. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +182 -117
  167. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +179 -114
  168. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +181 -116
  169. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +181 -116
  170. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +180 -115
  171. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +186 -121
  172. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +181 -116
  173. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +181 -116
  174. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +179 -114
  175. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +184 -119
  176. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +180 -115
  177. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +179 -114
  178. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +207 -142
  179. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +181 -116
  180. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +183 -118
  181. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +181 -116
  182. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +189 -124
  183. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +190 -125
  184. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +187 -122
  185. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +182 -117
  186. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +185 -120
  187. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +181 -116
  188. data/site/news/2017/10/19/diversity-open-source/index.html +181 -116
  189. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +183 -118
  190. data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +184 -119
  191. data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +189 -124
  192. data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +180 -115
  193. data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +185 -120
  194. data/site/news/2018/04/19/development-update/index.html +699 -0
  195. data/site/news/2018/04/19/jekyll-3-8-0-released/index.html +715 -0
  196. data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +182 -117
  197. data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +181 -116
  198. data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +183 -118
  199. data/site/news/2018/08/01/jekyll-sponsoring/index.html +748 -0
  200. data/site/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/index.html +692 -0
  201. data/site/news/2018/11/04/jekyll-3-8-5-released/index.html +682 -0
  202. data/site/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/index.html +710 -0
  203. data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +180 -115
  204. data/site/news/2019/07/20/jekyll-4-0-0-pre-beta1-released/index.html +11 -0
  205. data/site/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/index.html +708 -0
  206. data/site/news/2019/08/20/jekyll-4-0-0-released/index.html +809 -0
  207. data/site/news/index.html +976 -326
  208. data/site/news/releases/index.html +820 -321
  209. data/site/{philosophy.html → philosophy/index.html} +1 -1
  210. data/site/redirects.json +1 -1
  211. data/site/resources/index.html +332 -0
  212. data/site/showcase/index.html +844 -0
  213. data/site/sitemap.xml +256 -81
  214. data/site/team/index.html +63 -77
  215. data/site/tutorials/cache-api/index.html +418 -0
  216. data/site/tutorials/convert-site-to-jekyll/index.html +155 -124
  217. data/site/tutorials/custom-404-page/index.html +76 -43
  218. data/site/tutorials/home/index.html +64 -37
  219. data/site/tutorials/navigation/index.html +186 -103
  220. data/site/tutorials/orderofinterpretation/index.html +80 -53
  221. data/site/tutorials/using-jekyll-with-bundler/index.html +80 -51
  222. data/site/tutorials/video-walkthroughs/index.html +62 -35
  223. metadata +102 -13
  224. data/site/community/index.html +0 -11
  225. data/site/docs/continuous-integration/index.html +0 -681
@@ -3,17 +3,18 @@
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.9.0">
6
+ <meta name="generator" content="Jekyll v4.0.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
+ <link type="application/atom+xml" rel="alternate" href="/feed/release.xml" title="Jekyll releases posts" />
8
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">
9
- <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
10
- <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
10
+ <link rel="preload" href="/fonts/lato-v14-latin-300.woff2" as="font" type="font/woff2" crossorigin />
11
+ <link rel="preload" href="/fonts/lato-v14-latin-700.woff2" as="font" type="font/woff2" crossorigin />
12
+ <link rel="preload" href="/css/screen.css" as="style">
12
13
  <link rel="stylesheet" href="/css/screen.css">
13
14
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
15
  <!-- Begin Jekyll SEO tag v2.6.1 -->
15
16
  <title>News | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.9.0" />
17
+ <meta name="generator" content="Jekyll v4.0.0" />
17
18
  <meta property="og:title" content="News" />
18
19
  <meta name="author" content="all" />
19
20
  <meta property="og:locale" content="en_US" />
@@ -22,13 +23,15 @@
22
23
  <link rel="canonical" href="https://jekyllrb.com/news/" />
23
24
  <meta property="og:url" content="https://jekyllrb.com/news/" />
24
25
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
25
- <meta name="twitter:card" content="summary" />
26
+ <meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
27
+ <meta name="twitter:card" content="summary_large_image" />
28
+ <meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
26
29
  <meta property="twitter:title" content="News" />
27
30
  <meta name="twitter:site" content="@jekyllrb" />
28
31
  <meta name="twitter:creator" content="@all" />
29
32
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
30
33
  <script type="application/ld+json">
31
- {"url":"https://jekyllrb.com/news/","headline":"News","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"https://schema.org"}</script>
34
+ {"description":"Transform your plain text into static websites and blogs","@type":"WebPage","headline":"News","url":"https://jekyllrb.com/news/","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"author":{"@type":"Person","name":"all"},"@context":"https://schema.org"}</script>
32
35
  <!-- End Jekyll SEO tag -->
33
36
 
34
37
  <!--[if lt IE 9]>
@@ -51,18 +54,27 @@
51
54
  </div>
52
55
  <nav class="main-nav hide-on-mobiles">
53
56
  <ul>
54
- <li class="">
57
+
58
+ <li>
55
59
  <a href="/">Home</a>
56
60
  </li>
57
- <li class="">
58
- <a href="/docs/home/">Docs</a>
61
+
62
+ <li>
63
+ <a href="/docs/">Docs</a>
64
+ </li>
65
+
66
+ <li>
67
+ <a href="/resources/">Resources</a>
68
+ </li>
69
+
70
+ <li>
71
+ <a href="/showcase/">Showcase</a>
59
72
  </li>
73
+
60
74
  <li class="current">
61
75
  <a href="/news/">News</a>
62
76
  </li>
63
- <li class="">
64
- <a href="/help/">Help</a>
65
- </li>
77
+
66
78
  </ul>
67
79
 
68
80
  </nav>
@@ -73,7 +85,7 @@
73
85
  <div class="meta hide-on-mobiles">
74
86
  <ul>
75
87
  <li>
76
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
88
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
77
89
  </li>
78
90
  <li>
79
91
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -83,18 +95,24 @@
83
95
  </div>
84
96
  <nav class="mobile-nav show-on-mobiles">
85
97
  <ul>
86
- <li class="">
87
- <a href="/">Home</a>
88
- </li>
89
- <li class="">
90
- <a href="/docs/home/">Docs</a>
91
- </li>
92
- <li class="current">
93
- <a href="/news/">News</a>
94
- </li>
95
- <li class="">
96
- <a href="/help/">Help</a>
97
- </li>
98
+
99
+ <li>
100
+ <a href="/">Home</a>
101
+ </li>
102
+
103
+ <li>
104
+ <a href="/docs/">Docs</a>
105
+ </li>
106
+
107
+ <li>
108
+ <a href="/resources/">Resources</a>
109
+ </li>
110
+
111
+
112
+ <li class="current">
113
+ <a href="/news/">News</a>
114
+ </li>
115
+
98
116
  <li>
99
117
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
100
118
  </li>
@@ -111,16 +129,32 @@
111
129
  <select onchange="if (this.value) window.location.href=this.value">
112
130
  <option value="">Navigate the blog…</option>
113
131
  <option value="/news/">Home</option>
114
- <optgroup label="v1.x">
132
+ <optgroup label="posts">
133
+
134
+ <option value="/news/2019/08/20/jekyll-4-0-0-released/">Jekyll 4.0.0 Released</option>
135
+
136
+ <option value="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">Jekyll 4.0.0.pre.beta1 Released</option>
115
137
 
116
138
  <option value="/news/2019/07/02/jekyll-3-8-6-released/">Jekyll 3.8.6 Released</option>
117
139
 
140
+ <option value="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">Jekyll 4.0.0.pre.alpha1 Released</option>
141
+
142
+ <option value="/news/2018/11/04/jekyll-3-8-5-released/">Jekyll 3.8.5 Released</option>
143
+
144
+ <option value="/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/">Security Fixes for series 3.6, 3.7 and 3.8</option>
145
+
146
+ <option value="/news/2018/08/01/jekyll-sponsoring/">Sponsoring Jekyll's development</option>
147
+
118
148
  <option value="/news/2018/06/05/jekyll-3-8-3-released/">Jekyll 3.8.3 Released</option>
119
149
 
120
150
  <option value="/news/2018/05/19/jekyll-3-8-2-released/">Jekyll 3.8.2 Released</option>
121
151
 
122
152
  <option value="/news/2018/05/01/jekyll-3-8-1-released/">Jekyll 3.8.1 Released</option>
123
153
 
154
+ <option value="/news/2018/04/19/development-update/">Jekyll 4.0 is on the Horizon!</option>
155
+
156
+ <option value="/news/2018/04/19/jekyll-3-8-0-released/">Jekyll 3.8.0 Released</option>
157
+
124
158
  <option value="/news/2018/02/24/jekyll-3-7-3-released/">Jekyll 3.7.3 Released</option>
125
159
 
126
160
  <option value="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</option>
@@ -266,6 +300,229 @@
266
300
 
267
301
  <div class="unit four-fifths">
268
302
 
303
+ <article>
304
+ <h2>
305
+ <a href="/news/2019/08/20/jekyll-4-0-0-released/">
306
+ Jekyll 4.0.0 Released
307
+ </a>
308
+ </h2>
309
+ <span class="post-category">
310
+ <span class="label">
311
+ release
312
+ </span>
313
+ </span>
314
+ <div class="post-meta">
315
+ <span class="post-date">
316
+ 20 Aug 2019
317
+ </span>
318
+
319
+ <a href="https://github.com/mattr-" class="post-author">
320
+ <img class="avatar avatar-small" alt="mattr-" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=24" srcset="https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=96 4x">
321
+ mattr-
322
+ </a>
323
+ </div>
324
+ <div class="post-content">
325
+ <p>Hi! 👋 I bring some good news! Jekyll 4.0.0 is finally here! 🎉</p>
326
+
327
+ <p>There’s quite a bit in this release to unpack, so let me hit the high points quickly:</p>
328
+ <ul>
329
+ <li>Ruby 2.4.0 or greater is now required.</li>
330
+ <li>Rouge 3.0 or greater is now required for syntax highlighting.</li>
331
+ <li>Jekyll builds should be much faster.</li>
332
+ <li>Kramdown 2.1 is now the default markdown engine.</li>
333
+ <li>Sass processing should be faster.</li>
334
+ <li>We dropped support for a lot of stuff, specifically:
335
+ <ul>
336
+ <li>Pygments</li>
337
+ <li>RedCarpet</li>
338
+ <li>RDiscount</li>
339
+ </ul>
340
+ </li>
341
+ </ul>
342
+
343
+ <p>Alright, so with the high points out of the way, let’s get into the details a little bit.</p>
344
+
345
+ <h3 id="cache-all-the-things-">Cache all the things! 💰</h3>
346
+
347
+ <p>While some optimizations first made an appearance with Jekyll 3.8.0, Jekyll 4.0 takes
348
+ it to another level altogether.</p>
349
+
350
+ <p>Jekyll 4.0 caches the processing done by Liquid in memory. So every Liquid
351
+ template is processed only as required. If you have 10 pages depending on a
352
+ single layout, the layout is cached and that data is then rendered as per the
353
+ 10 different contexts of the individual files.</p>
354
+
355
+ <p>There’s also a disk cache! Jekyll can now cache data to disk to avoid repeated
356
+ processing of content that doesn’t change between build sessions. Currently,
357
+ this is limited to markdown. So while the very first build will take a certain
358
+ amount of time, consequent builds for content that hasn’t changed will take
359
+ much less time due to the disk-cache. Disk caching is disabled for <code class="highlighter-rouge">safe</code> mode,
360
+ however.</p>
361
+
362
+ <h3 id="super-powered-content-transformations-">Super-powered content transformations 💪</h3>
363
+
364
+ <p>We’ve upgraded Sass support so it should be faster and support. There’s also
365
+ support for sourcemaps now! Under the hood, our Sass support uses the <code class="highlighter-rouge">SassC</code>
366
+ library now, which is supported directly by the Sass team, which should mean
367
+ better support for everybody in the long run.</p>
368
+
369
+ <p>Kramdown is updated to version 2.1. This also brings with it a bunch of changes
370
+ to the Kramdown configuration, as the Kramdown team have extracted a fair
371
+ number of features into separate gems. Support for GitHub Flavored Markdown is
372
+ enabled by default, but if you’re using another Kramdown extension in your
373
+ site, you’ll likely need to update your plugin configuration. See the <a href="/docs/upgrading/3-to-4/">upgrade
374
+ guide</a> for more details.</p>
375
+
376
+ <p>The <code class="highlighter-rouge">link</code> and <code class="highlighter-rouge">post_url</code> tags no longer need <code class="highlighter-rouge">site.baseurl</code> prepended every
377
+ time they’re used. Those tags now use our <code class="highlighter-rouge">relative_url</code> filter to take care of
378
+ this for you. Existing uses of the prepending pattern will break though!
379
+ Sorry! <img class="emoji" title=":sweat_smile:" alt=":sweat_smile:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f605.png" height="20" width="20"></p>
380
+
381
+ <p>A few other smaller features when it comes to content:</p>
382
+ <ul>
383
+ <li>The <code class="highlighter-rouge">link</code> tag understands Liquid variables in the same fashion our
384
+ <code class="highlighter-rouge">include</code> tag does now.</li>
385
+ <li>Disable Liquid processing for a particular page / document by adding
386
+ <code class="highlighter-rouge">render_with_liquid: false</code> to it’s front matter.</li>
387
+ <li>Liquid’s binary <code class="highlighter-rouge">and</code> and <code class="highlighter-rouge">or</code> operations can be used in the <code class="highlighter-rouge">where_exp</code>
388
+ filter for more powerful filtering</li>
389
+ </ul>
390
+
391
+ <p>There’s some goodies for theme community as well. Developers may now bundle a
392
+ <code class="highlighter-rouge">config.yml</code> into their theme-gem to provide some boilerplate configurations for
393
+ the theme. Like other resources in the theme, these configuration values can also
394
+ be customized at the user’s end.</p>
395
+
396
+ <p>Check out the <a href="/docs/history/#v4-0-0">full history</a> and the various pull requests
397
+ for more details on all the enhancements and bug-fixes.</p>
398
+
399
+ <h3 id="upgrading-">Upgrading 📈</h3>
400
+
401
+ <p>First, read the <a href="/docs/upgrading/3-to-4/">upgrade guide</a>!</p>
402
+
403
+ <p>Next, Edit your project’s <code class="highlighter-rouge">Gemfile</code> to test Jekyll v4.x:</p>
404
+
405
+ <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s2">"jekyll"</span><span class="p">,</span> <span class="s2">"~&gt; 4.0"</span>
406
+ </code></pre></div></div>
407
+
408
+ <p>Then run <code class="highlighter-rouge">bundle update</code> to update all dependencies. Unless you’re using
409
+ third-party plugins that haven’t yet added support for Jekyll 4.0, you should be
410
+ good to go.</p>
411
+
412
+ <p>Plugins and themes authors must relax the jekyll dependency in their <code class="highlighter-rouge">gemspec</code> file
413
+ to allow for Jekyll v4.0:</p>
414
+
415
+ <p><code class="highlighter-rouge">spec.add_runtime_dependency "jekyll", "&gt;= 3.6", "&lt; 5.0"</code></p>
416
+
417
+ <p>If your favorite plugin hasn’t relaxed that dependency yet, please gently
418
+ encourage them to do so. <img class="emoji" title=":slightly_smiling_face:" alt=":slightly_smiling_face:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f642.png" height="20" width="20"></p>
419
+
420
+ <h3 id="have-questions">Have questions❓</h3>
421
+
422
+ <p>Please reach out on our <a href="https://talk.jekyllrb.com">community forum</a></p>
423
+
424
+ <h3 id="thank-you-">Thank you!! 🙇</h3>
425
+
426
+ <p>Jekyll would not be possible without the many people who have taken the time to write issues, submit pull requests, create themes, answer questions for other users, or make their own sites using our project. Thanks to all of you who contribute, no matter how small you think your contribution might have been.</p>
427
+
428
+ <p>In addition, special thanks to the 139 contributors who made this
429
+ release possible via a pull request submission (in alphabetical order): Aidan
430
+ Fitzgerald, Akshat Kedia, Ale Muñoz, Alex Wood,
431
+ Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez,
432
+ Ananthakumar, Andreas Möller, Andrew Lyndem, Andrew Marcuse, Andy Alt, Anne
433
+ Gentle, Anny, Anuj Bhatnagar, argv-minus-one, Arjun Thakur, Arthur Attwell,
434
+ Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed,
435
+ Bjorn Krols, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Chris
436
+ Oliver, chrisfinazzo, Christian Oliff, Christoph Päper, Damien Solodow, Dan
437
+ Allen, Dan Friedman, Daniel Höpfl, David J. Malan, David Kennell, David Zhang,
438
+ Denis McDonald, Derek Smart, Derpy, Dusty Candland, Edgar Tinajero, Elvio
439
+ Vicosa, ExE Boss, Fons van der Plas, Frank Taillandier, Gareth Cooper, Grzegorz
440
+ Kaczorek, Haris Bjelic, Hodong Kim, ikeji, Isaac Goodman, Jacob Byers, Jakob
441
+ Krigovsky, James Rhea, Jan Pobořil, jess, jingze_lu, Joe Shannon, Jordan Morgan,
442
+ Jörg Steinsträter, Jorie Tappa, Josue Caraballo, jpasholk, Justin Vallelonga,
443
+ Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, krissy,
444
+ Kyle Barbour, Lars Kanis, Leandro Facchinetti, Liam Rosenfeld, Luis Enrique
445
+ Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, makmm, Manu Mathew, Mario,
446
+ Martin Scharm, Matt Kraai, Matt Massicotte, Matt Rogers, Matthew Rathbone,
447
+ Maxwell Gerber, Mertcan Yücel, Michael Bishop, Michael Hiiva, Michelle Greer,
448
+ Mike Kasberg, Mike Neumegen, mo khan, Monica Powell, Nicolas Hoizey, Nikhil
449
+ Benesch, Nikhil Swaminathan, Nikita Skalkin, Niklas Eicker, ninevra, Olivia
450
+ Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, penguinpet,
451
+ Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes,
452
+ Sadik Kuzu, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer,
453
+ Stephen Weiss, Steven Westmoreland, strangehill, Sundaram Kalyan Vedala, Thanos
454
+ Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev,
455
+ Vinicius Flores, Vitor Oliveira, Wouter Schoot, XhmikosR, Yi Feng Xie, Zhang
456
+ Xiangze, 김정환, 104fps.</p>
457
+
458
+ <p>Happy Jekylling everyone!</p>
459
+
460
+ </div>
461
+ </article>
462
+
463
+
464
+ <article>
465
+ <h2>
466
+ <a href="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">
467
+ Jekyll 4.0.0.pre.beta1 Released
468
+ </a>
469
+ </h2>
470
+ <span class="post-category">
471
+ <span class="label">
472
+ release
473
+ </span>
474
+ </span>
475
+ <div class="post-meta">
476
+ <span class="post-date">
477
+ 04 Aug 2019
478
+ </span>
479
+
480
+ <a href="https://github.com/mattr-" class="post-author">
481
+ <img class="avatar avatar-small" alt="mattr-" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=24" srcset="https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/mattr-?v=3&amp;s=96 4x">
482
+ mattr-
483
+ </a>
484
+ </div>
485
+ <div class="post-content">
486
+ <p>Dear Jekyllers,</p>
487
+
488
+ <p>It’s time for another pre-release of Jekyll 4! 🎉</p>
489
+
490
+ <p>This pre-release moves us further down the path of releasing Jekyll 4.0.0. All the same goodies <a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">from the last pre-release</a> are here, along with a few more things I want to highlight:</p>
491
+
492
+ <p>Jekyll 4.0 is a new <em>major</em> version and it comes with a few breaking changes, notably :</p>
493
+
494
+ <ol>
495
+ <li>We dropped support for <a href="https://www.ruby-lang.org/en/downloads/">Ruby 2.3 which EOL at the end of March 2019</a>.
496
+ GitHub Pages runs Ruby 2.5.x, services like Netlify or Forestry already upgraded to latest Ruby 2.6.x.</li>
497
+ <li>
498
+ <code class="highlighter-rouge">link</code> tag now include <code class="highlighter-rouge">relative_url</code> filter, hurray <a href="https://github.com/jekyll/jekyll/pull/6727">no more need to prepend <code class="highlighter-rouge">{{ site.baseurl }}</code> </a>.</li>
499
+ <li>
500
+ <a href="https://github.com/jekyll/jekyll/pull/6821"><code class="highlighter-rouge">{% highlight %}</code> now behaves like <code class="highlighter-rouge">{% raw %}</code></a>, so you can no longer use <code class="highlighter-rouge">include</code> tags within.</li>
501
+ <li>We dropped support for Pygments, RedCarpet and rdiscount.</li>
502
+ <li>We bumped kramdown to v2.</li>
503
+ </ol>
504
+
505
+ <p>If you’re a plugin developer, we still need your feedback! Your plugin may not work with version 4 and we’d like to fix those issues before we release.</p>
506
+
507
+ <p>Checkout the complete <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0.pre.beta1">changelog</a> for more details.</p>
508
+
509
+ <p>To test this pre version run:</p>
510
+
511
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install </span>jekyll <span class="nt">--pre</span>
512
+ </code></pre></div></div>
513
+
514
+ <p>Please test this version thoroughly and file bugs as you encounter them.</p>
515
+
516
+ <p>Thanks to our dear contributors for helping making Jekyll better:</p>
517
+
518
+ <p>Aidan Fitzgerald, Akshat Kedia, Alex Wood, Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez, Ananthakumar, Andreas Möller, Andrew Lyndem, Andy Alt, Anne Gentle, Anny, Arjun Thakur, Arthur Attwell, Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Christian Oliff, Damien Solodow, Dan Allen, Dan Friedman, Daniel Höpfl, David J. Malan, Denis McDonald, Derek Smart, Derpy, Dusty Candland, ExE Boss, Frank Taillandier, Gareth Cooper, Grzegorz Kaczorek, Isaac Goodman, Jacob Byers, Jakob Krigovsky, Jan Pobořil, Joe Shannon, Jordan Morgan, Jorie Tappa, Josue Caraballo, Justin Vallelonga, Jörg Steinsträter, Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, Kyle Barbour, Lars Kanis, Leandro Facchinetti, Luis Enrique Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, Manu Mathew, Mario, Martin Scharm, Matt Massicotte, Matthew Rathbone, Maxwell Gerber, Mertcan Yücel, Michael Hiiva, Mike Kasberg, Mike Neumegen, Monica Powell, Nicolas Hoizey, Nikhil Swaminathan, Nikita Skalkin, Olivia Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer, Stephen Weiss, Steven Westmoreland, Sundaram Kalyan Vedala, Thanos Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev, Vitor Oliveira, Wouter Schoot, XhmikosR, Zhang Xiangze, _94gsc, argv-minus-one, chrisfinazzo, ikeji, jess, jpasholk, makmm, mo khan, ninevra, penguinpet, 김정환, 104fps</p>
519
+
520
+ <p>Happy Jekylling everyone!</p>
521
+
522
+ </div>
523
+ </article>
524
+
525
+
269
526
  <article>
270
527
  <h2>
271
528
  <a href="/news/2019/07/02/jekyll-3-8-6-released/">
@@ -306,6 +563,248 @@ and a handful of bug patches, including:</p>
306
563
  </article>
307
564
 
308
565
 
566
+ <article>
567
+ <h2>
568
+ <a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">
569
+ Jekyll 4.0.0.pre.alpha1 Released
570
+ </a>
571
+ </h2>
572
+ <span class="post-category">
573
+ <span class="label">
574
+ release
575
+ </span>
576
+ </span>
577
+ <div class="post-meta">
578
+ <span class="post-date">
579
+ 18 Mar 2019
580
+ </span>
581
+
582
+ <a href="https://github.com/dirtyf" class="post-author">
583
+ <img class="avatar avatar-small" alt="dirtyf" width="24" height="24" data-proofer-ignore="true" src="https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=24" srcset="https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=96 4x">
584
+ dirtyf
585
+ </a>
586
+ </div>
587
+ <div class="post-content">
588
+ <p>Dear Jekyllers,</p>
589
+
590
+ <p>Time has come to release a first alpha for Jekyll 4!</p>
591
+
592
+ <p>This pre version fixes many bugs, and should improve your build times. Some of you already shared <a href="https://forestry.io/blog/how-i-reduced-my-jekyll-build-time-by-61/">really</a> <a href="https://boris.schapira.dev/2018/11/jekyll-build-optimization/">good</a> results. We hope your Jekyll sites will also benefit from these optimizations.</p>
593
+
594
+ <p>If you’re a plugin developer, we definitely need your feedback, especially if your plugin does not work with v4.</p>
595
+
596
+ <p>Jekyll now exposes a <a href="/tutorials/cache-api/">caching API</a>, that some plugins could benefit from.</p>
597
+
598
+ <p>Also be aware that it’s a new <em>major</em> version, and it comes with a few breaking changes, notably :</p>
599
+
600
+ <ol>
601
+ <li>We dropped support for <a href="https://www.ruby-lang.org/en/downloads/">Ruby 2.3 who goes EOL at the end of the month</a>.
602
+ GitHub Pages runs Ruby 2.5.x, services like Netlify or Forestry already upgraded to latest Ruby 2.6.x.</li>
603
+ <li>
604
+ <code class="highlighter-rouge">link</code> tag now include <code class="highlighter-rouge">relative_url</code> filter, hurray <a href="https://github.com/jekyll/jekyll/pull/6727">no more need to prepend <code class="highlighter-rouge">{{ site.baseurl }}</code> </a>.</li>
605
+ <li>
606
+ <a href="https://github.com/jekyll/jekyll/pull/6821"><code class="highlighter-rouge">{% highlight %}</code> now behaves like <code class="highlighter-rouge">{% raw %}</code></a>, so you can no longer use <code class="highlighter-rouge">include</code> tags within.</li>
607
+ <li>We dropped support for Pygments, RedCarpet and rdiscount.</li>
608
+ <li>We bumped kramdown to v2.</li>
609
+ </ol>
610
+
611
+ <p>Checkout the complete <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0.pre.alpha1">changelog</a> for more details.</p>
612
+
613
+ <p>To test this pre version run:</p>
614
+
615
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install </span>jekyll <span class="nt">--pre</span>
616
+ </code></pre></div></div>
617
+
618
+ <p>Please test this version thoroughly and file bugs as you encounter them.</p>
619
+
620
+ <p>Thanks to our dear contributors for helping making Jekyll better:</p>
621
+
622
+ <p>Aidan Fitzgerald, Akshat Kedia, Alex Wood, Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez, Ananthakumar, Andreas Möller, Andrew Lyndem, Andy Alt, Anne Gentle, Anny, Arjun Thakur, Arthur Attwell, Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Christian Oliff, Damien Solodow, Dan Allen, Dan Friedman, Daniel Höpfl, David J. Malan, Denis McDonald, Derek Smart, Derpy, Dusty Candland, ExE Boss, Frank Taillandier, Gareth Cooper, Grzegorz Kaczorek, Isaac Goodman, Jacob Byers, Jakob Krigovsky, Jan Pobořil, Joe Shannon, Jordan Morgan, Jorie Tappa, Josue Caraballo, Justin Vallelonga, Jörg Steinsträter, Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, Kyle Barbour, Lars Kanis, Leandro Facchinetti, Luis Enrique Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, Manu Mathew, Mario, Martin Scharm, Matt Massicotte, Matthew Rathbone, Maxwell Gerber, Mertcan Yücel, Michael Hiiva, Mike Kasberg, Mike Neumegen, Monica Powell, Nicolas Hoizey, Nikhil Swaminathan, Nikita Skalkin, Olivia Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer, Stephen Weiss, Steven Westmoreland, Sundaram Kalyan Vedala, Thanos Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev, Vitor Oliveira, Wouter Schoot, XhmikosR, Zhang Xiangze, _94gsc, argv-minus-one, chrisfinazzo, ikeji, jess, jpasholk, makmm, mo khan, ninevra, penguinpet, 김정환, 104fps</p>
623
+
624
+ <p>Happy Jekylling everyone!</p>
625
+
626
+ </div>
627
+ </article>
628
+
629
+
630
+ <article>
631
+ <h2>
632
+ <a href="/news/2018/11/04/jekyll-3-8-5-released/">
633
+ Jekyll 3.8.5 Released
634
+ </a>
635
+ </h2>
636
+ <span class="post-category">
637
+ <span class="label">
638
+ release
639
+ </span>
640
+ </span>
641
+ <div class="post-meta">
642
+ <span class="post-date">
643
+ 04 Nov 2018
644
+ </span>
645
+
646
+ <a href="https://github.com/oe" class="post-author">
647
+ <img class="avatar avatar-small" alt="oe" width="24" height="24" data-proofer-ignore="true" src="https://avatars2.githubusercontent.com/oe?v=3&amp;s=24" srcset="https://avatars2.githubusercontent.com/oe?v=3&amp;s=24 1x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=48 2x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=72 3x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=96 4x">
648
+ oe
649
+ </a>
650
+ </div>
651
+ <div class="post-content">
652
+ <p>This release fixes a bug where multiple Liquid tags were not supported in
653
+ excerpts.</p>
654
+
655
+ <p>Thanks to <a href="https://github.com/ashmaroli" class="user-mention">@ashmaroli</a> for fixing this issue in <a href="https://github.com/jekyll/jekyll/pull/7250">#7250</a>.</p>
656
+
657
+ <p>Happy Jekylling!</p>
658
+
659
+
660
+ </div>
661
+ </article>
662
+
663
+
664
+ <article>
665
+ <h2>
666
+ <a href="/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/">
667
+ Security Fixes for series 3.6, 3.7 and 3.8
668
+ </a>
669
+ </h2>
670
+ <span class="post-category">
671
+ <span class="label">
672
+ release
673
+ </span>
674
+ </span>
675
+ <div class="post-meta">
676
+ <span class="post-date">
677
+ 19 Sep 2018
678
+ </span>
679
+
680
+ <a href="https://github.com/ashmaroli" class="post-author">
681
+ <img class="avatar avatar-small" alt="ashmaroli" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24" srcset="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=96 4x">
682
+ ashmaroli
683
+ </a>
684
+ </div>
685
+ <div class="post-content">
686
+ <p>Hi Jekyllers,</p>
687
+
688
+ <p>We have patched a <strong>critical vulnerability</strong> reported to GitHub a couple of weeks ago and have released a set of new gems to
689
+ bring that patch to you. The vulnerability allowed arbitrary file reads with the cunning use of the <code class="highlighter-rouge">include:</code> setting in the
690
+ config file.</p>
691
+
692
+ <p>By simply including a symlink in the <code class="highlighter-rouge">include</code> array allowed the symlinked file to be read into the build when they shouldn’t
693
+ actually be read in any circumstance.  
694
+ Further details regarding the patch can be viewed at the <a href="https://github.com/jekyll/jekyll/pull/7224">pull request URL</a></p>
695
+
696
+ <p>The patch has been released as versions <code class="highlighter-rouge">3.6.3</code>, <code class="highlighter-rouge">3.7.4</code> and <code class="highlighter-rouge">3.8.4</code>.  
697
+ Thanks to <a href="https://github.com/parkr" class="user-mention">@parkr</a> <code class="highlighter-rouge">v3.7.4</code> was released a couple of weeks prior and has been bundled with <code class="highlighter-rouge">github-pages-v192</code>.</p>
698
+
699
+ <p>Please keep in mind that this issue affects <em>all previously released Jekyll versions</em>. If you have not had
700
+ a good reason to upgrade to <code class="highlighter-rouge">3.6</code>, <code class="highlighter-rouge">3.7</code> or <code class="highlighter-rouge">3.8</code> yet, we advise that you do so at the earliest.</p>
701
+
702
+ <p>As always, Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
703
+
704
+ </div>
705
+ </article>
706
+
707
+
708
+ <article>
709
+ <h2>
710
+ <a href="/news/2018/08/01/jekyll-sponsoring/">
711
+ Sponsoring Jekyll's development
712
+ </a>
713
+ </h2>
714
+ <span class="post-category">
715
+ <span class="label">
716
+ community
717
+ </span>
718
+ </span>
719
+ <div class="post-meta">
720
+ <span class="post-date">
721
+ 01 Aug 2018
722
+ </span>
723
+
724
+ <a href="https://github.com/oe" class="post-author">
725
+ <img class="avatar avatar-small" alt="oe" width="24" height="24" data-proofer-ignore="true" src="https://avatars2.githubusercontent.com/oe?v=3&amp;s=24" srcset="https://avatars2.githubusercontent.com/oe?v=3&amp;s=24 1x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=48 2x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=72 3x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=96 4x">
726
+ oe
727
+ </a>
728
+ </div>
729
+ <div class="post-content">
730
+ <p><em>(TL;DR: We’re open for sponsorships on our <a href="https://opencollective.com/jekyll">OpenCollective page</a>)</em></p>
731
+
732
+ <p>Hi Jekyllers,</p>
733
+
734
+ <p>As you may know, Jekyll is a completely free and open source project. We offer
735
+ our software and its related plugins and documentation at no cost because we
736
+ believe that good software should not cost anything. We’re not planning on
737
+ changing that, but today I want to talk about a different monetary aspect of
738
+ open source.</p>
739
+
740
+ <p>Open source developers being paid for the work they do is a rare sight. Most
741
+ open source software is effectively the result of hundreds and thousands of
742
+ hours of free labor provided by individuals who are passionate enough to work
743
+ outside of their day job to create software that, ironically, is being used by
744
+ almost every company that offers digital services. It’s a problem that has
745
+ gotten more attention in recent years, with the open source community becoming
746
+ more diverse and more and more companies actively investing in providing
747
+ monetary support for open source developers.</p>
748
+
749
+ <p>Jekyll has always been a product of volunteers. Rarely has someone been paid to
750
+ implement a certain plugin or feature. Today, we’re excited to announce that we
751
+ will finally be able to fund our contributors! <strong>We are opening an
752
+ OpenCollective to receive individual and corporate sponsorships</strong>.
753
+ This is not unheard of, <a href="http://gohugo.io">Hugo</a> is also funded by sponsorships,
754
+ as are many other similar projects, such as
755
+ <a href="https://opencollective.com/webpack">webpack</a>,
756
+ <a href="https://opencollective.com/babel">Babel</a> or
757
+ <a href="https://opencollective.com/rubocop">RuboCop</a>.</p>
758
+
759
+ <p>OpenCollective is a service that makes it easy for open source projects to
760
+ receive funding from individuals and companies alike. It’s specifically designed
761
+ for open source and many other projects already use it for funding.</p>
762
+
763
+ <p>Sponsoring is, for us, a method to finally realize some of the more ambitious
764
+ goals we’ve had with the project for years. The closest thing we want to realize
765
+ is to <strong>release Jekyll 4.0, and to make it as polished as we can</strong>. In the
766
+ future, we would also like to work on other things that will improve the Jekyll
767
+ ecosystem. Here’s a couple of ideas:</p>
768
+
769
+ <ul>
770
+ <li>Create a comprehensive official plugin and theme directory site</li>
771
+ <li>Improve tooling built around measuring and improving Jekyll’s performance</li>
772
+ <li>Improve maintenance for official plugins</li>
773
+ <li>Including the community into official decisions; making Jekyll more friendly to folks in the community</li>
774
+ </ul>
775
+
776
+ <p>Again, these are just some ideas, but with the help of sponsoring, they are now
777
+ one step closer to being realized <img class="emoji" title=":heart:" alt=":heart:" src="https://github.githubassets.com/images/icons/emoji/unicode/2764.png" height="20" width="20"></p>
778
+
779
+ <div align="center" style="background-color: white;padding: 1em;">
780
+ <a href="https://forestry/io"><img src="/img/forestry-logo.svg" alt="Forestry"></a>
781
+ </div>
782
+
783
+ <p>With that, we would like to announce our very first sponsor:
784
+ <a href="https://forestry.io"><strong>Forestry.io</strong></a>!
785
+ Forestry is a CMS that integrates with your Jekyll sites and lets you update
786
+ content using a beautiful interface, and then automatically commits it back to
787
+ your GitHub repository. We’re excited to have them on board on a new, exciting
788
+ step of our journey.</p>
789
+
790
+ <p>Will anything change for Jekyll users? The answer is no - this step does not
791
+ impact the Jekyll software in any aspect. In fact, you might see positive
792
+ changes, such as more features and better performance. Surprisingly, that’s what
793
+ happens when you properly fund people for their work!</p>
794
+
795
+ <p>If you have been a long time user for Jekyll and would like to give something
796
+ back to the project, you can consider a small monthly donation to our
797
+ <a href="http://opencollective.com/jekyll">OpenCollective page</a>. If your company heavily
798
+ relies on Jekyll, do consider sponsoring us!</p>
799
+
800
+ <p>Contact <a href="mailto:matt@jekyllrb.com">matt@jekyllrb.com</a> and we’ll figure something out together.</p>
801
+
802
+ <p>Thanks for sticking with us, and happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
803
+
804
+ </div>
805
+ </article>
806
+
807
+
309
808
  <article>
310
809
  <h2>
311
810
  <a href="/news/2018/06/05/jekyll-3-8-3-released/">
@@ -328,11 +827,11 @@ and a handful of bug patches, including:</p>
328
827
  </a>
329
828
  </div>
330
829
  <div class="post-content">
331
- <p>This release fixes a regression in 3.8 where collections with <code class="language-plaintext highlighter-rouge">published: false</code>
332
- do not show when using the <code class="language-plaintext highlighter-rouge">--unpublished</code> flag.</p>
830
+ <p>This release fixes a regression in 3.8 where collections with <code class="highlighter-rouge">published: false</code>
831
+ do not show when using the <code class="highlighter-rouge">--unpublished</code> flag.</p>
333
832
 
334
833
  <p>Thanks to <a href="https://github.com/philipbelesky" class="user-mention">@philipbelesky</a> for reporting and fixing this issue; collections with
335
- <code class="language-plaintext highlighter-rouge">published: false</code> now behave the same way as Posts.</p>
834
+ <code class="highlighter-rouge">published: false</code> now behave the same way as Posts.</p>
336
835
 
337
836
  </div>
338
837
  </article>
@@ -362,7 +861,7 @@ do not show when using the <code class="language-plaintext highlighter-rouge">--
362
861
  <div class="post-content">
363
862
  <p>Hello Jekyllers!!</p>
364
863
 
365
- <p>Today we are releasing <code class="language-plaintext highlighter-rouge">v3.8.2</code>, which fixes the way Jekyll generates excerpts
864
+ <p>Today we are releasing <code class="highlighter-rouge">v3.8.2</code>, which fixes the way Jekyll generates excerpts
366
865
  for posts when the first paragraph of the post contains Liquid tags that take
367
866
  advantage of <a href="https://shopify.github.io/liquid/basics/whitespace/">Liquid’s whitespace control feature</a>.</p>
368
867
 
@@ -399,8 +898,8 @@ the latest version of Rubocop to lint our code.</p>
399
898
  <div class="post-content">
400
899
  <p>Happy May Day <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
401
900
 
402
- <p>The Jekyll team is happy to announce the release of <code class="language-plaintext highlighter-rouge">v3.8.1</code>, which fixes
403
- a couple of bugs that were introduced two weeks ago in <code class="language-plaintext highlighter-rouge">v3.8.0</code>. If you have
901
+ <p>The Jekyll team is happy to announce the release of <code class="highlighter-rouge">v3.8.1</code>, which fixes
902
+ a couple of bugs that were introduced two weeks ago in <code class="highlighter-rouge">v3.8.0</code>. If you have
404
903
  experienced trouble regarding post excerpts or non-published posts, this release
405
904
  should be the remedy. Thanks to <a href="https://github.com/Chaosed0" class="user-mention">@Chaosed0</a> and <a href="https://github.com/domLocalHeroes" class="user-mention">@domLocalHeroes</a> for originally
406
905
  reporting these issues, and to <a href="https://github.com/ashmaroli" class="user-mention">@ashmaroli</a> for fixing them so quickly.</p>
@@ -414,6 +913,124 @@ list</a>.</p>
414
913
  </article>
415
914
 
416
915
 
916
+ <article>
917
+ <h2>
918
+ <a href="/news/2018/04/19/development-update/">
919
+ Jekyll 4.0 is on the Horizon!
920
+ </a>
921
+ </h2>
922
+ <span class="post-category">
923
+ <span class="label">
924
+ community
925
+ </span>
926
+ </span>
927
+ <div class="post-meta">
928
+ <span class="post-date">
929
+ 19 Apr 2018
930
+ </span>
931
+
932
+ <a href="https://github.com/oe" class="post-author">
933
+ <img class="avatar avatar-small" alt="oe" width="24" height="24" data-proofer-ignore="true" src="https://avatars2.githubusercontent.com/oe?v=3&amp;s=24" srcset="https://avatars2.githubusercontent.com/oe?v=3&amp;s=24 1x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=48 2x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=72 3x, https://avatars2.githubusercontent.com/oe?v=3&amp;s=96 4x">
934
+ oe
935
+ </a>
936
+ </div>
937
+ <div class="post-content">
938
+ <p>With the release of Jekyll 3.8.0, it’s been 2 and a half years since the last major release. Jekyll 3.0.0 was released in late October of 2015! That’s a long time ago, and we’ve been working towards the next major release of Jekyll for a couple of months now. Here’s a small preview of what’s to come:</p>
939
+
940
+ <ul>
941
+ <li>Dropping support for Ruby 2.1 and 2.2. Both versions have reached their EOL period.</li>
942
+ <li>Dropping Pygments as a dependency. We’re already defaulting to Rouge, and this removes the implicit Python dependency. (finally!)</li>
943
+ <li>Making the <code class="highlighter-rouge">link</code> tag use relative URLs. This is a big breaking change, but it’s the cleaner solution.</li>
944
+ </ul>
945
+
946
+ <p>We’re open to more ideas, though. If the development cost isn’t too high, or if someone volunteers to take care of the implementation, it’s likely that your suggestion might make it into Jekyll 4.0. Head over to this <a href="https://github.com/jekyll/jekyll/issues/6948">issue</a> for more details. Some interesting topics might be improving Internationalization support in Jekyll, creating convenience Liquid tags, et cetera.</p>
947
+
948
+ <p>That being said, the development period of version 4.0 begins <em>now</em>. This means a couple of things:</p>
949
+
950
+ <ul>
951
+ <li>New features will only be implemented in Jekyll 4.0. There will be no 3.9.0 or the like.</li>
952
+ <li>Same with bug fixes, unless they concern something introduced in Jekyll 3.7 or 3.8, in which case we will backport the fixes and release a patch version.</li>
953
+ <li>Now is a great time to finally take on the feature you’ve wanted to see in Jekyll for ages! Just open an issue or experiment with the code to get going!</li>
954
+ </ul>
955
+
956
+ <p>As for a release date, we’re currently aiming for late summer, around September or so. However, keep in mind that this project is purely volunteer-run, and as such, delays might occur and we might not hit that release date.</p>
957
+
958
+ <p>Finally, this is a great time for newcomers to open-source to make their first contribution. We’ll be doing our best to mark recommended contributions and create newcomer-friendly issues, as well as to provide mentoring throughout the contribution process (although we’d like to think that we’re already pretty proficient at that). So if you’ve always been hestitant about contributing to a large open-source project, Jekyll is a good place to start!</p>
959
+
960
+ <p>Happy Jekylling! <img class="emoji" title=":wave:" alt=":wave:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f44b.png" height="20" width="20"></p>
961
+
962
+
963
+ </div>
964
+ </article>
965
+
966
+
967
+ <article>
968
+ <h2>
969
+ <a href="/news/2018/04/19/jekyll-3-8-0-released/">
970
+ Jekyll 3.8.0 Released
971
+ </a>
972
+ </h2>
973
+ <span class="post-category">
974
+ <span class="label">
975
+ release
976
+ </span>
977
+ </span>
978
+ <div class="post-meta">
979
+ <span class="post-date">
980
+ 19 Apr 2018
981
+ </span>
982
+
983
+ <a href="https://github.com/ashmaroli" class="post-author">
984
+ <img class="avatar avatar-small" alt="ashmaroli" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24" srcset="https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/ashmaroli?v=3&amp;s=96 4x">
985
+ ashmaroli
986
+ </a>
987
+ </div>
988
+ <div class="post-content">
989
+ <p>Aloha Jekyllers!! <img class="emoji" title=":wave:" alt=":wave:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f44b.png" height="20" width="20"></p>
990
+
991
+ <p>After months of toiling on the codebase and shipping a couple of release-candidates, the Jekyll Team is delighted to finally
992
+ present <code class="highlighter-rouge">v3.8.0</code>, packed with optimizations, improvements, some new features and a couple of bug-fixes. Yay!!!</p>
993
+
994
+ <p>Under the hood, Jekyll has undergone many minor changes that will allow it to run more performantly in the coming years. <img class="emoji" title=":smiley:" alt=":smiley:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f603.png" height="20" width="20">
995
+ Rest assured, our users should see minor improvements in their site’s build times.</p>
996
+
997
+ <p>Speaking of improvements, users running a site containing a huge amount of posts or those who like to use our <code class="highlighter-rouge">where</code> filter
998
+ frequently in a single template, are going to see a massive reduction in their total build times!! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
999
+
1000
+ <p>Hold on, this version is not just about optimizations, there are some new features as well..:</p>
1001
+ <ul>
1002
+ <li>Detect non-existent variables and filters specified in a template by enabling <code class="highlighter-rouge">strict_variables</code> and <code class="highlighter-rouge">strict_filters</code> under the
1003
+ <code class="highlighter-rouge">liquid</code> key in your config file.</li>
1004
+ <li>Allow <em>date filters</em> to output ordinal days.</li>
1005
+ <li>
1006
+ <code class="highlighter-rouge">jekyll doctor</code> now warns you if you have opted for custom <code class="highlighter-rouge">collections_dir</code> but placed <code class="highlighter-rouge">_posts</code> directory outside that
1007
+ directory.</li>
1008
+ </ul>
1009
+
1010
+ <p>..and yes, a couple of bug-fixes, notably:</p>
1011
+ <ul>
1012
+ <li>Jekyll now handles future-dated documents properly.</li>
1013
+ <li>Jekyll is able to handle Liquid blocks intelligently in excerpts.</li>
1014
+ <li>A few methods that were <em>not meant to be publically accessible</em> have been entombed properly.</li>
1015
+ <li>A few bugs that still plagued our <code class="highlighter-rouge">collections_dir</code> feature from <code class="highlighter-rouge">v3.7</code> got crushed.</li>
1016
+ </ul>
1017
+
1018
+ <p>As always, the full list of changes since last release can be viewed <a href="/docs/history/#v3-8-0">here</a>.</p>
1019
+
1020
+ <p>A big thanks to the following people who contributed to our repository with pull-requests that improved our codebase, documentation
1021
+ and tests:</p>
1022
+
1023
+ <p>Ana María Martínez Gómez, Antonio Argote, Ashwin Maroli, Awjin Ahn, Ben Balter, Benjamin Høegh, Christian Oliff, Damien Solodow,
1024
+ David Zhang, Delson Lima, Eric Cornelissen, Florian Thomas, Frank Taillandier, Heinrich Hartmann, Jakob Vad Nielsen, John Eismeier,
1025
+ Kacper Duras, KajMagnus, Mario Cekic, Max Vilimpoc, Michael H, Mike Kasberg, Parker Moore, Pat Hawks, Paweł Kuna, Robert Riemann,
1026
+ Roger Rohrbach, Semen Zhydenko, Stefan Dellmuth, Tim Carry, olivia, and steelman.</p>
1027
+
1028
+ <p>Happy Jekylling!! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
1029
+
1030
+ </div>
1031
+ </article>
1032
+
1033
+
417
1034
  <article>
418
1035
  <h2>
419
1036
  <a href="/news/2018/02/24/jekyll-3-7-3-released/">
@@ -438,13 +1055,13 @@ list</a>.</p>
438
1055
  <div class="post-content">
439
1056
  <p>Hello Jekyllers!! <img class="emoji" title=":wave:" alt=":wave:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f44b.png" height="20" width="20"></p>
440
1057
 
441
- <p>We’re pleased to announce the release of <code class="language-plaintext highlighter-rouge">v3.7.3</code> which fixes a bug one might encounter while using <code class="language-plaintext highlighter-rouge">Jekyll - 3.7.x</code> along with a
442
- Jekyll plugin that in turn uses the <code class="language-plaintext highlighter-rouge">I18n</code> library.</p>
1058
+ <p>We’re pleased to announce the release of <code class="highlighter-rouge">v3.7.3</code> which fixes a bug one might encounter while using <code class="highlighter-rouge">Jekyll - 3.7.x</code> along with a
1059
+ Jekyll plugin that in turn uses the <code class="highlighter-rouge">I18n</code> library.</p>
443
1060
 
444
- <p>When <a href="/news/2018/01/02/jekyll-3-7-0-released/">v3.7.0</a> enhanced our <code class="language-plaintext highlighter-rouge">slugify</code> filter with a <code class="language-plaintext highlighter-rouge">latin</code> option, we also
445
- hardcoded a default fallback locale for the <code class="language-plaintext highlighter-rouge">I18n</code> library to avoid an exception raised in the event the library fails to find
1061
+ <p>When <a href="/news/2018/01/02/jekyll-3-7-0-released/">v3.7.0</a> enhanced our <code class="highlighter-rouge">slugify</code> filter with a <code class="highlighter-rouge">latin</code> option, we also
1062
+ hardcoded a default fallback locale for the <code class="highlighter-rouge">I18n</code> library to avoid an exception raised in the event the library fails to find
446
1063
  any locale. This led to issues with third-party i18n plugins for Jekyll, especially since the default locale got assigned before
447
- the plugin was loaded, irrespective of whether the <code class="language-plaintext highlighter-rouge">slugify</code> filter was used.</p>
1064
+ the plugin was loaded, irrespective of whether the <code class="highlighter-rouge">slugify</code> filter was used.</p>
448
1065
 
449
1066
  <p>Jekyll will henceforth set the default locale if and only if necessary.</p>
450
1067
 
@@ -540,23 +1157,23 @@ lead Jekyll to even greater heights.</p>
540
1157
  regressions due to the changes made in that release. In due time, Team Jekyll
541
1158
  set out to address those issues as early as possible.</p>
542
1159
 
543
- <p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
1160
+ <p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
544
1161
  RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20">
545
1162
  The highlights being:</p>
546
1163
 
547
1164
  <ul>
548
1165
  <li>
549
1166
  <p>A major regression in 3.7.0 was that when a Front Matter Default was
550
- configured with a <code class="language-plaintext highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
1167
+ configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
551
1168
  that directory for any subfolders and files, for each document in that
552
- <code class="language-plaintext highlighter-rouge">path</code>.
1169
+ <code class="highlighter-rouge">path</code>.
553
1170
  Though this is intended, it increases build times in proportion to the size
554
1171
  of the directory.</p>
555
1172
 
556
1173
  <p>We addressed this by having Jekyll scan the directory path only if the user
557
- explicitly configures the <code class="language-plaintext highlighter-rouge">scope["path"]</code> using wildcards.</p>
1174
+ explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
558
1175
 
559
- <p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
1176
+ <p>Read our <a href="/docs/configuration/front-matter-defaults/#glob-patterns-in-front-matter-defaults">documentation</a>
560
1177
  for more details.</p>
561
1178
 
562
1179
  <p>A huge shout-out to <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> for bringing this to our notice and
@@ -566,7 +1183,7 @@ additionally providing us with a test repository to aid in resolving the issue.<
566
1183
  <p>Another regression reported was related to our “Custom collections
567
1184
  directory” feature introduced in 3.7.0.</p>
568
1185
 
569
- <p>Users setting <code class="language-plaintext highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
1186
+ <p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
570
1187
  paths to their posts still at the root of their site’s source. This
571
1188
  roughly translated to 404 errors on URLs to their posts.</p>
572
1189
 
@@ -574,16 +1191,16 @@ roughly translated to 404 errors on URLs to their posts.</p>
574
1191
 
575
1192
  <p>We decided to resolve this by having Jekyll ignore posts and drafts at the
576
1193
  root of the site’s source directory if the user customizes the
577
- <code class="language-plaintext highlighter-rouge">collection_dir</code> setting.</p>
1194
+ <code class="highlighter-rouge">collection_dir</code> setting.</p>
578
1195
 
579
1196
  <p>Ergo, if you set a custom location for your collections, please ensure you
580
1197
  move all of your collections into that directory. <strong>This includes posts and
581
1198
  drafts as well</strong>. Your links generated by
582
- <code class="language-plaintext highlighter-rouge">{% post_url %}</code> or <code class="language-plaintext highlighter-rouge">{% link %}</code>
1199
+ <code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
583
1200
  will adapt automatically.</p>
584
1201
  </li>
585
1202
  <li>
586
- <p>We also found out that <code class="language-plaintext highlighter-rouge">gem "wdm"</code> boosts performance while directories are
1203
+ <p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
587
1204
  being watched on Windows. So we recommend having it included in your Gemfile
588
1205
  for a better development experience on Windows. (Newly generated Gemfiles
589
1206
  will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f609.png" height="20" width="20">)</p>
@@ -632,11 +1249,11 @@ Paul Robert Lloyd.</p>
632
1249
  Here are a few of the latest additions from our contributors:</p>
633
1250
 
634
1251
  <ul>
635
- <li>LiveReload is available as an option during development: with <code class="language-plaintext highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
636
- <li>New <code class="language-plaintext highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
637
- <li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="language-plaintext highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
1252
+ <li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
1253
+ <li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
1254
+ <li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
638
1255
  <li>Jekyll will now check to determine whether host machine has internet connection.</li>
639
- <li>A new <code class="language-plaintext highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
1256
+ <li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/liquid/filters/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
640
1257
  <li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
641
1258
  <li>
642
1259
  <a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
@@ -689,7 +1306,7 @@ Here are a few of the latest additions from our contributors:</p>
689
1306
  </a>
690
1307
  </div>
691
1308
  <div class="post-content">
692
- <p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="language-plaintext highlighter-rouge">bundle update</code>
1309
+ <p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="highlighter-rouge">bundle update</code>
693
1310
  if you want to avoid possible build problems with:</p>
694
1311
 
695
1312
  <ul>
@@ -697,7 +1314,7 @@ if you want to avoid possible build problems with:</p>
697
1314
  <li>fully numeric layout names (we convert those to string for you now).</li>
698
1315
  </ul>
699
1316
 
700
- <p>Other changes include updates to our documentation, like this <a href="../tutorials/video-walkthroughs/">complete
1317
+ <p>Other changes include updates to our documentation, like this <a href="/tutorials/video-walkthroughs/">complete
701
1318
  video series by Giraffe Academy</a> aimed at
702
1319
  complete beginners. A big thanks to Mike for this.</p>
703
1320
 
@@ -709,7 +1326,7 @@ working on the next minor version 3.7.0 that will allow you to store all your
709
1326
  collections in a single directory. Stay tuned.</p>
710
1327
 
711
1328
  <p>Theme developers are invited to test the brand new
712
- <a href="https://github.com/benbalter/jekyll-remote-theme"><code class="language-plaintext highlighter-rouge">jekyll-remote-theme</code></a> plugin
1329
+ <a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
713
1330
  and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
714
1331
  GitHub hosted theme as a remote theme!</p>
715
1332
 
@@ -771,7 +1388,7 @@ today.</p>
771
1388
 
772
1389
  <h2 id="create-newcomer-friendly-issues">Create newcomer-friendly issues</h2>
773
1390
 
774
- <p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="language-plaintext highlighter-rouge">first timers only</code> issues:</p>
1391
+ <p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="highlighter-rouge">first timers only</code> issues:</p>
775
1392
 
776
1393
  <ul>
777
1394
  <li><a href="https://github.com/jekyll/jekyll/issues/6437">Issue #6437</a></li>
@@ -779,7 +1396,7 @@ today.</p>
779
1396
  <li><a href="https://github.com/jekyll/jekyll/issues/6439">Issue #6439</a></li>
780
1397
  </ul>
781
1398
 
782
- <p>(There’s also an up-to-date listing of all of our <code class="language-plaintext highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
1399
+ <p>(There’s also an up-to-date listing of all of our <code class="highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
783
1400
 
784
1401
  <p>These issues are designed to be taken on only by someone who has had little to no exposure to contributing to open source before, and additionally, project maintainers offer support in case a question arises.</p>
785
1402
 
@@ -819,7 +1436,7 @@ today.</p>
819
1436
  <div class="post-content">
820
1437
  <p>Another much-anticipated release of Jekyll. This release comes with it Rouge 2 support, but note you can continue to use Rouge 1 if you’d prefer. We also now require Ruby 2.1.0 as 2.0.x is no longer supported by the Ruby team.</p>
821
1438
 
822
- <p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="language-plaintext highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
1439
+ <p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
823
1440
 
824
1441
  <p>Please let us know if you find any bugs! You can see <a href="/docs/history/#v3-6-0">the full history here</a>.</p>
825
1442
 
@@ -856,12 +1473,12 @@ today.</p>
856
1473
  <p>3.5.2 is out with 6 great bug fixes, most notably one which should dramatically speed up generation of your site! In testing #6266, jekyllrb.com generation when from 18 seconds down to 8! Here is the full line-up of fixes:</p>
857
1474
 
858
1475
  <ul>
859
- <li>Backport #6266 for v3.5.x: Memoize the return value of <code class="language-plaintext highlighter-rouge">Document#url</code> (#6301)</li>
1476
+ <li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
860
1477
  <li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
861
- <li>Backport #6281 for v3.5.x: Fix <code class="language-plaintext highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
862
- <li>Backport #6280 for v3.5.x: Guard against type error in <code class="language-plaintext highlighter-rouge">absolute_url</code> (#6287)</li>
863
- <li>Backport #6273 for v3.5.x: delegate <code class="language-plaintext highlighter-rouge">StaticFile#to_json</code> to <code class="language-plaintext highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
864
- <li>Backport #6226 for v3.5.x: <code class="language-plaintext highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
1478
+ <li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
1479
+ <li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
1480
+ <li>Backport #6273 for v3.5.x: delegate <code class="highlighter-rouge">StaticFile#to_json</code> to <code class="highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
1481
+ <li>Backport #6226 for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
865
1482
  </ul>
866
1483
 
867
1484
  <p>A <a href="/docs/history/#v3-5-2">full history</a> is available for your perusal. As always, please file bugs if you encounter them! Opening a pull request with a failing test for your expected behaviour is the easiest way for us to address the issue since we have a reproducible example to test again. Short of that, please fill out our issue template to the best of your ability and we’ll try to get to it quickly!</p>
@@ -900,8 +1517,8 @@ possible: Ben Balter &amp; Kyle Zhao.</p>
900
1517
  <p>We’ve released a few bugfixes in the form of v3.5.1 today:</p>
901
1518
 
902
1519
  <ul>
903
- <li>Some plugins stopped functioning properly due to a NoMethodError for <code class="language-plaintext highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
904
- <li>A bug in <code class="language-plaintext highlighter-rouge">relative_url</code> when <code class="language-plaintext highlighter-rouge">baseurl</code> is <code class="language-plaintext highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
1520
+ <li>Some plugins stopped functioning properly due to a NoMethodError for <code class="highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
1521
+ <li>A bug in <code class="highlighter-rouge">relative_url</code> when <code class="highlighter-rouge">baseurl</code> is <code class="highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
905
1522
  <li>Static files’ liquid representations should now have all the keys you were expecting when serialized into JSON.</li>
906
1523
  </ul>
907
1524
 
@@ -941,18 +1558,18 @@ possible: Ben Balter &amp; Kyle Zhao.</p>
941
1558
  the wild. Some new shiny things you might want to test out:</p>
942
1559
 
943
1560
  <ul>
944
- <li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="language-plaintext highlighter-rouge">concat</code> and <code class="language-plaintext highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
1561
+ <li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> and <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
945
1562
  </li>
946
1563
  <li>Themes can specify runtime dependencies (in their gemspecs) and we’ll require those. This makes it easier for theme writers to use plugins.</li>
947
1564
  <li>Speaking of themes, we’ll properly handle the discrepancy between a convertible file in the local site and a static file in the theme. Overriding a file locally now doesn’t matter if it’s convertible or static.</li>
948
- <li>Pages, posts, and other documents can now access layout variables via <code class="language-plaintext highlighter-rouge">{{ layout }}</code>.</li>
949
- <li>The <code class="language-plaintext highlighter-rouge">gems</code> key in the <code class="language-plaintext highlighter-rouge">_config.yml</code> is now <code class="language-plaintext highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="language-plaintext highlighter-rouge">gems</code> to <code class="language-plaintext highlighter-rouge">plugins</code> if you use the former.</li>
950
- <li>Filters like <code class="language-plaintext highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="language-plaintext highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
1565
+ <li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
1566
+ <li>The <code class="highlighter-rouge">gems</code> key in the <code class="highlighter-rouge">_config.yml</code> is now <code class="highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="highlighter-rouge">gems</code> to <code class="highlighter-rouge">plugins</code> if you use the former.</li>
1567
+ <li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
951
1568
  <li>You can now create tab-separated data files.</li>
952
- <li>Using <code class="language-plaintext highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="language-plaintext highlighter-rouge">layout: null</code>, with the exception that <code class="language-plaintext highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
1569
+ <li>Using <code class="highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="highlighter-rouge">layout: null</code>, with the exception that <code class="highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
953
1570
  <li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
954
- <li>We now automatically exclude the <code class="language-plaintext highlighter-rouge">Gemfile</code> from the site manifest when compiling your site. No more <code class="language-plaintext highlighter-rouge">_site/Gemfile</code>!</li>
955
- <li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="language-plaintext highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
1571
+ <li>We now automatically exclude the <code class="highlighter-rouge">Gemfile</code> from the site manifest when compiling your site. No more <code class="highlighter-rouge">_site/Gemfile</code>!</li>
1572
+ <li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
956
1573
  </ul>
957
1574
 
958
1575
  <p>And <a href="/docs/history/">so much more!</a></p>
@@ -999,26 +1616,26 @@ how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://git
999
1616
  <div class="post-content">
1000
1617
  <p>Another one-PR patch update as we continue our quest to destroy all bugs. A
1001
1618
  fairly technical debriefing follows, but the TLDR is that we have updated the
1002
- <code class="language-plaintext highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
1619
+ <code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
1003
1620
 
1004
1621
  <p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
1005
1622
  moved away from using the deprecated
1006
- <a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="language-plaintext highlighter-rouge">URI.escape</code></a>
1623
+ <a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="highlighter-rouge">URI.escape</code></a>
1007
1624
  in favor of
1008
- <a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code></a>.
1009
- This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="language-plaintext highlighter-rouge">uri_escape</code>
1625
+ <a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
1626
+ This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
1010
1627
  filter</a>.</p>
1011
1628
 
1012
1629
  <p>While this transition was mostly a smooth one, the two methods are not
1013
- identical. While <code class="language-plaintext highlighter-rouge">URI.escape</code> was happy to escape any string,
1014
- <code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code>
1630
+ identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
1631
+ <code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
1015
1632
  object, and will then escape each component of that object. In most cases, this
1016
1633
  difference was insignificant, but there were a few cases where this caused some
1017
1634
  unintended regressions when encoding colons.</p>
1018
1635
 
1019
- <p>While <strong>Addressable</strong> can understand that something like <code class="language-plaintext highlighter-rouge">"/example :page"</code> is a
1636
+ <p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
1020
1637
  relative URI, without the slash it cannot figure out how to turn
1021
- <code class="language-plaintext highlighter-rouge">"example :page"</code> into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code> object. <code class="language-plaintext highlighter-rouge">URI.escape</code> had no such
1638
+ <code class="highlighter-rouge">"example :page"</code> into an <code class="highlighter-rouge">Addressable::URI</code> object. <code class="highlighter-rouge">URI.escape</code> had no such
1022
1639
  objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
1023
1640
  but breaking in 3.4.0:</p>
1024
1641
 
@@ -1028,8 +1645,8 @@ but breaking in 3.4.0:</p>
1028
1645
  <p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
1029
1646
 
1030
1647
  <p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
1031
- <a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.normalize_component</code></a>
1032
- which will simply escape the characters in a string, much like <code class="language-plaintext highlighter-rouge">URI.escape</code>.</p>
1648
+ <a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
1649
+ which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
1033
1650
 
1034
1651
  <p>Thanks to <a href="https://github.com/cameronmcefee" class="user-mention">@cameronmcefee</a> and <a href="https://github.com/FriesFlorian" class="user-mention">@FriesFlorian</a> for reporting
1035
1652
  <a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
@@ -1069,21 +1686,21 @@ previous release</a>.</p>
1069
1686
  <strong>static files now respect front matter defaults</strong>.</p>
1070
1687
 
1071
1688
  <p>You might be asking yourself: “why would static files, files that are
1072
- static files explicitly because they <em>don’t</em> have YAML front matter, want
1073
- to respect YAML front matter?” That’s a great question. Let me illustrate
1689
+ static files explicitly because they <em>don’t</em> have front matter, want
1690
+ to respect front matter?” That’s a great question. Let me illustrate
1074
1691
  with an example.</p>
1075
1692
 
1076
- <p>Let’s look at <code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
1693
+ <p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
1077
1694
  pages, and static files, and some metadata for them in an XML file for a
1078
1695
  Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
1079
- file in this list, you set <code class="language-plaintext highlighter-rouge">sitemap: false</code> in the YAML front matter. But
1080
- what about static files, which don’t have YAML front matter? Before this
1696
+ file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in front matter. But
1697
+ what about static files, which don’t have front matter? Before this
1081
1698
  release, they could not be excluded because they had no properties in YAML
1082
1699
  other than <a href="https://github.com/jekyll/jekyll/blob/v3.4.1/lib/jekyll/static_file.rb#L98-L106">the ones we explicitly assigned</a>.
1083
1700
  So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
1084
- <code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>.</p>
1701
+ <code class="highlighter-rouge">jekyll-sitemap</code>.</p>
1085
1702
 
1086
- <p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
1703
+ <p>With this release, you can now set <a href="/docs/configuration/front-matter-defaults/">front matter
1087
1704
  defaults</a> for static files:</p>
1088
1705
 
1089
1706
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
@@ -1094,8 +1711,8 @@ defaults</a> for static files:</p>
1094
1711
  <span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
1095
1712
  </code></pre></div></div>
1096
1713
 
1097
- <p>Now, for every file in the Liquid <code class="language-plaintext highlighter-rouge">site.static_files</code> loop which is in the
1098
- folder <code class="language-plaintext highlighter-rouge">pdfs/</code>, you’ll see <code class="language-plaintext highlighter-rouge">sitemap</code> equal to <code class="language-plaintext highlighter-rouge">false</code>.</p>
1714
+ <p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
1715
+ folder <code class="highlighter-rouge">pdfs/</code>, you’ll see <code class="highlighter-rouge">sitemap</code> equal to <code class="highlighter-rouge">false</code>.</p>
1099
1716
 
1100
1717
  <p>Many thanks to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a> for coming up with the solution and ensuring
1101
1718
  sitemaps everywhere are filled with just the right content.</p>
@@ -1182,7 +1799,7 @@ well.</p>
1182
1799
 
1183
1800
  <p>Well, not so much.</p>
1184
1801
 
1185
- <p>A very common way to specify the month of February is <code class="language-plaintext highlighter-rouge">2</code>. This is true for
1802
+ <p>A very common way to specify the month of February is <code class="highlighter-rouge">2</code>. This is true for
1186
1803
  all single-digit months and days of the month. Notice anything about our
1187
1804
  first regular expression versus our second? The second regular expression
1188
1805
  imposes a <strong>minimum</strong>, as well as maximum, number of digits. This change
@@ -1256,10 +1873,10 @@ Packed full of bug fixes as usual, thanks to the tireless efforts of our
1256
1873
  exceptional Jekyll community. Three changes to call out:</p>
1257
1874
 
1258
1875
  <ol>
1259
- <li>If you’re a big fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">where_by_exp</code></a>, you’ll be an
1260
- even bigger fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">group_by_exp</code></a>.</li>
1876
+ <li>If you’re a big fan of <a href="/docs/liquid/filters/"><code class="highlighter-rouge">where_by_exp</code></a>, you’ll be an
1877
+ even bigger fan of <a href="/docs/liquid/filters/"><code class="highlighter-rouge">group_by_exp</code></a>.</li>
1261
1878
  <li>Using a custom timezone in Jekyll on Windows? Yeah, sorry that hasn’t ever worked
1262
- properly. We made it possible to accurately <a href="https://jekyllrb.com/docs/windows/#timezone-management">set the timezone using IANA
1879
+ properly. We made it possible to accurately <a href="/docs/installation/windows/#time-zone-management">set the timezone using IANA
1263
1880
  timezone codes</a>.</li>
1264
1881
  <li>Documentation has been improved, notably on themes, includes and permalinks.</li>
1265
1882
  </ol>
@@ -1319,7 +1936,7 @@ fixes to call out:</p>
1319
1936
 
1320
1937
  <ol>
1321
1938
  <li>Only warn about auto-regeneration issues on Windows instead of disabling</li>
1322
- <li>Exclude very specific <code class="language-plaintext highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="language-plaintext highlighter-rouge">vendor/</code>
1939
+ <li>Exclude very specific <code class="highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="highlighter-rouge">vendor/</code>
1323
1940
  </li>
1324
1941
  <li>Allow permalink templates to have plaintext underscores</li>
1325
1942
  </ol>
@@ -1357,66 +1974,66 @@ fixes to call out:</p>
1357
1974
  <p>There are tons of great new quality-of-life features you can use in 3.3.
1358
1975
  Three key things you might want to try:</p>
1359
1976
 
1360
- <h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static &amp; dynamic assets in an <code class="language-plaintext highlighter-rouge">/assets</code> directory</h3>
1977
+ <h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static &amp; dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
1361
1978
 
1362
1979
  <p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
1363
1980
  <a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
1364
1981
  layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
1365
1982
 
1366
1983
  <p>In an effort to make theme management a bit easier, any files you put into
1367
- <code class="language-plaintext highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
1984
+ <code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
1368
1985
  user’s site. This means you can ship SCSS and CoffeeScript, images and
1369
1986
  webfonts, and so on – anything you’d consider a part of the
1370
1987
  <em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
1371
- front matter, it will be converted and rendered. No YAML front matter, and
1988
+ front matter, it will be converted and rendered. No front matter, and
1372
1989
  it will simply be copied over like a static asset.</p>
1373
1990
 
1374
1991
  <p>Note that if a user has a file of the same path, the theme content will not
1375
- be included in the site, i.e. a user’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code> will be read and
1376
- processed if present instead of a theme’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code>.</p>
1992
+ be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
1993
+ processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
1377
1994
 
1378
1995
  <p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
1379
1996
  for more info.</p>
1380
1997
 
1381
- <h3 id="2-relative_url-and-absolute_url-filters">2. <code class="language-plaintext highlighter-rouge">relative_url</code> and <code class="language-plaintext highlighter-rouge">absolute_url</code> filters</h3>
1998
+ <h3 id="2-relative_url-and-absolute_url-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
1382
1999
 
1383
- <p>Want a clean way to prepend the <code class="language-plaintext highlighter-rouge">baseurl</code> or <code class="language-plaintext highlighter-rouge">url</code> in your config? These
2000
+ <p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
1384
2001
  new filters have you covered. When working locally, if you set your
1385
- <code class="language-plaintext highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="language-plaintext highlighter-rouge">baseurl: "/myproject"</code>,
1386
- then <code class="language-plaintext highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
2002
+ <code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
2003
+ then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
1387
2004
  you pass it:</p>
1388
2005
 
1389
2006
  <figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> =&gt; /myproject/docs/assets</code></pre></figure>
1390
2007
 
1391
- <p>By default, <code class="language-plaintext highlighter-rouge">baseurl</code> is set to <code class="language-plaintext highlighter-rouge">""</code> and therefore yields (never set to
1392
- <code class="language-plaintext highlighter-rouge">"/"</code>):</p>
2008
+ <p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
2009
+ <code class="highlighter-rouge">"/"</code>):</p>
1393
2010
 
1394
2011
  <figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> =&gt; /docs/assets</code></pre></figure>
1395
2012
 
1396
- <p>A result of <code class="language-plaintext highlighter-rouge">relative_url</code> will safely always produce a URL which is
1397
- relative to the domain root. A similar principle applies to <code class="language-plaintext highlighter-rouge">absolute_url</code>.
1398
- It prepends your <code class="language-plaintext highlighter-rouge">baseurl</code> and <code class="language-plaintext highlighter-rouge">url</code> values, making absolute URLs all the
2013
+ <p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
2014
+ relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
2015
+ It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
1399
2016
  easier to make:</p>
1400
2017
 
1401
2018
  <figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> =&gt; https://jekyllrb.com/myproject/docs/assets</code></pre></figure>
1402
2019
 
1403
- <h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="language-plaintext highlighter-rouge">site.url</code> is set by the development server</h3>
2020
+ <h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
1404
2021
 
1405
- <p>When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
1406
- <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
1407
- development. If you are using the new <code class="language-plaintext highlighter-rouge">absolute_url</code> filter, or using
1408
- <code class="language-plaintext highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
1409
- which resets the <code class="language-plaintext highlighter-rouge">url</code> value to point to <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
2022
+ <p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
2023
+ <code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
2024
+ development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
2025
+ <code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
2026
+ which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
1410
2027
 
1411
- <p>No longer! When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
1412
- the value of the <code class="language-plaintext highlighter-rouge">host</code>, <code class="language-plaintext highlighter-rouge">port</code>, and SSL-related options. This defaults to
1413
- <code class="language-plaintext highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="language-plaintext highlighter-rouge">site.url</code>
1414
- will yield <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
2028
+ <p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
2029
+ the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
2030
+ <code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
2031
+ will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
1415
2032
 
1416
2033
  <p>This happens by default when running Jekyll locally. It will not be set if
1417
- you set <code class="language-plaintext highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="language-plaintext highlighter-rouge">jekyll serve</code>. If <code class="language-plaintext highlighter-rouge">JEKYLL_ENV</code> is
1418
- any value except <code class="language-plaintext highlighter-rouge">development</code> (its default value), Jekyll will not
1419
- overwrite the value of <code class="language-plaintext highlighter-rouge">url</code> in your config. And again, this only applies
2034
+ you set <code class="highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="highlighter-rouge">jekyll serve</code>. If <code class="highlighter-rouge">JEKYLL_ENV</code> is
2035
+ any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
2036
+ overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
1420
2037
  to serving, not to building.</p>
1421
2038
 
1422
2039
  <h2 id="a-lot-more">A <em>lot</em> more!</h2>
@@ -1556,7 +2173,7 @@ say? Yes, proper, versionable, releasable, first-class themes. We’re pretty
1556
2173
  stoked about it and we hope you like building and using them. For now, it
1557
2174
  only supports layouts, includes, and sass, but we have plans to include
1558
2175
  static assets like images and CSS/JS in a future release. <a href="/docs/themes/">Read more about
1559
- it in the docs.</a> Our site template generated by <code class="language-plaintext highlighter-rouge">jekyll new</code>
2176
+ it in the docs.</a> Our site template generated by <code class="highlighter-rouge">jekyll new</code>
1560
2177
  now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">minima</a> theme.</p>
1561
2178
 
1562
2179
  <p>Some other notable changes:</p>
@@ -1564,9 +2181,9 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
1564
2181
  <ul>
1565
2182
  <li>Symlinks are allowed as long as they target a file in the site source</li>
1566
2183
  <li>Explicit support for Ruby 2.0.x was dropped</li>
1567
- <li>Added an <code class="language-plaintext highlighter-rouge">:after_init</code> Hook</li>
1568
- <li>Added a <code class="language-plaintext highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
1569
- <li>Added a <code class="language-plaintext highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
2184
+ <li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
2185
+ <li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
2186
+ <li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
1570
2187
  post or document based on its path relative to the site source</li>
1571
2188
  <li>… and lots more!</li>
1572
2189
  </ul>
@@ -1735,7 +2352,7 @@ release. Thank you!</p>
1735
2352
  </div>
1736
2353
  <div class="post-content">
1737
2354
  <p>Upon releasing 3.1.5 and kicking the tires, we noticed a glaring bug: our
1738
- beloved <code class="language-plaintext highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
2355
+ beloved <code class="highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
1739
2356
  us and we decided a 3.1.6 was necessary. This release restores sanity to
1740
2357
  our object-to-JSON generation in Liquid and we hope you enjoy.</p>
1741
2358
 
@@ -1774,7 +2391,7 @@ changelog</a>.</p>
1774
2391
  <p>There’s always at least one bug, right? :)</p>
1775
2392
 
1776
2393
  <p>Hot on the trails of <a href="/news/2016/05/18/jekyll-3-1-4-released/">v3.1.4</a>, we
1777
- bring you v3.1.5! It fixes one bug around requiring the <code class="language-plaintext highlighter-rouge">ExcerptDrop</code>,
2394
+ bring you v3.1.5! It fixes one bug around requiring the <code class="highlighter-rouge">ExcerptDrop</code>,
1778
2395
  which only affects Linux. For the gory details, see <a href="https://github.com/jekyll/jekyll/pull/4912">the pull
1779
2396
  request for the fix</a>.</p>
1780
2397
 
@@ -1811,15 +2428,15 @@ request for the fix</a>.</p>
1811
2428
  <p>Today, we released v3.1.4 in an effort to bring more stability to the v3.1.x series. This bugfix release consists of:</p>
1812
2429
 
1813
2430
  <ul>
1814
- <li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
1815
- <li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where a parent layout (e.g. <code class="language-plaintext highlighter-rouge">default</code> or <code class="language-plaintext highlighter-rouge">base</code>) would overwrite the metadata of the child layout (e.g. <code class="language-plaintext highlighter-rouge">post</code> or <code class="language-plaintext highlighter-rouge">special</code>).</li>
1816
- <li>A fix where <code class="language-plaintext highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
1817
- <li>We added <code class="language-plaintext highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
2431
+ <li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
2432
+ <li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where a parent layout (e.g. <code class="highlighter-rouge">default</code> or <code class="highlighter-rouge">base</code>) would overwrite the metadata of the child layout (e.g. <code class="highlighter-rouge">post</code> or <code class="highlighter-rouge">special</code>).</li>
2433
+ <li>A fix where <code class="highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
2434
+ <li>We added <code class="highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
1818
2435
  <li>
1819
- <code class="language-plaintext highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="language-plaintext highlighter-rouge">docs</code> shows up before <code class="language-plaintext highlighter-rouge">posts</code> reliably.</li>
2436
+ <code class="highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="highlighter-rouge">docs</code> shows up before <code class="highlighter-rouge">posts</code> reliably.</li>
1820
2437
  </ul>
1821
2438
 
1822
- <p>The fixes for <code class="language-plaintext highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
2439
+ <p>The fixes for <code class="highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
1823
2440
 
1824
2441
  <p>We are alwawys striving to make Jekyll more straight-forward to use. Please do open an issue if you believe an aspect of Jekyll’s user experience isn’t up to par.</p>
1825
2442
 
@@ -1900,7 +2517,7 @@ we think you’ll love.</p>
1900
2517
 
1901
2518
  <ul>
1902
2519
  <li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
1903
- <li>Running <code class="language-plaintext highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
2520
+ <li>Running <code class="highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
1904
2521
  </ul>
1905
2522
 
1906
2523
  <p>Both of these issues have been resolved. For more information, check out <a href="/docs/history/#v3-1-3">the full history</a>.</p>
@@ -1937,7 +2554,7 @@ we think you’ll love.</p>
1937
2554
 
1938
2555
  <ul>
1939
2556
  <li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
1940
- <li>Configuration for the posts permalink might be borked when a user specified a value for <code class="language-plaintext highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="language-plaintext highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
2557
+ <li>Configuration for the posts permalink might be borked when a user specified a value for <code class="highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
1941
2558
  </ul>
1942
2559
 
1943
2560
  <figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">collections</span><span class="pi">:</span>
@@ -2017,8 +2634,8 @@ we think you’ll love.</p>
2017
2634
  <li>If a syntax error is encountered by Liquid, it will now print the line number.</li>
2018
2635
  <li>A nasty war between symbols and strings in our configuration hash caused kramdown syntax highlighting to break. That has been resolved; you stand victorious!</li>
2019
2636
  <li>A tilde at the beginning of a filename will no longer crash Jekyll.</li>
2020
- <li>The <code class="language-plaintext highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
2021
- <li>Permalinks which end in a slash will now always output as a folder with an <code class="language-plaintext highlighter-rouge">index.html</code> inside.</li>
2637
+ <li>The <code class="highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
2638
+ <li>Permalinks which end in a slash will now always output as a folder with an <code class="highlighter-rouge">index.html</code> inside.</li>
2022
2639
  </ul>
2023
2640
 
2024
2641
  <p>Nitty-gritty details, like always, are available in the <a href="/docs/history/">history</a>.</p>
@@ -2058,7 +2675,7 @@ fixes:</p>
2058
2675
 
2059
2676
  <ul>
2060
2677
  <li>Fix problem where outputting to a folder would have two extensions</li>
2061
- <li>Handle tildes (<code class="language-plaintext highlighter-rouge">~</code>) in filenames properly</li>
2678
+ <li>Handle tildes (<code class="highlighter-rouge">~</code>) in filenames properly</li>
2062
2679
  <li>Fix issue when comparing documents without dates</li>
2063
2680
  <li>Include line numbers in liquid error output</li>
2064
2681
  </ul>
@@ -2104,11 +2721,11 @@ you’re having.</p>
2104
2721
  wonderful Jekyll users:</p>
2105
2722
 
2106
2723
  <ul>
2107
- <li>If your <code class="language-plaintext highlighter-rouge">permalink</code> ended with a <code class="language-plaintext highlighter-rouge">/</code>, your URL didn’t have any extension,
2724
+ <li>If your <code class="highlighter-rouge">permalink</code> ended with a <code class="highlighter-rouge">/</code>, your URL didn’t have any extension,
2108
2725
  even if you wanted one</li>
2109
- <li>We now strip the BOM by default per Ruby’s <code class="language-plaintext highlighter-rouge">IO.open</code>.</li>
2726
+ <li>We now strip the BOM by default per Ruby’s <code class="highlighter-rouge">IO.open</code>.</li>
2110
2727
  <li>
2111
- <code class="language-plaintext highlighter-rouge">page.dir</code> will not always end in a slash.</li>
2728
+ <code class="highlighter-rouge">page.dir</code> will not always end in a slash.</li>
2112
2729
  </ul>
2113
2730
 
2114
2731
  <p>We also updated our <a href="/docs/conduct/">Code of Conduct</a> to the latest version of
@@ -2166,13 +2783,13 @@ considerably!</p>
2166
2783
  <p>Some other highlights:</p>
2167
2784
 
2168
2785
  <ul>
2169
- <li>Fix: <code class="language-plaintext highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
2170
- <li>Fix: <code class="language-plaintext highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="language-plaintext highlighter-rouge">--source</code>.</li>
2171
- <li>Enhancement: <code class="language-plaintext highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
2172
- <li>Feature: adds new <code class="language-plaintext highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
2173
- <li>Fix: Jekyll will read in files with YAML front matter that has extraneous
2786
+ <li>Fix: <code class="highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
2787
+ <li>Fix: <code class="highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="highlighter-rouge">--source</code>.</li>
2788
+ <li>Enhancement: <code class="highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
2789
+ <li>Feature: adds new <code class="highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
2790
+ <li>Fix: Jekyll will read in files with front matter that has extraneous
2174
2791
  spaces after the first line</li>
2175
- <li>Enhancement: extract the <code class="language-plaintext highlighter-rouge">title</code> attribute from the filename for
2792
+ <li>Enhancement: extract the <code class="highlighter-rouge">title</code> attribute from the filename for
2176
2793
  collection items without a date</li>
2177
2794
  <li>Fix: gracefully handle empty configuration files</li>
2178
2795
  </ul>
@@ -2227,8 +2844,8 @@ midnightSuyama, musoke, and rebornix</p>
2227
2844
  <p>A crucial bug was found in v3.0.1 which caused invalid post dates to go
2228
2845
  unnoticed in the build chain until the error that popped up was unhelpful.
2229
2846
  v3.0.2 <a href="https://github.com/jekyll/jekyll/issues/4375">throws errors as you’d expect</a>
2230
- when there is a post like <code class="language-plaintext highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
2231
- invalid date like <code class="language-plaintext highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
2847
+ when there is a post like <code class="highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
2848
+ invalid date like <code class="highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
2232
2849
 
2233
2850
  <p>This should make the experience of working with Jekyll just a little
2234
2851
  better.</p>
@@ -2264,12 +2881,12 @@ better.</p>
2264
2881
  <p>Hey, folks! Bunch of bug fixes here. Notables:</p>
2265
2882
 
2266
2883
  <ul>
2267
- <li>Only superdirectories of <code class="language-plaintext highlighter-rouge">_posts</code> will be categories.</li>
2884
+ <li>Only superdirectories of <code class="highlighter-rouge">_posts</code> will be categories.</li>
2268
2885
  <li>
2269
- <code class="language-plaintext highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
2886
+ <code class="highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
2270
2887
  <li>
2271
- <code class="language-plaintext highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
2272
- <li>Failure in liquid will now always fail the <code class="language-plaintext highlighter-rouge">jekyll</code> process.</li>
2888
+ <code class="highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
2889
+ <li>Failure in liquid will now always fail the <code class="highlighter-rouge">jekyll</code> process.</li>
2273
2890
  <li>All hooks should now be properly registered &amp; documented</li>
2274
2891
  </ul>
2275
2892
 
@@ -2311,20 +2928,20 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
2311
2928
  <p>The much-anticipated Jekyll 3.0 has been released! Key changes:</p>
2312
2929
 
2313
2930
  <ul>
2314
- <li>Incremental regeneration (experimental, enable with <code class="language-plaintext highlighter-rouge">--incremental</code>)</li>
2315
- <li>Liquid profiler (add <code class="language-plaintext highlighter-rouge">--profile</code> to a build or serve)</li>
2931
+ <li>Incremental regeneration (experimental, enable with <code class="highlighter-rouge">--incremental</code>)</li>
2932
+ <li>Liquid profiler (add <code class="highlighter-rouge">--profile</code> to a build or serve)</li>
2316
2933
  <li>Hook plugin API (no more monkey-patching!)</li>
2317
2934
  <li>Dependencies reduced from 14 to 8, none contain C extensions. We’re hoping to reduce this even more in the future.</li>
2318
2935
  <li>Changed version support: no support for Ruby 1.9.3, added basic JRuby support. Better Windows support.</li>
2319
2936
  <li>Extension-less URLs</li>
2320
2937
  <li>
2321
- <code class="language-plaintext highlighter-rouge">site.collections</code> is an array of collections, thus:
2938
+ <code class="highlighter-rouge">site.collections</code> is an array of collections, thus:
2322
2939
  <ul>
2323
2940
  <li>
2324
- <code class="language-plaintext highlighter-rouge">collection[0]</code> becomes <code class="language-plaintext highlighter-rouge">collection.label</code>
2941
+ <code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
2325
2942
  </li>
2326
2943
  <li>
2327
- <code class="language-plaintext highlighter-rouge">collection[1]</code> becomes <code class="language-plaintext highlighter-rouge">collection</code>
2944
+ <code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
2328
2945
  </li>
2329
2946
  </ul>
2330
2947
  </li>
@@ -2375,7 +2992,7 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
2375
2992
 
2376
2993
  <p>The forum was set up by <a href="https://github.com/envygeeks">@envygeeks</a> to build a community more accessible to Jekyll users and more suitable for general discussion.</p>
2377
2994
 
2378
- <p>There’s already been a lot of interesting topics, including a <a href="https://talk.jekyllrb.com/t/showcase-sites-made-using-jekyll/18">site showcase</a> and <a href="https://talk.jekyllrb.com/t/poll-installation-priorities-for-3-0/106/9">a poll for Jekyll 3.0 priorities</a>.</p>
2995
+ <p>There’s already been a lot of interesting topics, including a site showcase and a poll for Jekyll 3.0 priorities.</p>
2379
2996
 
2380
2997
  <p>Come join the fun!</p>
2381
2998
 
@@ -2585,8 +3202,8 @@ place!</p>
2585
3202
  </div>
2586
3203
  <div class="post-content">
2587
3204
  <p>A very minor release, 2.5.2 fixes a bug with path sanitation that 2.5.1
2588
- introduced. It also improves the <code class="language-plaintext highlighter-rouge">post_url</code> tag such that it checks the
2589
- posts’ name (e.g. <code class="language-plaintext highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
3205
+ introduced. It also improves the <code class="highlighter-rouge">post_url</code> tag such that it checks the
3206
+ posts’ name (e.g. <code class="highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
2590
3207
  name. This fixes issues where posts are created and the day changes based
2591
3208
  on timezone discrepancies.</p>
2592
3209
 
@@ -2673,17 +3290,17 @@ milestone with a pretty big release. What’s changed in 2.5.0? Here are some
2673
3290
  highlights:</p>
2674
3291
 
2675
3292
  <ul>
2676
- <li>Require plugins in the <code class="language-plaintext highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
2677
- <li>YAML Front Matter permalinks can now contain placeholders like <code class="language-plaintext highlighter-rouge">:name</code>. Check out all the placeholders on the <a href="/docs/permalinks/">Permalinks docs page</a>.</li>
2678
- <li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
2679
- <li>Shorted <code class="language-plaintext highlighter-rouge">build</code> and <code class="language-plaintext highlighter-rouge">serve</code> commands with <code class="language-plaintext highlighter-rouge">b</code> and <code class="language-plaintext highlighter-rouge">s</code> aliases, respectively</li>
3293
+ <li>Require plugins in the <code class="highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
3294
+ <li>Front matter permalinks can now contain placeholders like <code class="highlighter-rouge">:name</code>. Check out all the placeholders on the <a href="/docs/permalinks/">Permalinks docs page</a>.</li>
3295
+ <li>The <code class="highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
3296
+ <li>Shorted <code class="highlighter-rouge">build</code> and <code class="highlighter-rouge">serve</code> commands with <code class="highlighter-rouge">b</code> and <code class="highlighter-rouge">s</code> aliases, respectively</li>
2680
3297
  <li>WEBrick will now list your directory if it can’t find an index file.</li>
2681
- <li>Any enumerable can be used with the <code class="language-plaintext highlighter-rouge">where</code> filter.</li>
3298
+ <li>Any enumerable can be used with the <code class="highlighter-rouge">where</code> filter.</li>
2682
3299
  <li>Performance optimizations thanks to <a href="https://github.com/tmm1" class="user-mention">@tmm1</a>’s <a href="https://github.com/tmm1/stackprof">stackprof</a>
2683
3300
  </li>
2684
3301
  <li>Fix for Rouge’s Redcarpet interface</li>
2685
3302
  <li>Security auditors will love this: path sanitation has now been centralized.</li>
2686
- <li>Specify a log level with <code class="language-plaintext highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
3303
+ <li>Specify a log level with <code class="highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
2687
3304
  </ul>
2688
3305
 
2689
3306
  <p>…and a whole bunch of other fixes and enhancements you can read more
@@ -2691,8 +3308,8 @@ about in <a href="/docs/history/">the changelog!</a></p>
2691
3308
 
2692
3309
  <p>As always, if you run into issues, please <a href="https://github.com/jekyll/jekyll/issues">check the issues</a>
2693
3310
  and <a href="https://github.com/jekyll/jekyll/issues/new">create an issue if one doesn’t exist for the bug you encountered</a>.
2694
- If you just need some help, the extraordinary <a href="">jekyll help team is here for
2695
- you!</a></p>
3311
+ If you just need some help, the extraordinary jekyll help team is here for
3312
+ you!</p>
2696
3313
 
2697
3314
  <p><em>When was the <a href="https://github.com/jekyll/jekyll/commit/d189e05d236769c1e5594af9db4d6eacb86fc16e">first commit to Jekyll</a>?
2698
3315
  All the way back on October 19, 2008. It features interesting historical
@@ -2737,14 +3354,14 @@ Custódio, Igor Kapkov, and Kevin Ndung’u!</p>
2737
3354
  <p>Well, lookie here! A new release of Jekyll! v2.4.0 contains lots of goodies, including some brilliant new additions:</p>
2738
3355
 
2739
3356
  <ul>
2740
- <li>A new <code class="language-plaintext highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
3357
+ <li>A new <code class="highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
2741
3358
  <li>Render Liquid in CoffeeScript files (<a href="https://github.com/jekyll/jekyll/issues/2830">#2830</a>)</li>
2742
- <li>Add 4 new array Liquid filters: <code class="language-plaintext highlighter-rouge">push</code>, <code class="language-plaintext highlighter-rouge">pop</code>, <code class="language-plaintext highlighter-rouge">shift</code>, and <code class="language-plaintext highlighter-rouge">unshift</code> (<a href="https://github.com/jekyll/jekyll/pull/2895">#2895</a>)</li>
2743
- <li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="language-plaintext highlighter-rouge">-w</code>!</li>
2744
- <li>Add <code class="language-plaintext highlighter-rouge">:title</code> and <code class="language-plaintext highlighter-rouge">:name</code> to collection URL template fillers (<a href="https://github.com/jekyll/jekyll/issues/2864">#2864</a> &amp; <a href="https://github.com/jekyll/jekyll/issues/2799">#2799</a>)</li>
2745
- <li>Add support for CSV files in the <code class="language-plaintext highlighter-rouge">_data</code> directory (<a href="https://github.com/jekyll/jekyll/issues/2761">#2761</a>)</li>
2746
- <li>Add <code class="language-plaintext highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
2747
- <li>Add a <code class="language-plaintext highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
3359
+ <li>Add 4 new array Liquid filters: <code class="highlighter-rouge">push</code>, <code class="highlighter-rouge">pop</code>, <code class="highlighter-rouge">shift</code>, and <code class="highlighter-rouge">unshift</code> (<a href="https://github.com/jekyll/jekyll/pull/2895">#2895</a>)</li>
3360
+ <li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="highlighter-rouge">-w</code>!</li>
3361
+ <li>Add <code class="highlighter-rouge">:title</code> and <code class="highlighter-rouge">:name</code> to collection URL template fillers (<a href="https://github.com/jekyll/jekyll/issues/2864">#2864</a> &amp; <a href="https://github.com/jekyll/jekyll/issues/2799">#2799</a>)</li>
3362
+ <li>Add support for CSV files in the <code class="highlighter-rouge">_data</code> directory (<a href="https://github.com/jekyll/jekyll/issues/2761">#2761</a>)</li>
3363
+ <li>Add <code class="highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
3364
+ <li>Add a <code class="highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
2748
3365
  </ul>
2749
3366
 
2750
3367
  <p>Some other wunderbar bug fixes in there as well. Check out the <a href="/docs/history/">full changelog</a> for the whole scoop.</p>
@@ -2788,22 +3405,22 @@ curious bug indeed.</a>
2788
3405
  </li>
2789
3406
  <li>Pages, Posts, and Drafts can now be converted by multiple converters.</li>
2790
3407
  <li>Static files can now be safely included in collections. They’ll be placed
2791
- in a <code class="language-plaintext highlighter-rouge">collection.files</code> array. <code class="language-plaintext highlighter-rouge">collection.docs</code> still holds exclusively
2792
- content with YAML front matter.</li>
3408
+ in a <code class="highlighter-rouge">collection.files</code> array. <code class="highlighter-rouge">collection.docs</code> still holds exclusively
3409
+ content with front matter.</li>
2793
3410
  <li>Sass files can once again be rendered by Liquid. However, neither Sass
2794
- nor CoffeeScript can ever have a layout. Bonus: <code class="language-plaintext highlighter-rouge">scssify</code> and <code class="language-plaintext highlighter-rouge">sassify</code>
3411
+ nor CoffeeScript can ever have a layout. Bonus: <code class="highlighter-rouge">scssify</code> and <code class="highlighter-rouge">sassify</code>
2795
3412
  Liquid filters.</li>
2796
- <li>Partial variables allowed now in the path argument of <code class="language-plaintext highlighter-rouge">include</code> calls</li>
2797
- <li>We added a <code class="language-plaintext highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
2798
- about that subcommand. Or don’t, to see the help for <code class="language-plaintext highlighter-rouge">jekyll</code> itself.</li>
2799
- <li>Lots of fixes to the site template we use for <code class="language-plaintext highlighter-rouge">jekyll new</code>, including
3413
+ <li>Partial variables allowed now in the path argument of <code class="highlighter-rouge">include</code> calls</li>
3414
+ <li>We added a <code class="highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
3415
+ about that subcommand. Or don’t, to see the help for <code class="highlighter-rouge">jekyll</code> itself.</li>
3416
+ <li>Lots of fixes to the site template we use for <code class="highlighter-rouge">jekyll new</code>, including
2800
3417
  converting the CSS into SCSS.</li>
2801
- <li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter will now call <code class="language-plaintext highlighter-rouge">#to_liquid</code> for you</li>
3418
+ <li>The <code class="highlighter-rouge">jsonify</code> filter will now call <code class="highlighter-rouge">#to_liquid</code> for you</li>
2802
3419
  <li>Lots, lots more!</li>
2803
3420
  </ul>
2804
3421
 
2805
3422
  <p>One change deserves special note. In <a href="https://github.com/jekyll/jekyll/issues/2633">#2633</a>, subfolders <em>inside</em> a
2806
- <code class="language-plaintext highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
3423
+ <code class="highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
2807
3424
  turns out, this behaviour was unwanted by a large number of individuals, as
2808
3425
  it is a handy way to organize posts. Ultimately, we decided to revert this
2809
3426
  change in <a href="https://github.com/jekyll/jekyll/issues/2705">#2705</a>, because it was a change in behaviour that was already
@@ -2844,7 +3461,7 @@ page</a>! Happy Jekylling!</p>
2844
3461
  <li>A warning will now fire if you specify a layout in any of your pages or
2845
3462
  posts that doesn’t exist.</li>
2846
3463
  <li>Certain Pygments options are now whitelisted in safe mode</li>
2847
- <li>Categories in a post’s path are now respected (i.e. folders in <code class="language-plaintext highlighter-rouge">_posts</code>
3464
+ <li>Categories in a post’s path are now respected (i.e. folders in <code class="highlighter-rouge">_posts</code>
2848
3465
  will now work properly).</li>
2849
3466
  </ol>
2850
3467
 
@@ -2884,7 +3501,7 @@ introduces fixes for a couple security-related issues.</p>
2884
3501
 
2885
3502
  <ol>
2886
3503
  <li>One in the reading of data</li>
2887
- <li>One in the <code class="language-plaintext highlighter-rouge">layouts</code> setting</li>
3504
+ <li>One in the <code class="highlighter-rouge">layouts</code> setting</li>
2888
3505
  </ol>
2889
3506
 
2890
3507
  <p>They were identified in Jekyll 1.5.1 and has been confirmed as patched
@@ -2892,7 +3509,7 @@ in this version and the version used by GitHub Pages. If you are in the
2892
3509
  business of building Jekyll sites, please ensure you upgrade to 2.1.1 as
2893
3510
  soon as possible.</p>
2894
3511
 
2895
- <p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="language-plaintext highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
3512
+ <p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
2896
3513
 
2897
3514
  <p>Additionally, the dependency on Maruku has been loosened and a bug was
2898
3515
  fixed with document URLs.</p>
@@ -2936,13 +3553,13 @@ things to look forward to:</p>
2936
3553
  <li>Set front matter defaults for collections (#2419)</li>
2937
3554
  <li>Set a collection-specific URL template (#2418)</li>
2938
3555
  <li>
2939
- <code class="language-plaintext highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
3556
+ <code class="highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
2940
3557
  <li>
2941
- <code class="language-plaintext highlighter-rouge">.json</code> files in <code class="language-plaintext highlighter-rouge">_data</code> (#2369)</li>
2942
- <li>Allow subdirectories in <code class="language-plaintext highlighter-rouge">_data</code> (#2395)</li>
2943
- <li>Add support for <code class="language-plaintext highlighter-rouge">hl_lines</code> in <code class="language-plaintext highlighter-rouge">highlight</code> tag (#2532)</li>
3558
+ <code class="highlighter-rouge">.json</code> files in <code class="highlighter-rouge">_data</code> (#2369)</li>
3559
+ <li>Allow subdirectories in <code class="highlighter-rouge">_data</code> (#2395)</li>
3560
+ <li>Add support for <code class="highlighter-rouge">hl_lines</code> in <code class="highlighter-rouge">highlight</code> tag (#2532)</li>
2944
3561
  <li>Post categories now merge with directory, front matter, and defaults (#2373)</li>
2945
- <li>New <code class="language-plaintext highlighter-rouge">--skip_initial_build</code> flag for <code class="language-plaintext highlighter-rouge">jekyll serve</code> (#2477)</li>
3562
+ <li>New <code class="highlighter-rouge">--skip_initial_build</code> flag for <code class="highlighter-rouge">jekyll serve</code> (#2477)</li>
2946
3563
  <li>A bajilion bug fixes and site updates!</li>
2947
3564
  </ul>
2948
3565
 
@@ -2989,8 +3606,8 @@ that you could have a sticker honoring your beloved Jekyll.</p>
2989
3606
  <p>The StickerMule team says, <em>“Pine no longer!”</em> StickerMule has <strong><a href="https://www.stickermule.com/marketplace/825-jekyll-stickers">discounted the
2990
3607
  price of Jekyll stickers down to $1 and are offering free (domestic)
2991
3608
  shipping</a>!</strong>
2992
- Go grab one now on the StickerMule marketplace – <a href="https://twitter.com/parkr/status/430826309707902976/photo/1">they’ll look
2993
- swell on your favourite hardware.</a></p>
3609
+ Go grab one now on the StickerMule marketplace – they’ll look
3610
+ swell on your favourite hardware.</p>
2994
3611
 
2995
3612
  </div>
2996
3613
  </article>
@@ -3062,15 +3679,15 @@ swell on your favourite hardware.</a></p>
3062
3679
  <li>
3063
3680
  <a href="/docs/collections/">Collections</a> - Collections allow you to define an unlimited number of custom document types (beyond just posts and pages) for different types of content you may want to author in Jekyll such as API documentation or a cookbook!</li>
3064
3681
  <li>
3065
- <a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="language-plaintext highlighter-rouge">jekyll new &lt;path&gt;</code> and you’re good to go.</li>
3682
+ <a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="highlighter-rouge">jekyll new &lt;path&gt;</code> and you’re good to go.</li>
3066
3683
  <li>
3067
3684
  <a href="/docs/assets/">Native Sass &amp; CoffeeScript support</a> - We love CSS and JavaScript as much as the next guy, but there will always be a special place in our hearts for Sass and CoffeeScript. We now offer native support for these file types — no more messing around with Rake or Grunt!</li>
3068
3685
  <li>
3069
- <a href="/docs/configuration/#front-matter-defaults">YAML Front Matter defaults</a> - If you’ve set <code class="language-plaintext highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
3686
+ <a href="/docs/configuration/front-matter-defaults/">Front Matter defaults</a> - If you’ve set <code class="highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
3070
3687
  <li>
3071
- <a href="/docs/configuration/#custom-markdown-processors">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="language-plaintext highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
3688
+ <a href="/docs/configuration/markdown/">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
3072
3689
  <li>
3073
- <a href="/docs/templates/#filters">Addition of <code class="language-plaintext highlighter-rouge">where</code> and <code class="language-plaintext highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="language-plaintext highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="language-plaintext highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
3690
+ <a href="/docs/liquid/filters/">Addition of <code class="highlighter-rouge">where</code> and <code class="highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
3074
3691
  <li>
3075
3692
  <a href="https://github.com/jekyll/jekyll/pull/1988">Switch from Maruku to Kramdown as default markdown converter</a> - Maruku is dead. We’ve replaced it with the converter which has the closest feature parity: Kramdown!</li>
3076
3693
  </ol>
@@ -3111,7 +3728,7 @@ swell on your favourite hardware.</a></p>
3111
3728
  </div>
3112
3729
  <div class="post-content">
3113
3730
  <p>The hawk-eyed <a href="https://github.com/gregose">@gregose</a> spotted a bug in our
3114
- <code class="language-plaintext highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
3731
+ <code class="highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
3115
3732
 
3116
3733
  <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="o">&gt;</span> <span class="n">sanitized_path</span><span class="p">(</span><span class="s2">"/tmp/foobar/jail"</span><span class="p">,</span> <span class="s2">"..c:/..c:/..c:/etc/passwd"</span><span class="p">)</span>
3117
3734
  <span class="o">=&gt;</span> <span class="s2">"/tmp/foobar/jail/../../../etc/passwd"</span></code></pre></figure>
@@ -3151,7 +3768,7 @@ the masses. Thanks, Greg!</p>
3151
3768
  </div>
3152
3769
  <div class="post-content">
3153
3770
  <p>As work continues on Jekyll 2.0.0, we felt it was important to address two key
3154
- issues of Jekyll 1.4.3, namely the <code class="language-plaintext highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
3771
+ issues of Jekyll 1.4.3, namely the <code class="highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
3155
3772
  inability to use Jekyll 1.4.3 on Windows due to a <a href="https://github.com/jekyll/jekyll/issues/1948">fun issue with path sanitizing</a>.</p>
3156
3773
 
3157
3774
  <p>For a full changelog, check out our <a href="/docs/history/#v1-5-0">history</a> page.</p>
@@ -3196,7 +3813,7 @@ generated output via improper symlink sanitization, potentially resulting in an
3196
3813
  inadvertent information disclosure.</p>
3197
3814
 
3198
3815
  <p>Versions of Jekyll prior to 1.4.3 may also allow malicious users to write
3199
- arbitrary <code class="language-plaintext highlighter-rouge">.html</code> files outside of the destination folder via relative path
3816
+ arbitrary <code class="highlighter-rouge">.html</code> files outside of the destination folder via relative path
3200
3817
  traversal, potentially overwriting otherwise-trusted content with arbitrary HTML
3201
3818
  or Javascript depending on your server’s configuration.</p>
3202
3819
 
@@ -3231,8 +3848,8 @@ these vulnerabilities, and to <a href="https://github.com/BenBalter" class="user
3231
3848
  <div class="post-content">
3232
3849
  <p>This release fixes <a href="https://github.com/jekyll/jekyll/pull/1830">a regression</a> where Maruku fenced code blocks were turned
3233
3850
  off, instead of the previous default to on. We’ve added a new default
3234
- configuration to our <code class="language-plaintext highlighter-rouge">maruku</code> config key: <code class="language-plaintext highlighter-rouge">fenced_code_blocks</code> and set it to
3235
- default to <code class="language-plaintext highlighter-rouge">true</code>.</p>
3851
+ configuration to our <code class="highlighter-rouge">maruku</code> config key: <code class="highlighter-rouge">fenced_code_blocks</code> and set it to
3852
+ default to <code class="highlighter-rouge">true</code>.</p>
3236
3853
 
3237
3854
  <p>If you do not wish to use Maruku fenced code blocks, you may turn this option
3238
3855
  off in your site’s configuration file.</p>
@@ -3315,7 +3932,7 @@ Jekyll v1.4.0. This release will be the last non-patch release to support Ruby
3315
3932
  a ton of bugfixes over the previous 0.6.x releases.</p>
3316
3933
  </li>
3317
3934
  <li>
3318
- <p>Non-<code class="language-plaintext highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
3935
+ <p>Non-<code class="highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
3319
3936
  processed, which can provide a rudimentary way to establish a load order for
3320
3937
  plugins.</p>
3321
3938
  </li>
@@ -3359,7 +3976,7 @@ Karékinian, Jordon Bedwell, Matthew Iversen, Persa Zula, and Yi Zeng.</p>
3359
3976
  release of 1.3.0.</p>
3360
3977
 
3361
3978
  <p>In addition to a couple of other smaller bug fixes, the biggest thing
3362
- we’ve fixed is an issue with the <code class="language-plaintext highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
3979
+ we’ve fixed is an issue with the <code class="highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
3363
3980
  full run-down, visit our <a href="/docs/history/">change log</a>!</p>
3364
3981
 
3365
3982
  <p>Thanks to all the people who have contributed to this release! They are
@@ -3403,33 +4020,33 @@ love.</p>
3403
4020
  <ul>
3404
4021
  <li>
3405
4022
  <p>You can add <a href="/docs/datafiles/">arbitrary data</a> to the site by adding YAML files under a
3406
- site’s <code class="language-plaintext highlighter-rouge">_data</code> directory. This will allow you to avoid
4023
+ site’s <code class="highlighter-rouge">_data</code> directory. This will allow you to avoid
3407
4024
  repetition in your templates and to set site specific options without
3408
- changing <code class="language-plaintext highlighter-rouge">_config.yml</code>.</p>
4025
+ changing <code class="highlighter-rouge">_config.yml</code>.</p>
3409
4026
  </li>
3410
4027
  <li>
3411
- <p>You can now run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
3412
- background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut
4028
+ <p>You can now run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
4029
+ background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut
3413
4030
  the server down. When ran, you’ll get a process id that you can use in
3414
- place of <code class="language-plaintext highlighter-rouge">[server_pid]</code></p>
4031
+ place of <code class="highlighter-rouge">[server_pid]</code></p>
3415
4032
  </li>
3416
4033
  <li>
3417
4034
  <p>You can now <strong>disable automatically-generated excerpts</strong> if you set
3418
- <code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</p>
4035
+ <code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</p>
3419
4036
  </li>
3420
4037
  <li>
3421
4038
  <p>If you’re moving pages and posts, you can now check for <strong>URL
3422
- conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</p>
4039
+ conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</p>
3423
4040
  </li>
3424
4041
  <li>
3425
4042
  <p>If you’re a fan of the drafts feature, you’ll be happy to know we’ve
3426
- added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</p>
4043
+ added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</p>
3427
4044
  </li>
3428
4045
  <li>
3429
4046
  <p>Permalinks with special characters should now generate without errors.</p>
3430
4047
  </li>
3431
4048
  <li>
3432
- <p>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid
4049
+ <p>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid
3433
4050
  variable.</p>
3434
4051
  </li>
3435
4052
  </ul>
@@ -3500,11 +4117,11 @@ issues!</p>
3500
4117
  <div class="post-content">
3501
4118
  <p>Quick turnover, anyone? A <a href="https://github.com/jekyll/jekyll/pull/1525">recent incompatibility with Liquid
3502
4119
  v2.5.2</a> produced a nasty bug in
3503
- which <code class="language-plaintext highlighter-rouge">include</code> tags were not rendered properly within <code class="language-plaintext highlighter-rouge">if</code> blocks.</p>
4120
+ which <code class="highlighter-rouge">include</code> tags were not rendered properly within <code class="highlighter-rouge">if</code> blocks.</p>
3504
4121
 
3505
4122
  <p>This release also includes a better handling of detached servers (prints pid and
3506
- the command for killing the process). <strong>Note</strong>: the <code class="language-plaintext highlighter-rouge">--detach</code> flag and
3507
- <code class="language-plaintext highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
4123
+ the command for killing the process). <strong>Note</strong>: the <code class="highlighter-rouge">--detach</code> flag and
4124
+ <code class="highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
3508
4125
 
3509
4126
  <p>For a full list of the fixes in this release, check out <a href="/docs/history/">the change
3510
4127
  log</a>!</p>
@@ -3542,12 +4159,12 @@ enhancements that we think you’ll love.</p>
3542
4159
  <p>Here are a few things we think you’ll want to know about this release:</p>
3543
4160
 
3544
4161
  <ul>
3545
- <li>Run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut the server down.</li>
3546
- <li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</li>
3547
- <li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</li>
3548
- <li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</li>
4162
+ <li>Run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut the server down.</li>
4163
+ <li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</li>
4164
+ <li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</li>
4165
+ <li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</li>
3549
4166
  <li>Permalinks with special characters should now generate without errors.</li>
3550
- <li>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid variable.</li>
4167
+ <li>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid variable.</li>
3551
4168
  </ul>
3552
4169
 
3553
4170
  <p>For a full run-down, visit our <a href="/docs/history/">change log</a>!</p>
@@ -3580,9 +4197,9 @@ enhancements that we think you’ll love.</p>
3580
4197
  <div class="post-content">
3581
4198
  <p>Version 1.1.2 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
3582
4199
 
3583
- <p>Community and custom plugins extending the <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
4200
+ <p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
3584
4201
 
3585
- <p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
4202
+ <p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
3586
4203
 
3587
4204
  <p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
3588
4205
  and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
@@ -3616,9 +4233,9 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
3616
4233
  <div class="post-content">
3617
4234
  <p>Version 1.0.4 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
3618
4235
 
3619
- <p>Community and custom plugins extending the <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
4236
+ <p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
3620
4237
 
3621
- <p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
4238
+ <p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
3622
4239
 
3623
4240
  <p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
3624
4241
  and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
@@ -3694,12 +4311,12 @@ more a more detailed changelog for this release.</p>
3694
4311
  Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new additions:</p>
3695
4312
 
3696
4313
  <ul>
3697
- <li>Add <code class="language-plaintext highlighter-rouge">docs</code> subcommand to read Jekyll’s docs when offline. (<a href="https://github.com/jekyll/jekyll/issues/1046">#1046</a>)</li>
3698
- <li>Support passing parameters to templates in <code class="language-plaintext highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
4314
+ <li>Add <code class="highlighter-rouge">docs</code> subcommand to read Jekyll’s docs when offline. (<a href="https://github.com/jekyll/jekyll/issues/1046">#1046</a>)</li>
4315
+ <li>Support passing parameters to templates in <code class="highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
3699
4316
  <li>Add support for Liquid tags to post excerpts (<a href="https://github.com/jekyll/jekyll/issues/1302">#1302</a>)</li>
3700
4317
  <li>Fix pagination for subdirectories (<a href="https://github.com/jekyll/jekyll/issues/1198">#1198</a>)</li>
3701
4318
  <li>Provide better error reporting when generating sites (<a href="https://github.com/jekyll/jekyll/issues/1253">#1253</a>)</li>
3702
- <li>Latest posts first in non-LSI <code class="language-plaintext highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
4319
+ <li>Latest posts first in non-LSI <code class="highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
3703
4320
  </ul>
3704
4321
 
3705
4322
  <p>See the <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.0">GitHub Release</a> page for more a more detailed changelog for this release.</p>
@@ -3735,10 +4352,10 @@ Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new add
3735
4352
 
3736
4353
  <ul>
3737
4354
  <li>Fail with non-zero exit code when MaRuKu errors (<a href="https://github.com/jekyll/jekyll/issues/1190">#1190</a>) or Liquid errors (<a href="https://github.com/jekyll/jekyll/issues/1121">#1121</a>)</li>
3738
- <li>Add support for private gists to <code class="language-plaintext highlighter-rouge">gist</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1189">#1189</a>)</li>
3739
- <li>Add <code class="language-plaintext highlighter-rouge">--force</code> option to <code class="language-plaintext highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/1115">#1115</a>)</li>
3740
- <li>Fix compatibility with <code class="language-plaintext highlighter-rouge">exclude</code> and <code class="language-plaintext highlighter-rouge">include</code> with pre-1.0 Jekyll (<a href="https://github.com/jekyll/jekyll/issues/1114">#1114</a>)</li>
3741
- <li>Fix pagination issue regarding <code class="language-plaintext highlighter-rouge">File.basename</code> and <code class="language-plaintext highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
4355
+ <li>Add support for private gists to <code class="highlighter-rouge">gist</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1189">#1189</a>)</li>
4356
+ <li>Add <code class="highlighter-rouge">--force</code> option to <code class="highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/1115">#1115</a>)</li>
4357
+ <li>Fix compatibility with <code class="highlighter-rouge">exclude</code> and <code class="highlighter-rouge">include</code> with pre-1.0 Jekyll (<a href="https://github.com/jekyll/jekyll/issues/1114">#1114</a>)</li>
4358
+ <li>Fix pagination issue regarding <code class="highlighter-rouge">File.basename</code> and <code class="highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
3742
4359
  </ul>
3743
4360
 
3744
4361
  <p>See the <a href="/docs/history/#v1-0-3">History</a> page for more information on this release.</p>
@@ -3775,11 +4392,11 @@ releases, and fix some other annoying bugs:</p>
3775
4392
 
3776
4393
  <ul>
3777
4394
  <li>Backwards-compatibilize relative permalinks (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
3778
- <li>Add <code class="language-plaintext highlighter-rouge">jekyll doctor</code> command to check site for any known compatibility problems (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
3779
- <li>Deprecate old config <code class="language-plaintext highlighter-rouge">server_port</code>, match to <code class="language-plaintext highlighter-rouge">port</code> if <code class="language-plaintext highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
4395
+ <li>Add <code class="highlighter-rouge">jekyll doctor</code> command to check site for any known compatibility problems (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
4396
+ <li>Deprecate old config <code class="highlighter-rouge">server_port</code>, match to <code class="highlighter-rouge">port</code> if <code class="highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
3780
4397
  <li>Update pygments.rb and kramdon versions to 0.5.0 and 1.0.2, respectively (<a href="https://github.com/jekyll/jekyll/issues/1061">#1061</a>, <a href="https://github.com/jekyll/jekyll/issues/1067">#1067</a>)</li>
3781
4398
  <li>Fix issue when post categories are numbers (<a href="https://github.com/jekyll/jekyll/issues/1078">#1078</a>)</li>
3782
- <li>Add a <code class="language-plaintext highlighter-rouge">data-lang="&lt;lang&gt;"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
4399
+ <li>Add a <code class="highlighter-rouge">data-lang="&lt;lang&gt;"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
3783
4400
  <li>Catching that Redcarpet gem isn’t installed (<a href="https://github.com/jekyll/jekyll/issues/1059">#1059</a>)</li>
3784
4401
  </ul>
3785
4402
 
@@ -3815,13 +4432,13 @@ releases, and fix some other annoying bugs:</p>
3815
4432
  <p>Hot on the trails of v1.0, v1.0.1 is out! Here are the highlights:</p>
3816
4433
 
3817
4434
  <ul>
3818
- <li>Add newer <code class="language-plaintext highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
4435
+ <li>Add newer <code class="highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
3819
4436
  <li>Commander error message now preferred over process abort with incorrect args (<a href="https://github.com/jekyll/jekyll/issues/1040">#1040</a>)</li>
3820
4437
  <li>Do not force use of toc_token when using generate_toc in RDiscount (<a href="https://github.com/jekyll/jekyll/issues/1048">#1048</a>)</li>
3821
4438
  <li>Make Redcarpet respect the pygments configuration option (<a href="https://github.com/jekyll/jekyll/issues/1053">#1053</a>)</li>
3822
4439
  <li>Fix the index build with LSI (<a href="https://github.com/jekyll/jekyll/issues/1045">#1045</a>)</li>
3823
4440
  <li>Don’t print deprecation warning when no arguments are specified. (<a href="https://github.com/jekyll/jekyll/issues/1041">#1041</a>)</li>
3824
- <li>Add missing <code class="language-plaintext highlighter-rouge">&lt;/div&gt;</code> to site template used by <code class="language-plaintext highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
4441
+ <li>Add missing <code class="highlighter-rouge">&lt;/div&gt;</code> to site template used by <code class="highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
3825
4442
  </ul>
3826
4443
 
3827
4444
  <p>See the <a href="/docs/history/#v1-0-1">History</a> page for more information on this release.</p>
@@ -3881,31 +4498,31 @@ examples and for compiling this list):</p>
3881
4498
  <li class="current">
3882
4499
  <a href="/news/">All News</a>
3883
4500
  </li>
3884
- <li class="">
4501
+ <li>
3885
4502
  <a href="/news/releases/">Jekyll Releases</a>
3886
4503
  </li>
3887
4504
  </ul>
3888
4505
  <h4>Recent Releases</h4>
3889
4506
  <ul>
3890
4507
 
3891
- <li class="">
3892
- <a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
4508
+ <li>
4509
+ <a href="/news/2019/08/20/jekyll-4-0-0-released/">Version 4.0.0</a>
3893
4510
  </li>
3894
4511
 
3895
- <li class="">
3896
- <a href="/news/2018/06/05/jekyll-3-8-3-released/">Version 3.8.3</a>
4512
+ <li>
4513
+ <a href="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">Version 4.0.0.pre.beta1</a>
3897
4514
  </li>
3898
4515
 
3899
- <li class="">
3900
- <a href="/news/2018/05/19/jekyll-3-8-2-released/">Version 3.8.2</a>
4516
+ <li>
4517
+ <a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
3901
4518
  </li>
3902
4519
 
3903
- <li class="">
3904
- <a href="/news/2018/05/01/jekyll-3-8-1-released/">Version 3.8.1</a>
4520
+ <li>
4521
+ <a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">Version 4.0.0.pre.alpha1</a>
3905
4522
  </li>
3906
4523
 
3907
- <li class="">
3908
- <a href="/news/2018/02/24/jekyll-3-7-3-released/">Version 3.7.3</a>
4524
+ <li>
4525
+ <a href="/news/2018/11/04/jekyll-3-8-5-released/">Version 3.8.5</a>
3909
4526
  </li>
3910
4527
 
3911
4528
  <li>
@@ -3914,189 +4531,213 @@ examples and for compiling this list):</p>
3914
4531
  </ul>
3915
4532
  <h4>Other News</h4>
3916
4533
  <ul>
4534
+
3917
4535
 
4536
+
3918
4537
 
4538
+
3919
4539
 
4540
+
3920
4541
 
4542
+
3921
4543
 
4544
+
3922
4545
 
4546
+
3923
4547
 
4548
+ <li>
4549
+ <a href="/news/2018/08/01/jekyll-sponsoring/">Sponsoring Jekyll's development</a>
4550
+ </li>
3924
4551
 
4552
+
3925
4553
 
4554
+
3926
4555
 
4556
+
3927
4557
 
4558
+
3928
4559
 
3929
- <li class="">
3930
- <a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
4560
+ <li>
4561
+ <a href="/news/2018/04/19/development-update/">Jekyll 4.0 is on the Horizon!</a>
3931
4562
  </li>
3932
4563
 
4564
+
3933
4565
 
4566
+
3934
4567
 
4568
+
3935
4569
 
4570
+ <li>
4571
+ <a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
4572
+ </li>
3936
4573
 
4574
+
3937
4575
 
4576
+
3938
4577
 
4578
+
3939
4579
 
4580
+
3940
4581
 
3941
- <li class="">
4582
+ <li>
3942
4583
  <a href="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</a>
3943
4584
  </li>
3944
4585
 
4586
+
3945
4587
 
4588
+
3946
4589
 
4590
+
3947
4591
 
4592
+
3948
4593
 
4594
+
3949
4595
 
4596
+
3950
4597
 
4598
+
3951
4599
 
4600
+
3952
4601
 
4602
+
3953
4603
 
4604
+
3954
4605
 
4606
+
3955
4607
 
3956
-
3957
-
3958
-
3959
-
3960
-
3961
-
3962
-
3963
-
3964
-
3965
-
3966
-
3967
- <li class="">
4608
+ <li>
3968
4609
  <a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
3969
4610
  </li>
3970
4611
 
4612
+
3971
4613
 
4614
+
3972
4615
 
4616
+
3973
4617
 
3974
-
3975
-
3976
-
3977
- <li class="">
4618
+ <li>
3978
4619
  <a href="/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll's Google Summer of Code Project: The CMS You Always Wanted</a>
3979
4620
  </li>
3980
4621
 
4622
+
3981
4623
 
4624
+
3982
4625
 
4626
+
3983
4627
 
4628
+
3984
4629
 
4630
+
3985
4631
 
4632
+
3986
4633
 
4634
+
3987
4635
 
3988
-
3989
-
3990
-
3991
-
3992
-
3993
-
3994
-
3995
- <li class="">
4636
+ <li>
3996
4637
  <a href="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</a>
3997
4638
  </li>
3998
4639
 
4640
+
3999
4641
 
4642
+
4000
4643
 
4644
+
4001
4645
 
4646
+
4002
4647
 
4648
+
4003
4649
 
4650
+
4004
4651
 
4652
+
4005
4653
 
4654
+
4006
4655
 
4007
-
4008
-
4009
-
4010
-
4011
-
4012
-
4013
-
4014
-
4015
- <li class="">
4656
+ <li>
4016
4657
  <a href="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</a>
4017
4658
  </li>
4018
4659
 
4660
+
4019
4661
 
4662
+
4020
4663
 
4021
-
4022
-
4023
- <li class="">
4664
+ <li>
4024
4665
  <a href="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet &amp; Greet at GitHub HQ</a>
4025
4666
  </li>
4026
4667
 
4668
+
4027
4669
 
4670
+
4028
4671
 
4029
-
4030
-
4031
- <li class="">
4672
+ <li>
4032
4673
  <a href="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</a>
4033
4674
  </li>
4034
4675
 
4676
+
4035
4677
 
4678
+
4036
4679
 
4680
+
4037
4681
 
4682
+
4038
4683
 
4684
+
4039
4685
 
4686
+
4040
4687
 
4688
+
4041
4689
 
4690
+
4042
4691
 
4692
+
4043
4693
 
4044
-
4045
-
4046
-
4047
-
4048
-
4049
-
4050
-
4051
-
4052
-
4053
- <li class="">
4694
+ <li>
4054
4695
  <a href="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</a>
4055
4696
  </li>
4056
4697
 
4698
+
4057
4699
 
4700
+
4058
4701
 
4702
+
4059
4703
 
4704
+
4060
4705
 
4706
+
4061
4707
 
4708
+
4062
4709
 
4710
+
4063
4711
 
4712
+
4064
4713
 
4714
+
4065
4715
 
4716
+
4066
4717
 
4718
+
4067
4719
 
4720
+
4068
4721
 
4722
+
4069
4723
 
4724
+
4070
4725
 
4726
+
4071
4727
 
4728
+
4072
4729
 
4730
+
4073
4731
 
4732
+
4074
4733
 
4734
+
4075
4735
 
4736
+
4076
4737
 
4738
+
4077
4739
 
4078
-
4079
-
4080
-
4081
-
4082
-
4083
-
4084
-
4085
-
4086
-
4087
-
4088
-
4089
-
4090
-
4091
-
4092
-
4093
-
4094
-
4095
-
4096
-
4097
-
4098
-
4099
-
4740
+
4100
4741
  </ul>
4101
4742
  </aside>
4102
4743
  </div>
@@ -4111,7 +4752,8 @@ examples and for compiling this list):</p>
4111
4752
  <footer>
4112
4753
  <div class="grid">
4113
4754
  <div class="unit one-third center-on-mobiles">
4114
- <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>
4755
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
4756
+ <p>The contents of this website are <br>© 2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
4115
4757
  </div>
4116
4758
  <div class="unit two-thirds align-right center-on-mobiles">
4117
4759
  <p>
@@ -4121,6 +4763,14 @@ examples and for compiling this list):</p>
4121
4763
  </a>
4122
4764
  </p>
4123
4765
  </div>
4766
+ <div class="unit two-thirds align-right center-on-mobiles">
4767
+ <p>
4768
+ Jekyll is funded thanks to its
4769
+ <a href="https://github.com/jekyll/jekyll#sponsors">
4770
+ sponsors!
4771
+ </a>
4772
+ </p>
4773
+ </div>
4124
4774
  </div>
4125
4775
  </footer>
4126
4776