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>Releasing a new version | 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="Releasing a new version" />
18
19
  <meta property="og:locale" content="en_US" />
19
20
  <meta name="description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone." />
@@ -21,14 +22,16 @@
21
22
  <link rel="canonical" href="https://jekyllrb.com/docs/maintaining/releasing-a-new-version/" />
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/releasing-a-new-version/" />
23
24
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
25
+ <meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
24
26
  <meta property="og:type" content="article" />
25
- <meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
26
- <meta name="twitter:card" content="summary" />
27
+ <meta property="article:published_time" content="2019-09-11T07:30:27-07:00" />
28
+ <meta name="twitter:card" content="summary_large_image" />
29
+ <meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
27
30
  <meta property="twitter:title" content="Releasing a new version" />
28
31
  <meta name="twitter:site" content="@jekyllrb" />
29
32
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
30
33
  <script type="application/ld+json">
31
- {"url":"https://jekyllrb.com/docs/maintaining/releasing-a-new-version/","headline":"Releasing a new version","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/releasing-a-new-version/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
34
+ {"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/releasing-a-new-version/"},"headline":"Releasing a new version","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/maintaining/releasing-a-new-version/","datePublished":"2019-09-11T07:30:27-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@context":"https://schema.org"}</script>
32
35
  <!-- End Jekyll SEO tag -->
33
36
 
34
37
  <!--[if lt IE 9]>
@@ -51,18 +54,27 @@
51
54
  </div>
52
55
  <nav class="main-nav hide-on-mobiles">
53
56
  <ul>
54
- <li class="">
57
+
58
+ <li>
55
59
  <a href="/">Home</a>
56
60
  </li>
61
+
57
62
  <li class="current">
58
- <a href="/docs/home/">Docs</a>
63
+ <a href="/docs/">Docs</a>
59
64
  </li>
60
- <li class="">
61
- <a href="/news/">News</a>
65
+
66
+ <li>
67
+ <a href="/resources/">Resources</a>
62
68
  </li>
63
- <li class="">
64
- <a href="/help/">Help</a>
69
+
70
+ <li>
71
+ <a href="/showcase/">Showcase</a>
65
72
  </li>
73
+
74
+ <li>
75
+ <a href="/news/">News</a>
76
+ </li>
77
+
66
78
  </ul>
67
79
 
68
80
  </nav>
@@ -73,7 +85,7 @@
73
85
  <div class="meta hide-on-mobiles">
74
86
  <ul>
75
87
  <li>
76
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
88
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
77
89
  </li>
78
90
  <li>
79
91
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -83,18 +95,24 @@
83
95
  </div>
84
96
  <nav class="mobile-nav show-on-mobiles">
85
97
  <ul>
86
- <li class="">
87
- <a href="/">Home</a>
88
- </li>
89
- <li class="current">
90
- <a href="/docs/home/">Docs</a>
91
- </li>
92
- <li class="">
93
- <a href="/news/">News</a>
94
- </li>
95
- <li class="">
96
- <a href="/help/">Help</a>
97
- </li>
98
+
99
+ <li>
100
+ <a href="/">Home</a>
101
+ </li>
102
+
103
+ <li class="current">
104
+ <a href="/docs/">Docs</a>
105
+ </li>
106
+
107
+ <li>
108
+ <a href="/resources/">Resources</a>
109
+ </li>
110
+
111
+
112
+ <li>
113
+ <a href="/news/">News</a>
114
+ </li>
115
+
98
116
  <li>
99
117
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
100
118
  </li>
@@ -113,176 +131,152 @@
113
131
 
114
132
  <optgroup label="Getting Started">
115
133
 
116
-
117
-
118
- <option value="/docs/home/">Welcome</option>
119
-
120
-
121
-
122
- <option value="/docs/quickstart/">Quick-start guide</option>
123
-
124
-
125
-
126
- <option value="/docs/installation/">Installation</option>
127
-
128
-
129
-
130
- <option value="/docs/windows/">Jekyll on Windows</option>
131
-
132
-
133
-
134
- <option value="/docs/usage/">Basic Usage</option>
135
-
136
-
137
-
138
- <option value="/docs/structure/">Directory structure</option>
139
-
140
-
141
-
142
- <option value="/docs/configuration/">Configuration</option>
143
-
144
-
145
- </optgroup>
146
-
147
- <optgroup label="Your Content">
134
+
135
+ <option value="/docs/">
136
+ Quickstart
137
+ </option>
138
+
139
+
140
+ <option value="/docs/ruby-101/">
141
+ Ruby 101
142
+ </option>
143
+
144
+
145
+ <option value="/docs/installation/">
146
+ Installation
147
+ </option>
148
+
149
+
150
+ <option value="/docs/community/">
151
+ Community
152
+ </option>
153
+
154
+
155
+ <option value="/docs/step-by-step/01-setup/">
156
+ Step by Step Tutorial
157
+ </option>
148
158
 
149
-
150
-
151
- <option value="/docs/frontmatter/">Front Matter</option>
152
-
153
-
154
-
155
- <option value="/docs/posts/">Writing posts</option>
156
-
157
-
158
-
159
- <option value="/docs/drafts/">Working with drafts</option>
160
-
161
-
162
-
163
- <option value="/docs/pages/">Creating pages</option>
164
-
165
-
166
-
167
- <option value="/docs/static-files/">Static Files</option>
168
-
169
-
170
-
171
- <option value="/docs/variables/">Variables</option>
172
-
173
-
174
-
175
- <option value="/docs/collections/">Collections</option>
176
-
177
-
178
-
179
- <option value="/docs/datafiles/">Data Files</option>
180
-
181
-
182
-
183
- <option value="/docs/assets/">Assets</option>
184
-
185
-
186
-
187
- <option value="/docs/migrations/">Blog migrations</option>
188
-
189
-
190
159
  </optgroup>
191
160
 
192
- <optgroup label="Customization">
161
+ <optgroup label="Build">
162
+
163
+
164
+ <option value="/docs/usage/">
165
+ Command Line Usage
166
+ </option>
167
+
168
+
169
+ <option value="/docs/configuration/">
170
+ Configuration
171
+ </option>
193
172
 
194
-
195
-
196
- <option value="/docs/templates/">Templates</option>
197
-
198
-
199
-
200
- <option value="/docs/includes/">Includes</option>
201
-
202
-
203
-
204
- <option value="/docs/permalinks/">Permalinks</option>
205
-
206
-
207
-
208
- <option value="/docs/pagination/">Pagination</option>
209
-
210
-
211
-
212
- <option value="/docs/plugins/">Plugins</option>
213
-
214
-
215
-
216
- <option value="/docs/themes/">Themes</option>
217
-
218
-
219
-
220
- <option value="/docs/extras/">Extras</option>
221
-
222
-
223
173
  </optgroup>
224
174
 
225
- <optgroup label="Deployment">
175
+ <optgroup label="Content">
176
+
177
+
178
+ <option value="/docs/pages/">
179
+ Pages
180
+ </option>
181
+
182
+
183
+ <option value="/docs/posts/">
184
+ Posts
185
+ </option>
186
+
187
+
188
+ <option value="/docs/front-matter/">
189
+ Front Matter
190
+ </option>
191
+
192
+
193
+ <option value="/docs/collections/">
194
+ Collections
195
+ </option>
196
+
197
+
198
+ <option value="/docs/datafiles/">
199
+ Data Files
200
+ </option>
201
+
202
+
203
+ <option value="/docs/assets/">
204
+ Assets
205
+ </option>
206
+
207
+
208
+ <option value="/docs/static-files/">
209
+ Static Files
210
+ </option>
226
211
 
227
-
228
-
229
- <option value="/docs/github-pages/">GitHub Pages</option>
230
-
231
-
232
-
233
- <option value="/docs/deployment-methods/">Deployment methods</option>
234
-
235
-
236
-
237
- <option value="/docs/continuous-integration/">Continuous Integration</option>
238
-
239
-
240
212
  </optgroup>
241
213
 
242
- <optgroup label="Miscellaneous">
214
+ <optgroup label="Site Structure">
215
+
216
+
217
+ <option value="/docs/structure/">
218
+ Directory Structure
219
+ </option>
220
+
221
+
222
+ <option value="/docs/liquid/">
223
+ Liquid
224
+ </option>
225
+
226
+
227
+ <option value="/docs/variables/">
228
+ Variables
229
+ </option>
230
+
231
+
232
+ <option value="/docs/includes/">
233
+ Includes
234
+ </option>
235
+
236
+
237
+ <option value="/docs/layouts/">
238
+ Layouts
239
+ </option>
240
+
241
+
242
+ <option value="/docs/permalinks/">
243
+ Permalinks
244
+ </option>
245
+
246
+
247
+ <option value="/docs/themes/">
248
+ Themes
249
+ </option>
250
+
251
+
252
+ <option value="/docs/pagination/">
253
+ Pagination
254
+ </option>
243
255
 
244
-
245
-
246
- <option value="/docs/troubleshooting/">Troubleshooting</option>
247
-
248
-
249
-
250
- <option value="/docs/sites/">Sites using Jekyll</option>
251
-
252
-
253
-
254
- <option value="/docs/resources/">Resources</option>
255
-
256
-
257
-
258
- <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
259
-
260
-
261
-
262
- <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
263
-
264
-
265
256
  </optgroup>
266
257
 
267
- <optgroup label="Meta">
258
+ <optgroup label="Guides">
259
+
260
+
261
+ <option value="/docs/plugins/">
262
+ Plugins
263
+ </option>
264
+
265
+
266
+ <option value="/docs/migrations/">
267
+ Blog Migrations
268
+ </option>
269
+
270
+
271
+ <option value="/docs/upgrading/">
272
+ Upgrading
273
+ </option>
274
+
275
+
276
+ <option value="/docs/deployment/">
277
+ Deployment
278
+ </option>
268
279
 
269
-
270
-
271
- <option value="/docs/contributing/">Contributing</option>
272
-
273
-
274
-
275
- <option value="/docs/maintaining/">Maintaining Jekyll</option>
276
-
277
-
278
-
279
- <option value="/docs/conduct/">Code of Conduct</option>
280
-
281
-
282
-
283
- <option value="/docs/history/">History</option>
284
-
285
-
286
280
  </optgroup>
287
281
 
288
282
  </select>
@@ -292,7 +286,7 @@
292
286
  <div class="unit four-fifths">
293
287
  <article>
294
288
  <div class="improve right hide-on-mobiles">
295
- <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/maintaining/releasing-a-new-version.md"><i class="fa fa-pencil"></i>  Improve this page</a>
289
+ <a data-proofer-ignore href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/maintaining/releasing-a-new-version.md"><i class="fa fa-pencil"></i>  Improve this page</a>
296
290
  </div>
297
291
  <h1>Releasing a new version</h1>
298
292
  <p class="note info"><strong>This guide is for maintainers.</strong> These special people have <strong>write access</strong> to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.</p>
@@ -301,7 +295,7 @@
301
295
 
302
296
  <h3 id="bump-the-version">Bump the version</h3>
303
297
 
304
- <p>The only important place you need to manually bump the version is in <code class="language-plaintext highlighter-rouge">lib/jekyll/version.rb</code>. Adjust that, and everything else should work fine.</p>
298
+ <p>The only important place you need to manually bump the version is in <code class="highlighter-rouge">lib/jekyll/version.rb</code>. Adjust that, and everything else should work fine.</p>
305
299
 
306
300
  <h3 id="update-the-history-document">Update the history document</h3>
307
301
 
@@ -311,7 +305,7 @@
311
305
  </span><span class="gi">+## 3.7.1 / 2018-01-25
312
306
  </span></code></pre></div></div>
313
307
 
314
- <p>Adjust the version number and the date. The <code class="language-plaintext highlighter-rouge">## HEAD</code> heading will be regenerated next time a pull request is merged.</p>
308
+ <p>Adjust the version number and the date. The <code class="highlighter-rouge">## HEAD</code> heading will be regenerated next time a pull request is merged.</p>
315
309
 
316
310
  <p>Once you’ve done this, update the website by running the following command:</p>
317
311
 
@@ -320,21 +314,21 @@
320
314
 
321
315
  <p>This updates the website’s changelog, and pushes the versions in various other places.</p>
322
316
 
323
- <p>It’s recommended that you go over the <code class="language-plaintext highlighter-rouge">History.markdown</code> file manually one more time, in case there are any spelling errors or such. Feel free to fix those manually, and after you’re done generating the website changelog, commit your changes.</p>
317
+ <p>It’s recommended that you go over the <code class="highlighter-rouge">History.markdown</code> file manually one more time, in case there are any spelling errors or such. Feel free to fix those manually, and after you’re done generating the website changelog, commit your changes.</p>
324
318
 
325
319
  <h2 id="write-a-release-post">Write a release post</h2>
326
320
 
327
- <p>In case this isn’t done already, you can generate a new release post using the included <code class="language-plaintext highlighter-rouge">rake</code> command:</p>
321
+ <p>In case this isn’t done already, you can generate a new release post using the included <code class="highlighter-rouge">rake</code> command:</p>
328
322
 
329
323
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>rake site:releases:new[3.8.0]
330
324
  </code></pre></div></div>
331
325
 
332
- <p>where <code class="language-plaintext highlighter-rouge">3.8.0</code> should be replaced with the new version. Then, write the post. Be sure to thank all of the collaborators and maintainers who have contributed since the last release. You can generate a log of their names using the following command:</p>
326
+ <p>where <code class="highlighter-rouge">3.8.0</code> should be replaced with the new version. Then, write the post. Be sure to thank all of the collaborators and maintainers who have contributed since the last release. You can generate a log of their names using the following command:</p>
333
327
 
334
328
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git shortlog <span class="nt">-sn</span> master...v3.7.2
335
329
  </code></pre></div></div>
336
330
 
337
- <p>where, again <code class="language-plaintext highlighter-rouge">v3.7.2</code> is the last release. Be sure to open a pull request for your release post.</p>
331
+ <p>where, again <code class="highlighter-rouge">v3.7.2</code> is the last release. Be sure to open a pull request for your release post.</p>
338
332
 
339
333
  <h3 id="push-the-version">Push the version</h3>
340
334
 
@@ -344,7 +338,7 @@
344
338
  <li>You have permission to push a new gem version to RubyGems</li>
345
339
  <li>You’re logged into RubyGems on your command line</li>
346
340
  <li>A release post has been prepared, and is ideally already live</li>
347
- <li>All of the prior steps are done, committed, and pushed to <code class="language-plaintext highlighter-rouge">master</code>
341
+ <li>All of the prior steps are done, committed, and pushed to <code class="highlighter-rouge">master</code>
348
342
  </li>
349
343
  </ul>
350
344
 
@@ -359,319 +353,240 @@
359
353
 
360
354
  <p>If you have access to the <a href="https://twitter.com/jekyllrb">@jekyllrb</a> Twitter account, you should tweet the release post from there. If not, just ask another maintainer to do it or to give you access.</p>
361
355
 
356
+ <h3 id="build-the-docs">Build the docs</h3>
357
+
358
+ <p>We package our documentation as a <img class="emoji" title=":gem:" alt=":gem:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f48e.png" height="20" width="20"> Gem for offline use.</p>
359
+
360
+ <p>This is done with the
361
+ <a href="https://github.com/jekyll/jekyll-docs#building"><strong>jekyll-docs</strong></a> repository,
362
+ and more detailed instructions are provided there.</p>
363
+
362
364
  <h2 id="for-non-core-gems">For non-core gems</h2>
363
365
 
364
- <p>If you’re not a maintainer for <code class="language-plaintext highlighter-rouge">jekyll/jekyll</code>, the procedure is much simpler in a lot of cases. Generally, the procedure still looks like this:</p>
366
+ <p>If you’re not a maintainer for <code class="highlighter-rouge">jekyll/jekyll</code>, the procedure is much simpler in a lot of cases. Generally, the procedure still looks like this:</p>
365
367
 
366
368
  <ul>
367
- <li>Bump the gem version manually, usually in <code class="language-plaintext highlighter-rouge">lib/&lt;plugin_name&gt;/version.rb</code>
369
+ <li>Bump the gem version manually, usually in <code class="highlighter-rouge">lib/&lt;plugin_name&gt;/version.rb</code>
368
370
  </li>
369
371
  <li>Adjust the history file</li>
370
- <li>Run <code class="language-plaintext highlighter-rouge">bundle exec rake release</code> or <code class="language-plaintext highlighter-rouge">script/release</code>, depending on which of the two exists</li>
372
+ <li>Run <code class="highlighter-rouge">bundle exec rake release</code> or <code class="highlighter-rouge">script/release</code>, depending on which of the two exists</li>
371
373
  <li>Rejoice</li>
372
374
  </ul>
373
375
 
374
376
  <p>Be sure to ask your project’s maintainers if you’re unsure!</p>
375
377
 
376
-
377
-
378
-
379
-
380
-
381
-
382
-
383
-
384
-
385
-
386
-
387
-
388
-
389
-
390
-
391
-
392
-
393
-
394
-
395
-
396
-
397
-
398
-
399
-
400
-
401
-
402
-
403
-
404
-
405
-
406
-
407
-
408
-
409
-
410
-
411
-
412
-
413
-
414
-
415
-
416
-
417
-
418
-
419
-
420
-
421
-
422
-
423
-
424
-
425
-
426
-
427
-
428
-
429
-
430
-
431
-
432
-
433
-
434
-
435
-
436
-
437
-
438
-
439
-
440
-
441
-
442
-
443
-
444
-
445
-
446
-
447
-
448
-
449
-
450
-
451
-
452
-
453
-
454
-
455
-
456
-
457
-
458
-
459
-
460
-
461
-
462
-
463
-
464
-
465
-
466
-
467
-
468
-
469
-
470
-
471
-
472
-
473
-
474
-
475
-
476
-
477
-
478
-
479
-
480
-
481
-
482
-
483
-
484
-
485
-
486
-
487
-
488
-
489
-
490
378
  </article>
491
379
  </div>
492
380
 
493
381
  <div class="unit one-fifth hide-on-mobiles">
494
382
  <aside>
495
383
 
496
- <h4>Getting Started</h4>
497
- <ul>
498
-
499
-
500
-
501
- <li class=""><a href="/docs/home/">Welcome</a></li>
502
-
503
-
504
-
505
- <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
506
-
507
-
508
-
509
- <li class=""><a href="/docs/installation/">Installation</a></li>
510
-
511
-
512
-
513
- <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
514
-
515
-
516
-
517
- <li class=""><a href="/docs/usage/">Basic Usage</a></li>
518
-
519
-
520
-
521
- <li class=""><a href="/docs/structure/">Directory structure</a></li>
522
-
523
-
524
-
525
- <li class=""><a href="/docs/configuration/">Configuration</a></li>
526
-
527
- </ul>
528
-
529
-
530
- <h4>Your Content</h4>
531
- <ul>
532
-
533
-
534
-
535
- <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
536
-
537
-
538
-
539
- <li class=""><a href="/docs/posts/">Writing posts</a></li>
540
-
541
-
542
-
543
- <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
544
-
545
-
546
-
547
- <li class=""><a href="/docs/pages/">Creating pages</a></li>
548
-
549
-
550
-
551
- <li class=""><a href="/docs/static-files/">Static Files</a></li>
552
-
553
-
554
-
555
- <li class=""><a href="/docs/variables/">Variables</a></li>
556
-
557
-
558
-
559
- <li class=""><a href="/docs/collections/">Collections</a></li>
560
-
561
-
562
-
563
- <li class=""><a href="/docs/datafiles/">Data Files</a></li>
564
-
565
-
566
-
567
- <li class=""><a href="/docs/assets/">Assets</a></li>
568
-
569
-
570
-
571
- <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
572
-
573
- </ul>
574
-
384
+ <h4>Getting Started</h4>
385
+ <ul>
386
+
387
+
388
+ <li>
389
+ <a href="/docs/">
390
+ Quickstart
391
+ </a>
392
+ </li>
393
+
394
+
395
+ <li>
396
+ <a href="/docs/ruby-101/">
397
+ Ruby 101
398
+ </a>
399
+ </li>
400
+
401
+
402
+ <li>
403
+ <a href="/docs/installation/">
404
+ Installation
405
+ </a>
406
+ </li>
407
+
408
+
409
+ <li>
410
+ <a href="/docs/community/">
411
+ Community
412
+ </a>
413
+ </li>
414
+
415
+
416
+ <li>
417
+ <a href="/docs/step-by-step/01-setup/">
418
+ Step by Step Tutorial
419
+ </a>
420
+ </li>
421
+
422
+ </ul>
575
423
 
576
- <h4>Customization</h4>
577
- <ul>
578
-
579
-
580
-
581
- <li class=""><a href="/docs/templates/">Templates</a></li>
582
-
583
-
584
-
585
- <li class=""><a href="/docs/includes/">Includes</a></li>
586
-
587
-
588
-
589
- <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
590
-
591
-
592
-
593
- <li class=""><a href="/docs/pagination/">Pagination</a></li>
594
-
595
-
596
-
597
- <li class=""><a href="/docs/plugins/">Plugins</a></li>
598
-
599
-
600
-
601
- <li class=""><a href="/docs/themes/">Themes</a></li>
602
-
603
-
604
-
605
- <li class=""><a href="/docs/extras/">Extras</a></li>
606
-
607
- </ul>
608
-
424
+ <h4>Build</h4>
425
+ <ul>
426
+
427
+
428
+ <li>
429
+ <a href="/docs/usage/">
430
+ Command Line Usage
431
+ </a>
432
+ </li>
433
+
434
+
435
+ <li>
436
+ <a href="/docs/configuration/">
437
+ Configuration
438
+ </a>
439
+ </li>
440
+
441
+ </ul>
609
442
 
610
- <h4>Deployment</h4>
611
- <ul>
612
-
613
-
614
-
615
- <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
616
-
617
-
618
-
619
- <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
620
-
621
-
622
-
623
- <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
624
-
625
- </ul>
626
-
443
+ <h4>Content</h4>
444
+ <ul>
445
+
446
+
447
+ <li>
448
+ <a href="/docs/pages/">
449
+ Pages
450
+ </a>
451
+ </li>
452
+
453
+
454
+ <li>
455
+ <a href="/docs/posts/">
456
+ Posts
457
+ </a>
458
+ </li>
459
+
460
+
461
+ <li>
462
+ <a href="/docs/front-matter/">
463
+ Front Matter
464
+ </a>
465
+ </li>
466
+
467
+
468
+ <li>
469
+ <a href="/docs/collections/">
470
+ Collections
471
+ </a>
472
+ </li>
473
+
474
+
475
+ <li>
476
+ <a href="/docs/datafiles/">
477
+ Data Files
478
+ </a>
479
+ </li>
480
+
481
+
482
+ <li>
483
+ <a href="/docs/assets/">
484
+ Assets
485
+ </a>
486
+ </li>
487
+
488
+
489
+ <li>
490
+ <a href="/docs/static-files/">
491
+ Static Files
492
+ </a>
493
+ </li>
494
+
495
+ </ul>
627
496
 
628
- <h4>Miscellaneous</h4>
629
- <ul>
630
-
631
-
632
-
633
- <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
634
-
635
-
636
-
637
- <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
638
-
639
-
640
-
641
- <li class=""><a href="/docs/resources/">Resources</a></li>
642
-
643
-
644
-
645
- <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
646
-
647
-
648
-
649
- <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
650
-
651
- </ul>
652
-
497
+ <h4>Site Structure</h4>
498
+ <ul>
499
+
500
+
501
+ <li>
502
+ <a href="/docs/structure/">
503
+ Directory Structure
504
+ </a>
505
+ </li>
506
+
507
+
508
+ <li>
509
+ <a href="/docs/liquid/">
510
+ Liquid
511
+ </a>
512
+ </li>
513
+
514
+
515
+ <li>
516
+ <a href="/docs/variables/">
517
+ Variables
518
+ </a>
519
+ </li>
520
+
521
+
522
+ <li>
523
+ <a href="/docs/includes/">
524
+ Includes
525
+ </a>
526
+ </li>
527
+
528
+
529
+ <li>
530
+ <a href="/docs/layouts/">
531
+ Layouts
532
+ </a>
533
+ </li>
534
+
535
+
536
+ <li>
537
+ <a href="/docs/permalinks/">
538
+ Permalinks
539
+ </a>
540
+ </li>
541
+
542
+
543
+ <li>
544
+ <a href="/docs/themes/">
545
+ Themes
546
+ </a>
547
+ </li>
548
+
549
+
550
+ <li>
551
+ <a href="/docs/pagination/">
552
+ Pagination
553
+ </a>
554
+ </li>
555
+
556
+ </ul>
653
557
 
654
- <h4>Meta</h4>
655
- <ul>
656
-
657
-
658
-
659
- <li class=""><a href="/docs/contributing/">Contributing</a></li>
660
-
661
-
662
-
663
- <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
664
-
665
-
666
-
667
- <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
668
-
669
-
670
-
671
- <li class=""><a href="/docs/history/">History</a></li>
672
-
673
- </ul>
674
-
558
+ <h4>Guides</h4>
559
+ <ul>
560
+
561
+
562
+ <li>
563
+ <a href="/docs/plugins/">
564
+ Plugins
565
+ </a>
566
+ </li>
567
+
568
+
569
+ <li>
570
+ <a href="/docs/migrations/">
571
+ Blog Migrations
572
+ </a>
573
+ </li>
574
+
575
+
576
+ <li>
577
+ <a href="/docs/upgrading/">
578
+ Upgrading
579
+ </a>
580
+ </li>
581
+
582
+
583
+ <li>
584
+ <a href="/docs/deployment/">
585
+ Deployment
586
+ </a>
587
+ </li>
588
+
589
+ </ul>
675
590
 
676
591
  </aside>
677
592
  </div>
@@ -686,7 +601,8 @@
686
601
  <footer>
687
602
  <div class="grid">
688
603
  <div class="unit one-third center-on-mobiles">
689
- <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>
604
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
605
+ <p>The contents of this website are <br>© 2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
690
606
  </div>
691
607
  <div class="unit two-thirds align-right center-on-mobiles">
692
608
  <p>
@@ -696,6 +612,14 @@
696
612
  </a>
697
613
  </p>
698
614
  </div>
615
+ <div class="unit two-thirds align-right center-on-mobiles">
616
+ <p>
617
+ Jekyll is funded thanks to its
618
+ <a href="https://github.com/jekyll/jekyll#sponsors">
619
+ sponsors!
620
+ </a>
621
+ </p>
622
+ </div>
699
623
  </div>
700
624
  </footer>
701
625