jekyll-docs 3.9.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/jekyll-docs.rb +3 -3
- data/site/404.html +10 -7
- data/site/css/screen.css +3 -1
- data/site/css/screen.css.map +28 -0
- data/site/docs/assets/index.html +412 -453
- data/site/docs/code_of_conduct/index.html +447 -501
- data/site/docs/collections/index.html +487 -674
- data/site/docs/community/bug/index.html +603 -0
- data/site/docs/community/index.html +635 -0
- data/site/docs/conduct/index.html +447 -515
- data/site/docs/configuration/default/index.html +682 -0
- data/site/docs/configuration/environments/index.html +641 -0
- data/site/docs/configuration/front-matter-defaults/index.html +738 -0
- data/site/docs/configuration/incremental-regeneration/index.html +631 -0
- data/site/docs/configuration/index.html +405 -1230
- data/site/docs/configuration/liquid/index.html +616 -0
- data/site/docs/configuration/markdown/index.html +766 -0
- data/site/docs/configuration/options/index.html +1011 -0
- data/site/docs/configuration/webrick/index.html +615 -0
- data/site/docs/continuous-integration/buddyworks/index.html +393 -479
- data/site/docs/continuous-integration/circleci/index.html +465 -481
- data/site/docs/continuous-integration/travis-ci/index.html +450 -507
- data/site/docs/contributing/index.html +425 -514
- data/site/docs/datafiles/index.html +411 -453
- data/site/docs/deployment-methods/index.html +9 -871
- data/site/docs/deployment/automated/index.html +663 -0
- data/site/docs/deployment/index.html +607 -0
- data/site/docs/deployment/manual/index.html +631 -0
- data/site/docs/deployment/third-party/index.html +639 -0
- data/site/docs/drafts/index.html +9 -634
- data/site/docs/extras/index.html +9 -687
- data/site/docs/front-matter/index.html +799 -0
- data/site/docs/frontmatter/index.html +9 -819
- data/site/docs/github-pages/index.html +407 -475
- data/site/docs/history/index.html +1370 -1154
- data/site/docs/home/index.html +9 -627
- data/site/docs/includes/index.html +425 -501
- data/site/docs/index.html +630 -9
- data/site/docs/installation/index.html +403 -540
- data/site/docs/installation/macos/index.html +716 -0
- data/site/docs/installation/other-linux/index.html +613 -0
- data/site/docs/installation/ubuntu/index.html +623 -0
- data/site/docs/installation/windows/index.html +733 -0
- data/site/docs/layouts/index.html +726 -0
- data/site/docs/liquid/filters/index.html +1169 -0
- data/site/docs/liquid/index.html +615 -0
- data/site/docs/liquid/tags/index.html +728 -0
- data/site/docs/maintaining/affinity-team-captain/index.html +395 -479
- data/site/docs/maintaining/avoiding-burnout/index.html +391 -475
- data/site/docs/maintaining/becoming-a-maintainer/index.html +391 -475
- data/site/docs/maintaining/index.html +391 -486
- data/site/docs/maintaining/merging-a-pull-request/index.html +406 -490
- data/site/docs/maintaining/releasing-a-new-version/index.html +409 -485
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +392 -476
- data/site/docs/maintaining/special-labels/index.html +397 -481
- data/site/docs/maintaining/triaging-an-issue/index.html +394 -478
- data/site/docs/markdown-101/index.html +601 -0
- data/site/docs/migrations/index.html +396 -440
- data/site/docs/pages/index.html +408 -482
- data/site/docs/pagination/index.html +450 -509
- data/site/docs/permalinks/index.html +552 -587
- data/site/docs/plugins/commands/index.html +656 -0
- data/site/docs/plugins/converters/index.html +685 -0
- data/site/docs/plugins/filters/index.html +624 -0
- data/site/docs/plugins/generators/index.html +697 -0
- data/site/docs/plugins/hooks/index.html +838 -0
- data/site/docs/plugins/index.html +415 -1565
- data/site/docs/plugins/installation/index.html +681 -0
- data/site/docs/plugins/tags/index.html +699 -0
- data/site/docs/plugins/your-first-plugin/index.html +741 -0
- data/site/docs/posts/index.html +491 -627
- data/site/docs/quickstart/index.html +9 -645
- data/site/docs/resources/index.html +9 -761
- data/site/docs/ruby-101/index.html +640 -0
- data/site/docs/sites/index.html +9 -696
- data/site/docs/static-files/index.html +401 -433
- data/site/docs/step-by-step/01-setup/index.html +771 -0
- data/site/docs/step-by-step/02-liquid/index.html +756 -0
- data/site/docs/step-by-step/03-front-matter/index.html +730 -0
- data/site/docs/step-by-step/04-layouts/index.html +770 -0
- data/site/docs/step-by-step/05-includes/index.html +768 -0
- data/site/docs/step-by-step/06-data-files/index.html +738 -0
- data/site/docs/step-by-step/07-assets/index.html +773 -0
- data/site/docs/step-by-step/08-blogging/index.html +835 -0
- data/site/docs/step-by-step/09-collections/index.html +932 -0
- data/site/docs/step-by-step/10-deployment/index.html +842 -0
- data/site/docs/structure/index.html +411 -430
- data/site/docs/support/index.html +392 -476
- data/site/docs/templates/index.html +9 -1232
- data/site/docs/themes/index.html +487 -521
- data/site/docs/troubleshooting/index.html +443 -520
- data/site/docs/upgrading/0-to-2/index.html +437 -523
- data/site/docs/upgrading/2-to-3/index.html +422 -507
- data/site/docs/upgrading/3-to-4/index.html +765 -0
- data/site/docs/upgrading/index.html +395 -478
- data/site/docs/usage/index.html +409 -506
- data/site/docs/variables/index.html +504 -652
- data/site/docs/windows/index.html +9 -784
- data/site/feed.xml +269 -188
- data/site/feed/release.xml +324 -0
- data/site/fonts/lato-v14-latin-300.woff +0 -0
- data/site/fonts/lato-v14-latin-300.woff2 +0 -0
- data/site/fonts/lato-v14-latin-300italic.woff +0 -0
- data/site/fonts/lato-v14-latin-300italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-700.woff +0 -0
- data/site/fonts/lato-v14-latin-700.woff2 +0 -0
- data/site/fonts/lato-v14-latin-700italic.woff +0 -0
- data/site/fonts/lato-v14-latin-700italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-900.woff +0 -0
- data/site/fonts/lato-v14-latin-900.woff2 +0 -0
- data/site/fonts/lato-v14-latin-900italic.woff +0 -0
- data/site/fonts/lato-v14-latin-900italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-italic.woff +0 -0
- data/site/fonts/lato-v14-latin-italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-regular.woff +0 -0
- data/site/fonts/lato-v14-latin-regular.woff2 +0 -0
- data/site/help/index.html +9 -247
- data/site/img/forestry-logo.svg +19 -0
- data/site/img/jekyll-og.png +0 -0
- data/site/img/spacer.gif +0 -0
- data/site/index.html +56 -29
- data/site/jekyllconf/index.html +62 -35
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +180 -115
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +182 -117
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +183 -118
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +184 -119
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +183 -118
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +180 -115
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +182 -117
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +182 -117
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +185 -120
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +183 -118
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +180 -115
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +189 -124
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +181 -116
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +181 -116
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +180 -115
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +182 -117
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +181 -116
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +181 -116
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +181 -116
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +184 -119
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +180 -115
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +181 -116
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +185 -120
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +182 -117
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +181 -116
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +189 -124
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +187 -122
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +188 -123
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +180 -115
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +182 -117
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +179 -114
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +180 -115
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +179 -114
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +180 -115
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +180 -115
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +185 -120
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +184 -119
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +182 -117
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +186 -121
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +183 -118
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +181 -116
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +182 -117
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +179 -114
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +181 -116
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +181 -116
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +180 -115
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +186 -121
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +181 -116
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +181 -116
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +179 -114
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +184 -119
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +180 -115
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +179 -114
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +207 -142
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +181 -116
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +183 -118
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +181 -116
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +189 -124
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +190 -125
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +187 -122
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +182 -117
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +185 -120
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +181 -116
- data/site/news/2017/10/19/diversity-open-source/index.html +181 -116
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +183 -118
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +184 -119
- data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +189 -124
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +180 -115
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +185 -120
- data/site/news/2018/04/19/development-update/index.html +699 -0
- data/site/news/2018/04/19/jekyll-3-8-0-released/index.html +715 -0
- data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +182 -117
- data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +181 -116
- data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +183 -118
- data/site/news/2018/08/01/jekyll-sponsoring/index.html +748 -0
- data/site/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/index.html +692 -0
- data/site/news/2018/11/04/jekyll-3-8-5-released/index.html +682 -0
- data/site/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/index.html +710 -0
- data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +180 -115
- data/site/news/2019/07/20/jekyll-4-0-0-pre-beta1-released/index.html +11 -0
- data/site/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/index.html +708 -0
- data/site/news/2019/08/20/jekyll-4-0-0-released/index.html +809 -0
- data/site/news/index.html +976 -326
- data/site/news/releases/index.html +820 -321
- data/site/{philosophy.html → philosophy/index.html} +1 -1
- data/site/redirects.json +1 -1
- data/site/resources/index.html +332 -0
- data/site/showcase/index.html +844 -0
- data/site/sitemap.xml +256 -81
- data/site/team/index.html +63 -77
- data/site/tutorials/cache-api/index.html +418 -0
- data/site/tutorials/convert-site-to-jekyll/index.html +155 -124
- data/site/tutorials/custom-404-page/index.html +76 -43
- data/site/tutorials/home/index.html +64 -37
- data/site/tutorials/navigation/index.html +186 -103
- data/site/tutorials/orderofinterpretation/index.html +80 -53
- data/site/tutorials/using-jekyll-with-bundler/index.html +80 -51
- data/site/tutorials/video-walkthroughs/index.html +62 -35
- metadata +102 -13
- data/site/community/index.html +0 -11
- 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
|
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="
|
10
|
-
<link rel="
|
11
|
-
<link rel="
|
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
|
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
|
20
|
-
<meta property="og:description" content="You can
|
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="
|
26
|
-
<meta name="twitter:card" content="
|
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
|
-
{"
|
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
|
-
|
57
|
+
|
58
|
+
<li>
|
55
59
|
<a href="/">Home</a>
|
56
60
|
</li>
|
61
|
+
|
57
62
|
<li class="current">
|
58
|
-
<a href="/docs/
|
63
|
+
<a href="/docs/">Docs</a>
|
59
64
|
</li>
|
60
|
-
|
61
|
-
|
65
|
+
|
66
|
+
<li>
|
67
|
+
<a href="/resources/">Resources</a>
|
62
68
|
</li>
|
63
|
-
|
64
|
-
|
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/
|
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
|
-
|
87
|
-
<
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
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
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
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="
|
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="
|
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="
|
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="
|
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> 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> Improve this page</a>
|
296
290
|
</div>
|
297
291
|
<h1>Travis CI</h1>
|
298
|
-
<p>You can
|
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>
|
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="
|
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
|
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="
|
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="
|
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="
|
338
|
-
<code class="
|
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="
|
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="
|
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="
|
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="
|
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
|
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="
|
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.
|
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.
|
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
|
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="
|
430
|
-
directory, and to call your test script <code class="
|
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 && htmlproofer ./_site</span>
|
436
442
|
</code></pre></div></div>
|
437
443
|
|
438
|
-
<p>The <code class="
|
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="
|
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="
|
460
|
+
prefixed, exemplified above with the <code class="highlighter-rouge">/pages-(.*)/</code> regular expression.</p>
|
455
461
|
|
456
|
-
<p>The <code class="
|
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="
|
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="
|
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="
|
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="
|
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="
|
496
|
-
<code class="
|
497
|
-
an entry in the <code class="
|
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
|
-
|
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
|
-
<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
|
-
|
706
|
-
|
707
|
-
|
708
|
-
|
709
|
-
|
710
|
-
|
711
|
-
|
712
|
-
|
713
|
-
|
714
|
-
|
715
|
-
|
716
|
-
|
717
|
-
|
718
|
-
|
719
|
-
|
720
|
-
|
721
|
-
|
722
|
-
|
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
|
-
|
740
|
-
|
741
|
-
|
742
|
-
|
743
|
-
|
744
|
-
|
745
|
-
|
746
|
-
|
747
|
-
|
748
|
-
|
749
|
-
|
750
|
-
|
751
|
-
|
752
|
-
|
753
|
-
|
754
|
-
</
|
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
|
-
|
758
|
-
|
759
|
-
|
760
|
-
|
761
|
-
|
762
|
-
|
763
|
-
|
764
|
-
|
765
|
-
|
766
|
-
|
767
|
-
|
768
|
-
|
769
|
-
|
770
|
-
|
771
|
-
|
772
|
-
|
773
|
-
|
774
|
-
|
775
|
-
|
776
|
-
|
777
|
-
|
778
|
-
|
779
|
-
|
780
|
-
|
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
|
-
|
784
|
-
|
785
|
-
|
786
|
-
|
787
|
-
|
788
|
-
|
789
|
-
|
790
|
-
|
791
|
-
|
792
|
-
|
793
|
-
|
794
|
-
|
795
|
-
|
796
|
-
|
797
|
-
|
798
|
-
|
799
|
-
|
800
|
-
|
801
|
-
|
802
|
-
|
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>
|
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 />© 2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT 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
|
|