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,17 +3,18 @@
|
|
3
3
|
<head>
|
4
4
|
<meta charset="UTF-8">
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
6
|
-
<meta name="generator" content="Jekyll
|
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>Troubleshooting | 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="Troubleshooting" />
|
18
19
|
<meta property="og:locale" content="en_US" />
|
19
20
|
<meta name="description" content="If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well." />
|
@@ -21,14 +22,16 @@
|
|
21
22
|
<link rel="canonical" href="https://jekyllrb.com/docs/troubleshooting/" />
|
22
23
|
<meta property="og:url" content="https://jekyllrb.com/docs/troubleshooting/" />
|
23
24
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
25
|
+
<meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
|
24
26
|
<meta property="og:type" content="article" />
|
25
|
-
<meta property="article:published_time" content="
|
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="Troubleshooting" />
|
28
31
|
<meta name="twitter:site" content="@jekyllrb" />
|
29
32
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
30
33
|
<script type="application/ld+json">
|
31
|
-
{"
|
34
|
+
{"description":"If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/troubleshooting/"},"headline":"Troubleshooting","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/troubleshooting/","datePublished":"2019-09-11T07:30:27-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@context":"https://schema.org"}</script>
|
32
35
|
<!-- End Jekyll SEO tag -->
|
33
36
|
|
34
37
|
<!--[if lt IE 9]>
|
@@ -51,18 +54,27 @@
|
|
51
54
|
</div>
|
52
55
|
<nav class="main-nav hide-on-mobiles">
|
53
56
|
<ul>
|
54
|
-
|
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>
|
68
|
+
</li>
|
69
|
+
|
70
|
+
<li>
|
71
|
+
<a href="/showcase/">Showcase</a>
|
62
72
|
</li>
|
63
|
-
|
64
|
-
|
73
|
+
|
74
|
+
<li>
|
75
|
+
<a href="/news/">News</a>
|
65
76
|
</li>
|
77
|
+
|
66
78
|
</ul>
|
67
79
|
|
68
80
|
</nav>
|
@@ -73,7 +85,7 @@
|
|
73
85
|
<div class="meta hide-on-mobiles">
|
74
86
|
<ul>
|
75
87
|
<li>
|
76
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/
|
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,7 +286,7 @@
|
|
292
286
|
<div class="unit four-fifths">
|
293
287
|
<article>
|
294
288
|
<div class="improve right hide-on-mobiles">
|
295
|
-
<a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/troubleshooting.md"><i class="fa fa-pencil"></i> Improve this page</a>
|
289
|
+
<a data-proofer-ignore href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/troubleshooting.md"><i class="fa fa-pencil"></i> Improve this page</a>
|
296
290
|
</div>
|
297
291
|
<h1>Troubleshooting</h1>
|
298
292
|
<p>If you ever run into problems installing or using Jekyll, here are a few tips
|
@@ -314,7 +308,7 @@ that might be of help. If the problem you’re experiencing isn’t covered belo
|
|
314
308
|
the header files for compiling extension modules for Ruby 2.x This
|
315
309
|
can be done on Ubuntu or Debian by running:</p>
|
316
310
|
|
317
|
-
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby2.
|
311
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby2.6-dev
|
318
312
|
</code></pre></div></div>
|
319
313
|
|
320
314
|
<p>On Red Hat, CentOS, and Fedora systems you can do this by running:</p>
|
@@ -322,7 +316,7 @@ can be done on Ubuntu or Debian by running:</p>
|
|
322
316
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yum <span class="nb">install </span>ruby-devel
|
323
317
|
</code></pre></div></div>
|
324
318
|
|
325
|
-
<p>If you installed the above - specifically on Fedora 23 - but the extensions would still not compile, you are probably running a Fedora image that misses the <code class="
|
319
|
+
<p>If you installed the above - specifically on Fedora 23 - but the extensions would still not compile, you are probably running a Fedora image that misses the <code class="highlighter-rouge">redhat-rpm-config</code> package. To solve this, run:</p>
|
326
320
|
|
327
321
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>dnf <span class="nb">install </span>redhat-rpm-config
|
328
322
|
</code></pre></div></div>
|
@@ -332,10 +326,10 @@ can be done on Ubuntu or Debian by running:</p>
|
|
332
326
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>pacman <span class="nt">-S</span> ruby-ffi
|
333
327
|
</code></pre></div></div>
|
334
328
|
|
335
|
-
<p>On Ubuntu if you get stuck after <code class="
|
336
|
-
messages like <code class="
|
329
|
+
<p>On Ubuntu if you get stuck after <code class="highlighter-rouge">bundle exec jekyll serve</code> and see error
|
330
|
+
messages like <code class="highlighter-rouge">Could not locate Gemfile</code> or <code class="highlighter-rouge">.bundle/ directory</code>, it’s likely
|
337
331
|
because all requirements have not been fully met. Recent stock Ubuntu
|
338
|
-
distributions require the installation of both the <code class="
|
332
|
+
distributions require the installation of both the <code class="highlighter-rouge">ruby</code> and <code class="highlighter-rouge">ruby-all-dev</code>
|
339
333
|
packages:</p>
|
340
334
|
|
341
335
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby ruby-all-dev
|
@@ -363,19 +357,19 @@ DevKit</a>.</p>
|
|
363
357
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>apt update <span class="o">&&</span> apt <span class="nb">install </span>libffi-dev clang ruby-dev make
|
364
358
|
</code></pre></div></div>
|
365
359
|
|
366
|
-
<p>On macOS, you may need to update RubyGems (using <code class="
|
360
|
+
<p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
367
361
|
|
368
362
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem update <span class="nt">--system</span>
|
369
363
|
</code></pre></div></div>
|
370
364
|
|
371
365
|
<p>If you still have issues, you can download and install new Command Line
|
372
|
-
Tools (such as <code class="
|
366
|
+
Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
|
373
367
|
|
374
368
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xcode-select <span class="nt">--install</span>
|
375
369
|
</code></pre></div></div>
|
376
370
|
|
377
371
|
<p>which may allow you to install native gems using this command (again, using
|
378
|
-
<code class="
|
372
|
+
<code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
379
373
|
|
380
374
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install </span>jekyll
|
381
375
|
</code></pre></div></div>
|
@@ -390,55 +384,55 @@ Line Tools.</p>
|
|
390
384
|
|
391
385
|
<p>On most flavors of Linux, macOS, and Bash on Ubuntu on Windows, it is
|
392
386
|
possible to run Jekyll as a non-superuser and without having to install
|
393
|
-
gems to system-wide locations by adding the following lines to the end
|
394
|
-
of your <code class="
|
387
|
+
gems to system-wide locations by adding the following lines to the end
|
388
|
+
of your <code class="highlighter-rouge">.bashrc</code> file:</p>
|
395
389
|
|
396
|
-
<div class="
|
390
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code># Ruby exports
|
397
391
|
|
398
392
|
export GEM_HOME=$HOME/gems
|
399
393
|
export PATH=$HOME/gems/bin:$PATH
|
400
394
|
</code></pre></div></div>
|
401
395
|
|
402
|
-
<p>This tells <code class="
|
403
|
-
not in a system-wide location, and adds the local <code class="
|
404
|
-
user’s <code class="
|
396
|
+
<p>This tells <code class="highlighter-rouge">gem</code> to place its gems within the user’s home folder,
|
397
|
+
not in a system-wide location, and adds the local <code class="highlighter-rouge">jekyll</code> command to the
|
398
|
+
user’s <code class="highlighter-rouge">PATH</code> ahead of any system-wide paths.</p>
|
405
399
|
|
406
400
|
<p>This is also useful for many shared webhosting services, where user accounts
|
407
|
-
have only limited privileges. Adding these exports to <code class="
|
408
|
-
<code class="
|
401
|
+
have only limited privileges. Adding these exports to <code class="highlighter-rouge">.bashrc</code> before running
|
402
|
+
<code class="highlighter-rouge">gem install jekyll bundler</code> allows a complete non-<code class="highlighter-rouge">sudo</code> install of Jekyll.</p>
|
409
403
|
|
410
|
-
<p>To activate the new exports, either close and restart Bash, logout and
|
411
|
-
log back into your shell account, or run <code class="
|
404
|
+
<p>To activate the new exports, either close and restart Bash, logout and
|
405
|
+
log back into your shell account, or run <code class="highlighter-rouge">. .bashrc</code> in the
|
412
406
|
currently-running shell.</p>
|
413
407
|
|
414
|
-
<p>If you see the following error when running the <code class="
|
408
|
+
<p>If you see the following error when running the <code class="highlighter-rouge">jekyll new</code> command,
|
415
409
|
you can solve it by using the above-described procedure:</p>
|
416
410
|
|
417
411
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll new <span class="nb">test
|
418
412
|
|
419
413
|
</span>Running bundle <span class="nb">install </span><span class="k">in</span> /home/user/test...
|
420
414
|
|
421
|
-
Your user account
|
415
|
+
Your user account is not allowed to <span class="nb">install </span>to the system RubyGems.
|
422
416
|
You can cancel this installation and run:
|
423
417
|
|
424
|
-
|
418
|
+
bundle <span class="nb">install</span> <span class="nt">--path</span> vendor/bundle
|
425
419
|
|
426
|
-
to install the gems into ./vendor/bundle/, or you can enter your password
|
427
|
-
and install the bundled gems to RubyGems using sudo.
|
420
|
+
to <span class="nb">install </span>the gems into ./vendor/bundle/, or you can enter your password
|
421
|
+
and <span class="nb">install </span>the bundled gems to RubyGems using sudo.
|
428
422
|
|
429
423
|
Password:
|
430
|
-
</
|
424
|
+
</code></pre></div></div>
|
431
425
|
|
432
|
-
<p>Once this is done, the <code class="
|
426
|
+
<p>Once this is done, the <code class="highlighter-rouge">jekyll new</code> command should work properly for
|
433
427
|
your user account.</p>
|
434
428
|
|
435
|
-
<h3 id="jekyll--
|
429
|
+
<h3 id="jekyll--macos">Jekyll & macOS</h3>
|
436
430
|
|
437
|
-
<p>With the introduction of System Integrity Protection, several directories
|
431
|
+
<p>With the introduction of System Integrity Protection in v10.11, several directories
|
438
432
|
that were previously writable are now considered system locations and are no
|
439
433
|
longer available. Given these changes, there are a couple of simple ways to get
|
440
434
|
up and running. One option is to change the location where the gem will be
|
441
|
-
installed (again, using <code class="
|
435
|
+
installed (again, using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
442
436
|
|
443
437
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install</span> <span class="nt">-n</span> /usr/local/bin jekyll
|
444
438
|
</code></pre></div></div>
|
@@ -449,7 +443,7 @@ done as follows:</p>
|
|
449
443
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ruby <span class="nt">-e</span> <span class="s2">"</span><span class="si">$(</span>curl <span class="nt">-fsSL</span> https://raw.githubusercontent.com/Homebrew/install/master/install<span class="si">)</span><span class="s2">"</span>
|
450
444
|
</code></pre></div></div>
|
451
445
|
|
452
|
-
<p>Once Homebrew is installed, the second step is
|
446
|
+
<p>Once Homebrew is installed, the second step is to run:</p>
|
453
447
|
|
454
448
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brew <span class="nb">install </span>ruby
|
455
449
|
</code></pre></div></div>
|
@@ -459,33 +453,33 @@ number of Ruby version managers (<a href="https://rvm.io">RVM</a>, <a href="http
|
|
459
453
|
which to install Jekyll.</p>
|
460
454
|
|
461
455
|
<p>If you elect to use one of the above methods to install Ruby, it might be
|
462
|
-
necessary to modify your <code class="
|
456
|
+
necessary to modify your <code class="highlighter-rouge">$PATH</code> variable using the following command:</p>
|
463
457
|
|
464
458
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span>/usr/local/bin:<span class="nv">$PATH</span>
|
465
459
|
</code></pre></div></div>
|
466
460
|
|
467
|
-
<p>GUI apps can modify the <code class="
|
461
|
+
<p>GUI apps can modify the <code class="highlighter-rouge">$PATH</code> as follows:</p>
|
468
462
|
|
469
463
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span>
|
470
464
|
</code></pre></div></div>
|
471
465
|
|
472
|
-
<p>Either of these approaches are useful because <code class="
|
466
|
+
<p>Either of these approaches are useful because <code class="highlighter-rouge">/usr/local</code> is considered a
|
473
467
|
“safe” location on systems which have SIP enabled, they avoid potential
|
474
468
|
conflicts with the version of Ruby included by Apple, and it keeps Jekyll and
|
475
469
|
its dependencies in a sandboxed environment. This also has the added
|
476
|
-
benefit of not requiring <code class="
|
470
|
+
benefit of not requiring <code class="highlighter-rouge">sudo</code> when you want to add or remove a gem.</p>
|
477
471
|
|
478
472
|
<h3 id="could-not-find-a-javascript-runtime-execjsruntimeunavailable">Could not find a JavaScript runtime. (ExecJS::RuntimeUnavailable)</h3>
|
479
473
|
|
480
|
-
<p>This error can occur during the installation of <code class="
|
474
|
+
<p>This error can occur during the installation of <code class="highlighter-rouge">jekyll-coffeescript</code> when
|
481
475
|
you don’t have a proper JavaScript runtime. To solve this, either install
|
482
|
-
<code class="
|
476
|
+
<code class="highlighter-rouge">execjs</code> and <code class="highlighter-rouge">therubyracer</code> gems, or install <code class="highlighter-rouge">nodejs</code>. Check out
|
483
477
|
<a href="https://github.com/jekyll/jekyll/issues/2327">issue #2327</a> for more info.</p>
|
484
478
|
|
485
479
|
<h2 id="problems-running-jekyll">Problems running Jekyll</h2>
|
486
480
|
|
487
|
-
<p>On Debian or Ubuntu, you may need to add <code class="
|
488
|
-
in order to have the <code class="
|
481
|
+
<p>On Debian or Ubuntu, you may need to add <code class="highlighter-rouge">/var/lib/gems/1.8/bin/</code> to your path
|
482
|
+
in order to have the <code class="highlighter-rouge">jekyll</code> executable be available in your Terminal.</p>
|
489
483
|
|
490
484
|
<h2 id="base-url-problems">Base-URL Problems</h2>
|
491
485
|
|
@@ -496,17 +490,17 @@ in order to have the <code class="language-plaintext highlighter-rouge">jekyll</
|
|
496
490
|
|
497
491
|
<p>… then make sure that you access the site at:</p>
|
498
492
|
|
499
|
-
<div class="
|
493
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog/index.html
|
500
494
|
</code></pre></div></div>
|
501
495
|
|
502
496
|
<p>It won’t work to just access:</p>
|
503
497
|
|
504
|
-
<div class="
|
498
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog
|
505
499
|
</code></pre></div></div>
|
506
500
|
|
507
501
|
<h2 id="configuration-problems">Configuration problems</h2>
|
508
502
|
|
509
|
-
<p>The order of precedence for conflicting <a href="
|
503
|
+
<p>The order of precedence for conflicting <a href="/docs/configuration/">configuration settings</a>
|
510
504
|
is as follows:</p>
|
511
505
|
|
512
506
|
<ol>
|
@@ -515,24 +509,24 @@ is as follows:</p>
|
|
515
509
|
<li>Defaults</li>
|
516
510
|
</ol>
|
517
511
|
|
518
|
-
<p>That is: defaults are overridden by options specified in <code class="
|
512
|
+
<p>That is: defaults are overridden by options specified in <code class="highlighter-rouge">_config.yml</code>,
|
519
513
|
and flags specified at the command-line will override all other settings
|
520
514
|
specified elsewhere.</p>
|
521
515
|
|
522
|
-
<p><strong>Note: From v3.3.0 onward, Jekyll does not process <code class="
|
516
|
+
<p><strong>Note: From v3.3.0 onward, Jekyll does not process <code class="highlighter-rouge">node_modules</code> and certain subdirectories within <code class="highlighter-rouge">vendor</code>, by default. But, by having an <code class="highlighter-rouge">exclude:</code> array defined explicitly in the config file overrides this default setting, which results in some users to encounter an error in building the site, with the following error message:</strong></p>
|
523
517
|
|
524
518
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code> ERROR: YOUR SITE COULD NOT BE BUILT:
|
525
519
|
<span class="nt">------------------------------------</span>
|
526
520
|
Invalid <span class="nb">date</span> <span class="s1">'<%= Time.now.strftime('</span>%Y-%m-%d %H:%M:%S %z<span class="s1">') %>'</span>:
|
527
521
|
Document <span class="s1">'vendor/bundle/gems/jekyll-3.4.3/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb'</span>
|
528
|
-
does not have a valid <span class="nb">date </span><span class="k">in </span>
|
522
|
+
does not have a valid <span class="nb">date </span><span class="k">in </span>front matter.
|
529
523
|
</code></pre></div></div>
|
530
524
|
|
531
|
-
<p>
|
525
|
+
<p>Adding <code class="highlighter-rouge">vendor/bundle</code> to the <code class="highlighter-rouge">exclude:</code> list will solve this problem but will lead to having other sub-directories under <code class="highlighter-rouge">/vendor/</code> (and also <code class="highlighter-rouge">/node_modules/</code>, if present) be processed to the destination folder <code class="highlighter-rouge">_site</code>.</p>
|
532
526
|
|
533
|
-
<p>The proper solution is to incorporate the default setting for <code class="
|
527
|
+
<p>The proper solution is to incorporate the default setting for <code class="highlighter-rouge">exclude:</code> rather than override it completely:</p>
|
534
528
|
|
535
|
-
<p>For versions
|
529
|
+
<p>For versions up to <code class="highlighter-rouge">v3.4.3</code>, the <code class="highlighter-rouge">exclude:</code> setting must look like following:</p>
|
536
530
|
|
537
531
|
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">exclude</span><span class="pi">:</span>
|
538
532
|
<span class="pi">-</span> <span class="s">Gemfile</span>
|
@@ -545,7 +539,7 @@ specified elsewhere.</p>
|
|
545
539
|
<span class="pi">-</span> <span class="s">any_additional_item</span> <span class="c1"># any user-specific listing goes at the end</span>
|
546
540
|
</code></pre></div></div>
|
547
541
|
|
548
|
-
<p>From <code class="
|
542
|
+
<p>From <code class="highlighter-rouge">v3.5</code> onward, <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code> are also excluded by default. So, in most cases there is no need to define another <code class="highlighter-rouge">exclude:</code> array in the config file. So an existing definition can either be modified as above, or removed completely, or commented out to enable easy edits in future.</p>
|
549
543
|
|
550
544
|
<h2 id="markup-problems">Markup Problems</h2>
|
551
545
|
|
@@ -555,8 +549,8 @@ problems.</p>
|
|
555
549
|
|
556
550
|
<h3 id="liquid">Liquid</h3>
|
557
551
|
|
558
|
-
<p>Liquid version 2.0 seems to break the use of <code class="
|
559
|
-
Unlike previous versions, using <code class="
|
552
|
+
<p>Liquid version 2.0 seems to break the use of <code class="highlighter-rouge">{{</code> in templates.
|
553
|
+
Unlike previous versions, using <code class="highlighter-rouge">{{</code> in 2.0 triggers the following error:</p>
|
560
554
|
|
561
555
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="s1">'{{'</span> was not properly terminated with regexp: /<span class="se">\}\}</span>/ <span class="o">(</span>Liquid::SyntaxError<span class="o">)</span>
|
562
556
|
</code></pre></div></div>
|
@@ -566,14 +560,14 @@ Unlike previous versions, using <code class="language-plaintext highlighter-roug
|
|
566
560
|
<p>Since v1.0.0, Jekyll has had automatically-generated post excerpts. Since
|
567
561
|
v1.1.0, Jekyll also passes these excerpts through Liquid, which can cause
|
568
562
|
strange errors where references don’t exist or a tag hasn’t been closed. If you
|
569
|
-
run into these errors, try setting <code class="
|
570
|
-
<code class="
|
563
|
+
run into these errors, try setting <code class="highlighter-rouge">excerpt_separator: ""</code> in your
|
564
|
+
<code class="highlighter-rouge">_config.yml</code>, or set it to some nonsense string.</p>
|
571
565
|
|
572
566
|
<h2 id="production-problems">Production Problems</h2>
|
573
567
|
|
574
568
|
<p>If you run into an issue that a static file can’t be found in your
|
575
569
|
production environment during build since v3.2.0 you should set your
|
576
|
-
<a href="
|
570
|
+
<a href="/docs/configuration/environments/">environment to <code class="highlighter-rouge">production</code></a>.
|
577
571
|
The issue is caused by trying to copy a non-existing symlink.</p>
|
578
572
|
|
579
573
|
<div class="note">
|
@@ -585,298 +579,218 @@ The issue is caused by trying to copy a non-existing symlink.</p>
|
|
585
579
|
</p>
|
586
580
|
</div>
|
587
581
|
|
588
|
-
|
589
|
-
|
590
|
-
|
591
|
-
|
592
|
-
|
593
|
-
|
594
|
-
|
595
|
-
|
596
|
-
|
597
|
-
|
598
|
-
|
599
|
-
|
600
|
-
|
601
|
-
|
602
|
-
|
603
|
-
|
604
|
-
|
605
|
-
|
606
|
-
|
607
|
-
|
608
|
-
|
609
|
-
|
610
|
-
|
611
|
-
|
612
|
-
|
613
|
-
|
614
|
-
|
615
|
-
|
616
|
-
|
617
|
-
|
618
|
-
|
619
|
-
|
620
|
-
|
621
|
-
|
622
|
-
|
623
|
-
|
624
|
-
|
625
|
-
|
626
|
-
|
627
|
-
|
628
|
-
|
629
|
-
|
630
|
-
|
631
|
-
|
632
|
-
|
633
|
-
|
634
|
-
|
635
|
-
|
636
|
-
|
637
|
-
|
638
|
-
|
639
|
-
|
640
|
-
|
641
|
-
|
642
|
-
|
643
|
-
|
644
|
-
|
645
|
-
|
646
|
-
|
647
|
-
|
648
|
-
|
649
|
-
|
650
|
-
|
651
|
-
|
652
|
-
|
653
|
-
|
654
|
-
|
655
|
-
|
656
|
-
|
657
|
-
|
658
|
-
|
659
|
-
|
660
|
-
|
661
|
-
|
662
|
-
|
663
|
-
|
664
|
-
|
665
|
-
|
666
|
-
|
667
|
-
|
668
|
-
|
669
|
-
|
670
|
-
|
671
|
-
|
672
|
-
|
673
|
-
|
674
|
-
|
675
|
-
|
676
|
-
|
677
|
-
<div class="section-nav">
|
678
|
-
<div class="left align-right">
|
679
|
-
|
680
|
-
|
681
|
-
|
682
|
-
<a href="/docs/continuous-integration/" class="prev">Back</a>
|
683
|
-
|
684
|
-
</div>
|
685
|
-
<div class="right align-left">
|
686
|
-
|
687
|
-
|
688
|
-
|
689
|
-
<a href="/docs/sites/" class="next">Next</a>
|
690
|
-
|
691
|
-
</div>
|
692
|
-
</div>
|
693
|
-
<div class="clear"></div>
|
694
|
-
|
695
582
|
</article>
|
696
583
|
</div>
|
697
584
|
|
698
585
|
<div class="unit one-fifth hide-on-mobiles">
|
699
586
|
<aside>
|
700
587
|
|
701
|
-
|
702
|
-
|
703
|
-
|
704
|
-
|
705
|
-
|
706
|
-
|
707
|
-
|
708
|
-
|
709
|
-
|
710
|
-
|
711
|
-
|
712
|
-
|
713
|
-
|
714
|
-
|
715
|
-
|
716
|
-
|
717
|
-
|
718
|
-
|
719
|
-
|
720
|
-
|
721
|
-
|
722
|
-
|
723
|
-
|
724
|
-
|
725
|
-
|
726
|
-
|
727
|
-
|
728
|
-
|
729
|
-
|
730
|
-
|
731
|
-
|
732
|
-
|
733
|
-
|
734
|
-
|
735
|
-
|
736
|
-
|
737
|
-
|
738
|
-
|
739
|
-
|
740
|
-
<li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
|
741
|
-
|
742
|
-
|
743
|
-
|
744
|
-
<li class=""><a href="/docs/posts/">Writing posts</a></li>
|
745
|
-
|
746
|
-
|
747
|
-
|
748
|
-
<li class=""><a href="/docs/drafts/">Working with drafts</a></li>
|
749
|
-
|
750
|
-
|
751
|
-
|
752
|
-
<li class=""><a href="/docs/pages/">Creating pages</a></li>
|
753
|
-
|
754
|
-
|
755
|
-
|
756
|
-
<li class=""><a href="/docs/static-files/">Static Files</a></li>
|
757
|
-
|
758
|
-
|
759
|
-
|
760
|
-
<li class=""><a href="/docs/variables/">Variables</a></li>
|
761
|
-
|
762
|
-
|
763
|
-
|
764
|
-
<li class=""><a href="/docs/collections/">Collections</a></li>
|
765
|
-
|
766
|
-
|
767
|
-
|
768
|
-
<li class=""><a href="/docs/datafiles/">Data Files</a></li>
|
769
|
-
|
770
|
-
|
771
|
-
|
772
|
-
<li class=""><a href="/docs/assets/">Assets</a></li>
|
773
|
-
|
774
|
-
|
775
|
-
|
776
|
-
<li class=""><a href="/docs/migrations/">Blog migrations</a></li>
|
777
|
-
|
778
|
-
</ul>
|
779
|
-
|
588
|
+
<h4>Getting Started</h4>
|
589
|
+
<ul>
|
590
|
+
|
591
|
+
|
592
|
+
<li>
|
593
|
+
<a href="/docs/">
|
594
|
+
Quickstart
|
595
|
+
</a>
|
596
|
+
</li>
|
597
|
+
|
598
|
+
|
599
|
+
<li>
|
600
|
+
<a href="/docs/ruby-101/">
|
601
|
+
Ruby 101
|
602
|
+
</a>
|
603
|
+
</li>
|
604
|
+
|
605
|
+
|
606
|
+
<li>
|
607
|
+
<a href="/docs/installation/">
|
608
|
+
Installation
|
609
|
+
</a>
|
610
|
+
</li>
|
611
|
+
|
612
|
+
|
613
|
+
<li>
|
614
|
+
<a href="/docs/community/">
|
615
|
+
Community
|
616
|
+
</a>
|
617
|
+
</li>
|
618
|
+
|
619
|
+
|
620
|
+
<li>
|
621
|
+
<a href="/docs/step-by-step/01-setup/">
|
622
|
+
Step by Step Tutorial
|
623
|
+
</a>
|
624
|
+
</li>
|
625
|
+
|
626
|
+
</ul>
|
780
627
|
|
781
|
-
|
782
|
-
|
783
|
-
|
784
|
-
|
785
|
-
|
786
|
-
|
787
|
-
|
788
|
-
|
789
|
-
|
790
|
-
|
791
|
-
|
792
|
-
|
793
|
-
|
794
|
-
|
795
|
-
|
796
|
-
|
797
|
-
|
798
|
-
|
799
|
-
|
800
|
-
|
801
|
-
|
802
|
-
<li class=""><a href="/docs/plugins/">Plugins</a></li>
|
803
|
-
|
804
|
-
|
805
|
-
|
806
|
-
<li class=""><a href="/docs/themes/">Themes</a></li>
|
807
|
-
|
808
|
-
|
809
|
-
|
810
|
-
<li class=""><a href="/docs/extras/">Extras</a></li>
|
811
|
-
|
812
|
-
</ul>
|
813
|
-
|
628
|
+
<h4>Build</h4>
|
629
|
+
<ul>
|
630
|
+
|
631
|
+
|
632
|
+
<li>
|
633
|
+
<a href="/docs/usage/">
|
634
|
+
Command Line Usage
|
635
|
+
</a>
|
636
|
+
</li>
|
637
|
+
|
638
|
+
|
639
|
+
<li>
|
640
|
+
<a href="/docs/configuration/">
|
641
|
+
Configuration
|
642
|
+
</a>
|
643
|
+
</li>
|
644
|
+
|
645
|
+
</ul>
|
814
646
|
|
815
|
-
|
816
|
-
|
817
|
-
|
818
|
-
|
819
|
-
|
820
|
-
|
821
|
-
|
822
|
-
|
823
|
-
|
824
|
-
|
825
|
-
|
826
|
-
|
827
|
-
|
828
|
-
|
829
|
-
|
830
|
-
</
|
831
|
-
|
647
|
+
<h4>Content</h4>
|
648
|
+
<ul>
|
649
|
+
|
650
|
+
|
651
|
+
<li>
|
652
|
+
<a href="/docs/pages/">
|
653
|
+
Pages
|
654
|
+
</a>
|
655
|
+
</li>
|
656
|
+
|
657
|
+
|
658
|
+
<li>
|
659
|
+
<a href="/docs/posts/">
|
660
|
+
Posts
|
661
|
+
</a>
|
662
|
+
</li>
|
663
|
+
|
664
|
+
|
665
|
+
<li>
|
666
|
+
<a href="/docs/front-matter/">
|
667
|
+
Front Matter
|
668
|
+
</a>
|
669
|
+
</li>
|
670
|
+
|
671
|
+
|
672
|
+
<li>
|
673
|
+
<a href="/docs/collections/">
|
674
|
+
Collections
|
675
|
+
</a>
|
676
|
+
</li>
|
677
|
+
|
678
|
+
|
679
|
+
<li>
|
680
|
+
<a href="/docs/datafiles/">
|
681
|
+
Data Files
|
682
|
+
</a>
|
683
|
+
</li>
|
684
|
+
|
685
|
+
|
686
|
+
<li>
|
687
|
+
<a href="/docs/assets/">
|
688
|
+
Assets
|
689
|
+
</a>
|
690
|
+
</li>
|
691
|
+
|
692
|
+
|
693
|
+
<li>
|
694
|
+
<a href="/docs/static-files/">
|
695
|
+
Static Files
|
696
|
+
</a>
|
697
|
+
</li>
|
698
|
+
|
699
|
+
</ul>
|
832
700
|
|
833
|
-
|
834
|
-
|
835
|
-
|
836
|
-
|
837
|
-
|
838
|
-
|
839
|
-
|
840
|
-
|
841
|
-
|
842
|
-
|
843
|
-
|
844
|
-
|
845
|
-
|
846
|
-
|
847
|
-
|
848
|
-
|
849
|
-
|
850
|
-
|
851
|
-
|
852
|
-
|
853
|
-
|
854
|
-
|
855
|
-
|
856
|
-
|
857
|
-
|
701
|
+
<h4>Site Structure</h4>
|
702
|
+
<ul>
|
703
|
+
|
704
|
+
|
705
|
+
<li>
|
706
|
+
<a href="/docs/structure/">
|
707
|
+
Directory Structure
|
708
|
+
</a>
|
709
|
+
</li>
|
710
|
+
|
711
|
+
|
712
|
+
<li>
|
713
|
+
<a href="/docs/liquid/">
|
714
|
+
Liquid
|
715
|
+
</a>
|
716
|
+
</li>
|
717
|
+
|
718
|
+
|
719
|
+
<li>
|
720
|
+
<a href="/docs/variables/">
|
721
|
+
Variables
|
722
|
+
</a>
|
723
|
+
</li>
|
724
|
+
|
725
|
+
|
726
|
+
<li>
|
727
|
+
<a href="/docs/includes/">
|
728
|
+
Includes
|
729
|
+
</a>
|
730
|
+
</li>
|
731
|
+
|
732
|
+
|
733
|
+
<li>
|
734
|
+
<a href="/docs/layouts/">
|
735
|
+
Layouts
|
736
|
+
</a>
|
737
|
+
</li>
|
738
|
+
|
739
|
+
|
740
|
+
<li>
|
741
|
+
<a href="/docs/permalinks/">
|
742
|
+
Permalinks
|
743
|
+
</a>
|
744
|
+
</li>
|
745
|
+
|
746
|
+
|
747
|
+
<li>
|
748
|
+
<a href="/docs/themes/">
|
749
|
+
Themes
|
750
|
+
</a>
|
751
|
+
</li>
|
752
|
+
|
753
|
+
|
754
|
+
<li>
|
755
|
+
<a href="/docs/pagination/">
|
756
|
+
Pagination
|
757
|
+
</a>
|
758
|
+
</li>
|
759
|
+
|
760
|
+
</ul>
|
858
761
|
|
859
|
-
|
860
|
-
|
861
|
-
|
862
|
-
|
863
|
-
|
864
|
-
|
865
|
-
|
866
|
-
|
867
|
-
|
868
|
-
|
869
|
-
|
870
|
-
|
871
|
-
|
872
|
-
|
873
|
-
|
874
|
-
|
875
|
-
|
876
|
-
|
877
|
-
|
878
|
-
|
879
|
-
|
762
|
+
<h4>Guides</h4>
|
763
|
+
<ul>
|
764
|
+
|
765
|
+
|
766
|
+
<li>
|
767
|
+
<a href="/docs/plugins/">
|
768
|
+
Plugins
|
769
|
+
</a>
|
770
|
+
</li>
|
771
|
+
|
772
|
+
|
773
|
+
<li>
|
774
|
+
<a href="/docs/migrations/">
|
775
|
+
Blog Migrations
|
776
|
+
</a>
|
777
|
+
</li>
|
778
|
+
|
779
|
+
|
780
|
+
<li>
|
781
|
+
<a href="/docs/upgrading/">
|
782
|
+
Upgrading
|
783
|
+
</a>
|
784
|
+
</li>
|
785
|
+
|
786
|
+
|
787
|
+
<li>
|
788
|
+
<a href="/docs/deployment/">
|
789
|
+
Deployment
|
790
|
+
</a>
|
791
|
+
</li>
|
792
|
+
|
793
|
+
</ul>
|
880
794
|
|
881
795
|
</aside>
|
882
796
|
</div>
|
@@ -891,7 +805,8 @@ The issue is caused by trying to copy a non-existing symlink.</p>
|
|
891
805
|
<footer>
|
892
806
|
<div class="grid">
|
893
807
|
<div class="unit one-third center-on-mobiles">
|
894
|
-
<p>
|
808
|
+
<p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
|
809
|
+
<p>The contents of this website are <br />© 2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
895
810
|
</div>
|
896
811
|
<div class="unit two-thirds align-right center-on-mobiles">
|
897
812
|
<p>
|
@@ -901,6 +816,14 @@ The issue is caused by trying to copy a non-existing symlink.</p>
|
|
901
816
|
</a>
|
902
817
|
</p>
|
903
818
|
</div>
|
819
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
820
|
+
<p>
|
821
|
+
Jekyll is funded thanks to its
|
822
|
+
<a href="https://github.com/jekyll/jekyll#sponsors">
|
823
|
+
sponsors!
|
824
|
+
</a>
|
825
|
+
</p>
|
826
|
+
</div>
|
904
827
|
</div>
|
905
828
|
</footer>
|
906
829
|
|