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>Directory structure | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.9.0" />
17
- <meta property="og:title" content="Directory structure" />
16
+ <title>Directory Structure | Jekyll • Simple, blog-aware, static sites</title>
17
+ <meta name="generator" content="Jekyll v4.0.0" />
18
+ <meta property="og:title" content="Directory Structure" />
18
19
  <meta property="og:locale" content="en_US" />
19
- <meta name="description" content="Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product." />
20
- <meta property="og:description" content="Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product." />
20
+ <meta name="description" content="A basic Jekyll site usually looks something like this:" />
21
+ <meta property="og:description" content="A basic Jekyll site usually looks something like this:" />
21
22
  <link rel="canonical" href="https://jekyllrb.com/docs/structure/" />
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/structure/" />
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="Directory structure" />
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="Directory Structure" />
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/structure/","headline":"Directory structure","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":"Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/structure/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
34
+ {"description":"A basic Jekyll site usually looks something like this:","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/structure/"},"headline":"Directory Structure","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/structure/","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,18 +286,10 @@
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/structure.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/structure.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
296
290
  </div>
297
- <h1>Directory structure</h1>
298
- <p>Jekyll is, at its core, a text transformation engine. The concept behind the
299
- system is this: you give it text written in your favorite markup language, be
300
- that Markdown, Textile, or just plain HTML, and it churns that through a layout
301
- or a series of layout files. Throughout that process you can tweak how you want
302
- the site URLs to look, what data gets displayed in the layout, and more. This
303
- is all done through editing text files; the static web site is the final
304
- product.</p>
305
-
306
- <p>A basic Jekyll site usually looks something like this:</p>
291
+ <h1>Directory Structure</h1>
292
+ <p>A basic Jekyll site usually looks something like this:</p>
307
293
 
308
294
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">.</span>
309
295
  ├── _config.yml
@@ -326,13 +312,13 @@ product.</p>
326
312
  | └── _layout.scss
327
313
  ├── _site
328
314
  ├── .jekyll-metadata
329
- └── index.html <span class="c"># can also be an 'index.md' with valid YAML Frontmatter</span>
315
+ └── index.html <span class="c"># can also be an 'index.md' with valid front matter</span>
330
316
  </code></pre></div></div>
331
317
 
332
318
  <div class="note info">
333
319
  <h5>Directory structure of Jekyll sites using gem-based themes</h5>
334
320
  <p>
335
- Starting <strong>Jekyll 3.2</strong>, a new Jekyll project bootstrapped with <code>jekyll new</code> uses <a href="../themes/">gem-based themes</a> to define the look of the site. This results in a lighter default directory structure : <code>_layouts</code>, <code>_includes</code> and <code>_sass</code> are stored in the theme-gem, by default.
321
+ Starting <strong>Jekyll 3.2</strong>, a new Jekyll project bootstrapped with <code>jekyll new</code> uses <a href="/docs/themes/">gem-based themes</a> to define the look of the site. This results in a lighter default directory structure : <code>_layouts</code>, <code>_includes</code> and <code>_sass</code> are stored in the theme-gem, by default.
336
322
  </p>
337
323
  <br />
338
324
  <p>
@@ -357,7 +343,7 @@ product.</p>
357
343
  </td>
358
344
  <td>
359
345
  <p>
360
- Stores <a href="../configuration/">configuration</a> data. Many of
346
+ Stores <a href="/docs/configuration/">configuration</a> data. Many of
361
347
  these options can be specified from the command line executable but
362
348
  it’s easier to specify them here so you don’t have to remember them.
363
349
  </p>
@@ -370,7 +356,7 @@ product.</p>
370
356
  <td>
371
357
  <p>
372
358
  Drafts are unpublished posts. The format of these files is without a
373
- date: <code>title.MARKUP</code>. Learn how to <a href="../drafts/">
359
+ date: <code>title.MARKUP</code>. Learn how to <a href="/docs/posts/#drafts">
374
360
  work with drafts</a>.
375
361
  </p>
376
362
  </td>
@@ -397,7 +383,7 @@ product.</p>
397
383
  <p>
398
384
  These are the templates that wrap posts. Layouts are chosen on a
399
385
  post-by-post basis in the
400
- <a href="../frontmatter/">YAML Front Matter</a>,
386
+ <a href="/docs/front-matter/">front matter</a>,
401
387
  which is described in the next section. The liquid tag
402
388
  <code>{{ content }}</code>
403
389
  is used to inject content into the web page.
@@ -413,7 +399,7 @@ product.</p>
413
399
  Your dynamic content, so to speak. The naming convention of these
414
400
  files is important, and must follow the format:
415
401
  <code>YEAR-MONTH-DAY-title.MARKUP</code>.
416
- The <a href="../permalinks/">permalinks</a> can be customized for
402
+ The <a href="/docs/permalinks/">permalinks</a> can be customized for
417
403
  each post, but the date and markup language are determined solely by
418
404
  the file name.
419
405
  </p>
@@ -427,9 +413,9 @@ product.</p>
427
413
  <p>
428
414
  Well-formatted site data should be placed here. The Jekyll engine
429
415
  will autoload all data files (using either the <code>.yml</code>,
430
- <code>.yaml</code>, <code>.json</code> or <code>.csv</code>
431
- formats and extensions) in this directory, and they will be
432
- accessible via `site.data`. If there's a file
416
+ <code>.yaml</code>, <code>.json</code>, <code>.csv</code> or
417
+ <code>.tsv</code> formats and extensions) in this directory,
418
+ and they will be accessible via `site.data`. If there's a file
433
419
  <code>members.yml</code> under the directory, then you can access
434
420
  contents of the file through <code>site.data.members</code>.
435
421
  </p>
@@ -476,12 +462,12 @@ product.</p>
476
462
  <tr>
477
463
  <td>
478
464
  <p><code>index.html</code> or <code>index.md</code> and other HTML,
479
- Markdown, Textile files</p>
465
+ Markdown files</p>
480
466
  </td>
481
467
  <td>
482
468
  <p>
483
- Provided that the file has a <a href="../frontmatter/">YAML Front
484
- Matter</a> section, it will be transformed by Jekyll. The same will
469
+ Provided that the file has a <a href="/docs/front-matter/">front
470
+ matter</a> section, it will be transformed by Jekyll. The same will
485
471
  happen for any <code>.html</code>, <code>.markdown</code>,
486
472
  <code>.md</code>, or <code>.textile</code> file in your site’s root
487
473
  directory or directories not listed above.
@@ -497,7 +483,7 @@ product.</p>
497
483
  Every other directory and file except for those listed above—such as
498
484
  <code>css</code> and <code>images</code> folders,
499
485
  <code>favicon.ico</code> files, and so forth—will be copied verbatim
500
- to the generated site. There are plenty of <a href="../sites/">sites
486
+ to the generated site. There are plenty of <a href="/showcase/">sites
501
487
  already using Jekyll</a> if you’re curious to see how they’re laid
502
488
  out.
503
489
  </p>
@@ -507,232 +493,218 @@ product.</p>
507
493
  </table>
508
494
  </div>
509
495
 
510
-
511
-
512
-
513
-
514
-
515
-
516
-
517
-
518
-
519
-
520
-
521
-
522
-
523
-
524
-
525
-
526
-
527
-
528
-
529
-
530
-
531
-
532
-
533
- <div class="section-nav">
534
- <div class="left align-right">
535
-
536
-
537
-
538
- <a href="/docs/usage/" class="prev">Back</a>
539
-
540
- </div>
541
- <div class="right align-left">
542
-
543
-
544
-
545
- <a href="/docs/configuration/" class="next">Next</a>
546
-
547
- </div>
548
- </div>
549
- <div class="clear"></div>
550
-
551
496
  </article>
552
497
  </div>
553
498
 
554
499
  <div class="unit one-fifth hide-on-mobiles">
555
500
  <aside>
556
501
 
557
- <h4>Getting Started</h4>
558
- <ul>
559
-
560
-
561
-
562
- <li class=""><a href="/docs/home/">Welcome</a></li>
563
-
564
-
565
-
566
- <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
567
-
568
-
569
-
570
- <li class=""><a href="/docs/installation/">Installation</a></li>
571
-
572
-
573
-
574
- <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
575
-
576
-
577
-
578
- <li class=""><a href="/docs/usage/">Basic Usage</a></li>
579
-
580
-
581
-
582
- <li class="current"><a href="/docs/structure/">Directory structure</a></li>
583
-
584
-
585
-
586
- <li class=""><a href="/docs/configuration/">Configuration</a></li>
587
-
588
- </ul>
589
-
590
-
591
- <h4>Your Content</h4>
592
- <ul>
593
-
594
-
595
-
596
- <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
597
-
598
-
599
-
600
- <li class=""><a href="/docs/posts/">Writing posts</a></li>
601
-
602
-
603
-
604
- <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
605
-
606
-
607
-
608
- <li class=""><a href="/docs/pages/">Creating pages</a></li>
609
-
610
-
611
-
612
- <li class=""><a href="/docs/static-files/">Static Files</a></li>
613
-
614
-
615
-
616
- <li class=""><a href="/docs/variables/">Variables</a></li>
617
-
618
-
619
-
620
- <li class=""><a href="/docs/collections/">Collections</a></li>
621
-
622
-
623
-
624
- <li class=""><a href="/docs/datafiles/">Data Files</a></li>
625
-
626
-
627
-
628
- <li class=""><a href="/docs/assets/">Assets</a></li>
629
-
630
-
631
-
632
- <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
633
-
634
- </ul>
635
-
502
+ <h4>Getting Started</h4>
503
+ <ul>
504
+
505
+
506
+ <li>
507
+ <a href="/docs/">
508
+ Quickstart
509
+ </a>
510
+ </li>
511
+
512
+
513
+ <li>
514
+ <a href="/docs/ruby-101/">
515
+ Ruby 101
516
+ </a>
517
+ </li>
518
+
519
+
520
+ <li>
521
+ <a href="/docs/installation/">
522
+ Installation
523
+ </a>
524
+ </li>
525
+
526
+
527
+ <li>
528
+ <a href="/docs/community/">
529
+ Community
530
+ </a>
531
+ </li>
532
+
533
+
534
+ <li>
535
+ <a href="/docs/step-by-step/01-setup/">
536
+ Step by Step Tutorial
537
+ </a>
538
+ </li>
539
+
540
+ </ul>
636
541
 
637
- <h4>Customization</h4>
638
- <ul>
639
-
640
-
641
-
642
- <li class=""><a href="/docs/templates/">Templates</a></li>
643
-
644
-
645
-
646
- <li class=""><a href="/docs/includes/">Includes</a></li>
647
-
648
-
649
-
650
- <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
651
-
652
-
653
-
654
- <li class=""><a href="/docs/pagination/">Pagination</a></li>
655
-
656
-
657
-
658
- <li class=""><a href="/docs/plugins/">Plugins</a></li>
659
-
660
-
661
-
662
- <li class=""><a href="/docs/themes/">Themes</a></li>
663
-
664
-
665
-
666
- <li class=""><a href="/docs/extras/">Extras</a></li>
667
-
668
- </ul>
669
-
542
+ <h4>Build</h4>
543
+ <ul>
544
+
545
+
546
+ <li>
547
+ <a href="/docs/usage/">
548
+ Command Line Usage
549
+ </a>
550
+ </li>
551
+
552
+
553
+ <li>
554
+ <a href="/docs/configuration/">
555
+ Configuration
556
+ </a>
557
+ </li>
558
+
559
+ </ul>
670
560
 
671
- <h4>Deployment</h4>
672
- <ul>
673
-
674
-
675
-
676
- <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
677
-
678
-
679
-
680
- <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
681
-
682
-
683
-
684
- <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
685
-
686
- </ul>
687
-
561
+ <h4>Content</h4>
562
+ <ul>
563
+
564
+
565
+ <li>
566
+ <a href="/docs/pages/">
567
+ Pages
568
+ </a>
569
+ </li>
570
+
571
+
572
+ <li>
573
+ <a href="/docs/posts/">
574
+ Posts
575
+ </a>
576
+ </li>
577
+
578
+
579
+ <li>
580
+ <a href="/docs/front-matter/">
581
+ Front Matter
582
+ </a>
583
+ </li>
584
+
585
+
586
+ <li>
587
+ <a href="/docs/collections/">
588
+ Collections
589
+ </a>
590
+ </li>
591
+
592
+
593
+ <li>
594
+ <a href="/docs/datafiles/">
595
+ Data Files
596
+ </a>
597
+ </li>
598
+
599
+
600
+ <li>
601
+ <a href="/docs/assets/">
602
+ Assets
603
+ </a>
604
+ </li>
605
+
606
+
607
+ <li>
608
+ <a href="/docs/static-files/">
609
+ Static Files
610
+ </a>
611
+ </li>
612
+
613
+ </ul>
688
614
 
689
- <h4>Miscellaneous</h4>
690
- <ul>
691
-
692
-
693
-
694
- <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
695
-
696
-
697
-
698
- <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
699
-
700
-
701
-
702
- <li class=""><a href="/docs/resources/">Resources</a></li>
703
-
704
-
705
-
706
- <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
707
-
708
-
709
-
710
- <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
711
-
712
- </ul>
713
-
615
+ <h4>Site Structure</h4>
616
+ <ul>
617
+
618
+
619
+ <li class="current">
620
+ <a href="/docs/structure/">
621
+ Directory Structure
622
+ </a>
623
+ </li>
624
+
625
+
626
+ <li>
627
+ <a href="/docs/liquid/">
628
+ Liquid
629
+ </a>
630
+ </li>
631
+
632
+
633
+ <li>
634
+ <a href="/docs/variables/">
635
+ Variables
636
+ </a>
637
+ </li>
638
+
639
+
640
+ <li>
641
+ <a href="/docs/includes/">
642
+ Includes
643
+ </a>
644
+ </li>
645
+
646
+
647
+ <li>
648
+ <a href="/docs/layouts/">
649
+ Layouts
650
+ </a>
651
+ </li>
652
+
653
+
654
+ <li>
655
+ <a href="/docs/permalinks/">
656
+ Permalinks
657
+ </a>
658
+ </li>
659
+
660
+
661
+ <li>
662
+ <a href="/docs/themes/">
663
+ Themes
664
+ </a>
665
+ </li>
666
+
667
+
668
+ <li>
669
+ <a href="/docs/pagination/">
670
+ Pagination
671
+ </a>
672
+ </li>
673
+
674
+ </ul>
714
675
 
715
- <h4>Meta</h4>
716
- <ul>
717
-
718
-
719
-
720
- <li class=""><a href="/docs/contributing/">Contributing</a></li>
721
-
722
-
723
-
724
- <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
725
-
726
-
727
-
728
- <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
729
-
730
-
731
-
732
- <li class=""><a href="/docs/history/">History</a></li>
733
-
734
- </ul>
735
-
676
+ <h4>Guides</h4>
677
+ <ul>
678
+
679
+
680
+ <li>
681
+ <a href="/docs/plugins/">
682
+ Plugins
683
+ </a>
684
+ </li>
685
+
686
+
687
+ <li>
688
+ <a href="/docs/migrations/">
689
+ Blog Migrations
690
+ </a>
691
+ </li>
692
+
693
+
694
+ <li>
695
+ <a href="/docs/upgrading/">
696
+ Upgrading
697
+ </a>
698
+ </li>
699
+
700
+
701
+ <li>
702
+ <a href="/docs/deployment/">
703
+ Deployment
704
+ </a>
705
+ </li>
706
+
707
+ </ul>
736
708
 
737
709
  </aside>
738
710
  </div>
@@ -747,7 +719,8 @@ product.</p>
747
719
  <footer>
748
720
  <div class="grid">
749
721
  <div class="unit one-third center-on-mobiles">
750
- <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>
722
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
723
+ <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>
751
724
  </div>
752
725
  <div class="unit two-thirds align-right center-on-mobiles">
753
726
  <p>
@@ -757,6 +730,14 @@ product.</p>
757
730
  </a>
758
731
  </p>
759
732
  </div>
733
+ <div class="unit two-thirds align-right center-on-mobiles">
734
+ <p>
735
+ Jekyll is funded thanks to its
736
+ <a href="https://github.com/jekyll/jekyll#sponsors">
737
+ sponsors!
738
+ </a>
739
+ </p>
740
+ </div>
760
741
  </div>
761
742
  </footer>
762
743