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,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