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>Jekyll 3.3 is here with better theme support, new URL filters, and tons more | 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="Jekyll 3.3 is here with better theme support, new URL filters, and tons more" />
18
19
  <meta name="author" content="parkr" />
19
20
  <meta property="og:locale" content="en_US" />
@@ -22,17 +23,17 @@
22
23
  <link rel="canonical" href="https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/" />
23
24
  <meta property="og:url" content="https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/" />
24
25
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
25
- <meta property="og:image" content="https://jekyllrb.com/img/twitter-card.png" />
26
+ <meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
26
27
  <meta property="og:type" content="article" />
27
28
  <meta property="article:published_time" content="2016-10-06T11:10:38-07:00" />
28
29
  <meta name="twitter:card" content="summary_large_image" />
29
- <meta property="twitter:image" content="https://jekyllrb.com/img/twitter-card.png" />
30
+ <meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
30
31
  <meta property="twitter:title" content="Jekyll 3.3 is here with better theme support, new URL filters, and tons more" />
31
32
  <meta name="twitter:site" content="@jekyllrb" />
32
33
  <meta name="twitter:creator" content="@parkr" />
33
34
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
34
35
  <script type="application/ld+json">
35
- {"url":"https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/","headline":"Jekyll 3.3 is here with better theme support, new URL filters, and tons more","dateModified":"2016-10-06T11:10:38-07:00","datePublished":"2016-10-06T11:10:38-07:00","image":"https://jekyllrb.com/img/twitter-card.png","author":{"@type":"Person","name":"parkr"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"parkr"},"description":"There are tons of great new quality-of-life features you can use in 3.3. Three key things you might want to try:","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
36
+ {"description":"There are tons of great new quality-of-life features you can use in 3.3. Three key things you might want to try:","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/"},"headline":"Jekyll 3.3 is here with better theme support, new URL filters, and tons more","dateModified":"2016-10-06T11:10:38-07:00","url":"https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/","datePublished":"2016-10-06T11:10:38-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"parkr"},"author":{"@type":"Person","name":"parkr"},"@context":"https://schema.org"}</script>
36
37
  <!-- End Jekyll SEO tag -->
37
38
 
38
39
  <!--[if lt IE 9]>
@@ -55,18 +56,27 @@
55
56
  </div>
56
57
  <nav class="main-nav hide-on-mobiles">
57
58
  <ul>
58
- <li class="">
59
+
60
+ <li>
59
61
  <a href="/">Home</a>
60
62
  </li>
61
- <li class="">
62
- <a href="/docs/home/">Docs</a>
63
+
64
+ <li>
65
+ <a href="/docs/">Docs</a>
66
+ </li>
67
+
68
+ <li>
69
+ <a href="/resources/">Resources</a>
70
+ </li>
71
+
72
+ <li>
73
+ <a href="/showcase/">Showcase</a>
63
74
  </li>
75
+
64
76
  <li class="current">
65
77
  <a href="/news/">News</a>
66
78
  </li>
67
- <li class="">
68
- <a href="/help/">Help</a>
69
- </li>
79
+
70
80
  </ul>
71
81
 
72
82
  </nav>
@@ -77,7 +87,7 @@
77
87
  <div class="meta hide-on-mobiles">
78
88
  <ul>
79
89
  <li>
80
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
90
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
81
91
  </li>
82
92
  <li>
83
93
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -87,18 +97,24 @@
87
97
  </div>
88
98
  <nav class="mobile-nav show-on-mobiles">
89
99
  <ul>
90
- <li class="">
91
- <a href="/">Home</a>
92
- </li>
93
- <li class="">
94
- <a href="/docs/home/">Docs</a>
95
- </li>
96
- <li class="current">
97
- <a href="/news/">News</a>
98
- </li>
99
- <li class="">
100
- <a href="/help/">Help</a>
101
- </li>
100
+
101
+ <li>
102
+ <a href="/">Home</a>
103
+ </li>
104
+
105
+ <li>
106
+ <a href="/docs/">Docs</a>
107
+ </li>
108
+
109
+ <li>
110
+ <a href="/resources/">Resources</a>
111
+ </li>
112
+
113
+
114
+ <li class="current">
115
+ <a href="/news/">News</a>
116
+ </li>
117
+
102
118
  <li>
103
119
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
104
120
  </li>
@@ -115,16 +131,32 @@
115
131
  <select onchange="if (this.value) window.location.href=this.value">
116
132
  <option value="">Navigate the blog…</option>
117
133
  <option value="/news/">Home</option>
118
- <optgroup label="v1.x">
134
+ <optgroup label="posts">
135
+
136
+ <option value="/news/2019/08/20/jekyll-4-0-0-released/">Jekyll 4.0.0 Released</option>
137
+
138
+ <option value="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">Jekyll 4.0.0.pre.beta1 Released</option>
119
139
 
120
140
  <option value="/news/2019/07/02/jekyll-3-8-6-released/">Jekyll 3.8.6 Released</option>
121
141
 
142
+ <option value="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">Jekyll 4.0.0.pre.alpha1 Released</option>
143
+
144
+ <option value="/news/2018/11/04/jekyll-3-8-5-released/">Jekyll 3.8.5 Released</option>
145
+
146
+ <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>
147
+
148
+ <option value="/news/2018/08/01/jekyll-sponsoring/">Sponsoring Jekyll's development</option>
149
+
122
150
  <option value="/news/2018/06/05/jekyll-3-8-3-released/">Jekyll 3.8.3 Released</option>
123
151
 
124
152
  <option value="/news/2018/05/19/jekyll-3-8-2-released/">Jekyll 3.8.2 Released</option>
125
153
 
126
154
  <option value="/news/2018/05/01/jekyll-3-8-1-released/">Jekyll 3.8.1 Released</option>
127
155
 
156
+ <option value="/news/2018/04/19/development-update/">Jekyll 4.0 is on the Horizon!</option>
157
+
158
+ <option value="/news/2018/04/19/jekyll-3-8-0-released/">Jekyll 3.8.0 Released</option>
159
+
128
160
  <option value="/news/2018/02/24/jekyll-3-7-3-released/">Jekyll 3.7.3 Released</option>
129
161
 
130
162
  <option value="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</option>
@@ -296,66 +328,66 @@
296
328
  <p>There are tons of great new quality-of-life features you can use in 3.3.
297
329
  Three key things you might want to try:</p>
298
330
 
299
- <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>
331
+ <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>
300
332
 
301
333
  <p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
302
334
  <a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
303
335
  layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
304
336
 
305
337
  <p>In an effort to make theme management a bit easier, any files you put into
306
- <code class="language-plaintext highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
338
+ <code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
307
339
  user’s site. This means you can ship SCSS and CoffeeScript, images and
308
340
  webfonts, and so on – anything you’d consider a part of the
309
341
  <em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
310
- front matter, it will be converted and rendered. No YAML front matter, and
342
+ front matter, it will be converted and rendered. No front matter, and
311
343
  it will simply be copied over like a static asset.</p>
312
344
 
313
345
  <p>Note that if a user has a file of the same path, the theme content will not
314
- be included in the site, i.e. a user’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code> will be read and
315
- processed if present instead of a theme’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code>.</p>
346
+ be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
347
+ processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
316
348
 
317
349
  <p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
318
350
  for more info.</p>
319
351
 
320
- <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>
352
+ <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>
321
353
 
322
- <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
354
+ <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
323
355
  new filters have you covered. When working locally, if you set your
324
- <code class="language-plaintext highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="language-plaintext highlighter-rouge">baseurl: "/myproject"</code>,
325
- then <code class="language-plaintext highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
356
+ <code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
357
+ then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
326
358
  you pass it:</p>
327
359
 
328
360
  <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>
329
361
 
330
- <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
331
- <code class="language-plaintext highlighter-rouge">"/"</code>):</p>
362
+ <p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
363
+ <code class="highlighter-rouge">"/"</code>):</p>
332
364
 
333
365
  <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>
334
366
 
335
- <p>A result of <code class="language-plaintext highlighter-rouge">relative_url</code> will safely always produce a URL which is
336
- relative to the domain root. A similar principle applies to <code class="language-plaintext highlighter-rouge">absolute_url</code>.
337
- 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
367
+ <p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
368
+ relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
369
+ It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
338
370
  easier to make:</p>
339
371
 
340
372
  <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>
341
373
 
342
- <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>
374
+ <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>
343
375
 
344
- <p>When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
345
- <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
346
- development. If you are using the new <code class="language-plaintext highlighter-rouge">absolute_url</code> filter, or using
347
- <code class="language-plaintext highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
348
- 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>
376
+ <p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
377
+ <code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
378
+ development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
379
+ <code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
380
+ which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
349
381
 
350
- <p>No longer! When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
351
- 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
352
- <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>
353
- will yield <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
382
+ <p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
383
+ the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
384
+ <code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
385
+ will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
354
386
 
355
387
  <p>This happens by default when running Jekyll locally. It will not be set if
356
- 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
357
- any value except <code class="language-plaintext highlighter-rouge">development</code> (its default value), Jekyll will not
358
- overwrite the value of <code class="language-plaintext highlighter-rouge">url</code> in your config. And again, this only applies
388
+ 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
389
+ any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
390
+ overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
359
391
  to serving, not to building.</p>
360
392
 
361
393
  <h2 id="a-lot-more">A <em>lot</em> more!</h2>
@@ -391,34 +423,34 @@ bug report.</p>
391
423
  <div class="unit one-fifth hide-on-mobiles">
392
424
  <aside>
393
425
  <ul>
394
- <li class="">
426
+ <li>
395
427
  <a href="/news/">All News</a>
396
428
  </li>
397
- <li class="">
429
+ <li>
398
430
  <a href="/news/releases/">Jekyll Releases</a>
399
431
  </li>
400
432
  </ul>
401
433
  <h4>Recent Releases</h4>
402
434
  <ul>
403
435
 
404
- <li class="">
405
- <a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
436
+ <li>
437
+ <a href="/news/2019/08/20/jekyll-4-0-0-released/">Version 4.0.0</a>
406
438
  </li>
407
439
 
408
- <li class="">
409
- <a href="/news/2018/06/05/jekyll-3-8-3-released/">Version 3.8.3</a>
440
+ <li>
441
+ <a href="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">Version 4.0.0.pre.beta1</a>
410
442
  </li>
411
443
 
412
- <li class="">
413
- <a href="/news/2018/05/19/jekyll-3-8-2-released/">Version 3.8.2</a>
444
+ <li>
445
+ <a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
414
446
  </li>
415
447
 
416
- <li class="">
417
- <a href="/news/2018/05/01/jekyll-3-8-1-released/">Version 3.8.1</a>
448
+ <li>
449
+ <a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">Version 4.0.0.pre.alpha1</a>
418
450
  </li>
419
451
 
420
- <li class="">
421
- <a href="/news/2018/02/24/jekyll-3-7-3-released/">Version 3.7.3</a>
452
+ <li>
453
+ <a href="/news/2018/11/04/jekyll-3-8-5-released/">Version 3.8.5</a>
422
454
  </li>
423
455
 
424
456
  <li>
@@ -427,189 +459,213 @@ bug report.</p>
427
459
  </ul>
428
460
  <h4>Other News</h4>
429
461
  <ul>
462
+
430
463
 
464
+
431
465
 
466
+
432
467
 
468
+
433
469
 
470
+
434
471
 
472
+
435
473
 
474
+
436
475
 
476
+ <li>
477
+ <a href="/news/2018/08/01/jekyll-sponsoring/">Sponsoring Jekyll's development</a>
478
+ </li>
437
479
 
480
+
438
481
 
482
+
439
483
 
484
+
440
485
 
486
+
441
487
 
442
- <li class="">
443
- <a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
488
+ <li>
489
+ <a href="/news/2018/04/19/development-update/">Jekyll 4.0 is on the Horizon!</a>
444
490
  </li>
445
491
 
492
+
446
493
 
494
+
447
495
 
496
+
448
497
 
498
+ <li>
499
+ <a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
500
+ </li>
449
501
 
502
+
450
503
 
504
+
451
505
 
506
+
452
507
 
508
+
453
509
 
454
- <li class="">
510
+ <li>
455
511
  <a href="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</a>
456
512
  </li>
457
513
 
514
+
458
515
 
516
+
459
517
 
518
+
460
519
 
520
+
461
521
 
522
+
462
523
 
524
+
463
525
 
526
+
464
527
 
528
+
465
529
 
530
+
466
531
 
532
+
467
533
 
534
+
468
535
 
469
-
470
-
471
-
472
-
473
-
474
-
475
-
476
-
477
-
478
-
479
-
480
- <li class="">
536
+ <li>
481
537
  <a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
482
538
  </li>
483
539
 
540
+
484
541
 
542
+
485
543
 
544
+
486
545
 
487
-
488
-
489
-
490
- <li class="">
546
+ <li>
491
547
  <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>
492
548
  </li>
493
549
 
550
+
494
551
 
552
+
495
553
 
554
+
496
555
 
556
+
497
557
 
558
+
498
559
 
560
+
499
561
 
562
+
500
563
 
501
-
502
-
503
-
504
-
505
-
506
-
507
-
508
- <li class="">
564
+ <li>
509
565
  <a href="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</a>
510
566
  </li>
511
567
 
568
+
512
569
 
570
+
513
571
 
572
+
514
573
 
574
+
515
575
 
576
+
516
577
 
578
+
517
579
 
580
+
518
581
 
582
+
519
583
 
520
-
521
-
522
-
523
-
524
-
525
-
526
-
527
-
528
- <li class="">
584
+ <li>
529
585
  <a href="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</a>
530
586
  </li>
531
587
 
588
+
532
589
 
590
+
533
591
 
534
-
535
-
536
- <li class="">
592
+ <li>
537
593
  <a href="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet & Greet at GitHub HQ</a>
538
594
  </li>
539
595
 
596
+
540
597
 
598
+
541
599
 
542
-
543
-
544
- <li class="">
600
+ <li>
545
601
  <a href="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</a>
546
602
  </li>
547
603
 
604
+
548
605
 
606
+
549
607
 
608
+
550
609
 
610
+
551
611
 
612
+
552
613
 
614
+
553
615
 
616
+
554
617
 
618
+
555
619
 
620
+
556
621
 
557
-
558
-
559
-
560
-
561
-
562
-
563
-
564
-
565
-
566
- <li class="">
622
+ <li>
567
623
  <a href="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</a>
568
624
  </li>
569
625
 
626
+
570
627
 
628
+
571
629
 
630
+
572
631
 
632
+
573
633
 
634
+
574
635
 
636
+
575
637
 
638
+
576
639
 
640
+
577
641
 
642
+
578
643
 
644
+
579
645
 
646
+
580
647
 
648
+
581
649
 
650
+
582
651
 
652
+
583
653
 
654
+
584
655
 
656
+
585
657
 
658
+
586
659
 
660
+
587
661
 
662
+
588
663
 
664
+
589
665
 
666
+
590
667
 
591
-
592
-
593
-
594
-
595
-
596
-
597
-
598
-
599
-
600
-
601
-
602
-
603
-
604
-
605
-
606
-
607
-
608
-
609
-
610
-
611
-
612
-
668
+
613
669
  </ul>
614
670
  </aside>
615
671
  </div>
@@ -624,7 +680,8 @@ bug report.</p>
624
680
  <footer>
625
681
  <div class="grid">
626
682
  <div class="unit one-third center-on-mobiles">
627
- <p>The contents of this website are <br />&copy;&nbsp;2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
683
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
684
+ <p>The contents of this website are <br />&copy;&nbsp;2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
628
685
  </div>
629
686
  <div class="unit two-thirds align-right center-on-mobiles">
630
687
  <p>
@@ -634,6 +691,14 @@ bug report.</p>
634
691
  </a>
635
692
  </p>
636
693
  </div>
694
+ <div class="unit two-thirds align-right center-on-mobiles">
695
+ <p>
696
+ Jekyll is funded thanks to its
697
+ <a href="https://github.com/jekyll/jekyll#sponsors">
698
+ sponsors!
699
+ </a>
700
+ </p>
701
+ </div>
637
702
  </div>
638
703
  </footer>
639
704