jekyll-docs 3.9.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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,32 +3,35 @@
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
- <title>Creating pages | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.9.0" />
17
- <meta property="og:title" content="Creating pages" />
16
+ <title>Pages | Jekyll • Simple, blog-aware, static sites</title>
17
+ <meta name="generator" content="Jekyll v4.0.0" />
18
+ <meta property="og:title" content="Pages" />
18
19
  <meta property="og:locale" content="en_US" />
19
- <meta name="description" content="In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do." />
20
- <meta property="og:description" content="In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do." />
20
+ <meta name="description" content="Pages are the most basic building block for content. They’re useful for standalone content (content which is not date based or is not a group of content such as staff members or recipes)." />
21
+ <meta property="og:description" content="Pages are the most basic building block for content. They’re useful for standalone content (content which is not date based or is not a group of content such as staff members or recipes)." />
21
22
  <link rel="canonical" href="https://jekyllrb.com/docs/pages/" />
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/pages/" />
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="twitter:title" content="Creating pages" />
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" />
30
+ <meta property="twitter:title" content="Pages" />
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/pages/","headline":"Creating pages","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":"In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pages/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
34
+ {"description":"Pages are the most basic building block for content. They’re useful for standalone content (content which is not date based or is not a group of content such as staff members or recipes).","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pages/"},"headline":"Pages","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/pages/","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>
72
+ </li>
73
+
74
+ <li>
75
+ <a href="/news/">News</a>
65
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,320 +286,243 @@
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/pages.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
289
+ <a data-proofer-ignore href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/pages.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
296
290
  </div>
297
- <h1>Creating pages</h1>
298
- <p>In addition to <a href="../posts/">writing posts</a>, you might also want to add static pages (content that isnt date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.</p>
299
-
300
- <h2 id="homepage">Homepage</h2>
301
-
302
- <p>Just about every web server configuration you come across will look for an HTML
303
- file called <code class="language-plaintext highlighter-rouge">index.html</code> (by convention) in the site’s root folder and display
304
- that as the homepage. Unless the web server you’re using is configured to look
305
- for some different filename as the default, this file will turn into the
306
- homepage of your Jekyll-generated site.</p>
307
-
308
- <div class="note">
309
- <h5>ProTip™: Use layouts on your homepage</h5>
310
- <p>
311
- Any HTML file on your site can use layouts and/or includes, even the
312
- homepage. Common content, like headers and footers, make excellent
313
- candidates for extraction into a layout.
314
- </p>
315
- </div>
316
-
317
- <h2 id="where-additional-pages-live">Where additional pages live</h2>
318
-
319
- <p>Where you put HTML or <a href="https://daringfireball.net/projects/markdown/">Markdown</a>
320
- files for pages depends on how you want the pages to work. There are two main ways of creating pages:</p>
321
-
322
- <ul>
323
- <li>Place named HTML or <a href="https://daringfireball.net/projects/markdown/">Markdown</a>
324
- files for each page in your site’s root folder.</li>
325
- <li>Place pages inside folders and subfolders named whatever you want.</li>
326
- </ul>
327
-
328
- <p>Both methods work fine (and can be used in conjunction with each other),
329
- with the only real difference being the resulting URLs. By default, pages retain the same folder structure in <code class="language-plaintext highlighter-rouge">_site</code> as they do in the source directory.</p>
330
-
331
- <h3 id="named-html-files">Named HTML files</h3>
332
-
333
- <p>The simplest way of adding a page is just to add an HTML file in the root
334
- directory with a suitable name for the page you want to create. For a site with
291
+ <h1>Pages</h1>
292
+ <p>Pages are the most basic building block for content. Theyre useful for standalone
293
+ content (content which is not date based or is not a group of content such as staff
294
+ members or recipes).</p>
295
+
296
+ <p>The simplest way of adding a page is to add an HTML file in the root
297
+ directory with a suitable filename. You can also write a page in Markdown using
298
+ a <code class="highlighter-rouge">.md</code> extension which converts to HTML on build. For a site with
335
299
  a homepage, an about page, and a contact page, here’s what the root directory
336
300
  and associated URLs might look like:</p>
337
301
 
338
302
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">.</span>
339
- |-- _config.yml
340
- |-- _includes/
341
- |-- _layouts/
342
- |-- _posts/
343
- |-- _site/
344
- |-- about.html <span class="c"># =&gt; http://example.com/about.html</span>
303
+ |-- about.md <span class="c"># =&gt; http://example.com/about.html</span>
345
304
  |-- index.html <span class="c"># =&gt; http://example.com/</span>
346
- |-- other.md <span class="c"># =&gt; http://example.com/other.html</span>
347
305
  └── contact.html <span class="c"># =&gt; http://example.com/contact.html</span>
348
306
  </code></pre></div></div>
349
307
 
350
- <p>If you have a lot of pages, you can organize those pages into subfolders. The same subfolders that are used to group your pages in our project’s source will exist in the <code class="language-plaintext highlighter-rouge">_site</code> folder when your site builds.</p>
351
-
352
- <h2 id="flattening-pages-from-subfolders-into-the-root-directory">Flattening pages from subfolders into the root directory</h2>
353
-
354
- <p>If you have pages organized into subfolders in your source folder and want to flatten them in the root folder on build, you must add the <a href="/docs/permalinks/">permalink</a> property directly in your page’s front matter like this:</p>
355
-
356
- <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
357
- <span class="na">title</span><span class="pi">:</span> <span class="s">My page</span>
358
- <span class="na">permalink</span><span class="pi">:</span> <span class="s">mypageurl.html</span>
359
- <span class="nn">---</span>
360
- </code></pre></div></div>
361
-
362
- <h3 id="named-folders-containing-index-html-files">Named folders containing index HTML files</h3>
363
-
364
- <p>If you don’t want file extensions (<code class="language-plaintext highlighter-rouge">.html</code>) to appear in your page URLs (file extensions are the default), you can choose a <a href="../permalinks/#builtinpermalinkstyles">permalink style</a> that has a trailing slash instead of a file extension.</p>
365
-
366
- <p>Note if you want to view your site offline <em>without the Jekyll preview server</em>, your browser will need the file extension to display the page, and all assets will need to be relative links that function without the server baseurl.</p>
367
-
368
-
369
-
370
-
371
-
372
-
373
-
374
-
375
-
376
-
377
-
378
-
379
-
380
-
381
-
382
-
383
-
384
-
385
-
386
-
387
-
308
+ <p>If you have a lot of pages, you can organize them into subfolders. The same subfolders that are used to group your pages in our project’s source will exist in the <code class="highlighter-rouge">_site</code> folder when your site builds.</p>
388
309
 
389
-
390
-
310
+ <h2 id="changing-the-output-url">Changing the output URL</h2>
391
311
 
392
-
393
-
394
-
395
-
396
-
397
-
398
-
399
-
312
+ <p>You might want to have a particular folder structure for your source files that changes for the built site. With <a href="/docs/permalinks">permalinks</a> you have full control of the output URL.</p>
400
313
 
401
-
402
-
403
-
404
-
405
-
406
- <div class="section-nav">
407
- <div class="left align-right">
408
-
409
-
410
-
411
- <a href="/docs/drafts/" class="prev">Back</a>
412
-
413
- </div>
414
- <div class="right align-left">
415
-
416
-
417
-
418
- <a href="/docs/static-files/" class="next">Next</a>
419
-
420
- </div>
421
- </div>
422
- <div class="clear"></div>
423
-
424
314
  </article>
425
315
  </div>
426
316
 
427
317
  <div class="unit one-fifth hide-on-mobiles">
428
318
  <aside>
429
319
 
430
- <h4>Getting Started</h4>
431
- <ul>
432
-
433
-
434
-
435
- <li class=""><a href="/docs/home/">Welcome</a></li>
436
-
437
-
438
-
439
- <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
440
-
441
-
442
-
443
- <li class=""><a href="/docs/installation/">Installation</a></li>
444
-
445
-
446
-
447
- <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
448
-
449
-
450
-
451
- <li class=""><a href="/docs/usage/">Basic Usage</a></li>
452
-
453
-
454
-
455
- <li class=""><a href="/docs/structure/">Directory structure</a></li>
456
-
457
-
458
-
459
- <li class=""><a href="/docs/configuration/">Configuration</a></li>
460
-
461
- </ul>
462
-
463
-
464
- <h4>Your Content</h4>
465
- <ul>
466
-
467
-
468
-
469
- <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
470
-
471
-
472
-
473
- <li class=""><a href="/docs/posts/">Writing posts</a></li>
474
-
475
-
476
-
477
- <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
478
-
479
-
480
-
481
- <li class="current"><a href="/docs/pages/">Creating pages</a></li>
482
-
483
-
484
-
485
- <li class=""><a href="/docs/static-files/">Static Files</a></li>
486
-
487
-
488
-
489
- <li class=""><a href="/docs/variables/">Variables</a></li>
490
-
491
-
492
-
493
- <li class=""><a href="/docs/collections/">Collections</a></li>
494
-
495
-
496
-
497
- <li class=""><a href="/docs/datafiles/">Data Files</a></li>
498
-
499
-
500
-
501
- <li class=""><a href="/docs/assets/">Assets</a></li>
502
-
503
-
504
-
505
- <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
506
-
507
- </ul>
508
-
320
+ <h4>Getting Started</h4>
321
+ <ul>
322
+
323
+
324
+ <li>
325
+ <a href="/docs/">
326
+ Quickstart
327
+ </a>
328
+ </li>
329
+
330
+
331
+ <li>
332
+ <a href="/docs/ruby-101/">
333
+ Ruby 101
334
+ </a>
335
+ </li>
336
+
337
+
338
+ <li>
339
+ <a href="/docs/installation/">
340
+ Installation
341
+ </a>
342
+ </li>
343
+
344
+
345
+ <li>
346
+ <a href="/docs/community/">
347
+ Community
348
+ </a>
349
+ </li>
350
+
351
+
352
+ <li>
353
+ <a href="/docs/step-by-step/01-setup/">
354
+ Step by Step Tutorial
355
+ </a>
356
+ </li>
357
+
358
+ </ul>
509
359
 
510
- <h4>Customization</h4>
511
- <ul>
512
-
513
-
514
-
515
- <li class=""><a href="/docs/templates/">Templates</a></li>
516
-
517
-
518
-
519
- <li class=""><a href="/docs/includes/">Includes</a></li>
520
-
521
-
522
-
523
- <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
524
-
525
-
526
-
527
- <li class=""><a href="/docs/pagination/">Pagination</a></li>
528
-
529
-
530
-
531
- <li class=""><a href="/docs/plugins/">Plugins</a></li>
532
-
533
-
534
-
535
- <li class=""><a href="/docs/themes/">Themes</a></li>
536
-
537
-
538
-
539
- <li class=""><a href="/docs/extras/">Extras</a></li>
540
-
541
- </ul>
542
-
360
+ <h4>Build</h4>
361
+ <ul>
362
+
363
+
364
+ <li>
365
+ <a href="/docs/usage/">
366
+ Command Line Usage
367
+ </a>
368
+ </li>
369
+
370
+
371
+ <li>
372
+ <a href="/docs/configuration/">
373
+ Configuration
374
+ </a>
375
+ </li>
376
+
377
+ </ul>
543
378
 
544
- <h4>Deployment</h4>
545
- <ul>
546
-
547
-
548
-
549
- <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
550
-
551
-
552
-
553
- <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
554
-
555
-
556
-
557
- <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
558
-
559
- </ul>
560
-
379
+ <h4>Content</h4>
380
+ <ul>
381
+
382
+
383
+ <li class="current">
384
+ <a href="/docs/pages/">
385
+ Pages
386
+ </a>
387
+ </li>
388
+
389
+
390
+ <li>
391
+ <a href="/docs/posts/">
392
+ Posts
393
+ </a>
394
+ </li>
395
+
396
+
397
+ <li>
398
+ <a href="/docs/front-matter/">
399
+ Front Matter
400
+ </a>
401
+ </li>
402
+
403
+
404
+ <li>
405
+ <a href="/docs/collections/">
406
+ Collections
407
+ </a>
408
+ </li>
409
+
410
+
411
+ <li>
412
+ <a href="/docs/datafiles/">
413
+ Data Files
414
+ </a>
415
+ </li>
416
+
417
+
418
+ <li>
419
+ <a href="/docs/assets/">
420
+ Assets
421
+ </a>
422
+ </li>
423
+
424
+
425
+ <li>
426
+ <a href="/docs/static-files/">
427
+ Static Files
428
+ </a>
429
+ </li>
430
+
431
+ </ul>
561
432
 
562
- <h4>Miscellaneous</h4>
563
- <ul>
564
-
565
-
566
-
567
- <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
568
-
569
-
570
-
571
- <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
572
-
573
-
574
-
575
- <li class=""><a href="/docs/resources/">Resources</a></li>
576
-
577
-
578
-
579
- <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
580
-
581
-
582
-
583
- <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
584
-
585
- </ul>
586
-
433
+ <h4>Site Structure</h4>
434
+ <ul>
435
+
436
+
437
+ <li>
438
+ <a href="/docs/structure/">
439
+ Directory Structure
440
+ </a>
441
+ </li>
442
+
443
+
444
+ <li>
445
+ <a href="/docs/liquid/">
446
+ Liquid
447
+ </a>
448
+ </li>
449
+
450
+
451
+ <li>
452
+ <a href="/docs/variables/">
453
+ Variables
454
+ </a>
455
+ </li>
456
+
457
+
458
+ <li>
459
+ <a href="/docs/includes/">
460
+ Includes
461
+ </a>
462
+ </li>
463
+
464
+
465
+ <li>
466
+ <a href="/docs/layouts/">
467
+ Layouts
468
+ </a>
469
+ </li>
470
+
471
+
472
+ <li>
473
+ <a href="/docs/permalinks/">
474
+ Permalinks
475
+ </a>
476
+ </li>
477
+
478
+
479
+ <li>
480
+ <a href="/docs/themes/">
481
+ Themes
482
+ </a>
483
+ </li>
484
+
485
+
486
+ <li>
487
+ <a href="/docs/pagination/">
488
+ Pagination
489
+ </a>
490
+ </li>
491
+
492
+ </ul>
587
493
 
588
- <h4>Meta</h4>
589
- <ul>
590
-
591
-
592
-
593
- <li class=""><a href="/docs/contributing/">Contributing</a></li>
594
-
595
-
596
-
597
- <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
598
-
599
-
600
-
601
- <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
602
-
603
-
604
-
605
- <li class=""><a href="/docs/history/">History</a></li>
606
-
607
- </ul>
608
-
494
+ <h4>Guides</h4>
495
+ <ul>
496
+
497
+
498
+ <li>
499
+ <a href="/docs/plugins/">
500
+ Plugins
501
+ </a>
502
+ </li>
503
+
504
+
505
+ <li>
506
+ <a href="/docs/migrations/">
507
+ Blog Migrations
508
+ </a>
509
+ </li>
510
+
511
+
512
+ <li>
513
+ <a href="/docs/upgrading/">
514
+ Upgrading
515
+ </a>
516
+ </li>
517
+
518
+
519
+ <li>
520
+ <a href="/docs/deployment/">
521
+ Deployment
522
+ </a>
523
+ </li>
524
+
525
+ </ul>
609
526
 
610
527
  </aside>
611
528
  </div>
@@ -620,7 +537,8 @@ and associated URLs might look like:</p>
620
537
  <footer>
621
538
  <div class="grid">
622
539
  <div class="unit one-third center-on-mobiles">
623
- <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>
540
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
541
+ <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>
624
542
  </div>
625
543
  <div class="unit two-thirds align-right center-on-mobiles">
626
544
  <p>
@@ -630,6 +548,14 @@ and associated URLs might look like:</p>
630
548
  </a>
631
549
  </p>
632
550
  </div>
551
+ <div class="unit two-thirds align-right center-on-mobiles">
552
+ <p>
553
+ Jekyll is funded thanks to its
554
+ <a href="https://github.com/jekyll/jekyll#sponsors">
555
+ sponsors!
556
+ </a>
557
+ </p>
558
+ </div>
633
559
  </div>
634
560
  </footer>
635
561