jekyll-docs 3.9.0 → 4.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (225) hide show
  1. checksums.yaml +4 -4
  2. data/lib/jekyll-docs.rb +3 -3
  3. data/site/404.html +10 -7
  4. data/site/css/screen.css +3 -1
  5. data/site/css/screen.css.map +28 -0
  6. data/site/docs/assets/index.html +412 -453
  7. data/site/docs/code_of_conduct/index.html +447 -501
  8. data/site/docs/collections/index.html +487 -674
  9. data/site/docs/community/bug/index.html +603 -0
  10. data/site/docs/community/index.html +635 -0
  11. data/site/docs/conduct/index.html +447 -515
  12. data/site/docs/configuration/default/index.html +682 -0
  13. data/site/docs/configuration/environments/index.html +641 -0
  14. data/site/docs/configuration/front-matter-defaults/index.html +738 -0
  15. data/site/docs/configuration/incremental-regeneration/index.html +631 -0
  16. data/site/docs/configuration/index.html +405 -1230
  17. data/site/docs/configuration/liquid/index.html +616 -0
  18. data/site/docs/configuration/markdown/index.html +766 -0
  19. data/site/docs/configuration/options/index.html +1011 -0
  20. data/site/docs/configuration/webrick/index.html +615 -0
  21. data/site/docs/continuous-integration/buddyworks/index.html +393 -479
  22. data/site/docs/continuous-integration/circleci/index.html +465 -481
  23. data/site/docs/continuous-integration/travis-ci/index.html +450 -507
  24. data/site/docs/contributing/index.html +425 -514
  25. data/site/docs/datafiles/index.html +411 -453
  26. data/site/docs/deployment-methods/index.html +9 -871
  27. data/site/docs/deployment/automated/index.html +663 -0
  28. data/site/docs/deployment/index.html +607 -0
  29. data/site/docs/deployment/manual/index.html +631 -0
  30. data/site/docs/deployment/third-party/index.html +639 -0
  31. data/site/docs/drafts/index.html +9 -634
  32. data/site/docs/extras/index.html +9 -687
  33. data/site/docs/front-matter/index.html +799 -0
  34. data/site/docs/frontmatter/index.html +9 -819
  35. data/site/docs/github-pages/index.html +407 -475
  36. data/site/docs/history/index.html +1370 -1154
  37. data/site/docs/home/index.html +9 -627
  38. data/site/docs/includes/index.html +425 -501
  39. data/site/docs/index.html +630 -9
  40. data/site/docs/installation/index.html +403 -540
  41. data/site/docs/installation/macos/index.html +716 -0
  42. data/site/docs/installation/other-linux/index.html +613 -0
  43. data/site/docs/installation/ubuntu/index.html +623 -0
  44. data/site/docs/installation/windows/index.html +733 -0
  45. data/site/docs/layouts/index.html +726 -0
  46. data/site/docs/liquid/filters/index.html +1169 -0
  47. data/site/docs/liquid/index.html +615 -0
  48. data/site/docs/liquid/tags/index.html +728 -0
  49. data/site/docs/maintaining/affinity-team-captain/index.html +395 -479
  50. data/site/docs/maintaining/avoiding-burnout/index.html +391 -475
  51. data/site/docs/maintaining/becoming-a-maintainer/index.html +391 -475
  52. data/site/docs/maintaining/index.html +391 -486
  53. data/site/docs/maintaining/merging-a-pull-request/index.html +406 -490
  54. data/site/docs/maintaining/releasing-a-new-version/index.html +409 -485
  55. data/site/docs/maintaining/reviewing-a-pull-request/index.html +392 -476
  56. data/site/docs/maintaining/special-labels/index.html +397 -481
  57. data/site/docs/maintaining/triaging-an-issue/index.html +394 -478
  58. data/site/docs/markdown-101/index.html +601 -0
  59. data/site/docs/migrations/index.html +396 -440
  60. data/site/docs/pages/index.html +408 -482
  61. data/site/docs/pagination/index.html +450 -509
  62. data/site/docs/permalinks/index.html +552 -587
  63. data/site/docs/plugins/commands/index.html +656 -0
  64. data/site/docs/plugins/converters/index.html +685 -0
  65. data/site/docs/plugins/filters/index.html +624 -0
  66. data/site/docs/plugins/generators/index.html +697 -0
  67. data/site/docs/plugins/hooks/index.html +838 -0
  68. data/site/docs/plugins/index.html +415 -1565
  69. data/site/docs/plugins/installation/index.html +681 -0
  70. data/site/docs/plugins/tags/index.html +699 -0
  71. data/site/docs/plugins/your-first-plugin/index.html +741 -0
  72. data/site/docs/posts/index.html +491 -627
  73. data/site/docs/quickstart/index.html +9 -645
  74. data/site/docs/resources/index.html +9 -761
  75. data/site/docs/ruby-101/index.html +640 -0
  76. data/site/docs/sites/index.html +9 -696
  77. data/site/docs/static-files/index.html +401 -433
  78. data/site/docs/step-by-step/01-setup/index.html +771 -0
  79. data/site/docs/step-by-step/02-liquid/index.html +756 -0
  80. data/site/docs/step-by-step/03-front-matter/index.html +730 -0
  81. data/site/docs/step-by-step/04-layouts/index.html +770 -0
  82. data/site/docs/step-by-step/05-includes/index.html +768 -0
  83. data/site/docs/step-by-step/06-data-files/index.html +738 -0
  84. data/site/docs/step-by-step/07-assets/index.html +773 -0
  85. data/site/docs/step-by-step/08-blogging/index.html +835 -0
  86. data/site/docs/step-by-step/09-collections/index.html +932 -0
  87. data/site/docs/step-by-step/10-deployment/index.html +842 -0
  88. data/site/docs/structure/index.html +411 -430
  89. data/site/docs/support/index.html +392 -476
  90. data/site/docs/templates/index.html +9 -1232
  91. data/site/docs/themes/index.html +487 -521
  92. data/site/docs/troubleshooting/index.html +443 -520
  93. data/site/docs/upgrading/0-to-2/index.html +437 -523
  94. data/site/docs/upgrading/2-to-3/index.html +422 -507
  95. data/site/docs/upgrading/3-to-4/index.html +765 -0
  96. data/site/docs/upgrading/index.html +395 -478
  97. data/site/docs/usage/index.html +409 -506
  98. data/site/docs/variables/index.html +504 -652
  99. data/site/docs/windows/index.html +9 -784
  100. data/site/feed.xml +269 -188
  101. data/site/feed/release.xml +324 -0
  102. data/site/fonts/lato-v14-latin-300.woff +0 -0
  103. data/site/fonts/lato-v14-latin-300.woff2 +0 -0
  104. data/site/fonts/lato-v14-latin-300italic.woff +0 -0
  105. data/site/fonts/lato-v14-latin-300italic.woff2 +0 -0
  106. data/site/fonts/lato-v14-latin-700.woff +0 -0
  107. data/site/fonts/lato-v14-latin-700.woff2 +0 -0
  108. data/site/fonts/lato-v14-latin-700italic.woff +0 -0
  109. data/site/fonts/lato-v14-latin-700italic.woff2 +0 -0
  110. data/site/fonts/lato-v14-latin-900.woff +0 -0
  111. data/site/fonts/lato-v14-latin-900.woff2 +0 -0
  112. data/site/fonts/lato-v14-latin-900italic.woff +0 -0
  113. data/site/fonts/lato-v14-latin-900italic.woff2 +0 -0
  114. data/site/fonts/lato-v14-latin-italic.woff +0 -0
  115. data/site/fonts/lato-v14-latin-italic.woff2 +0 -0
  116. data/site/fonts/lato-v14-latin-regular.woff +0 -0
  117. data/site/fonts/lato-v14-latin-regular.woff2 +0 -0
  118. data/site/help/index.html +9 -247
  119. data/site/img/forestry-logo.svg +19 -0
  120. data/site/img/jekyll-og.png +0 -0
  121. data/site/img/spacer.gif +0 -0
  122. data/site/index.html +56 -29
  123. data/site/jekyllconf/index.html +62 -35
  124. data/site/latest_version.txt +1 -1
  125. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +180 -115
  126. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +182 -117
  127. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +183 -118
  128. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +184 -119
  129. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +183 -118
  130. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +180 -115
  131. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +182 -117
  132. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +182 -117
  133. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +185 -120
  134. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +183 -118
  135. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +180 -115
  136. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +189 -124
  137. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +181 -116
  138. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +181 -116
  139. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +180 -115
  140. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +182 -117
  141. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +181 -116
  142. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +181 -116
  143. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +181 -116
  144. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +184 -119
  145. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +180 -115
  146. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +181 -116
  147. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +185 -120
  148. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +182 -117
  149. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +181 -116
  150. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +189 -124
  151. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +187 -122
  152. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +188 -123
  153. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +180 -115
  154. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +182 -117
  155. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +179 -114
  156. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +180 -115
  157. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +179 -114
  158. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +180 -115
  159. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +180 -115
  160. data/site/news/2015/10/26/jekyll-3-0-released/index.html +185 -120
  161. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +184 -119
  162. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +182 -117
  163. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +186 -121
  164. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +183 -118
  165. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +181 -116
  166. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +182 -117
  167. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +179 -114
  168. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +181 -116
  169. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +181 -116
  170. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +180 -115
  171. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +186 -121
  172. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +181 -116
  173. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +181 -116
  174. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +179 -114
  175. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +184 -119
  176. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +180 -115
  177. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +179 -114
  178. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +207 -142
  179. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +181 -116
  180. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +183 -118
  181. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +181 -116
  182. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +189 -124
  183. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +190 -125
  184. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +187 -122
  185. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +182 -117
  186. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +185 -120
  187. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +181 -116
  188. data/site/news/2017/10/19/diversity-open-source/index.html +181 -116
  189. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +183 -118
  190. data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +184 -119
  191. data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +189 -124
  192. data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +180 -115
  193. data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +185 -120
  194. data/site/news/2018/04/19/development-update/index.html +699 -0
  195. data/site/news/2018/04/19/jekyll-3-8-0-released/index.html +715 -0
  196. data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +182 -117
  197. data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +181 -116
  198. data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +183 -118
  199. data/site/news/2018/08/01/jekyll-sponsoring/index.html +748 -0
  200. data/site/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/index.html +692 -0
  201. data/site/news/2018/11/04/jekyll-3-8-5-released/index.html +682 -0
  202. data/site/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/index.html +710 -0
  203. data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +180 -115
  204. data/site/news/2019/07/20/jekyll-4-0-0-pre-beta1-released/index.html +11 -0
  205. data/site/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/index.html +708 -0
  206. data/site/news/2019/08/20/jekyll-4-0-0-released/index.html +809 -0
  207. data/site/news/index.html +976 -326
  208. data/site/news/releases/index.html +820 -321
  209. data/site/{philosophy.html → philosophy/index.html} +1 -1
  210. data/site/redirects.json +1 -1
  211. data/site/resources/index.html +332 -0
  212. data/site/showcase/index.html +844 -0
  213. data/site/sitemap.xml +256 -81
  214. data/site/team/index.html +63 -77
  215. data/site/tutorials/cache-api/index.html +418 -0
  216. data/site/tutorials/convert-site-to-jekyll/index.html +155 -124
  217. data/site/tutorials/custom-404-page/index.html +76 -43
  218. data/site/tutorials/home/index.html +64 -37
  219. data/site/tutorials/navigation/index.html +186 -103
  220. data/site/tutorials/orderofinterpretation/index.html +80 -53
  221. data/site/tutorials/using-jekyll-with-bundler/index.html +80 -51
  222. data/site/tutorials/video-walkthroughs/index.html +62 -35
  223. metadata +102 -13
  224. data/site/community/index.html +0 -11
  225. data/site/docs/continuous-integration/index.html +0 -681
@@ -3,17 +3,18 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.9.0">
6
+ <meta name="generator" content="Jekyll v4.0.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
+ <link type="application/atom+xml" rel="alternate" href="/feed/release.xml" title="Jekyll releases posts" />
8
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
- <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
10
- <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
10
+ <link rel="preload" href="/fonts/lato-v14-latin-300.woff2" as="font" type="font/woff2" crossorigin />
11
+ <link rel="preload" href="/fonts/lato-v14-latin-700.woff2" as="font" type="font/woff2" crossorigin />
12
+ <link rel="preload" href="/css/screen.css" as="style">
12
13
  <link rel="stylesheet" href="/css/screen.css">
13
14
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
15
  <!-- Begin Jekyll SEO tag v2.6.1 -->
15
16
  <title>Troubleshooting | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.9.0" />
17
+ <meta name="generator" content="Jekyll v4.0.0" />
17
18
  <meta property="og:title" content="Troubleshooting" />
18
19
  <meta property="og:locale" content="en_US" />
19
20
  <meta name="description" content="If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well." />
@@ -21,14 +22,16 @@
21
22
  <link rel="canonical" href="https://jekyllrb.com/docs/troubleshooting/" />
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/troubleshooting/" />
23
24
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
25
+ <meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
24
26
  <meta property="og:type" content="article" />
25
- <meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
26
- <meta name="twitter:card" content="summary" />
27
+ <meta property="article:published_time" content="2019-09-11T07:30:27-07:00" />
28
+ <meta name="twitter:card" content="summary_large_image" />
29
+ <meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
27
30
  <meta property="twitter:title" content="Troubleshooting" />
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/troubleshooting/","headline":"Troubleshooting","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":"If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/troubleshooting/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
34
+ {"description":"If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/troubleshooting/"},"headline":"Troubleshooting","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/troubleshooting/","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>
68
+ </li>
69
+
70
+ <li>
71
+ <a href="/showcase/">Showcase</a>
62
72
  </li>
63
- <li class="">
64
- <a href="/help/">Help</a>
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,7 +286,7 @@
292
286
  <div class="unit four-fifths">
293
287
  <article>
294
288
  <div class="improve right hide-on-mobiles">
295
- <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/troubleshooting.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/troubleshooting.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
296
290
  </div>
297
291
  <h1>Troubleshooting</h1>
298
292
  <p>If you ever run into problems installing or using Jekyll, here are a few tips
@@ -314,7 +308,7 @@ that might be of help. If the problem you’re experiencing isn’t covered belo
314
308
  the header files for compiling extension modules for Ruby 2.x This
315
309
  can be done on Ubuntu or Debian by running:</p>
316
310
 
317
- <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby2.3-dev
311
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby2.6-dev
318
312
  </code></pre></div></div>
319
313
 
320
314
  <p>On Red Hat, CentOS, and Fedora systems you can do this by running:</p>
@@ -322,7 +316,7 @@ can be done on Ubuntu or Debian by running:</p>
322
316
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yum <span class="nb">install </span>ruby-devel
323
317
  </code></pre></div></div>
324
318
 
325
- <p>If you installed the above - specifically on Fedora 23 - but the extensions would still not compile, you are probably running a Fedora image that misses the <code class="language-plaintext highlighter-rouge">redhat-rpm-config</code> package. To solve this, simply run:</p>
319
+ <p>If you installed the above - specifically on Fedora 23 - but the extensions would still not compile, you are probably running a Fedora image that misses the <code class="highlighter-rouge">redhat-rpm-config</code> package. To solve this, run:</p>
326
320
 
327
321
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>dnf <span class="nb">install </span>redhat-rpm-config
328
322
  </code></pre></div></div>
@@ -332,10 +326,10 @@ can be done on Ubuntu or Debian by running:</p>
332
326
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>pacman <span class="nt">-S</span> ruby-ffi
333
327
  </code></pre></div></div>
334
328
 
335
- <p>On Ubuntu if you get stuck after <code class="language-plaintext highlighter-rouge">bundle exec jekyll serve</code> and see error
336
- messages like <code class="language-plaintext highlighter-rouge">Could not locate Gemfile</code> or <code class="language-plaintext highlighter-rouge">.bundle/ directory</code>, it’s likely
329
+ <p>On Ubuntu if you get stuck after <code class="highlighter-rouge">bundle exec jekyll serve</code> and see error
330
+ messages like <code class="highlighter-rouge">Could not locate Gemfile</code> or <code class="highlighter-rouge">.bundle/ directory</code>, it’s likely
337
331
  because all requirements have not been fully met. Recent stock Ubuntu
338
- distributions require the installation of both the <code class="language-plaintext highlighter-rouge">ruby</code> and <code class="language-plaintext highlighter-rouge">ruby-all-dev</code>
332
+ distributions require the installation of both the <code class="highlighter-rouge">ruby</code> and <code class="highlighter-rouge">ruby-all-dev</code>
339
333
  packages:</p>
340
334
 
341
335
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby ruby-all-dev
@@ -363,19 +357,19 @@ DevKit</a>.</p>
363
357
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>apt update <span class="o">&amp;&amp;</span> apt <span class="nb">install </span>libffi-dev clang ruby-dev make
364
358
  </code></pre></div></div>
365
359
 
366
- <p>On macOS, you may need to update RubyGems (using <code class="language-plaintext highlighter-rouge">sudo</code> only if necessary):</p>
360
+ <p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
367
361
 
368
362
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem update <span class="nt">--system</span>
369
363
  </code></pre></div></div>
370
364
 
371
365
  <p>If you still have issues, you can download and install new Command Line
372
- Tools (such as <code class="language-plaintext highlighter-rouge">gcc</code>) using the following command:</p>
366
+ Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
373
367
 
374
368
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xcode-select <span class="nt">--install</span>
375
369
  </code></pre></div></div>
376
370
 
377
371
  <p>which may allow you to install native gems using this command (again, using
378
- <code class="language-plaintext highlighter-rouge">sudo</code> only if necessary):</p>
372
+ <code class="highlighter-rouge">sudo</code> only if necessary):</p>
379
373
 
380
374
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install </span>jekyll
381
375
  </code></pre></div></div>
@@ -390,55 +384,55 @@ Line Tools.</p>
390
384
 
391
385
  <p>On most flavors of Linux, macOS, and Bash on Ubuntu on Windows, it is
392
386
  possible to run Jekyll as a non-superuser and without having to install
393
- gems to system-wide locations by adding the following lines to the end
394
- of your <code class="language-plaintext highlighter-rouge">.bashrc</code> file:</p>
387
+ gems to system-wide locations by adding the following lines to the end
388
+ of your <code class="highlighter-rouge">.bashrc</code> file:</p>
395
389
 
396
- <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code># Ruby exports
390
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code># Ruby exports
397
391
 
398
392
  export GEM_HOME=$HOME/gems
399
393
  export PATH=$HOME/gems/bin:$PATH
400
394
  </code></pre></div></div>
401
395
 
402
- <p>This tells <code class="language-plaintext highlighter-rouge">gem</code> to place its gems within the user’s home folder,
403
- not in a system-wide location, and adds the local <code class="language-plaintext highlighter-rouge">jekyll</code> command to the
404
- user’s <code class="language-plaintext highlighter-rouge">PATH</code> ahead of any system-wide paths.</p>
396
+ <p>This tells <code class="highlighter-rouge">gem</code> to place its gems within the user’s home folder,
397
+ not in a system-wide location, and adds the local <code class="highlighter-rouge">jekyll</code> command to the
398
+ user’s <code class="highlighter-rouge">PATH</code> ahead of any system-wide paths.</p>
405
399
 
406
400
  <p>This is also useful for many shared webhosting services, where user accounts
407
- have only limited privileges. Adding these exports to <code class="language-plaintext highlighter-rouge">.bashrc</code> before running
408
- <code class="language-plaintext highlighter-rouge">gem install jekyll bundler</code> allows a complete non-<code class="language-plaintext highlighter-rouge">sudo</code> install of Jekyll.</p>
401
+ have only limited privileges. Adding these exports to <code class="highlighter-rouge">.bashrc</code> before running
402
+ <code class="highlighter-rouge">gem install jekyll bundler</code> allows a complete non-<code class="highlighter-rouge">sudo</code> install of Jekyll.</p>
409
403
 
410
- <p>To activate the new exports, either close and restart Bash, logout and
411
- log back into your shell account, or run <code class="language-plaintext highlighter-rouge">. .bashrc</code> in the
404
+ <p>To activate the new exports, either close and restart Bash, logout and
405
+ log back into your shell account, or run <code class="highlighter-rouge">. .bashrc</code> in the
412
406
  currently-running shell.</p>
413
407
 
414
- <p>If you see the following error when running the <code class="language-plaintext highlighter-rouge">jekyll new</code> command,
408
+ <p>If you see the following error when running the <code class="highlighter-rouge">jekyll new</code> command,
415
409
  you can solve it by using the above-described procedure:</p>
416
410
 
417
411
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll new <span class="nb">test
418
412
 
419
413
  </span>Running bundle <span class="nb">install </span><span class="k">in</span> /home/user/test...
420
414
 
421
- Your user account isn<span class="s1">'t allowed to install to the system RubyGems.
415
+ Your user account is not allowed to <span class="nb">install </span>to the system RubyGems.
422
416
  You can cancel this installation and run:
423
417
 
424
- bundle install --path vendor/bundle
418
+ bundle <span class="nb">install</span> <span class="nt">--path</span> vendor/bundle
425
419
 
426
- to install the gems into ./vendor/bundle/, or you can enter your password
427
- and install the bundled gems to RubyGems using sudo.
420
+ to <span class="nb">install </span>the gems into ./vendor/bundle/, or you can enter your password
421
+ and <span class="nb">install </span>the bundled gems to RubyGems using sudo.
428
422
 
429
423
  Password:
430
- </span></code></pre></div></div>
424
+ </code></pre></div></div>
431
425
 
432
- <p>Once this is done, the <code class="language-plaintext highlighter-rouge">jekyll new</code> command should work properly for
426
+ <p>Once this is done, the <code class="highlighter-rouge">jekyll new</code> command should work properly for
433
427
  your user account.</p>
434
428
 
435
- <h3 id="jekyll--mac-os-x-1011">Jekyll &amp; Mac OS X 10.11</h3>
429
+ <h3 id="jekyll--macos">Jekyll &amp; macOS</h3>
436
430
 
437
- <p>With the introduction of System Integrity Protection, several directories
431
+ <p>With the introduction of System Integrity Protection in v10.11, several directories
438
432
  that were previously writable are now considered system locations and are no
439
433
  longer available. Given these changes, there are a couple of simple ways to get
440
434
  up and running. One option is to change the location where the gem will be
441
- installed (again, using <code class="language-plaintext highlighter-rouge">sudo</code> only if necessary):</p>
435
+ installed (again, using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
442
436
 
443
437
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install</span> <span class="nt">-n</span> /usr/local/bin jekyll
444
438
  </code></pre></div></div>
@@ -449,7 +443,7 @@ done as follows:</p>
449
443
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ruby <span class="nt">-e</span> <span class="s2">"</span><span class="si">$(</span>curl <span class="nt">-fsSL</span> https://raw.githubusercontent.com/Homebrew/install/master/install<span class="si">)</span><span class="s2">"</span>
450
444
  </code></pre></div></div>
451
445
 
452
- <p>Once Homebrew is installed, the second step is easy:</p>
446
+ <p>Once Homebrew is installed, the second step is to run:</p>
453
447
 
454
448
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brew <span class="nb">install </span>ruby
455
449
  </code></pre></div></div>
@@ -459,33 +453,33 @@ number of Ruby version managers (<a href="https://rvm.io">RVM</a>, <a href="http
459
453
  which to install Jekyll.</p>
460
454
 
461
455
  <p>If you elect to use one of the above methods to install Ruby, it might be
462
- necessary to modify your <code class="language-plaintext highlighter-rouge">$PATH</code> variable using the following command:</p>
456
+ necessary to modify your <code class="highlighter-rouge">$PATH</code> variable using the following command:</p>
463
457
 
464
458
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span>/usr/local/bin:<span class="nv">$PATH</span>
465
459
  </code></pre></div></div>
466
460
 
467
- <p>GUI apps can modify the <code class="language-plaintext highlighter-rouge">$PATH</code> as follows:</p>
461
+ <p>GUI apps can modify the <code class="highlighter-rouge">$PATH</code> as follows:</p>
468
462
 
469
463
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span>
470
464
  </code></pre></div></div>
471
465
 
472
- <p>Either of these approaches are useful because <code class="language-plaintext highlighter-rouge">/usr/local</code> is considered a
466
+ <p>Either of these approaches are useful because <code class="highlighter-rouge">/usr/local</code> is considered a
473
467
  “safe” location on systems which have SIP enabled, they avoid potential
474
468
  conflicts with the version of Ruby included by Apple, and it keeps Jekyll and
475
469
  its dependencies in a sandboxed environment. This also has the added
476
- benefit of not requiring <code class="language-plaintext highlighter-rouge">sudo</code> when you want to add or remove a gem.</p>
470
+ benefit of not requiring <code class="highlighter-rouge">sudo</code> when you want to add or remove a gem.</p>
477
471
 
478
472
  <h3 id="could-not-find-a-javascript-runtime-execjsruntimeunavailable">Could not find a JavaScript runtime. (ExecJS::RuntimeUnavailable)</h3>
479
473
 
480
- <p>This error can occur during the installation of <code class="language-plaintext highlighter-rouge">jekyll-coffeescript</code> when
474
+ <p>This error can occur during the installation of <code class="highlighter-rouge">jekyll-coffeescript</code> when
481
475
  you don’t have a proper JavaScript runtime. To solve this, either install
482
- <code class="language-plaintext highlighter-rouge">execjs</code> and <code class="language-plaintext highlighter-rouge">therubyracer</code> gems, or install <code class="language-plaintext highlighter-rouge">nodejs</code>. Check out
476
+ <code class="highlighter-rouge">execjs</code> and <code class="highlighter-rouge">therubyracer</code> gems, or install <code class="highlighter-rouge">nodejs</code>. Check out
483
477
  <a href="https://github.com/jekyll/jekyll/issues/2327">issue #2327</a> for more info.</p>
484
478
 
485
479
  <h2 id="problems-running-jekyll">Problems running Jekyll</h2>
486
480
 
487
- <p>On Debian or Ubuntu, you may need to add <code class="language-plaintext highlighter-rouge">/var/lib/gems/1.8/bin/</code> to your path
488
- in order to have the <code class="language-plaintext highlighter-rouge">jekyll</code> executable be available in your Terminal.</p>
481
+ <p>On Debian or Ubuntu, you may need to add <code class="highlighter-rouge">/var/lib/gems/1.8/bin/</code> to your path
482
+ in order to have the <code class="highlighter-rouge">jekyll</code> executable be available in your Terminal.</p>
489
483
 
490
484
  <h2 id="base-url-problems">Base-URL Problems</h2>
491
485
 
@@ -496,17 +490,17 @@ in order to have the <code class="language-plaintext highlighter-rouge">jekyll</
496
490
 
497
491
  <p>… then make sure that you access the site at:</p>
498
492
 
499
- <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog/index.html
493
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog/index.html
500
494
  </code></pre></div></div>
501
495
 
502
496
  <p>It won’t work to just access:</p>
503
497
 
504
- <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog
498
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog
505
499
  </code></pre></div></div>
506
500
 
507
501
  <h2 id="configuration-problems">Configuration problems</h2>
508
502
 
509
- <p>The order of precedence for conflicting <a href="../configuration/">configuration settings</a>
503
+ <p>The order of precedence for conflicting <a href="/docs/configuration/">configuration settings</a>
510
504
  is as follows:</p>
511
505
 
512
506
  <ol>
@@ -515,24 +509,24 @@ is as follows:</p>
515
509
  <li>Defaults</li>
516
510
  </ol>
517
511
 
518
- <p>That is: defaults are overridden by options specified in <code class="language-plaintext highlighter-rouge">_config.yml</code>,
512
+ <p>That is: defaults are overridden by options specified in <code class="highlighter-rouge">_config.yml</code>,
519
513
  and flags specified at the command-line will override all other settings
520
514
  specified elsewhere.</p>
521
515
 
522
- <p><strong>Note: From v3.3.0 onward, Jekyll does not process <code class="language-plaintext highlighter-rouge">node_modules</code> and certain subdirectories within <code class="language-plaintext highlighter-rouge">vendor</code>, by default. But, by having an <code class="language-plaintext highlighter-rouge">exclude:</code> array defined explicitly in the config file overrides this default setting, which results in some users to encounter an error in building the site, with the following error message:</strong></p>
516
+ <p><strong>Note: From v3.3.0 onward, Jekyll does not process <code class="highlighter-rouge">node_modules</code> and certain subdirectories within <code class="highlighter-rouge">vendor</code>, by default. But, by having an <code class="highlighter-rouge">exclude:</code> array defined explicitly in the config file overrides this default setting, which results in some users to encounter an error in building the site, with the following error message:</strong></p>
523
517
 
524
518
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code> ERROR: YOUR SITE COULD NOT BE BUILT:
525
519
  <span class="nt">------------------------------------</span>
526
520
  Invalid <span class="nb">date</span> <span class="s1">'&lt;%= Time.now.strftime('</span>%Y-%m-%d %H:%M:%S %z<span class="s1">') %&gt;'</span>:
527
521
  Document <span class="s1">'vendor/bundle/gems/jekyll-3.4.3/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb'</span>
528
- does not have a valid <span class="nb">date </span><span class="k">in </span>the YAML front matter.
522
+ does not have a valid <span class="nb">date </span><span class="k">in </span>front matter.
529
523
  </code></pre></div></div>
530
524
 
531
- <p>Simply adding <code class="language-plaintext highlighter-rouge">vendor/bundle</code> to the <code class="language-plaintext highlighter-rouge">exclude:</code> list will solve this problem but will lead to having other sub-directories under <code class="language-plaintext highlighter-rouge">/vendor/</code> (and also <code class="language-plaintext highlighter-rouge">/node_modules/</code>, if present) be processed to the destination folder <code class="language-plaintext highlighter-rouge">_site</code>.</p>
525
+ <p>Adding <code class="highlighter-rouge">vendor/bundle</code> to the <code class="highlighter-rouge">exclude:</code> list will solve this problem but will lead to having other sub-directories under <code class="highlighter-rouge">/vendor/</code> (and also <code class="highlighter-rouge">/node_modules/</code>, if present) be processed to the destination folder <code class="highlighter-rouge">_site</code>.</p>
532
526
 
533
- <p>The proper solution is to incorporate the default setting for <code class="language-plaintext highlighter-rouge">exclude:</code> rather than override it completely:</p>
527
+ <p>The proper solution is to incorporate the default setting for <code class="highlighter-rouge">exclude:</code> rather than override it completely:</p>
534
528
 
535
- <p>For versions upto <code class="language-plaintext highlighter-rouge">v3.4.3</code>, the <code class="language-plaintext highlighter-rouge">exclude:</code> setting must look like following:</p>
529
+ <p>For versions up to <code class="highlighter-rouge">v3.4.3</code>, the <code class="highlighter-rouge">exclude:</code> setting must look like following:</p>
536
530
 
537
531
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">exclude</span><span class="pi">:</span>
538
532
  <span class="pi">-</span> <span class="s">Gemfile</span>
@@ -545,7 +539,7 @@ specified elsewhere.</p>
545
539
  <span class="pi">-</span> <span class="s">any_additional_item</span> <span class="c1"># any user-specific listing goes at the end</span>
546
540
  </code></pre></div></div>
547
541
 
548
- <p>From <code class="language-plaintext highlighter-rouge">v3.5</code> onward, <code class="language-plaintext highlighter-rouge">Gemfile</code> and <code class="language-plaintext highlighter-rouge">Gemfile.lock</code> are also excluded by default. So, in most cases there is no need to define another <code class="language-plaintext highlighter-rouge">exclude:</code> array in the config file. So an existing definition can either be modified as above, or removed completely, or simply commented out to enable easy edits in future.</p>
542
+ <p>From <code class="highlighter-rouge">v3.5</code> onward, <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code> are also excluded by default. So, in most cases there is no need to define another <code class="highlighter-rouge">exclude:</code> array in the config file. So an existing definition can either be modified as above, or removed completely, or commented out to enable easy edits in future.</p>
549
543
 
550
544
  <h2 id="markup-problems">Markup Problems</h2>
551
545
 
@@ -555,8 +549,8 @@ problems.</p>
555
549
 
556
550
  <h3 id="liquid">Liquid</h3>
557
551
 
558
- <p>Liquid version 2.0 seems to break the use of <code class="language-plaintext highlighter-rouge">{{</code> in templates.
559
- Unlike previous versions, using <code class="language-plaintext highlighter-rouge">{{</code> in 2.0 triggers the following error:</p>
552
+ <p>Liquid version 2.0 seems to break the use of <code class="highlighter-rouge">{{</code> in templates.
553
+ Unlike previous versions, using <code class="highlighter-rouge">{{</code> in 2.0 triggers the following error:</p>
560
554
 
561
555
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="s1">'{{'</span> was not properly terminated with regexp: /<span class="se">\}\}</span>/ <span class="o">(</span>Liquid::SyntaxError<span class="o">)</span>
562
556
  </code></pre></div></div>
@@ -566,14 +560,14 @@ Unlike previous versions, using <code class="language-plaintext highlighter-roug
566
560
  <p>Since v1.0.0, Jekyll has had automatically-generated post excerpts. Since
567
561
  v1.1.0, Jekyll also passes these excerpts through Liquid, which can cause
568
562
  strange errors where references don’t exist or a tag hasn’t been closed. If you
569
- run into these errors, try setting <code class="language-plaintext highlighter-rouge">excerpt_separator: ""</code> in your
570
- <code class="language-plaintext highlighter-rouge">_config.yml</code>, or set it to some nonsense string.</p>
563
+ run into these errors, try setting <code class="highlighter-rouge">excerpt_separator: ""</code> in your
564
+ <code class="highlighter-rouge">_config.yml</code>, or set it to some nonsense string.</p>
571
565
 
572
566
  <h2 id="production-problems">Production Problems</h2>
573
567
 
574
568
  <p>If you run into an issue that a static file can’t be found in your
575
569
  production environment during build since v3.2.0 you should set your
576
- <a href="../configuration/#specifying-a-jekyll-environment-at-build-time">environment to <code class="language-plaintext highlighter-rouge">production</code></a>.
570
+ <a href="/docs/configuration/environments/">environment to <code class="highlighter-rouge">production</code></a>.
577
571
  The issue is caused by trying to copy a non-existing symlink.</p>
578
572
 
579
573
  <div class="note">
@@ -585,298 +579,218 @@ The issue is caused by trying to copy a non-existing symlink.</p>
585
579
  </p>
586
580
  </div>
587
581
 
588
-
589
-
590
-
591
-
592
-
593
-
594
-
595
-
596
-
597
-
598
-
599
-
600
-
601
-
602
-
603
-
604
-
605
-
606
-
607
-
608
-
609
-
610
-
611
-
612
-
613
-
614
-
615
-
616
-
617
-
618
-
619
-
620
-
621
-
622
-
623
-
624
-
625
-
626
-
627
-
628
-
629
-
630
-
631
-
632
-
633
-
634
-
635
-
636
-
637
-
638
-
639
-
640
-
641
-
642
-
643
-
644
-
645
-
646
-
647
-
648
-
649
-
650
-
651
-
652
-
653
-
654
-
655
-
656
-
657
-
658
-
659
-
660
-
661
-
662
-
663
-
664
-
665
-
666
-
667
-
668
-
669
-
670
-
671
-
672
-
673
-
674
-
675
-
676
-
677
- <div class="section-nav">
678
- <div class="left align-right">
679
-
680
-
681
-
682
- <a href="/docs/continuous-integration/" class="prev">Back</a>
683
-
684
- </div>
685
- <div class="right align-left">
686
-
687
-
688
-
689
- <a href="/docs/sites/" class="next">Next</a>
690
-
691
- </div>
692
- </div>
693
- <div class="clear"></div>
694
-
695
582
  </article>
696
583
  </div>
697
584
 
698
585
  <div class="unit one-fifth hide-on-mobiles">
699
586
  <aside>
700
587
 
701
- <h4>Getting Started</h4>
702
- <ul>
703
-
704
-
705
-
706
- <li class=""><a href="/docs/home/">Welcome</a></li>
707
-
708
-
709
-
710
- <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
711
-
712
-
713
-
714
- <li class=""><a href="/docs/installation/">Installation</a></li>
715
-
716
-
717
-
718
- <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
719
-
720
-
721
-
722
- <li class=""><a href="/docs/usage/">Basic Usage</a></li>
723
-
724
-
725
-
726
- <li class=""><a href="/docs/structure/">Directory structure</a></li>
727
-
728
-
729
-
730
- <li class=""><a href="/docs/configuration/">Configuration</a></li>
731
-
732
- </ul>
733
-
734
-
735
- <h4>Your Content</h4>
736
- <ul>
737
-
738
-
739
-
740
- <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
741
-
742
-
743
-
744
- <li class=""><a href="/docs/posts/">Writing posts</a></li>
745
-
746
-
747
-
748
- <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
749
-
750
-
751
-
752
- <li class=""><a href="/docs/pages/">Creating pages</a></li>
753
-
754
-
755
-
756
- <li class=""><a href="/docs/static-files/">Static Files</a></li>
757
-
758
-
759
-
760
- <li class=""><a href="/docs/variables/">Variables</a></li>
761
-
762
-
763
-
764
- <li class=""><a href="/docs/collections/">Collections</a></li>
765
-
766
-
767
-
768
- <li class=""><a href="/docs/datafiles/">Data Files</a></li>
769
-
770
-
771
-
772
- <li class=""><a href="/docs/assets/">Assets</a></li>
773
-
774
-
775
-
776
- <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
777
-
778
- </ul>
779
-
588
+ <h4>Getting Started</h4>
589
+ <ul>
590
+
591
+
592
+ <li>
593
+ <a href="/docs/">
594
+ Quickstart
595
+ </a>
596
+ </li>
597
+
598
+
599
+ <li>
600
+ <a href="/docs/ruby-101/">
601
+ Ruby 101
602
+ </a>
603
+ </li>
604
+
605
+
606
+ <li>
607
+ <a href="/docs/installation/">
608
+ Installation
609
+ </a>
610
+ </li>
611
+
612
+
613
+ <li>
614
+ <a href="/docs/community/">
615
+ Community
616
+ </a>
617
+ </li>
618
+
619
+
620
+ <li>
621
+ <a href="/docs/step-by-step/01-setup/">
622
+ Step by Step Tutorial
623
+ </a>
624
+ </li>
625
+
626
+ </ul>
780
627
 
781
- <h4>Customization</h4>
782
- <ul>
783
-
784
-
785
-
786
- <li class=""><a href="/docs/templates/">Templates</a></li>
787
-
788
-
789
-
790
- <li class=""><a href="/docs/includes/">Includes</a></li>
791
-
792
-
793
-
794
- <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
795
-
796
-
797
-
798
- <li class=""><a href="/docs/pagination/">Pagination</a></li>
799
-
800
-
801
-
802
- <li class=""><a href="/docs/plugins/">Plugins</a></li>
803
-
804
-
805
-
806
- <li class=""><a href="/docs/themes/">Themes</a></li>
807
-
808
-
809
-
810
- <li class=""><a href="/docs/extras/">Extras</a></li>
811
-
812
- </ul>
813
-
628
+ <h4>Build</h4>
629
+ <ul>
630
+
631
+
632
+ <li>
633
+ <a href="/docs/usage/">
634
+ Command Line Usage
635
+ </a>
636
+ </li>
637
+
638
+
639
+ <li>
640
+ <a href="/docs/configuration/">
641
+ Configuration
642
+ </a>
643
+ </li>
644
+
645
+ </ul>
814
646
 
815
- <h4>Deployment</h4>
816
- <ul>
817
-
818
-
819
-
820
- <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
821
-
822
-
823
-
824
- <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
825
-
826
-
827
-
828
- <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
829
-
830
- </ul>
831
-
647
+ <h4>Content</h4>
648
+ <ul>
649
+
650
+
651
+ <li>
652
+ <a href="/docs/pages/">
653
+ Pages
654
+ </a>
655
+ </li>
656
+
657
+
658
+ <li>
659
+ <a href="/docs/posts/">
660
+ Posts
661
+ </a>
662
+ </li>
663
+
664
+
665
+ <li>
666
+ <a href="/docs/front-matter/">
667
+ Front Matter
668
+ </a>
669
+ </li>
670
+
671
+
672
+ <li>
673
+ <a href="/docs/collections/">
674
+ Collections
675
+ </a>
676
+ </li>
677
+
678
+
679
+ <li>
680
+ <a href="/docs/datafiles/">
681
+ Data Files
682
+ </a>
683
+ </li>
684
+
685
+
686
+ <li>
687
+ <a href="/docs/assets/">
688
+ Assets
689
+ </a>
690
+ </li>
691
+
692
+
693
+ <li>
694
+ <a href="/docs/static-files/">
695
+ Static Files
696
+ </a>
697
+ </li>
698
+
699
+ </ul>
832
700
 
833
- <h4>Miscellaneous</h4>
834
- <ul>
835
-
836
-
837
-
838
- <li class="current"><a href="/docs/troubleshooting/">Troubleshooting</a></li>
839
-
840
-
841
-
842
- <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
843
-
844
-
845
-
846
- <li class=""><a href="/docs/resources/">Resources</a></li>
847
-
848
-
849
-
850
- <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
851
-
852
-
853
-
854
- <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
855
-
856
- </ul>
857
-
701
+ <h4>Site Structure</h4>
702
+ <ul>
703
+
704
+
705
+ <li>
706
+ <a href="/docs/structure/">
707
+ Directory Structure
708
+ </a>
709
+ </li>
710
+
711
+
712
+ <li>
713
+ <a href="/docs/liquid/">
714
+ Liquid
715
+ </a>
716
+ </li>
717
+
718
+
719
+ <li>
720
+ <a href="/docs/variables/">
721
+ Variables
722
+ </a>
723
+ </li>
724
+
725
+
726
+ <li>
727
+ <a href="/docs/includes/">
728
+ Includes
729
+ </a>
730
+ </li>
731
+
732
+
733
+ <li>
734
+ <a href="/docs/layouts/">
735
+ Layouts
736
+ </a>
737
+ </li>
738
+
739
+
740
+ <li>
741
+ <a href="/docs/permalinks/">
742
+ Permalinks
743
+ </a>
744
+ </li>
745
+
746
+
747
+ <li>
748
+ <a href="/docs/themes/">
749
+ Themes
750
+ </a>
751
+ </li>
752
+
753
+
754
+ <li>
755
+ <a href="/docs/pagination/">
756
+ Pagination
757
+ </a>
758
+ </li>
759
+
760
+ </ul>
858
761
 
859
- <h4>Meta</h4>
860
- <ul>
861
-
862
-
863
-
864
- <li class=""><a href="/docs/contributing/">Contributing</a></li>
865
-
866
-
867
-
868
- <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
869
-
870
-
871
-
872
- <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
873
-
874
-
875
-
876
- <li class=""><a href="/docs/history/">History</a></li>
877
-
878
- </ul>
879
-
762
+ <h4>Guides</h4>
763
+ <ul>
764
+
765
+
766
+ <li>
767
+ <a href="/docs/plugins/">
768
+ Plugins
769
+ </a>
770
+ </li>
771
+
772
+
773
+ <li>
774
+ <a href="/docs/migrations/">
775
+ Blog Migrations
776
+ </a>
777
+ </li>
778
+
779
+
780
+ <li>
781
+ <a href="/docs/upgrading/">
782
+ Upgrading
783
+ </a>
784
+ </li>
785
+
786
+
787
+ <li>
788
+ <a href="/docs/deployment/">
789
+ Deployment
790
+ </a>
791
+ </li>
792
+
793
+ </ul>
880
794
 
881
795
  </aside>
882
796
  </div>
@@ -891,7 +805,8 @@ The issue is caused by trying to copy a non-existing symlink.</p>
891
805
  <footer>
892
806
  <div class="grid">
893
807
  <div class="unit one-third center-on-mobiles">
894
- <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>
808
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
809
+ <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>
895
810
  </div>
896
811
  <div class="unit two-thirds align-right center-on-mobiles">
897
812
  <p>
@@ -901,6 +816,14 @@ The issue is caused by trying to copy a non-existing symlink.</p>
901
816
  </a>
902
817
  </p>
903
818
  </div>
819
+ <div class="unit two-thirds align-right center-on-mobiles">
820
+ <p>
821
+ Jekyll is funded thanks to its
822
+ <a href="https://github.com/jekyll/jekyll#sponsors">
823
+ sponsors!
824
+ </a>
825
+ </p>
826
+ </div>
904
827
  </div>
905
828
  </footer>
906
829