jekyll-docs 3.9.0 → 4.0.0
Sign up to get free protection for your applications and to get access to all the features.
- 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>Order of interpretation | 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="Order of interpretation" />
|
|
18
19
|
<meta property="og:locale" content="en_US" />
|
|
19
20
|
<meta name="description" content="Jekyll’s main job is to convert your raw text files into a static website. It does this by rendering Liquid, Markdown, and other transforms as it generates the static HTML output." />
|
|
@@ -21,14 +22,16 @@
|
|
|
21
22
|
<link rel="canonical" href="https://jekyllrb.com/tutorials/orderofinterpretation/" />
|
|
22
23
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/orderofinterpretation/" />
|
|
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="Order of interpretation" />
|
|
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":"Jekyll’s main job is to convert your raw text files into a static website. It does this by rendering Liquid, Markdown, and other transforms as it generates the static HTML output.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/orderofinterpretation/"},"headline":"Order of interpretation","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/tutorials/orderofinterpretation/","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>
|
|
57
|
-
|
|
58
|
-
|
|
61
|
+
|
|
62
|
+
<li>
|
|
63
|
+
<a href="/docs/">Docs</a>
|
|
64
|
+
</li>
|
|
65
|
+
|
|
66
|
+
<li>
|
|
67
|
+
<a href="/resources/">Resources</a>
|
|
59
68
|
</li>
|
|
60
|
-
|
|
61
|
-
|
|
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>
|
|
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>
|
|
@@ -167,22 +185,22 @@
|
|
|
167
185
|
|
|
168
186
|
<ol>
|
|
169
187
|
<li>
|
|
170
|
-
<p><strong>Site variables</strong>. Jekyll looks across your files and populates <a href="/docs/variables/">site variables</a>, such as <code class="
|
|
188
|
+
<p><strong>Site variables</strong>. Jekyll looks across your files and populates <a href="/docs/variables/">site variables</a>, such as <code class="highlighter-rouge">site</code>, <code class="highlighter-rouge">page</code>, <code class="highlighter-rouge">post</code>, and collection objects. (From these objects, Jekyll determines the values for permalinks, tags, categories, and other details.)</p>
|
|
171
189
|
</li>
|
|
172
|
-
<li><strong>Liquid</strong>. Jekyll processes any <a href="https://github.com/Shopify/liquid">Liquid</a> formatting in pages that contain <a href="/docs/
|
|
190
|
+
<li><strong>Liquid</strong>. Jekyll processes any <a href="https://github.com/Shopify/liquid">Liquid</a> formatting in pages that contain <a href="/docs/front-matter/">front matter</a>. You can identify Liquid as follows:
|
|
173
191
|
<ul>
|
|
174
|
-
<li><strong>Liquid tags</strong> start with <code class="
|
|
175
|
-
<li><strong>Liquid variables</strong> start and end with double curly braces. For example: <code class="
|
|
176
|
-
<li><strong>Liquid filters</strong> start with a pipe character (<code class="
|
|
192
|
+
<li><strong>Liquid tags</strong> start with <code class="highlighter-rouge">{%</code> and end with a <code class="highlighter-rouge">%}</code>. For example: <code class="highlighter-rouge">{% highlight %}</code> or <code class="highlighter-rouge">{% seo %}</code>. Tags can define blocks or be inline. Block-defining tags will also come with a corresponding end tag — for example, <code class="highlighter-rouge">{% endhighlight %}</code>.</li>
|
|
193
|
+
<li><strong>Liquid variables</strong> start and end with double curly braces. For example: <code class="highlighter-rouge">{{ site.myvariable }}</code> or <code class="highlighter-rouge">{{ content }}</code>.</li>
|
|
194
|
+
<li><strong>Liquid filters</strong> start with a pipe character (<code class="highlighter-rouge">|</code>) and can only be used within <strong>Liquid variables</strong> after the variable string. For example: the <code class="highlighter-rouge">relative_url</code> filter in <code class="highlighter-rouge">{{ "css/main.css" | relative_url }}</code>.</li>
|
|
177
195
|
</ul>
|
|
178
196
|
</li>
|
|
179
197
|
<li>
|
|
180
198
|
<p><strong>Markdown</strong>. Jekyll converts Markdown to HTML using the Markdown filter specified in your config file. Files must have a Markdown file extension and front matter in order for Jekyll to convert them.</p>
|
|
181
199
|
</li>
|
|
182
200
|
<li>
|
|
183
|
-
<p><strong>Layout</strong>. Jekyll pushes content into the layouts specified by the page’s front matter (or as specified in the config file). The content from each page gets pushed into the <code class="
|
|
201
|
+
<p><strong>Layout</strong>. Jekyll pushes content into the layouts specified by the page’s front matter (or as specified in the config file). The content from each page gets pushed into the <code class="highlighter-rouge">{{ content }}</code> tags within the layouts.</p>
|
|
184
202
|
</li>
|
|
185
|
-
<li><strong>Files</strong>. Jekyll writes the generated content into files in the <a href="/docs/structure/">directory structure</a> in <code class="
|
|
203
|
+
<li><strong>Files</strong>. Jekyll writes the generated content into files in the <a href="/docs/structure/">directory structure</a> in <code class="highlighter-rouge">_site</code>. Pages, posts, and collections get structured based on their <a href="/docs/permalinks/">permalink</a> setting. Directories that begin with <code class="highlighter-rouge">_</code> (such as <code class="highlighter-rouge">_includes</code> and <code class="highlighter-rouge">_data</code>) are usually hidden in the output.</li>
|
|
186
204
|
</ol>
|
|
187
205
|
|
|
188
206
|
<h2 id="scenarios-where-incorrect-configurations-create-problems">Scenarios where incorrect configurations create problems</h2>
|
|
@@ -193,7 +211,7 @@
|
|
|
193
211
|
|
|
194
212
|
<h3 id="variable-on-page-not-rendered-because-variable-is-assigned-in-layout">Variable on page not rendered because variable is assigned in layout</h3>
|
|
195
213
|
|
|
196
|
-
<p>In your layout file (<code class="
|
|
214
|
+
<p>In your layout file (<code class="highlighter-rouge">_layouts/default.html</code>), suppose you have a variable assigned:</p>
|
|
197
215
|
|
|
198
216
|
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">assign</span><span class="w"> </span><span class="nv">myvar</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"joe"</span><span class="w"> </span><span class="p">%}</span>
|
|
199
217
|
</code></pre></div></div>
|
|
@@ -209,7 +227,7 @@
|
|
|
209
227
|
|
|
210
228
|
<h3 id="markdown-in-include-file-not-processed">Markdown in include file not processed</h3>
|
|
211
229
|
|
|
212
|
-
<p>Suppose you have a Markdown file at <code class="
|
|
230
|
+
<p>Suppose you have a Markdown file at <code class="highlighter-rouge">_includes/mycontent.md</code>. In the Markdown file, you have some Markdown formatting:</p>
|
|
213
231
|
|
|
214
232
|
<div class="language-markdown highlighter-rouge"><div class="highlight"><pre class="highlight"><code>This is a list:
|
|
215
233
|
<span class="p">*</span> first item
|
|
@@ -218,27 +236,27 @@
|
|
|
218
236
|
|
|
219
237
|
<p>You include the file into an HTML file as follows:</p>
|
|
220
238
|
|
|
221
|
-
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span>mycontent
|
|
239
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="nv">mycontent</span><span class="p">.</span><span class="nv">md</span><span class="w"> </span><span class="p">%}</span>
|
|
222
240
|
</code></pre></div></div>
|
|
223
241
|
|
|
224
|
-
<p>The Markdown is not processed because first the Liquid (<code class="
|
|
242
|
+
<p>The Markdown is not processed because first the Liquid (<code class="highlighter-rouge">include</code> tag) gets processed, inserting <code class="highlighter-rouge">mycontent.md</code> into the HTML file. <em>Then</em> the Markdown would get processed.</p>
|
|
225
243
|
|
|
226
244
|
<p>But because the content is included into an <em>HTML</em> page, the Markdown isn’t rendered. The Markdown filter processes content only in Markdown files.</p>
|
|
227
245
|
|
|
228
246
|
<p>To make the code work, use HTML formatting in includes that are inserted into HTML files.</p>
|
|
229
247
|
|
|
230
|
-
<p>Note that <code class="
|
|
248
|
+
<p>Note that <code class="highlighter-rouge">highlight</code> tags don’t require Markdown to process. Suppose your include contains the following:</p>
|
|
231
249
|
|
|
232
250
|
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">highlight</span><span class="w"> </span>javascript<span class="w"> </span><span class="p">%}</span>
|
|
233
251
|
console.log('alert');
|
|
234
252
|
<span class="p">{%</span><span class="w"> </span><span class="nt">endhighlight</span><span class="w"> </span><span class="p">%}</span>
|
|
235
253
|
</code></pre></div></div>
|
|
236
254
|
|
|
237
|
-
<p>The <code class="
|
|
255
|
+
<p>The <code class="highlighter-rouge">highlight</code> tag <em>is</em> Liquid. (Liquid passes the content to Rouge for syntax highlighting.) As a result, this code will actually convert to HTML with syntax highlighting. Jekyll does not need the Markdown filter to process <code class="highlighter-rouge">highlight</code> tags.</p>
|
|
238
256
|
|
|
239
257
|
<h3 id="liquid-mixed-with-javascript-isnt-rendered">Liquid mixed with JavaScript isn’t rendered</h3>
|
|
240
258
|
|
|
241
|
-
<p>Suppose you try to mix Liquid’s <code class="
|
|
259
|
+
<p>Suppose you try to mix Liquid’s <code class="highlighter-rouge">assign</code> tag with JavaScript, like this:</p>
|
|
242
260
|
|
|
243
261
|
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o"><</span><span class="nx">button</span> <span class="nx">onclick</span><span class="o">=</span><span class="dl">"</span><span class="s2">someFunction()</span><span class="dl">"</span><span class="o">></span><span class="nx">Click</span> <span class="nx">me</span><span class="o"><</span><span class="sr">/button</span><span class="err">>
|
|
244
262
|
</span>
|
|
@@ -252,9 +270,9 @@ console.log('alert');
|
|
|
252
270
|
<span class="o"><</span><span class="sr">/script</span><span class="err">>
|
|
253
271
|
</span></code></pre></div></div>
|
|
254
272
|
|
|
255
|
-
<p>This won’t work because the <code class="
|
|
273
|
+
<p>This won’t work because the <code class="highlighter-rouge">assign</code> tag is only available during the Liquid rendering phase of the site. In this JavaScript example, the script executes when a user clicks a button (“Click me”) on the HTML page. At that time, the Liquid logic is no longer available, so the <code class="highlighter-rouge">assign</code> tag wouldn’t return anything.</p>
|
|
256
274
|
|
|
257
|
-
<p>However, you can use Jekyll’s site variables or Liquid to <em>populate</em> a script that is executed at a later time. For example, suppose you have the following property in your front matter: <code class="
|
|
275
|
+
<p>However, you can use Jekyll’s site variables or Liquid to <em>populate</em> a script that is executed at a later time. For example, suppose you have the following property in your front matter: <code class="highlighter-rouge">someContent: "This is some content"</code>. You could do this:</p>
|
|
258
276
|
|
|
259
277
|
<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o"><</span><span class="nx">button</span> <span class="nx">onclick</span><span class="o">=</span><span class="dl">"</span><span class="s2">someFunction()</span><span class="dl">"</span><span class="o">></span><span class="nx">Click</span> <span class="nx">me</span><span class="o"><</span><span class="sr">/button</span><span class="err">>
|
|
260
278
|
</span>
|
|
@@ -268,7 +286,7 @@ console.log('alert');
|
|
|
268
286
|
<span class="o"><</span><span class="sr">/script</span><span class="err">>
|
|
269
287
|
</span></code></pre></div></div>
|
|
270
288
|
|
|
271
|
-
<p>When Jekyll builds the site, this <code class="
|
|
289
|
+
<p>When Jekyll builds the site, this <code class="highlighter-rouge">someContent</code> property populates the script’s values, converting <code class="highlighter-rouge">{{ page.someContent }}</code> to <code class="highlighter-rouge">"This is some content"</code>.</p>
|
|
272
290
|
|
|
273
291
|
<p>The key to remember is that Liquid renders when Jekyll builds your site. Liquid is not available at run-time in the browser when a user executes an event.</p>
|
|
274
292
|
|
|
@@ -276,7 +294,7 @@ console.log('alert');
|
|
|
276
294
|
|
|
277
295
|
<p>There’s one more detail to remember: Liquid does not render when embedded in YAML files or front matter. (This isn’t related to order of interpretation, but it’s worth mentioning because it’s a common question about element rendering.)</p>
|
|
278
296
|
|
|
279
|
-
<p>For example, suppose you have a <code class="
|
|
297
|
+
<p>For example, suppose you have a <code class="highlighter-rouge">highlight</code> tag in your <code class="highlighter-rouge">_data/mydata.yml</code> file:</p>
|
|
280
298
|
|
|
281
299
|
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>myvalue: >
|
|
282
300
|
<span class="p">{%</span><span class="w"> </span><span class="nt">highlight</span><span class="w"> </span>javascript<span class="w"> </span><span class="p">%}</span>
|
|
@@ -338,15 +356,15 @@ console.log('alert');
|
|
|
338
356
|
|
|
339
357
|
|
|
340
358
|
|
|
341
|
-
<li
|
|
359
|
+
<li><a href="/tutorials/home/">Tutorials</a></li>
|
|
342
360
|
|
|
343
361
|
|
|
344
362
|
|
|
345
|
-
<li
|
|
363
|
+
<li><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
346
364
|
|
|
347
365
|
|
|
348
366
|
|
|
349
|
-
<li
|
|
367
|
+
<li><a href="/tutorials/navigation/">Navigation</a></li>
|
|
350
368
|
|
|
351
369
|
|
|
352
370
|
|
|
@@ -354,15 +372,15 @@ console.log('alert');
|
|
|
354
372
|
|
|
355
373
|
|
|
356
374
|
|
|
357
|
-
<li
|
|
375
|
+
<li><a href="/tutorials/custom-404-page/">Custom 404 Page</a></li>
|
|
358
376
|
|
|
359
377
|
|
|
360
378
|
|
|
361
|
-
<li
|
|
379
|
+
<li><a href="/tutorials/convert-site-to-jekyll/">Convert an HTML site to Jekyll</a></li>
|
|
362
380
|
|
|
363
381
|
|
|
364
382
|
|
|
365
|
-
<li
|
|
383
|
+
<li><a href="/tutorials/using-jekyll-with-bundler/">Using Jekyll with Bundler</a></li>
|
|
366
384
|
|
|
367
385
|
</ul>
|
|
368
386
|
|
|
@@ -381,7 +399,8 @@ console.log('alert');
|
|
|
381
399
|
<footer>
|
|
382
400
|
<div class="grid">
|
|
383
401
|
<div class="unit one-third center-on-mobiles">
|
|
384
|
-
<p>
|
|
402
|
+
<p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
|
|
403
|
+
<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>
|
|
385
404
|
</div>
|
|
386
405
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
387
406
|
<p>
|
|
@@ -391,6 +410,14 @@ console.log('alert');
|
|
|
391
410
|
</a>
|
|
392
411
|
</p>
|
|
393
412
|
</div>
|
|
413
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
|
414
|
+
<p>
|
|
415
|
+
Jekyll is funded thanks to its
|
|
416
|
+
<a href="https://github.com/jekyll/jekyll#sponsors">
|
|
417
|
+
sponsors!
|
|
418
|
+
</a>
|
|
419
|
+
</p>
|
|
420
|
+
</div>
|
|
394
421
|
</div>
|
|
395
422
|
</footer>
|
|
396
423
|
|
|
@@ -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>Using Jekyll with Bundler | 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="Using Jekyll with Bundler" />
|
|
18
19
|
<meta property="og:locale" content="en_US" />
|
|
19
20
|
<meta name="description" content="Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed." />
|
|
@@ -21,14 +22,16 @@
|
|
|
21
22
|
<link rel="canonical" href="https://jekyllrb.com/tutorials/using-jekyll-with-bundler/" />
|
|
22
23
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/using-jekyll-with-bundler/" />
|
|
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="Using Jekyll with Bundler" />
|
|
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":"Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/using-jekyll-with-bundler/"},"headline":"Using Jekyll with Bundler","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/tutorials/using-jekyll-with-bundler/","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>
|
|
57
|
-
|
|
58
|
-
|
|
61
|
+
|
|
62
|
+
<li>
|
|
63
|
+
<a href="/docs/">Docs</a>
|
|
64
|
+
</li>
|
|
65
|
+
|
|
66
|
+
<li>
|
|
67
|
+
<a href="/resources/">Resources</a>
|
|
59
68
|
</li>
|
|
60
|
-
|
|
61
|
-
|
|
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>
|
|
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>
|
|
@@ -176,7 +194,7 @@ installed. You can find the installation instructions on their websites.</p>
|
|
|
176
194
|
<h2 id="initialize-bundler">Initialize Bundler</h2>
|
|
177
195
|
|
|
178
196
|
<p>The first thing to do is create a new directory for your project and run
|
|
179
|
-
<code class="
|
|
197
|
+
<code class="highlighter-rouge">bundle init</code>. This creates a new Bundler project (by creating an empty
|
|
180
198
|
Gemfile).</p>
|
|
181
199
|
|
|
182
200
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">mkdir </span>my-jekyll-website
|
|
@@ -187,7 +205,7 @@ bundle init
|
|
|
187
205
|
<h2 id="configure-bundler">Configure Bundler</h2>
|
|
188
206
|
|
|
189
207
|
<p>This step is optional, but encouraged. We’re going to configure Bundler to install
|
|
190
|
-
gems in the <code class="
|
|
208
|
+
gems in the <code class="highlighter-rouge">./vendor/bundle/</code> project subdirectory. This allows us to install
|
|
191
209
|
our dependencies in an isolated environment, ensuring they don’t conflict with
|
|
192
210
|
other gems on your system. If you skip this step, Bundler will install your
|
|
193
211
|
dependencies globally on your system.</p>
|
|
@@ -208,7 +226,7 @@ dependencies globally on your system.</p>
|
|
|
208
226
|
|
|
209
227
|
<p>Now, we’re going to use Bundler to add Jekyll as a dependency of our new
|
|
210
228
|
project. This command will add the Jekyll gem to our Gemfile and install it to
|
|
211
|
-
the <code class="
|
|
229
|
+
the <code class="highlighter-rouge">./vendor/bundle/</code> folder.</p>
|
|
212
230
|
|
|
213
231
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle add jekyll
|
|
214
232
|
</code></pre></div></div>
|
|
@@ -216,8 +234,8 @@ the <code class="language-plaintext highlighter-rouge">./vendor/bundle/</code> f
|
|
|
216
234
|
<h2 id="create-a-jekyll-scaffold">Create A Jekyll Scaffold</h2>
|
|
217
235
|
|
|
218
236
|
<p>Now that Jekyll is installed, we can use it to create the scaffolding for our
|
|
219
|
-
site. We need the <code class="
|
|
220
|
-
already has some Bundler files in it. We run the <code class="
|
|
237
|
+
site. We need the <code class="highlighter-rouge">--force</code> parameter because our folder isn’t empty - it
|
|
238
|
+
already has some Bundler files in it. We run the <code class="highlighter-rouge">bundle install</code> separately
|
|
221
239
|
because Jekyll gets confused if the Gemfile already exists.</p>
|
|
222
240
|
|
|
223
241
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>jekyll new <span class="nt">--force</span> <span class="nt">--skip-bundle</span> <span class="nb">.</span>
|
|
@@ -227,29 +245,31 @@ bundle <span class="nb">install</span>
|
|
|
227
245
|
<h2 id="serve-the-site">Serve the Site</h2>
|
|
228
246
|
|
|
229
247
|
<p>Your new website is ready! You can serve the website with
|
|
230
|
-
<code class="
|
|
248
|
+
<code class="highlighter-rouge">bundle exec jekyll serve</code> and visit it at
|
|
231
249
|
<a href="http://127.0.0.1:4000">http://127.0.0.1:4000</a>. From here, you’re ready to
|
|
232
250
|
continue developing the site on your own. All of the normal Jekyll commands are
|
|
233
|
-
available to you, but you should prefix them with <code class="
|
|
251
|
+
available to you, but you should prefix them with <code class="highlighter-rouge">bundle exec</code> so that Bundler
|
|
234
252
|
runs the version of Jekyll that is installed in your project folder.</p>
|
|
235
253
|
|
|
236
254
|
<h2 id="commit-to-source-control">Commit to Source Control</h2>
|
|
237
255
|
|
|
238
256
|
<p>If you’re storing your new site in version control, you’ll want to ignore the
|
|
239
|
-
<code class="
|
|
257
|
+
<code class="highlighter-rouge">./vendor/</code> and <code class="highlighter-rouge">./.bundle/</code> folders since they contain user- or
|
|
240
258
|
platform-specific information. New users will be able to install the correct
|
|
241
|
-
dependencies based on <code class="
|
|
242
|
-
in. You can use this <code class="
|
|
259
|
+
dependencies based on <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code>, which should both be checked
|
|
260
|
+
in. You can use this <code class="highlighter-rouge">.gitignore</code> to get started, if you want.</p>
|
|
243
261
|
|
|
244
262
|
<p><strong>.gitignore</strong></p>
|
|
245
263
|
|
|
246
|
-
<div class="
|
|
247
|
-
|
|
248
|
-
.
|
|
264
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code># Ignore metadata generated by Jekyll
|
|
265
|
+
_site/
|
|
266
|
+
.sass-cache/
|
|
267
|
+
.jekyll-cache/
|
|
268
|
+
.jekyll-metadata
|
|
249
269
|
|
|
250
|
-
# Ignore folders generated by
|
|
251
|
-
.
|
|
252
|
-
|
|
270
|
+
# Ignore folders generated by Bundler
|
|
271
|
+
.bundle/
|
|
272
|
+
vendor/
|
|
253
273
|
</code></pre></div></div>
|
|
254
274
|
|
|
255
275
|
|
|
@@ -307,27 +327,27 @@ _site
|
|
|
307
327
|
|
|
308
328
|
|
|
309
329
|
|
|
310
|
-
<li
|
|
330
|
+
<li><a href="/tutorials/home/">Tutorials</a></li>
|
|
311
331
|
|
|
312
332
|
|
|
313
333
|
|
|
314
|
-
<li
|
|
334
|
+
<li><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
315
335
|
|
|
316
336
|
|
|
317
337
|
|
|
318
|
-
<li
|
|
338
|
+
<li><a href="/tutorials/navigation/">Navigation</a></li>
|
|
319
339
|
|
|
320
340
|
|
|
321
341
|
|
|
322
|
-
<li
|
|
342
|
+
<li><a href="/tutorials/orderofinterpretation/">Order of interpretation</a></li>
|
|
323
343
|
|
|
324
344
|
|
|
325
345
|
|
|
326
|
-
<li
|
|
346
|
+
<li><a href="/tutorials/custom-404-page/">Custom 404 Page</a></li>
|
|
327
347
|
|
|
328
348
|
|
|
329
349
|
|
|
330
|
-
<li
|
|
350
|
+
<li><a href="/tutorials/convert-site-to-jekyll/">Convert an HTML site to Jekyll</a></li>
|
|
331
351
|
|
|
332
352
|
|
|
333
353
|
|
|
@@ -350,7 +370,8 @@ _site
|
|
|
350
370
|
<footer>
|
|
351
371
|
<div class="grid">
|
|
352
372
|
<div class="unit one-third center-on-mobiles">
|
|
353
|
-
<p>
|
|
373
|
+
<p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
|
|
374
|
+
<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>
|
|
354
375
|
</div>
|
|
355
376
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
356
377
|
<p>
|
|
@@ -360,6 +381,14 @@ _site
|
|
|
360
381
|
</a>
|
|
361
382
|
</p>
|
|
362
383
|
</div>
|
|
384
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
|
385
|
+
<p>
|
|
386
|
+
Jekyll is funded thanks to its
|
|
387
|
+
<a href="https://github.com/jekyll/jekyll#sponsors">
|
|
388
|
+
sponsors!
|
|
389
|
+
</a>
|
|
390
|
+
</p>
|
|
391
|
+
</div>
|
|
363
392
|
</div>
|
|
364
393
|
</footer>
|
|
365
394
|
|