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>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
|
|