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
16
  <title>Travis CI | 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="Travis CI" />
18
19
  <meta property="og:locale" content="en_US" />
19
- <meta name="description" content="You can easily test your website build against one or more versions of Ruby. The following guide will show you how to set up a free build environment on Travis, with GitHub integration for pull requests." />
20
- <meta property="og:description" content="You can easily test your website build against one or more versions of Ruby. The following guide will show you how to set up a free build environment on Travis, with GitHub integration for pull requests." />
20
+ <meta name="description" content="You can test your website build against one or more versions of Ruby. The following guide will show you how to set up a free build environment on Travis, with GitHub integration for pull requests." />
21
+ <meta property="og:description" content="You can test your website build against one or more versions of Ruby. The following guide will show you how to set up a free build environment on Travis, with GitHub integration for pull requests." />
21
22
  <link rel="canonical" href="https://jekyllrb.com/docs/continuous-integration/travis-ci/" />
22
23
  <meta property="og:url" content="https://jekyllrb.com/docs/continuous-integration/travis-ci/" />
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="Travis CI" />
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/continuous-integration/travis-ci/","headline":"Travis CI","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":"You can easily test your website build against one or more versions of Ruby. The following guide will show you how to set up a free build environment on Travis, with GitHub integration for pull requests.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/continuous-integration/travis-ci/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
34
+ {"description":"You can test your website build against one or more versions of Ruby. The following guide will show you how to set up a free build environment on Travis, with GitHub integration for pull requests.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/continuous-integration/travis-ci/"},"headline":"Travis CI","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/continuous-integration/travis-ci/","datePublished":"2019-09-11T07:30:27-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@context":"https://schema.org"}</script>
32
35
  <!-- End Jekyll SEO tag -->
33
36
 
34
37
  <!--[if lt IE 9]>
@@ -51,18 +54,27 @@
51
54
  </div>
52
55
  <nav class="main-nav hide-on-mobiles">
53
56
  <ul>
54
- <li class="">
57
+
58
+ <li>
55
59
  <a href="/">Home</a>
56
60
  </li>
61
+
57
62
  <li class="current">
58
- <a href="/docs/home/">Docs</a>
63
+ <a href="/docs/">Docs</a>
59
64
  </li>
60
- <li class="">
61
- <a href="/news/">News</a>
65
+
66
+ <li>
67
+ <a href="/resources/">Resources</a>
62
68
  </li>
63
- <li class="">
64
- <a href="/help/">Help</a>
69
+
70
+ <li>
71
+ <a href="/showcase/">Showcase</a>
65
72
  </li>
73
+
74
+ <li>
75
+ <a href="/news/">News</a>
76
+ </li>
77
+
66
78
  </ul>
67
79
 
68
80
  </nav>
@@ -73,7 +85,7 @@
73
85
  <div class="meta hide-on-mobiles">
74
86
  <ul>
75
87
  <li>
76
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
88
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
77
89
  </li>
78
90
  <li>
79
91
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -83,18 +95,24 @@
83
95
  </div>
84
96
  <nav class="mobile-nav show-on-mobiles">
85
97
  <ul>
86
- <li class="">
87
- <a href="/">Home</a>
88
- </li>
89
- <li class="current">
90
- <a href="/docs/home/">Docs</a>
91
- </li>
92
- <li class="">
93
- <a href="/news/">News</a>
94
- </li>
95
- <li class="">
96
- <a href="/help/">Help</a>
97
- </li>
98
+
99
+ <li>
100
+ <a href="/">Home</a>
101
+ </li>
102
+
103
+ <li class="current">
104
+ <a href="/docs/">Docs</a>
105
+ </li>
106
+
107
+ <li>
108
+ <a href="/resources/">Resources</a>
109
+ </li>
110
+
111
+
112
+ <li>
113
+ <a href="/news/">News</a>
114
+ </li>
115
+
98
116
  <li>
99
117
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
100
118
  </li>
@@ -113,176 +131,152 @@
113
131
 
114
132
  <optgroup label="Getting Started">
115
133
 
116
-
117
-
118
- <option value="/docs/home/">Welcome</option>
119
-
120
-
121
-
122
- <option value="/docs/quickstart/">Quick-start guide</option>
123
-
124
-
125
-
126
- <option value="/docs/installation/">Installation</option>
127
-
128
-
129
-
130
- <option value="/docs/windows/">Jekyll on Windows</option>
131
-
132
-
133
-
134
- <option value="/docs/usage/">Basic Usage</option>
135
-
136
-
137
-
138
- <option value="/docs/structure/">Directory structure</option>
139
-
140
-
141
-
142
- <option value="/docs/configuration/">Configuration</option>
143
-
144
-
145
- </optgroup>
146
-
147
- <optgroup label="Your Content">
134
+
135
+ <option value="/docs/">
136
+ Quickstart
137
+ </option>
138
+
139
+
140
+ <option value="/docs/ruby-101/">
141
+ Ruby 101
142
+ </option>
143
+
144
+
145
+ <option value="/docs/installation/">
146
+ Installation
147
+ </option>
148
+
149
+
150
+ <option value="/docs/community/">
151
+ Community
152
+ </option>
153
+
154
+
155
+ <option value="/docs/step-by-step/01-setup/">
156
+ Step by Step Tutorial
157
+ </option>
148
158
 
149
-
150
-
151
- <option value="/docs/frontmatter/">Front Matter</option>
152
-
153
-
154
-
155
- <option value="/docs/posts/">Writing posts</option>
156
-
157
-
158
-
159
- <option value="/docs/drafts/">Working with drafts</option>
160
-
161
-
162
-
163
- <option value="/docs/pages/">Creating pages</option>
164
-
165
-
166
-
167
- <option value="/docs/static-files/">Static Files</option>
168
-
169
-
170
-
171
- <option value="/docs/variables/">Variables</option>
172
-
173
-
174
-
175
- <option value="/docs/collections/">Collections</option>
176
-
177
-
178
-
179
- <option value="/docs/datafiles/">Data Files</option>
180
-
181
-
182
-
183
- <option value="/docs/assets/">Assets</option>
184
-
185
-
186
-
187
- <option value="/docs/migrations/">Blog migrations</option>
188
-
189
-
190
159
  </optgroup>
191
160
 
192
- <optgroup label="Customization">
161
+ <optgroup label="Build">
162
+
163
+
164
+ <option value="/docs/usage/">
165
+ Command Line Usage
166
+ </option>
167
+
168
+
169
+ <option value="/docs/configuration/">
170
+ Configuration
171
+ </option>
193
172
 
194
-
195
-
196
- <option value="/docs/templates/">Templates</option>
197
-
198
-
199
-
200
- <option value="/docs/includes/">Includes</option>
201
-
202
-
203
-
204
- <option value="/docs/permalinks/">Permalinks</option>
205
-
206
-
207
-
208
- <option value="/docs/pagination/">Pagination</option>
209
-
210
-
211
-
212
- <option value="/docs/plugins/">Plugins</option>
213
-
214
-
215
-
216
- <option value="/docs/themes/">Themes</option>
217
-
218
-
219
-
220
- <option value="/docs/extras/">Extras</option>
221
-
222
-
223
173
  </optgroup>
224
174
 
225
- <optgroup label="Deployment">
175
+ <optgroup label="Content">
176
+
177
+
178
+ <option value="/docs/pages/">
179
+ Pages
180
+ </option>
181
+
182
+
183
+ <option value="/docs/posts/">
184
+ Posts
185
+ </option>
186
+
187
+
188
+ <option value="/docs/front-matter/">
189
+ Front Matter
190
+ </option>
191
+
192
+
193
+ <option value="/docs/collections/">
194
+ Collections
195
+ </option>
196
+
197
+
198
+ <option value="/docs/datafiles/">
199
+ Data Files
200
+ </option>
201
+
202
+
203
+ <option value="/docs/assets/">
204
+ Assets
205
+ </option>
206
+
207
+
208
+ <option value="/docs/static-files/">
209
+ Static Files
210
+ </option>
226
211
 
227
-
228
-
229
- <option value="/docs/github-pages/">GitHub Pages</option>
230
-
231
-
232
-
233
- <option value="/docs/deployment-methods/">Deployment methods</option>
234
-
235
-
236
-
237
- <option value="/docs/continuous-integration/">Continuous Integration</option>
238
-
239
-
240
212
  </optgroup>
241
213
 
242
- <optgroup label="Miscellaneous">
214
+ <optgroup label="Site Structure">
215
+
216
+
217
+ <option value="/docs/structure/">
218
+ Directory Structure
219
+ </option>
220
+
221
+
222
+ <option value="/docs/liquid/">
223
+ Liquid
224
+ </option>
225
+
226
+
227
+ <option value="/docs/variables/">
228
+ Variables
229
+ </option>
230
+
231
+
232
+ <option value="/docs/includes/">
233
+ Includes
234
+ </option>
235
+
236
+
237
+ <option value="/docs/layouts/">
238
+ Layouts
239
+ </option>
240
+
241
+
242
+ <option value="/docs/permalinks/">
243
+ Permalinks
244
+ </option>
245
+
246
+
247
+ <option value="/docs/themes/">
248
+ Themes
249
+ </option>
250
+
251
+
252
+ <option value="/docs/pagination/">
253
+ Pagination
254
+ </option>
243
255
 
244
-
245
-
246
- <option value="/docs/troubleshooting/">Troubleshooting</option>
247
-
248
-
249
-
250
- <option value="/docs/sites/">Sites using Jekyll</option>
251
-
252
-
253
-
254
- <option value="/docs/resources/">Resources</option>
255
-
256
-
257
-
258
- <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
259
-
260
-
261
-
262
- <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
263
-
264
-
265
256
  </optgroup>
266
257
 
267
- <optgroup label="Meta">
258
+ <optgroup label="Guides">
259
+
260
+
261
+ <option value="/docs/plugins/">
262
+ Plugins
263
+ </option>
264
+
265
+
266
+ <option value="/docs/migrations/">
267
+ Blog Migrations
268
+ </option>
269
+
270
+
271
+ <option value="/docs/upgrading/">
272
+ Upgrading
273
+ </option>
274
+
275
+
276
+ <option value="/docs/deployment/">
277
+ Deployment
278
+ </option>
268
279
 
269
-
270
-
271
- <option value="/docs/contributing/">Contributing</option>
272
-
273
-
274
-
275
- <option value="/docs/maintaining/">Maintaining Jekyll</option>
276
-
277
-
278
-
279
- <option value="/docs/conduct/">Code of Conduct</option>
280
-
281
-
282
-
283
- <option value="/docs/history/">History</option>
284
-
285
-
286
280
  </optgroup>
287
281
 
288
282
  </select>
@@ -292,37 +286,37 @@
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/continuous-integration/travis-ci.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/continuous-integration/travis-ci.md"><i class="fa fa-pencil"></i> &nbsp;Improve this page</a>
296
290
  </div>
297
291
  <h1>Travis CI</h1>
298
- <p>You can easily test your website build against one or more versions of Ruby.
292
+ <p>You can test your website build against one or more versions of Ruby.
299
293
  The following guide will show you how to set up a free build environment on
300
294
  <a href="https://travis-ci.org/">Travis</a>, with <a href="https://github.com/">GitHub</a> integration for pull requests.</p>
301
295
 
302
296
  <h2 id="1-enabling-travis-and-github">1. Enabling Travis and GitHub</h2>
303
297
 
304
- <p>Enabling Travis builds for your GitHub repository is pretty simple:</p>
298
+ <p>To enable Travis builds for your GitHub repository:</p>
305
299
 
306
300
  <ol>
307
301
  <li>Go to your profile on travis-ci.org: https://travis-ci.org/profile/username</li>
308
302
  <li>Find the repository for which you’re interested in enabling builds.</li>
309
303
  <li>Flick the repository switch on so that it turns blue.</li>
310
304
  <li>Optionally configure the build by clicking on the gear icon. Further
311
- configuration happens via your <code class="language-plaintext highlighter-rouge">.travis.yml</code> file. More details below.</li>
305
+ configuration happens via your <code class="highlighter-rouge">.travis.yml</code> file. More details below.</li>
312
306
  </ol>
313
307
 
314
308
  <h2 id="2-the-test-script">2. The Test Script</h2>
315
309
 
316
- <p>The simplest test script simply runs <code class="language-plaintext highlighter-rouge">jekyll build</code> and ensures that Jekyll
310
+ <p>The simplest test script runs <code class="highlighter-rouge">jekyll build</code> and ensures that Jekyll
317
311
  doesn’t fail to build the site. It doesn’t check the resulting site, but it
318
312
  does ensure things are built properly.</p>
319
313
 
320
314
  <p>When testing Jekyll output, there is no better tool than <a href="https://github.com/gjtorikian/html-proofer">html-proofer</a>.
321
315
  This tool checks your resulting site to ensure all links and images exist.
322
- Utilize it either with the convenient <code class="language-plaintext highlighter-rouge">htmlproofer</code> command-line executable,
316
+ Utilize it either with the convenient <code class="highlighter-rouge">htmlproofer</code> command-line executable,
323
317
  or write a Ruby script which utilizes the gem.</p>
324
318
 
325
- <p>Save the commands you want to run and succeed in a file: <code class="language-plaintext highlighter-rouge">./script/cibuild</code></p>
319
+ <p>Save the commands you want to run and succeed in a file: <code class="highlighter-rouge">./script/cibuild</code></p>
326
320
 
327
321
  <h3 id="the-html-proofer-executable">The HTML Proofer Executable</h3>
328
322
 
@@ -334,8 +328,8 @@ bundle <span class="nb">exec </span>htmlproofer ./_site
334
328
  </code></pre></div></div>
335
329
 
336
330
  <p>Some options can be specified via command-line switches. Check out the
337
- <code class="language-plaintext highlighter-rouge">html-proofer</code> README for more information about these switches, or run
338
- <code class="language-plaintext highlighter-rouge">htmlproofer --help</code> locally.</p>
331
+ <code class="highlighter-rouge">html-proofer</code> README for more information about these switches, or run
332
+ <code class="highlighter-rouge">htmlproofer --help</code> locally.</p>
339
333
 
340
334
  <p>For example to avoid testing external sites, use this command:</p>
341
335
 
@@ -344,7 +338,7 @@ bundle <span class="nb">exec </span>htmlproofer ./_site
344
338
 
345
339
  <h3 id="the-html-proofer-library">The HTML Proofer Library</h3>
346
340
 
347
- <p>You can also invoke <code class="language-plaintext highlighter-rouge">html-proofer</code> in Ruby scripts (e.g. in a Rakefile):</p>
341
+ <p>You can also invoke <code class="highlighter-rouge">html-proofer</code> in Ruby scripts (e.g. in a Rakefile):</p>
348
342
 
349
343
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">#!/usr/bin/env ruby</span>
350
344
 
@@ -352,18 +346,18 @@ bundle <span class="nb">exec </span>htmlproofer ./_site
352
346
  <span class="no">HTMLProofer</span><span class="p">.</span><span class="nf">check_directory</span><span class="p">(</span><span class="s2">"./_site"</span><span class="p">).</span><span class="nf">run</span>
353
347
  </code></pre></div></div>
354
348
 
355
- <p>Options are given as a second argument to <code class="language-plaintext highlighter-rouge">.new</code>, and are encoded in a
349
+ <p>Options are given as a second argument to <code class="highlighter-rouge">.new</code>, and are encoded in a
356
350
  symbol-keyed Ruby Hash. For more information about the configuration options,
357
- check out <code class="language-plaintext highlighter-rouge">html-proofer</code>’s README file.</p>
351
+ check out <code class="highlighter-rouge">html-proofer</code>’s README file.</p>
358
352
 
359
353
  <h2 id="3-configuring-your-travis-builds">3. Configuring Your Travis Builds</h2>
360
354
 
361
355
  <p>This file is used to configure your Travis builds. Because Jekyll is built
362
356
  with Ruby and requires RubyGems to install, we use the Ruby language build
363
- environment. Below is a sample <code class="language-plaintext highlighter-rouge">.travis.yml</code> file, followed by
357
+ environment. Below is a sample <code class="highlighter-rouge">.travis.yml</code> file, followed by
364
358
  an explanation of each line.</p>
365
359
 
366
- <p><strong>Note:</strong> You will need a Gemfile as well, <a href="https://docs.travis-ci.com/user/languages/ruby/#Dependency-Management">Travis will automatically install</a> the dependencies based on the referenced gems:</p>
360
+ <p><strong>Note:</strong> You will need a Gemfile as well, <a href="https://docs.travis-ci.com/user/languages/ruby/#Dependency-Management">Travis will automatically install</a> the dependencies based on the referenced gems. Here is an example <code class="highlighter-rouge">Gemfile</code> with two referenced gems, “jekyll” and “html-proofer”:</p>
367
361
 
368
362
  <div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s2">"https://rubygems.org"</span>
369
363
 
@@ -371,11 +365,11 @@ an explanation of each line.</p>
371
365
  <span class="n">gem</span> <span class="s2">"html-proofer"</span>
372
366
  </code></pre></div></div>
373
367
 
374
- <p>Your <code class="language-plaintext highlighter-rouge">.travis.yml</code> file should look like this:</p>
368
+ <p>Your <code class="highlighter-rouge">.travis.yml</code> file should look like this:</p>
375
369
 
376
370
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">language</span><span class="pi">:</span> <span class="s">ruby</span>
377
371
  <span class="na">rvm</span><span class="pi">:</span>
378
- <span class="pi">-</span> <span class="s">2.3.3</span>
372
+ <span class="pi">-</span> <span class="s">2.6.3</span>
379
373
 
380
374
  <span class="na">before_script</span><span class="pi">:</span>
381
375
  <span class="pi">-</span> <span class="s">chmod +x ./script/cibuild</span> <span class="c1"># or do this locally and commit</span>
@@ -394,7 +388,18 @@ an explanation of each line.</p>
394
388
  <span class="na">global</span><span class="pi">:</span>
395
389
  <span class="pi">-</span> <span class="s">NOKOGIRI_USE_SYSTEM_LIBRARIES=true</span> <span class="c1"># speeds up installation of html-proofer</span>
396
390
 
391
+ <span class="na">addons</span><span class="pi">:</span>
392
+ <span class="na">apt</span><span class="pi">:</span>
393
+ <span class="na">packages</span><span class="pi">:</span>
394
+ <span class="pi">-</span> <span class="s">libcurl4-openssl-dev</span>
395
+
397
396
  <span class="na">sudo</span><span class="pi">:</span> <span class="no">false</span> <span class="c1"># route your build to the container-based infrastructure for a faster build</span>
397
+
398
+ <span class="na">cache</span><span class="pi">:</span> <span class="s">bundler</span> <span class="c1"># caching bundler gem packages will speed up build</span>
399
+
400
+ <span class="c1"># Optional: disable email notifications about the outcome of your builds</span>
401
+ <span class="na">notifications</span><span class="pi">:</span>
402
+ <span class="na">email</span><span class="pi">:</span> <span class="no">false</span>
398
403
  </code></pre></div></div>
399
404
 
400
405
  <p>Ok, now for an explanation of each line:</p>
@@ -406,12 +411,13 @@ an explanation of each line.</p>
406
411
  access to Bundler, RubyGems, and a Ruby runtime.</p>
407
412
 
408
413
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">rvm</span><span class="pi">:</span>
409
- <span class="pi">-</span> <span class="s">2.3.3</span>
414
+ <span class="pi">-</span> <span class="s">2.6.3</span>
410
415
  </code></pre></div></div>
411
416
 
412
417
  <p>RVM is a popular Ruby Version Manager (like rbenv, chruby, etc). This
413
418
  directive tells Travis the Ruby version to use when running your test
414
- script.</p>
419
+ script. Use a <a href="https://docs.travis-ci.com/user/languages/ruby/#Specifying-Ruby-versions-and-implementations">version which is pre-installed on the Travis build docker</a>
420
+ image to speed up the build.</p>
415
421
 
416
422
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">before_script</span><span class="pi">:</span>
417
423
  <span class="pi">-</span> <span class="s">chmod +x ./script/cibuild</span>
@@ -426,8 +432,8 @@ irrelevant.</p>
426
432
  </code></pre></div></div>
427
433
 
428
434
  <p>Travis allows you to run any arbitrary shell script to test your site. One
429
- convention is to put all scripts for your project in the <code class="language-plaintext highlighter-rouge">script</code>
430
- directory, and to call your test script <code class="language-plaintext highlighter-rouge">cibuild</code>. This line is completely
435
+ convention is to put all scripts for your project in the <code class="highlighter-rouge">script</code>
436
+ directory, and to call your test script <code class="highlighter-rouge">cibuild</code>. This line is completely
431
437
  customizable. If your script won’t change much, you can write your test
432
438
  incantation here directly:</p>
433
439
 
@@ -435,7 +441,7 @@ incantation here directly:</p>
435
441
  <span class="na">script</span><span class="pi">:</span> <span class="s">jekyll build &amp;&amp; htmlproofer ./_site</span>
436
442
  </code></pre></div></div>
437
443
 
438
- <p>The <code class="language-plaintext highlighter-rouge">script</code> directive can be absolutely any valid shell command.</p>
444
+ <p>The <code class="highlighter-rouge">script</code> directive can be absolutely any valid shell command.</p>
439
445
 
440
446
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># branch whitelist, only for GitHub Pages</span>
441
447
  <span class="na">branches</span><span class="pi">:</span>
@@ -447,13 +453,13 @@ incantation here directly:</p>
447
453
  <p>You want to ensure the Travis builds for your site are being run only on
448
454
  the branch or branches which contain your site. One means of ensuring this
449
455
  isolation is including a branch whitelist in your Travis configuration
450
- file. By specifying the <code class="language-plaintext highlighter-rouge">gh-pages</code> branch, you will ensure the associated
456
+ file. By specifying the <code class="highlighter-rouge">gh-pages</code> branch, you will ensure the associated
451
457
  test script (discussed above) is only executed on site branches. If you use
452
458
  a pull request flow for proposing changes, you may wish to enforce a
453
459
  convention for your builds such that all branches containing edits are
454
- prefixed, exemplified above with the <code class="language-plaintext highlighter-rouge">/pages-(.*)/</code> regular expression.</p>
460
+ prefixed, exemplified above with the <code class="highlighter-rouge">/pages-(.*)/</code> regular expression.</p>
455
461
 
456
- <p>The <code class="language-plaintext highlighter-rouge">branches</code> directive is completely optional. Travis will build from every
462
+ <p>The <code class="highlighter-rouge">branches</code> directive is completely optional. Travis will build from every
457
463
  push to any branch of your repo if leave it out.</p>
458
464
 
459
465
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">env</span><span class="pi">:</span>
@@ -461,11 +467,11 @@ push to any branch of your repo if leave it out.</p>
461
467
  <span class="pi">-</span> <span class="s">NOKOGIRI_USE_SYSTEM_LIBRARIES=true</span> <span class="c1"># speeds up installation of html-proofer</span>
462
468
  </code></pre></div></div>
463
469
 
464
- <p>Using <code class="language-plaintext highlighter-rouge">html-proofer</code>? You’ll want this environment variable. Nokogiri, used
470
+ <p>Using <code class="highlighter-rouge">html-proofer</code>? You’ll want this environment variable. Nokogiri, used
465
471
  to parse HTML files in your compiled site, comes bundled with libraries
466
472
  which it must compile each time it is installed. Luckily, you can
467
473
  dramatically decrease the install time of Nokogiri by setting the
468
- environment variable <code class="language-plaintext highlighter-rouge">NOKOGIRI_USE_SYSTEM_LIBRARIES</code> to <code class="language-plaintext highlighter-rouge">true</code>.</p>
474
+ environment variable <code class="highlighter-rouge">NOKOGIRI_USE_SYSTEM_LIBRARIES</code> to <code class="highlighter-rouge">true</code>.</p>
469
475
 
470
476
  <div class="note warning">
471
477
  <h5>Be sure to exclude <code>vendor</code> from your
@@ -477,24 +483,39 @@ environment variable <code class="language-plaintext highlighter-rouge">NOKOGIRI
477
483
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">exclude</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">vendor</span><span class="pi">]</span>
478
484
  </code></pre></div></div>
479
485
 
480
- <p>By default you should supply the <code class="language-plaintext highlighter-rouge">sudo: false</code> command to Travis. This command
486
+ <p>By default you should supply the <code class="highlighter-rouge">sudo: false</code> command to Travis. This command
481
487
  explicitly tells Travis to run your build on Travis’s <a href="https://docs.travis-ci.com/user/workers/container-based-infrastructure/#Routing-your-build-to-container-based-infrastructure">container-based
482
488
  infrastructure</a>. Running on the container-based infrastructure can often times
483
489
  speed up your build. If you have any trouble with your build, or if your build
484
- does need <code class="language-plaintext highlighter-rouge">sudo</code> access, modify the line to <code class="language-plaintext highlighter-rouge">sudo: required</code>.</p>
490
+ does need <code class="highlighter-rouge">sudo</code> access, modify the line to <code class="highlighter-rouge">sudo: required</code>.</p>
485
491
 
486
492
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">sudo</span><span class="pi">:</span> <span class="no">false</span>
487
493
  </code></pre></div></div>
488
494
 
495
+ <p>To speed up the build, you should cache the gem packages created by <code class="highlighter-rouge">bundler</code>.
496
+ Travis has a pre-defined <a href="https://docs.travis-ci.com/user/caching/#Caching-directories-(Bundler%2C-dependencies)">cache strategy for this tool</a> which should have
497
+ all the default configs to do exactly that.</p>
498
+
499
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">cache</span><span class="pi">:</span> <span class="s">bundler</span>
500
+ </code></pre></div></div>
501
+
502
+ <p>Optionally, if you are not interested in the build email notifications you
503
+ can disable them with this configuration. Travis supports a wide array of
504
+ notification services, you may find <a href="https://docs.travis-ci.com/user/notifications/">another one more useful (e.g. slack)</a>.</p>
505
+
506
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">notifications</span><span class="pi">:</span>
507
+ <span class="na">email</span><span class="pi">:</span> <span class="no">false</span>
508
+ </code></pre></div></div>
509
+
489
510
  <h3 id="troubleshooting">Troubleshooting</h3>
490
511
 
491
512
  <p><strong>Travis error:</strong> <em>“You are trying to install in deployment mode after changing
492
513
  your Gemfile. Run bundle install elsewhere and add the updated Gemfile.lock
493
514
  to version control.”</em></p>
494
515
 
495
- <p><strong>Workaround:</strong> Either run <code class="language-plaintext highlighter-rouge">bundle install</code> locally and commit your changes to
496
- <code class="language-plaintext highlighter-rouge">Gemfile.lock</code>, or remove the <code class="language-plaintext highlighter-rouge">Gemfile.lock</code> file from your repository and add
497
- an entry in the <code class="language-plaintext highlighter-rouge">.gitignore</code> file to avoid it from being checked in again.</p>
516
+ <p><strong>Workaround:</strong> Either run <code class="highlighter-rouge">bundle install</code> locally and commit your changes to
517
+ <code class="highlighter-rouge">Gemfile.lock</code>, or remove the <code class="highlighter-rouge">Gemfile.lock</code> file from your repository and add
518
+ an entry in the <code class="highlighter-rouge">.gitignore</code> file to avoid it from being checked in again.</p>
498
519
 
499
520
  <h3 id="questions">Questions?</h3>
500
521
 
@@ -502,305 +523,218 @@ an entry in the <code class="language-plaintext highlighter-rouge">.gitignore</c
502
523
  fix or <a href="https://jekyllrb.com/help/">ask for help</a> if you run into trouble and need some help.</p>
503
524
 
504
525
 
505
-
506
-
507
-
508
-
509
-
510
-
511
-
512
-
513
-
514
-
515
-
516
-
517
-
518
-
519
-
520
-
521
-
522
-
523
-
524
-
525
-
526
-
527
-
528
-
529
-
530
-
531
-
532
-
533
-
534
-
535
-
536
-
537
-
538
-
539
-
540
-
541
-
542
-
543
-
544
-
545
-
546
-
547
-
548
-
549
-
550
-
551
-
552
-
553
-
554
-
555
-
556
-
557
-
558
-
559
-
560
-
561
-
562
-
563
-
564
-
565
-
566
-
567
-
568
-
569
-
570
-
571
-
572
-
573
-
574
-
575
-
576
-
577
-
578
-
579
-
580
-
581
-
582
-
583
-
584
-
585
-
586
-
587
-
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
526
  </article>
620
527
  </div>
621
528
 
622
529
  <div class="unit one-fifth hide-on-mobiles">
623
530
  <aside>
624
531
 
625
- <h4>Getting Started</h4>
626
- <ul>
627
-
628
-
629
-
630
- <li class=""><a href="/docs/home/">Welcome</a></li>
631
-
632
-
633
-
634
- <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
635
-
636
-
637
-
638
- <li class=""><a href="/docs/installation/">Installation</a></li>
639
-
640
-
641
-
642
- <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
643
-
644
-
645
-
646
- <li class=""><a href="/docs/usage/">Basic Usage</a></li>
647
-
648
-
649
-
650
- <li class=""><a href="/docs/structure/">Directory structure</a></li>
651
-
652
-
653
-
654
- <li class=""><a href="/docs/configuration/">Configuration</a></li>
655
-
656
- </ul>
657
-
658
-
659
- <h4>Your Content</h4>
660
- <ul>
661
-
662
-
663
-
664
- <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
665
-
666
-
667
-
668
- <li class=""><a href="/docs/posts/">Writing posts</a></li>
669
-
670
-
671
-
672
- <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
673
-
674
-
675
-
676
- <li class=""><a href="/docs/pages/">Creating pages</a></li>
677
-
678
-
679
-
680
- <li class=""><a href="/docs/static-files/">Static Files</a></li>
681
-
682
-
683
-
684
- <li class=""><a href="/docs/variables/">Variables</a></li>
685
-
686
-
687
-
688
- <li class=""><a href="/docs/collections/">Collections</a></li>
689
-
690
-
691
-
692
- <li class=""><a href="/docs/datafiles/">Data Files</a></li>
693
-
694
-
695
-
696
- <li class=""><a href="/docs/assets/">Assets</a></li>
697
-
698
-
699
-
700
- <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
701
-
702
- </ul>
703
-
532
+ <h4>Getting Started</h4>
533
+ <ul>
534
+
535
+
536
+ <li>
537
+ <a href="/docs/">
538
+ Quickstart
539
+ </a>
540
+ </li>
541
+
542
+
543
+ <li>
544
+ <a href="/docs/ruby-101/">
545
+ Ruby 101
546
+ </a>
547
+ </li>
548
+
549
+
550
+ <li>
551
+ <a href="/docs/installation/">
552
+ Installation
553
+ </a>
554
+ </li>
555
+
556
+
557
+ <li>
558
+ <a href="/docs/community/">
559
+ Community
560
+ </a>
561
+ </li>
562
+
563
+
564
+ <li>
565
+ <a href="/docs/step-by-step/01-setup/">
566
+ Step by Step Tutorial
567
+ </a>
568
+ </li>
569
+
570
+ </ul>
704
571
 
705
- <h4>Customization</h4>
706
- <ul>
707
-
708
-
709
-
710
- <li class=""><a href="/docs/templates/">Templates</a></li>
711
-
712
-
713
-
714
- <li class=""><a href="/docs/includes/">Includes</a></li>
715
-
716
-
717
-
718
- <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
719
-
720
-
721
-
722
- <li class=""><a href="/docs/pagination/">Pagination</a></li>
723
-
724
-
725
-
726
- <li class=""><a href="/docs/plugins/">Plugins</a></li>
727
-
728
-
729
-
730
- <li class=""><a href="/docs/themes/">Themes</a></li>
731
-
732
-
733
-
734
- <li class=""><a href="/docs/extras/">Extras</a></li>
735
-
736
- </ul>
737
-
572
+ <h4>Build</h4>
573
+ <ul>
574
+
575
+
576
+ <li>
577
+ <a href="/docs/usage/">
578
+ Command Line Usage
579
+ </a>
580
+ </li>
581
+
582
+
583
+ <li>
584
+ <a href="/docs/configuration/">
585
+ Configuration
586
+ </a>
587
+ </li>
588
+
589
+ </ul>
738
590
 
739
- <h4>Deployment</h4>
740
- <ul>
741
-
742
-
743
-
744
- <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
745
-
746
-
747
-
748
- <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
749
-
750
-
751
-
752
- <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
753
-
754
- </ul>
755
-
591
+ <h4>Content</h4>
592
+ <ul>
593
+
594
+
595
+ <li>
596
+ <a href="/docs/pages/">
597
+ Pages
598
+ </a>
599
+ </li>
600
+
601
+
602
+ <li>
603
+ <a href="/docs/posts/">
604
+ Posts
605
+ </a>
606
+ </li>
607
+
608
+
609
+ <li>
610
+ <a href="/docs/front-matter/">
611
+ Front Matter
612
+ </a>
613
+ </li>
614
+
615
+
616
+ <li>
617
+ <a href="/docs/collections/">
618
+ Collections
619
+ </a>
620
+ </li>
621
+
622
+
623
+ <li>
624
+ <a href="/docs/datafiles/">
625
+ Data Files
626
+ </a>
627
+ </li>
628
+
629
+
630
+ <li>
631
+ <a href="/docs/assets/">
632
+ Assets
633
+ </a>
634
+ </li>
635
+
636
+
637
+ <li>
638
+ <a href="/docs/static-files/">
639
+ Static Files
640
+ </a>
641
+ </li>
642
+
643
+ </ul>
756
644
 
757
- <h4>Miscellaneous</h4>
758
- <ul>
759
-
760
-
761
-
762
- <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
763
-
764
-
765
-
766
- <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
767
-
768
-
769
-
770
- <li class=""><a href="/docs/resources/">Resources</a></li>
771
-
772
-
773
-
774
- <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
775
-
776
-
777
-
778
- <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
779
-
780
- </ul>
781
-
645
+ <h4>Site Structure</h4>
646
+ <ul>
647
+
648
+
649
+ <li>
650
+ <a href="/docs/structure/">
651
+ Directory Structure
652
+ </a>
653
+ </li>
654
+
655
+
656
+ <li>
657
+ <a href="/docs/liquid/">
658
+ Liquid
659
+ </a>
660
+ </li>
661
+
662
+
663
+ <li>
664
+ <a href="/docs/variables/">
665
+ Variables
666
+ </a>
667
+ </li>
668
+
669
+
670
+ <li>
671
+ <a href="/docs/includes/">
672
+ Includes
673
+ </a>
674
+ </li>
675
+
676
+
677
+ <li>
678
+ <a href="/docs/layouts/">
679
+ Layouts
680
+ </a>
681
+ </li>
682
+
683
+
684
+ <li>
685
+ <a href="/docs/permalinks/">
686
+ Permalinks
687
+ </a>
688
+ </li>
689
+
690
+
691
+ <li>
692
+ <a href="/docs/themes/">
693
+ Themes
694
+ </a>
695
+ </li>
696
+
697
+
698
+ <li>
699
+ <a href="/docs/pagination/">
700
+ Pagination
701
+ </a>
702
+ </li>
703
+
704
+ </ul>
782
705
 
783
- <h4>Meta</h4>
784
- <ul>
785
-
786
-
787
-
788
- <li class=""><a href="/docs/contributing/">Contributing</a></li>
789
-
790
-
791
-
792
- <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
793
-
794
-
795
-
796
- <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
797
-
798
-
799
-
800
- <li class=""><a href="/docs/history/">History</a></li>
801
-
802
- </ul>
803
-
706
+ <h4>Guides</h4>
707
+ <ul>
708
+
709
+
710
+ <li>
711
+ <a href="/docs/plugins/">
712
+ Plugins
713
+ </a>
714
+ </li>
715
+
716
+
717
+ <li>
718
+ <a href="/docs/migrations/">
719
+ Blog Migrations
720
+ </a>
721
+ </li>
722
+
723
+
724
+ <li>
725
+ <a href="/docs/upgrading/">
726
+ Upgrading
727
+ </a>
728
+ </li>
729
+
730
+
731
+ <li>
732
+ <a href="/docs/deployment/">
733
+ Deployment
734
+ </a>
735
+ </li>
736
+
737
+ </ul>
804
738
 
805
739
  </aside>
806
740
  </div>
@@ -815,7 +749,8 @@ fix or <a href="https://jekyllrb.com/help/">ask for help</a> if you run into tro
815
749
  <footer>
816
750
  <div class="grid">
817
751
  <div class="unit one-third center-on-mobiles">
818
- <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>
752
+ <p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
753
+ <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>
819
754
  </div>
820
755
  <div class="unit two-thirds align-right center-on-mobiles">
821
756
  <p>
@@ -825,6 +760,14 @@ fix or <a href="https://jekyllrb.com/help/">ask for help</a> if you run into tro
825
760
  </a>
826
761
  </p>
827
762
  </div>
763
+ <div class="unit two-thirds align-right center-on-mobiles">
764
+ <p>
765
+ Jekyll is funded thanks to its
766
+ <a href="https://github.com/jekyll/jekyll#sponsors">
767
+ sponsors!
768
+ </a>
769
+ </p>
770
+ </div>
828
771
  </div>
829
772
  </footer>
830
773