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
@@ -0,0 +1,324 @@
1
+ <?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="4.0.0">Jekyll</generator><link href="https://jekyllrb.com/feed/release.xml" rel="self" type="application/atom+xml" /><link href="https://jekyllrb.com/" rel="alternate" type="text/html" /><updated>2019-09-11T07:30:27-07:00</updated><id>https://jekyllrb.com/feed/release.xml</id><title type="html">Jekyll • Simple, blog-aware, static sites | Release</title><subtitle>Transform your plain text into static websites and blogs</subtitle><entry><title type="html">Jekyll 4.0.0 Released</title><link href="https://jekyllrb.com/news/2019/08/20/jekyll-4-0-0-released/" rel="alternate" type="text/html" title="Jekyll 4.0.0 Released" /><published>2019-08-20T08:00:00-07:00</published><updated>2019-08-20T08:00:00-07:00</updated><id>https://jekyllrb.com/news/2019/08/20/jekyll-4-0-0-released</id><content type="html" xml:base="https://jekyllrb.com/news/2019/08/20/jekyll-4-0-0-released/">&lt;p&gt;Hi! 👋 I bring some good news! Jekyll 4.0.0 is finally here! 🎉&lt;/p&gt;
2
+
3
+ &lt;p&gt;There’s quite a bit in this release to unpack, so let me hit the high points quickly:&lt;/p&gt;
4
+ &lt;ul&gt;
5
+ &lt;li&gt;Ruby 2.4.0 or greater is now required.&lt;/li&gt;
6
+ &lt;li&gt;Rouge 3.0 or greater is now required for syntax highlighting.&lt;/li&gt;
7
+ &lt;li&gt;Jekyll builds should be much faster.&lt;/li&gt;
8
+ &lt;li&gt;Kramdown 2.1 is now the default markdown engine.&lt;/li&gt;
9
+ &lt;li&gt;Sass processing should be faster.&lt;/li&gt;
10
+ &lt;li&gt;We dropped support for a lot of stuff, specifically:
11
+ &lt;ul&gt;
12
+ &lt;li&gt;Pygments&lt;/li&gt;
13
+ &lt;li&gt;RedCarpet&lt;/li&gt;
14
+ &lt;li&gt;RDiscount&lt;/li&gt;
15
+ &lt;/ul&gt;
16
+ &lt;/li&gt;
17
+ &lt;/ul&gt;
18
+
19
+ &lt;p&gt;Alright, so with the high points out of the way, let’s get into the details a little bit.&lt;/p&gt;
20
+
21
+ &lt;h3 id=&quot;cache-all-the-things-&quot;&gt;Cache all the things! 💰&lt;/h3&gt;
22
+
23
+ &lt;p&gt;While some optimizations first made an appearance with Jekyll 3.8.0, Jekyll 4.0 takes
24
+ it to another level altogether.&lt;/p&gt;
25
+
26
+ &lt;p&gt;Jekyll 4.0 caches the processing done by Liquid in memory. So every Liquid
27
+ template is processed only as required. If you have 10 pages depending on a
28
+ single layout, the layout is cached and that data is then rendered as per the
29
+ 10 different contexts of the individual files.&lt;/p&gt;
30
+
31
+ &lt;p&gt;There’s also a disk cache! Jekyll can now cache data to disk to avoid repeated
32
+ processing of content that doesn’t change between build sessions. Currently,
33
+ this is limited to markdown. So while the very first build will take a certain
34
+ amount of time, consequent builds for content that hasn’t changed will take
35
+ much less time due to the disk-cache. Disk caching is disabled for &lt;code class=&quot;highlighter-rouge&quot;&gt;safe&lt;/code&gt; mode,
36
+ however.&lt;/p&gt;
37
+
38
+ &lt;h3 id=&quot;super-powered-content-transformations-&quot;&gt;Super-powered content transformations 💪&lt;/h3&gt;
39
+
40
+ &lt;p&gt;We’ve upgraded Sass support so it should be faster and support. There’s also
41
+ support for sourcemaps now! Under the hood, our Sass support uses the &lt;code class=&quot;highlighter-rouge&quot;&gt;SassC&lt;/code&gt;
42
+ library now, which is supported directly by the Sass team, which should mean
43
+ better support for everybody in the long run.&lt;/p&gt;
44
+
45
+ &lt;p&gt;Kramdown is updated to version 2.1. This also brings with it a bunch of changes
46
+ to the Kramdown configuration, as the Kramdown team have extracted a fair
47
+ number of features into separate gems. Support for GitHub Flavored Markdown is
48
+ enabled by default, but if you’re using another Kramdown extension in your
49
+ site, you’ll likely need to update your plugin configuration. See the &lt;a href=&quot;/docs/upgrading/3-to-4/&quot;&gt;upgrade
50
+ guide&lt;/a&gt; for more details.&lt;/p&gt;
51
+
52
+ &lt;p&gt;The &lt;code class=&quot;highlighter-rouge&quot;&gt;link&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;post_url&lt;/code&gt; tags no longer need &lt;code class=&quot;highlighter-rouge&quot;&gt;site.baseurl&lt;/code&gt; prepended every
53
+ time they’re used. Those tags now use our &lt;code class=&quot;highlighter-rouge&quot;&gt;relative_url&lt;/code&gt; filter to take care of
54
+ this for you. Existing uses of the prepending pattern will break though!
55
+ Sorry! :sweat_smile:&lt;/p&gt;
56
+
57
+ &lt;p&gt;A few other smaller features when it comes to content:&lt;/p&gt;
58
+ &lt;ul&gt;
59
+ &lt;li&gt;The &lt;code class=&quot;highlighter-rouge&quot;&gt;link&lt;/code&gt; tag understands Liquid variables in the same fashion our
60
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;include&lt;/code&gt; tag does now.&lt;/li&gt;
61
+ &lt;li&gt;Disable Liquid processing for a particular page / document by adding
62
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;render_with_liquid: false&lt;/code&gt; to it’s front matter.&lt;/li&gt;
63
+ &lt;li&gt;Liquid’s binary &lt;code class=&quot;highlighter-rouge&quot;&gt;and&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;or&lt;/code&gt; operations can be used in the &lt;code class=&quot;highlighter-rouge&quot;&gt;where_exp&lt;/code&gt;
64
+ filter for more powerful filtering&lt;/li&gt;
65
+ &lt;/ul&gt;
66
+
67
+ &lt;p&gt;There’s some goodies for theme community as well. Developers may now bundle a
68
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;config.yml&lt;/code&gt; into their theme-gem to provide some boilerplate configurations for
69
+ the theme. Like other resources in the theme, these configuration values can also
70
+ be customized at the user’s end.&lt;/p&gt;
71
+
72
+ &lt;p&gt;Check out the &lt;a href=&quot;/docs/history/#v4-0-0&quot;&gt;full history&lt;/a&gt; and the various pull requests
73
+ for more details on all the enhancements and bug-fixes.&lt;/p&gt;
74
+
75
+ &lt;h3 id=&quot;upgrading-&quot;&gt;Upgrading 📈&lt;/h3&gt;
76
+
77
+ &lt;p&gt;First, read the &lt;a href=&quot;/docs/upgrading/3-to-4/&quot;&gt;upgrade guide&lt;/a&gt;!&lt;/p&gt;
78
+
79
+ &lt;p&gt;Next, Edit your project’s &lt;code class=&quot;highlighter-rouge&quot;&gt;Gemfile&lt;/code&gt; to test Jekyll v4.x:&lt;/p&gt;
80
+
81
+ &lt;div class=&quot;language-ruby highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;n&quot;&gt;gem&lt;/span&gt; &lt;span class=&quot;s2&quot;&gt;&quot;jekyll&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt; &lt;span class=&quot;s2&quot;&gt;&quot;~&amp;gt; 4.0&quot;&lt;/span&gt;
82
+ &lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
83
+
84
+ &lt;p&gt;Then run &lt;code class=&quot;highlighter-rouge&quot;&gt;bundle update&lt;/code&gt; to update all dependencies. Unless you’re using
85
+ third-party plugins that haven’t yet added support for Jekyll 4.0, you should be
86
+ good to go.&lt;/p&gt;
87
+
88
+ &lt;p&gt;Plugins and themes authors must relax the jekyll dependency in their &lt;code class=&quot;highlighter-rouge&quot;&gt;gemspec&lt;/code&gt; file
89
+ to allow for Jekyll v4.0:&lt;/p&gt;
90
+
91
+ &lt;p&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;spec.add_runtime_dependency &quot;jekyll&quot;, &quot;&amp;gt;= 3.6&quot;, &quot;&amp;lt; 5.0&quot;&lt;/code&gt;&lt;/p&gt;
92
+
93
+ &lt;p&gt;If your favorite plugin hasn’t relaxed that dependency yet, please gently
94
+ encourage them to do so. :slightly_smiling_face:&lt;/p&gt;
95
+
96
+ &lt;h3 id=&quot;have-questions&quot;&gt;Have questions❓&lt;/h3&gt;
97
+
98
+ &lt;p&gt;Please reach out on our &lt;a href=&quot;https://talk.jekyllrb.com&quot;&gt;community forum&lt;/a&gt;&lt;/p&gt;
99
+
100
+ &lt;h3 id=&quot;thank-you-&quot;&gt;Thank you!! 🙇&lt;/h3&gt;
101
+
102
+ &lt;p&gt;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.&lt;/p&gt;
103
+
104
+ &lt;p&gt;In addition, special thanks to the 139 contributors who made this
105
+ release possible via a pull request submission (in alphabetical order): Aidan
106
+ Fitzgerald, Akshat Kedia, Ale Muñoz, Alex Wood,
107
+ Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez,
108
+ Ananthakumar, Andreas Möller, Andrew Lyndem, Andrew Marcuse, Andy Alt, Anne
109
+ Gentle, Anny, Anuj Bhatnagar, argv-minus-one, Arjun Thakur, Arthur Attwell,
110
+ Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed,
111
+ Bjorn Krols, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Chris
112
+ Oliver, chrisfinazzo, Christian Oliff, Christoph Päper, Damien Solodow, Dan
113
+ Allen, Dan Friedman, Daniel Höpfl, David J. Malan, David Kennell, David Zhang,
114
+ Denis McDonald, Derek Smart, Derpy, Dusty Candland, Edgar Tinajero, Elvio
115
+ Vicosa, ExE Boss, Fons van der Plas, Frank Taillandier, Gareth Cooper, Grzegorz
116
+ Kaczorek, Haris Bjelic, Hodong Kim, ikeji, Isaac Goodman, Jacob Byers, Jakob
117
+ Krigovsky, James Rhea, Jan Pobořil, jess, jingze_lu, Joe Shannon, Jordan Morgan,
118
+ Jörg Steinsträter, Jorie Tappa, Josue Caraballo, jpasholk, Justin Vallelonga,
119
+ Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, krissy,
120
+ Kyle Barbour, Lars Kanis, Leandro Facchinetti, Liam Rosenfeld, Luis Enrique
121
+ Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, makmm, Manu Mathew, Mario,
122
+ Martin Scharm, Matt Kraai, Matt Massicotte, Matt Rogers, Matthew Rathbone,
123
+ Maxwell Gerber, Mertcan Yücel, Michael Bishop, Michael Hiiva, Michelle Greer,
124
+ Mike Kasberg, Mike Neumegen, mo khan, Monica Powell, Nicolas Hoizey, Nikhil
125
+ Benesch, Nikhil Swaminathan, Nikita Skalkin, Niklas Eicker, ninevra, Olivia
126
+ Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, penguinpet,
127
+ Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes,
128
+ Sadik Kuzu, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer,
129
+ Stephen Weiss, Steven Westmoreland, strangehill, Sundaram Kalyan Vedala, Thanos
130
+ Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev,
131
+ Vinicius Flores, Vitor Oliveira, Wouter Schoot, XhmikosR, Yi Feng Xie, Zhang
132
+ Xiangze, 김정환, 104fps.&lt;/p&gt;
133
+
134
+ &lt;p&gt;Happy Jekylling everyone!&lt;/p&gt;</content><author><name>mattr-</name></author><category term="release" /><summary type="html">Hi! 👋 I bring some good news! Jekyll 4.0.0 is finally here! 🎉</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 4.0.0.pre.alpha1 Released</title><link href="https://jekyllrb.com/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/" rel="alternate" type="text/html" title="Jekyll 4.0.0.pre.alpha1 Released" /><published>2019-03-18T10:17:31-07:00</published><updated>2019-03-18T10:17:31-07:00</updated><id>https://jekyllrb.com/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released</id><content type="html" xml:base="https://jekyllrb.com/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">&lt;p&gt;Dear Jekyllers,&lt;/p&gt;
135
+
136
+ &lt;p&gt;Time has come to release a first alpha for Jekyll 4!&lt;/p&gt;
137
+
138
+ &lt;p&gt;This pre version fixes many bugs, and should improve your build times. Some of you already shared &lt;a href=&quot;https://forestry.io/blog/how-i-reduced-my-jekyll-build-time-by-61/&quot;&gt;really&lt;/a&gt; &lt;a href=&quot;https://boris.schapira.dev/2018/11/jekyll-build-optimization/&quot;&gt;good&lt;/a&gt; results. We hope your Jekyll sites will also benefit from these optimizations.&lt;/p&gt;
139
+
140
+ &lt;p&gt;If you’re a plugin developer, we definitely need your feedback, especially if your plugin does not work with v4.&lt;/p&gt;
141
+
142
+ &lt;p&gt;Jekyll now exposes a &lt;a href=&quot;/tutorials/cache-api/&quot;&gt;caching API&lt;/a&gt;, that some plugins could benefit from.&lt;/p&gt;
143
+
144
+ &lt;p&gt;Also be aware that it’s a new &lt;em&gt;major&lt;/em&gt; version, and it comes with a few breaking changes, notably :&lt;/p&gt;
145
+
146
+ &lt;ol&gt;
147
+ &lt;li&gt;We dropped support for &lt;a href=&quot;https://www.ruby-lang.org/en/downloads/&quot;&gt;Ruby 2.3 who goes EOL at the end of the month&lt;/a&gt;.
148
+ GitHub Pages runs Ruby 2.5.x, services like Netlify or Forestry already upgraded to latest Ruby 2.6.x.&lt;/li&gt;
149
+ &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;link&lt;/code&gt; tag now include &lt;code class=&quot;highlighter-rouge&quot;&gt;relative_url&lt;/code&gt; filter, hurray &lt;a href=&quot;https://github.com/jekyll/jekyll/pull/6727&quot;&gt;no more need to prepend &lt;code class=&quot;highlighter-rouge&quot;&gt;{{ site.baseurl }}&lt;/code&gt; &lt;/a&gt;.&lt;/li&gt;
150
+ &lt;li&gt;&lt;a href=&quot;https://github.com/jekyll/jekyll/pull/6821&quot;&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;{% highlight %}&lt;/code&gt; now behaves like &lt;code class=&quot;highlighter-rouge&quot;&gt;{% raw %}&lt;/code&gt;&lt;/a&gt;, so you can no longer use &lt;code class=&quot;highlighter-rouge&quot;&gt;include&lt;/code&gt; tags within.&lt;/li&gt;
151
+ &lt;li&gt;We dropped support for Pygments, RedCarpet and rdiscount.&lt;/li&gt;
152
+ &lt;li&gt;We bumped kramdown to v2.&lt;/li&gt;
153
+ &lt;/ol&gt;
154
+
155
+ &lt;p&gt;Checkout the complete &lt;a href=&quot;https://github.com/jekyll/jekyll/releases/tag/v4.0.0.pre.alpha1&quot;&gt;changelog&lt;/a&gt; for more details.&lt;/p&gt;
156
+
157
+ &lt;p&gt;To test this pre version run:&lt;/p&gt;
158
+
159
+ &lt;div class=&quot;language-sh highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;gem &lt;span class=&quot;nb&quot;&gt;install &lt;/span&gt;jekyll &lt;span class=&quot;nt&quot;&gt;--pre&lt;/span&gt;
160
+ &lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
161
+
162
+ &lt;p&gt;Please test this version thoroughly and file bugs as you encounter them.&lt;/p&gt;
163
+
164
+ &lt;p&gt;Thanks to our dear contributors for helping making Jekyll better:&lt;/p&gt;
165
+
166
+ &lt;p&gt;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&lt;/p&gt;
167
+
168
+ &lt;p&gt;Happy Jekylling everyone!&lt;/p&gt;</content><author><name>dirtyf</name></author><category term="release" /><summary type="html">Dear Jekyllers,</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.8.5 Released</title><link href="https://jekyllrb.com/news/2018/11/04/jekyll-3-8-5-released/" rel="alternate" type="text/html" title="Jekyll 3.8.5 Released" /><published>2018-11-04T11:58:20-08:00</published><updated>2018-11-04T11:58:20-08:00</updated><id>https://jekyllrb.com/news/2018/11/04/jekyll-3-8-5-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/11/04/jekyll-3-8-5-released/">&lt;p&gt;This release fixes a bug where multiple Liquid tags were not supported in
169
+ excerpts.&lt;/p&gt;
170
+
171
+ &lt;p&gt;Thanks to @ashmaroli for fixing this issue in &lt;a href=&quot;https://github.com/jekyll/jekyll/pull/7250&quot;&gt;#7250&lt;/a&gt;.&lt;/p&gt;
172
+
173
+ &lt;p&gt;Happy Jekylling!&lt;/p&gt;</content><author><name>oe</name></author><category term="release" /><summary type="html">This release fixes a bug where multiple Liquid tags were not supported in excerpts.</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Security Fixes for series 3.6, 3.7 and 3.8</title><link href="https://jekyllrb.com/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/" rel="alternate" type="text/html" title="Security Fixes for series 3.6, 3.7 and 3.8" /><published>2018-09-19T05:30:00-07:00</published><updated>2018-09-19T05:30:00-07:00</updated><id>https://jekyllrb.com/news/2018/09/19/security-fixes-for-3-6-3-7-3-8</id><content type="html" xml:base="https://jekyllrb.com/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/">&lt;p&gt;Hi Jekyllers,&lt;/p&gt;
174
+
175
+ &lt;p&gt;We have patched a &lt;strong&gt;critical vulnerability&lt;/strong&gt; reported to GitHub a couple of weeks ago and have released a set of new gems to
176
+ bring that patch to you. The vulnerability allowed arbitrary file reads with the cunning use of the &lt;code class=&quot;highlighter-rouge&quot;&gt;include:&lt;/code&gt; setting in the
177
+ config file.&lt;/p&gt;
178
+
179
+ &lt;p&gt;By simply including a symlink in the &lt;code class=&quot;highlighter-rouge&quot;&gt;include&lt;/code&gt; array allowed the symlinked file to be read into the build when they shouldn’t
180
+ actually be read in any circumstance.  
181
+ Further details regarding the patch can be viewed at the &lt;a href=&quot;https://github.com/jekyll/jekyll/pull/7224&quot;&gt;pull request URL&lt;/a&gt;&lt;/p&gt;
182
+
183
+ &lt;p&gt;The patch has been released as versions &lt;code class=&quot;highlighter-rouge&quot;&gt;3.6.3&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;3.7.4&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;3.8.4&lt;/code&gt;.  
184
+ Thanks to @parkr &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.7.4&lt;/code&gt; was released a couple of weeks prior and has been bundled with &lt;code class=&quot;highlighter-rouge&quot;&gt;github-pages-v192&lt;/code&gt;.&lt;/p&gt;
185
+
186
+ &lt;p&gt;Please keep in mind that this issue affects &lt;em&gt;all previously released Jekyll versions&lt;/em&gt;. If you have not had
187
+ a good reason to upgrade to &lt;code class=&quot;highlighter-rouge&quot;&gt;3.6&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;3.7&lt;/code&gt; or &lt;code class=&quot;highlighter-rouge&quot;&gt;3.8&lt;/code&gt; yet, we advise that you do so at the earliest.&lt;/p&gt;
188
+
189
+ &lt;p&gt;As always, Happy Jekylling! :sparkles:&lt;/p&gt;</content><author><name>ashmaroli</name></author><category term="release" /><summary type="html">Hi Jekyllers,</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.8.3 Released</title><link href="https://jekyllrb.com/news/2018/06/05/jekyll-3-8-3-released/" rel="alternate" type="text/html" title="Jekyll 3.8.3 Released" /><published>2018-06-05T07:00:00-07:00</published><updated>2018-06-05T07:00:00-07:00</updated><id>https://jekyllrb.com/news/2018/06/05/jekyll-3-8-3-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/06/05/jekyll-3-8-3-released/">&lt;p&gt;This release fixes a regression in 3.8 where collections with &lt;code class=&quot;highlighter-rouge&quot;&gt;published: false&lt;/code&gt;
190
+ do not show when using the &lt;code class=&quot;highlighter-rouge&quot;&gt;--unpublished&lt;/code&gt; flag.&lt;/p&gt;
191
+
192
+ &lt;p&gt;Thanks to @philipbelesky for reporting and fixing this issue; collections with
193
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;published: false&lt;/code&gt; now behave the same way as Posts.&lt;/p&gt;</content><author><name>pathawks</name></author><category term="release" /><summary type="html">This release fixes a regression in 3.8 where collections with published: false do not show when using the --unpublished flag.</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.8.2 Released</title><link href="https://jekyllrb.com/news/2018/05/19/jekyll-3-8-2-released/" rel="alternate" type="text/html" title="Jekyll 3.8.2 Released" /><published>2018-05-19T08:30:00-07:00</published><updated>2018-05-19T08:30:00-07:00</updated><id>https://jekyllrb.com/news/2018/05/19/jekyll-3-8-2-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/05/19/jekyll-3-8-2-released/">&lt;p&gt;Hello Jekyllers!!&lt;/p&gt;
194
+
195
+ &lt;p&gt;Today we are releasing &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.8.2&lt;/code&gt;, which fixes the way Jekyll generates excerpts
196
+ for posts when the first paragraph of the post contains Liquid tags that take
197
+ advantage of &lt;a href=&quot;https://shopify.github.io/liquid/basics/whitespace/&quot;&gt;Liquid’s whitespace control feature&lt;/a&gt;.&lt;/p&gt;
198
+
199
+ &lt;p&gt;Big thanks to @kylebarbour, who first reported this issue and also very quickly
200
+ submitted a fix. Also thanks to @nickskalkin for making sure that we are using
201
+ the latest version of Rubocop to lint our code.&lt;/p&gt;</content><author><name>pathawks</name></author><category term="release" /><summary type="html">Hello Jekyllers!!</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.8.1 Released</title><link href="https://jekyllrb.com/news/2018/05/01/jekyll-3-8-1-released/" rel="alternate" type="text/html" title="Jekyll 3.8.1 Released" /><published>2018-05-01T09:56:01-07:00</published><updated>2018-05-01T09:56:01-07:00</updated><id>https://jekyllrb.com/news/2018/05/01/jekyll-3-8-1-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/05/01/jekyll-3-8-1-released/">&lt;p&gt;Happy May Day :tada:&lt;/p&gt;
202
+
203
+ &lt;p&gt;The Jekyll team is happy to announce the release of &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.8.1&lt;/code&gt;, which fixes
204
+ a couple of bugs that were introduced two weeks ago in &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.8.0&lt;/code&gt;. If you have
205
+ experienced trouble regarding post excerpts or non-published posts, this release
206
+ should be the remedy. Thanks to @Chaosed0 and @domLocalHeroes for originally
207
+ reporting these issues, and to @ashmaroli for fixing them so quickly.&lt;/p&gt;
208
+
209
+ &lt;p&gt;As a reminder, we have started work on Jekyll 4.0. If there are any
210
+ features that you would love to see added to Jekyll, or any pain points you
211
+ would like to see removed, please do add your ideas to the &lt;a href=&quot;https://github.com/jekyll/jekyll/issues/6948&quot;&gt;Jekyll 4.0 idea
212
+ list&lt;/a&gt;.&lt;/p&gt;</content><author><name>pathawks</name></author><category term="release" /><summary type="html">Happy May Day :tada:</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.8.0 Released</title><link href="https://jekyllrb.com/news/2018/04/19/jekyll-3-8-0-released/" rel="alternate" type="text/html" title="Jekyll 3.8.0 Released" /><published>2018-04-19T07:15:15-07:00</published><updated>2018-04-19T07:15:15-07:00</updated><id>https://jekyllrb.com/news/2018/04/19/jekyll-3-8-0-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/04/19/jekyll-3-8-0-released/">&lt;p&gt;Aloha Jekyllers!! :wave:&lt;/p&gt;
213
+
214
+ &lt;p&gt;After months of toiling on the codebase and shipping a couple of release-candidates, the Jekyll Team is delighted to finally
215
+ present &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.8.0&lt;/code&gt;, packed with optimizations, improvements, some new features and a couple of bug-fixes. Yay!!!&lt;/p&gt;
216
+
217
+ &lt;p&gt;Under the hood, Jekyll has undergone many minor changes that will allow it to run more performantly in the coming years. :smiley:
218
+ Rest assured, our users should see minor improvements in their site’s build times.&lt;/p&gt;
219
+
220
+ &lt;p&gt;Speaking of improvements, users running a site containing a huge amount of posts or those who like to use our &lt;code class=&quot;highlighter-rouge&quot;&gt;where&lt;/code&gt; filter
221
+ frequently in a single template, are going to see a massive reduction in their total build times!! :tada:&lt;/p&gt;
222
+
223
+ &lt;p&gt;Hold on, this version is not just about optimizations, there are some new features as well..:&lt;/p&gt;
224
+ &lt;ul&gt;
225
+ &lt;li&gt;Detect non-existent variables and filters specified in a template by enabling &lt;code class=&quot;highlighter-rouge&quot;&gt;strict_variables&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;strict_filters&lt;/code&gt; under the
226
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;liquid&lt;/code&gt; key in your config file.&lt;/li&gt;
227
+ &lt;li&gt;Allow &lt;em&gt;date filters&lt;/em&gt; to output ordinal days.&lt;/li&gt;
228
+ &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;jekyll doctor&lt;/code&gt; now warns you if you have opted for custom &lt;code class=&quot;highlighter-rouge&quot;&gt;collections_dir&lt;/code&gt; but placed &lt;code class=&quot;highlighter-rouge&quot;&gt;_posts&lt;/code&gt; directory outside that
229
+ directory.&lt;/li&gt;
230
+ &lt;/ul&gt;
231
+
232
+ &lt;p&gt;..and yes, a couple of bug-fixes, notably:&lt;/p&gt;
233
+ &lt;ul&gt;
234
+ &lt;li&gt;Jekyll now handles future-dated documents properly.&lt;/li&gt;
235
+ &lt;li&gt;Jekyll is able to handle Liquid blocks intelligently in excerpts.&lt;/li&gt;
236
+ &lt;li&gt;A few methods that were &lt;em&gt;not meant to be publically accessible&lt;/em&gt; have been entombed properly.&lt;/li&gt;
237
+ &lt;li&gt;A few bugs that still plagued our &lt;code class=&quot;highlighter-rouge&quot;&gt;collections_dir&lt;/code&gt; feature from &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.7&lt;/code&gt; got crushed.&lt;/li&gt;
238
+ &lt;/ul&gt;
239
+
240
+ &lt;p&gt;As always, the full list of changes since last release can be viewed &lt;a href=&quot;/docs/history/#v3-8-0&quot;&gt;here&lt;/a&gt;.&lt;/p&gt;
241
+
242
+ &lt;p&gt;A big thanks to the following people who contributed to our repository with pull-requests that improved our codebase, documentation
243
+ and tests:&lt;/p&gt;
244
+
245
+ &lt;p&gt;Ana María Martínez Gómez, Antonio Argote, Ashwin Maroli, Awjin Ahn, Ben Balter, Benjamin Høegh, Christian Oliff, Damien Solodow,
246
+ David Zhang, Delson Lima, Eric Cornelissen, Florian Thomas, Frank Taillandier, Heinrich Hartmann, Jakob Vad Nielsen, John Eismeier,
247
+ Kacper Duras, KajMagnus, Mario Cekic, Max Vilimpoc, Michael H, Mike Kasberg, Parker Moore, Pat Hawks, Paweł Kuna, Robert Riemann,
248
+ Roger Rohrbach, Semen Zhydenko, Stefan Dellmuth, Tim Carry, olivia, and steelman.&lt;/p&gt;
249
+
250
+ &lt;p&gt;Happy Jekylling!! :sparkles:&lt;/p&gt;</content><author><name>ashmaroli</name></author><category term="release" /><summary type="html">Aloha Jekyllers!! :wave:</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.7.3 Released</title><link href="https://jekyllrb.com/news/2018/02/24/jekyll-3-7-3-released/" rel="alternate" type="text/html" title="Jekyll 3.7.3 Released" /><published>2018-02-24T23:32:08-08:00</published><updated>2018-02-24T23:32:08-08:00</updated><id>https://jekyllrb.com/news/2018/02/24/jekyll-3-7-3-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/02/24/jekyll-3-7-3-released/">&lt;p&gt;Hello Jekyllers!! :wave:&lt;/p&gt;
251
+
252
+ &lt;p&gt;We’re pleased to announce the release of &lt;code class=&quot;highlighter-rouge&quot;&gt;v3.7.3&lt;/code&gt; which fixes a bug one might encounter while using &lt;code class=&quot;highlighter-rouge&quot;&gt;Jekyll - 3.7.x&lt;/code&gt; along with a
253
+ Jekyll plugin that in turn uses the &lt;code class=&quot;highlighter-rouge&quot;&gt;I18n&lt;/code&gt; library.&lt;/p&gt;
254
+
255
+ &lt;p&gt;When &lt;a href=&quot;/news/2018/01/02/jekyll-3-7-0-released/&quot;&gt;v3.7.0&lt;/a&gt; enhanced our &lt;code class=&quot;highlighter-rouge&quot;&gt;slugify&lt;/code&gt; filter with a &lt;code class=&quot;highlighter-rouge&quot;&gt;latin&lt;/code&gt; option, we also
256
+ hardcoded a default fallback locale for the &lt;code class=&quot;highlighter-rouge&quot;&gt;I18n&lt;/code&gt; library to avoid an exception raised in the event the library fails to find
257
+ any locale. This led to issues with third-party i18n plugins for Jekyll, especially since the default locale got assigned before
258
+ the plugin was loaded, irrespective of whether the &lt;code class=&quot;highlighter-rouge&quot;&gt;slugify&lt;/code&gt; filter was used.&lt;/p&gt;
259
+
260
+ &lt;p&gt;Jekyll will henceforth set the default locale if and only if necessary.&lt;/p&gt;</content><author><name>ashmaroli</name></author><category term="release" /><summary type="html">Hello Jekyllers!! :wave:</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry><entry><title type="html">Jekyll 3.7.2 Released</title><link href="https://jekyllrb.com/news/2018/01/25/jekyll-3-7-2-released/" rel="alternate" type="text/html" title="Jekyll 3.7.2 Released" /><published>2018-01-25T08:52:22-08:00</published><updated>2018-01-25T08:52:22-08:00</updated><id>https://jekyllrb.com/news/2018/01/25/jekyll-3-7-2-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/01/25/jekyll-3-7-2-released/">&lt;p&gt;Close on the heels of shipping 3.7.0, we were informed of a couple of
261
+ regressions due to the changes made in that release. In due time, Team Jekyll
262
+ set out to address those issues as early as possible.&lt;/p&gt;
263
+
264
+ &lt;p&gt;Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
265
+ RubyGems didn’t want to play nice) that fixes numerous issues! :tada:
266
+ The highlights being:&lt;/p&gt;
267
+
268
+ &lt;ul&gt;
269
+ &lt;li&gt;
270
+ &lt;p&gt;A major regression in 3.7.0 was that when a Front Matter Default was
271
+ configured with a &lt;code class=&quot;highlighter-rouge&quot;&gt;scope[&quot;path&quot;]&lt;/code&gt; set to a directory, Jekyll would scan
272
+ that directory for any subfolders and files, for each document in that
273
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;path&lt;/code&gt;.
274
+ Though this is intended, it increases build times in proportion to the size
275
+ of the directory.&lt;/p&gt;
276
+
277
+ &lt;p&gt;We addressed this by having Jekyll scan the directory path only if the user
278
+ explicitly configures the &lt;code class=&quot;highlighter-rouge&quot;&gt;scope[&quot;path&quot;]&lt;/code&gt; using wildcards.&lt;/p&gt;
279
+
280
+ &lt;p&gt;Read our &lt;a href=&quot;/docs/configuration/front-matter-defaults/#glob-patterns-in-front-matter-defaults&quot;&gt;documentation&lt;/a&gt;
281
+ for more details.&lt;/p&gt;
282
+
283
+ &lt;p&gt;A huge shout-out to @mmistakes for bringing this to our notice and
284
+ additionally providing us with a test repository to aid in resolving the issue.&lt;/p&gt;
285
+ &lt;/li&gt;
286
+ &lt;li&gt;
287
+ &lt;p&gt;Another regression reported was related to our “Custom collections
288
+ directory” feature introduced in 3.7.0.&lt;/p&gt;
289
+
290
+ &lt;p&gt;Users setting &lt;code class=&quot;highlighter-rouge&quot;&gt;collection_dir&lt;/code&gt; to a certain directory would have &lt;em&gt;altered&lt;/em&gt;
291
+ paths to their posts still at the root of their site’s source. This
292
+ roughly translated to 404 errors on URLs to their posts.&lt;/p&gt;
293
+
294
+ &lt;p&gt;Props to @localheinz for bringing this regression to our notice.&lt;/p&gt;
295
+
296
+ &lt;p&gt;We decided to resolve this by having Jekyll ignore posts and drafts at the
297
+ root of the site’s source directory if the user customizes the
298
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;collection_dir&lt;/code&gt; setting.&lt;/p&gt;
299
+
300
+ &lt;p&gt;Ergo, if you set a custom location for your collections, please ensure you
301
+ move all of your collections into that directory. &lt;strong&gt;This includes posts and
302
+ drafts as well&lt;/strong&gt;. Your links generated by
303
+ &lt;code class=&quot;highlighter-rouge&quot;&gt;{% post_url %}&lt;/code&gt; or &lt;code class=&quot;highlighter-rouge&quot;&gt;{% link %}&lt;/code&gt;
304
+ will adapt automatically.&lt;/p&gt;
305
+ &lt;/li&gt;
306
+ &lt;li&gt;
307
+ &lt;p&gt;We also found out that &lt;code class=&quot;highlighter-rouge&quot;&gt;gem &quot;wdm&quot;&lt;/code&gt; boosts performance while directories are
308
+ being watched on Windows. So we recommend having it included in your Gemfile
309
+ for a better development experience on Windows. (Newly generated Gemfiles
310
+ will hereafter have that gem listed automatically :wink:)&lt;/p&gt;
311
+ &lt;/li&gt;
312
+ &lt;/ul&gt;
313
+
314
+ &lt;p&gt;In addition to the above, numerous other minor fixes and documentation updates
315
+ have been made that should improve your Jekyll experience. All of which, would
316
+ not have been possible without our wonderful contributors:&lt;/p&gt;
317
+
318
+ &lt;p&gt;Alexandr, Andreas Möller, Ashwin Maroli, Chayoung You, Florian Thomas,
319
+ Frank Taillandier, Hendrik Schneider, Kacper Duras, Olivia, Parker Moore and
320
+ Paul Robert Lloyd.&lt;/p&gt;
321
+
322
+ &lt;p&gt;As always, you can see our full changelog on &lt;a href=&quot;/docs/history/&quot;&gt;the History page&lt;/a&gt;.&lt;/p&gt;
323
+
324
+ &lt;p&gt;Happy Jekylling! :sparkles:&lt;/p&gt;</content><author><name>ashmaroli</name></author><category term="release" /><summary type="html">Close on the heels of shipping 3.7.0, we were informed of a couple of regressions due to the changes made in that release. In due time, Team Jekyll set out to address those issues as early as possible.</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/jekyll-og.png" /></entry></feed>
@@ -1,249 +1,11 @@
1
- <!DOCTYPE HTML>
1
+ <!DOCTYPE html>
2
2
  <html lang="en-US">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.9.0">
7
- <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
- <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
- <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" />
12
- <link rel="stylesheet" href="/css/screen.css">
13
- <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
- <!-- Begin Jekyll SEO tag v2.6.1 -->
15
- <title>Getting Help | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.9.0" />
17
- <meta property="og:title" content="Getting Help" />
18
- <meta property="og:locale" content="en_US" />
19
- <meta name="description" content="Transform your plain text into static websites and blogs" />
20
- <meta property="og:description" content="Transform your plain text into static websites and blogs" />
21
- <link rel="canonical" href="https://jekyllrb.com/help/" />
22
- <meta property="og:url" content="https://jekyllrb.com/help/" />
23
- <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
24
- <meta name="twitter:card" content="summary" />
25
- <meta property="twitter:title" content="Getting Help" />
26
- <meta name="twitter:site" content="@jekyllrb" />
27
- <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
28
- <script type="application/ld+json">
29
- {"url":"https://jekyllrb.com/help/","headline":"Getting Help","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"https://schema.org"}</script>
30
- <!-- End Jekyll SEO tag -->
31
-
32
- <!--[if lt IE 9]>
33
- <script src="/js/html5shiv.min.js"></script>
34
- <script src="/js/respond.min.js"></script>
35
- <![endif]-->
36
- </head>
37
-
38
-
39
- <body class="wrap">
40
- <header>
41
- <div class="flexbox">
42
- <div class="center-on-mobiles">
43
- <h1>
44
- <a href="/" class="logo">
45
- <span class="sr-only">Jekyll</span>
46
- <img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
47
- </a>
48
- </h1>
49
- </div>
50
- <nav class="main-nav hide-on-mobiles">
51
- <ul>
52
- <li class="">
53
- <a href="/">Home</a>
54
- </li>
55
- <li class="">
56
- <a href="/docs/home/">Docs</a>
57
- </li>
58
- <li class="">
59
- <a href="/news/">News</a>
60
- </li>
61
- <li class="current">
62
- <a href="/help/">Help</a>
63
- </li>
64
- </ul>
65
-
66
- </nav>
67
- <div class="search hide-on-mobiles">
68
- <input type="text" id="docsearch-input" placeholder="Search the docs…">
69
-
70
- </div>
71
- <div class="meta hide-on-mobiles">
72
- <ul>
73
- <li>
74
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
75
- </li>
76
- <li>
77
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
78
- </li>
79
- </ul>
80
- </div>
81
- </div>
82
- <nav class="mobile-nav show-on-mobiles">
83
- <ul>
84
- <li class="">
85
- <a href="/">Home</a>
86
- </li>
87
- <li class="">
88
- <a href="/docs/home/">Docs</a>
89
- </li>
90
- <li class="">
91
- <a href="/news/">News</a>
92
- </li>
93
- <li class="current">
94
- <a href="/help/">Help</a>
95
- </li>
96
- <li>
97
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
98
- </li>
99
- </ul>
100
-
101
- </nav>
102
- </header>
103
-
104
-
105
- <section class="standalone">
106
- <div class="grid">
107
-
108
- <div class="unit whole">
109
- <article>
110
- <h1>Getting Help</h1>
111
- <p>Need help with Jekyll? Try these resources.</p>
112
-
113
- <h3 id="documentation"><a href="/docs/home/">Documentation</a></h3>
114
-
115
- <p>Start with our official guide to Jekyll covering installation, writing, customization, deployment, and more.</p>
116
-
117
- <h3 id="jekyll-talk"><a href="https://talk.jekyllrb.com/">Jekyll Talk</a></h3>
118
-
119
- <p>Our official Discourse forum. Here, users and contributors
120
- can ask questions and discuss all aspects of Jekyll.
121
- Also the place to <a href="https://talk.jekyllrb.com/t/jekyll-showcase-share-your-sites-built-with-jekyll/44/80">showcase your jekyll sites</a> and <a href="https://talk.jekyllrb.com/t/jekyll-theme-showcase-share-your-jekyll-themes/1382/2">share your jekyll themes</a>.</p>
122
-
123
- <h3 id="jekyll-on-stackoverflow"><a href="https://stackoverflow.com/questions/tagged/jekyll">Jekyll on StackOverflow</a></h3>
124
-
125
- <p>StackOverflow is a staple of any developer’s diet. Check out the Jekyll tag
126
- on StackOverflow for an answer to your question. Not there? Ask a new
127
- question!</p>
128
-
129
- <h3 id="jekyll-irc-channel"><a href="irc:irc.freenode.net/jekyll">Jekyll IRC Channel</a></h3>
130
-
131
- <p>Get live support at <strong>#jekyll</strong> on <strong>irc.freenode.net</strong>, the official
132
- Jekyll IRC channel.</p>
133
-
134
- <h3 id="view-source">View source</h3>
135
-
136
- <p>Learn from the source of others, you’ll find plenty of <a href="https://github.com/topics/jekyll-site">jekyll sites</a> and <a href="https://github.com/topics/jekyll-themes">jekyll themes</a> carefully handcrafted on GitHub.</p>
137
-
138
- <h3 id="tutorials"><a href="/tutorials/home">Tutorials</a></h3>
139
-
140
- <p>Similar to documentation, but more detailed scenario-based walk-throughs covering a variety of topics.</p>
141
-
142
- <h3 id="upgrading"><a href="/docs/upgrading/">Upgrading</a></h3>
143
-
144
- <p>Did you recently upgrade from Jekyll 1 to 2 or from Jekyll 2 to 3?
145
- Known breaking changes are listed in the upgrading docs.</p>
146
-
147
- <h3 id="jekyllconf"><a href="/jekyllconf/">Jekyllconf</a></h3>
148
-
149
- <p>Watch videos from members of the Jekyll community speak about interesting use cases, tricks they’ve learned or meta Jekyll topics.</p>
150
-
151
- <h3 id="google"><a href="https://www.google.com/?q=jekyll">Google</a></h3>
152
-
153
- <p>Add <strong>jekyll</strong> to almost any query, and you’ll find just what you need.</p>
154
-
155
- <h3 id="jekylljekyll"><a href="https://github.com/jekyll/jekyll/issues">jekyll/jekyll</a></h3>
156
-
157
- <p>Search through the issues on the main Jekyll development. Think you’ve
158
- found a bug? File a new issue.</p>
159
-
160
- <h3 id="jekyllrb-on-twitter"><a href="https://twitter.com/jekyllrb">@jekyllrb on Twitter</a></h3>
161
-
162
- <p>The official Jekyll Twitter account. It’s not checked often, so try the
163
- above first.</p>
164
-
165
- </article>
166
- </div>
167
-
168
- <div class="clear"></div>
169
-
170
- </div>
171
- </section>
172
-
173
-
174
- <footer>
175
- <div class="grid">
176
- <div class="unit one-third center-on-mobiles">
177
- <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>
178
- </div>
179
- <div class="unit two-thirds align-right center-on-mobiles">
180
- <p>
181
- Proudly hosted by
182
- <a href="https://github.com">
183
- <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
184
- </a>
185
- </p>
186
- </div>
187
- </div>
188
- </footer>
189
-
190
- <script>
191
- var anchorForId = function (id) {
192
- var anchor = document.createElement("a");
193
- anchor.className = "header-link";
194
- anchor.href = "#" + id;
195
- anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
196
- anchor.title = "Permalink";
197
- return anchor;
198
- };
199
-
200
- var linkifyAnchors = function (level, containingElement) {
201
- var headers = containingElement.getElementsByTagName("h" + level);
202
- for (var h = 0; h < headers.length; h++) {
203
- var header = headers[h];
204
-
205
- if (typeof header.id !== "undefined" && header.id !== "") {
206
- header.appendChild(anchorForId(header.id));
207
- }
208
- }
209
- };
210
-
211
- document.onreadystatechange = function () {
212
- if (this.readyState === "complete") {
213
- var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
214
- if (!contentBlock) {
215
- return;
216
- }
217
- for (var level = 1; level <= 6; level++) {
218
- linkifyAnchors(level, contentBlock);
219
- }
220
- }
221
- };
222
- </script>
223
-
224
-
225
- <!-- Google Analytics (https://www.google.com/analytics) -->
226
- <script>
227
- !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
228
- (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
229
- L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
230
- L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
231
-
232
- ga('create', 'UA-50755011-1', 'jekyllrb.com');
233
- ga('send', 'pageview');
234
-
235
- </script>
236
-
237
-
238
- <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
239
- <script type="text/javascript"> docsearch({
240
- apiKey: '50fe39c839958dfad797000f33e2ec17',
241
- indexName: 'jekyllrb',
242
- inputSelector: '#docsearch-input',
243
- enhancedSearchInput: true,
244
- debug: false // Set debug to true if you want to inspect the dropdown
245
- });
246
- </script>
247
-
248
- </body>
3
+ <meta charset="utf-8">
4
+ <title>Redirecting&hellip;</title>
5
+ <link rel="canonical" href="https://jekyllrb.com/docs/community/">
6
+ <script>location="https://jekyllrb.com/docs/community/"</script>
7
+ <meta http-equiv="refresh" content="0; url=https://jekyllrb.com/docs/community/">
8
+ <meta name="robots" content="noindex">
9
+ <h1>Redirecting&hellip;</h1>
10
+ <a href="https://jekyllrb.com/docs/community/">Click here if you are not redirected.</a>
249
11
  </html>