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>Contributing | 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="Contributing" />
|
18
19
|
<meta property="og:locale" content="en_US" />
|
19
20
|
<meta name="description" content="Hi there! Interested in contributing to Jekyll? We’d love your help. Jekyll is an open source project, built one contribution at a time by users like you." />
|
@@ -21,14 +22,16 @@
|
|
21
22
|
<link rel="canonical" href="https://jekyllrb.com/docs/contributing/" />
|
22
23
|
<meta property="og:url" content="https://jekyllrb.com/docs/contributing/" />
|
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="Contributing" />
|
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":"Hi there! Interested in contributing to Jekyll? We’d love your help. Jekyll is an open source project, built one contribution at a time by users like you.","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/contributing/"},"headline":"Contributing","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/contributing/","datePublished":"2019-09-11T07:30:27-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@context":"https://schema.org"}</script>
|
32
35
|
<!-- End Jekyll SEO tag -->
|
33
36
|
|
34
37
|
<!--[if lt IE 9]>
|
@@ -51,18 +54,27 @@
|
|
51
54
|
</div>
|
52
55
|
<nav class="main-nav hide-on-mobiles">
|
53
56
|
<ul>
|
54
|
-
|
57
|
+
|
58
|
+
<li>
|
55
59
|
<a href="/">Home</a>
|
56
60
|
</li>
|
61
|
+
|
57
62
|
<li class="current">
|
58
|
-
<a href="/docs/
|
63
|
+
<a href="/docs/">Docs</a>
|
59
64
|
</li>
|
60
|
-
|
61
|
-
|
65
|
+
|
66
|
+
<li>
|
67
|
+
<a href="/resources/">Resources</a>
|
62
68
|
</li>
|
63
|
-
|
64
|
-
|
69
|
+
|
70
|
+
<li>
|
71
|
+
<a href="/showcase/">Showcase</a>
|
65
72
|
</li>
|
73
|
+
|
74
|
+
<li>
|
75
|
+
<a href="/news/">News</a>
|
76
|
+
</li>
|
77
|
+
|
66
78
|
</ul>
|
67
79
|
|
68
80
|
</nav>
|
@@ -73,7 +85,7 @@
|
|
73
85
|
<div class="meta hide-on-mobiles">
|
74
86
|
<ul>
|
75
87
|
<li>
|
76
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/
|
88
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
|
77
89
|
</li>
|
78
90
|
<li>
|
79
91
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
@@ -83,18 +95,24 @@
|
|
83
95
|
</div>
|
84
96
|
<nav class="mobile-nav show-on-mobiles">
|
85
97
|
<ul>
|
86
|
-
|
87
|
-
<
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
+
|
99
|
+
<li>
|
100
|
+
<a href="/">Home</a>
|
101
|
+
</li>
|
102
|
+
|
103
|
+
<li class="current">
|
104
|
+
<a href="/docs/">Docs</a>
|
105
|
+
</li>
|
106
|
+
|
107
|
+
<li>
|
108
|
+
<a href="/resources/">Resources</a>
|
109
|
+
</li>
|
110
|
+
|
111
|
+
|
112
|
+
<li>
|
113
|
+
<a href="/news/">News</a>
|
114
|
+
</li>
|
115
|
+
|
98
116
|
<li>
|
99
117
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
100
118
|
</li>
|
@@ -113,176 +131,152 @@
|
|
113
131
|
|
114
132
|
<optgroup label="Getting Started">
|
115
133
|
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
|
141
|
-
|
142
|
-
<option value="/docs/configuration/">Configuration</option>
|
143
|
-
|
144
|
-
|
145
|
-
</optgroup>
|
146
|
-
|
147
|
-
<optgroup label="Your Content">
|
134
|
+
|
135
|
+
<option value="/docs/">
|
136
|
+
Quickstart
|
137
|
+
</option>
|
138
|
+
|
139
|
+
|
140
|
+
<option value="/docs/ruby-101/">
|
141
|
+
Ruby 101
|
142
|
+
</option>
|
143
|
+
|
144
|
+
|
145
|
+
<option value="/docs/installation/">
|
146
|
+
Installation
|
147
|
+
</option>
|
148
|
+
|
149
|
+
|
150
|
+
<option value="/docs/community/">
|
151
|
+
Community
|
152
|
+
</option>
|
153
|
+
|
154
|
+
|
155
|
+
<option value="/docs/step-by-step/01-setup/">
|
156
|
+
Step by Step Tutorial
|
157
|
+
</option>
|
148
158
|
|
149
|
-
|
150
|
-
|
151
|
-
<option value="/docs/frontmatter/">Front Matter</option>
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
<option value="/docs/posts/">Writing posts</option>
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
<option value="/docs/drafts/">Working with drafts</option>
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
<option value="/docs/pages/">Creating pages</option>
|
164
|
-
|
165
|
-
|
166
|
-
|
167
|
-
<option value="/docs/static-files/">Static Files</option>
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
<option value="/docs/variables/">Variables</option>
|
172
|
-
|
173
|
-
|
174
|
-
|
175
|
-
<option value="/docs/collections/">Collections</option>
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
<option value="/docs/datafiles/">Data Files</option>
|
180
|
-
|
181
|
-
|
182
|
-
|
183
|
-
<option value="/docs/assets/">Assets</option>
|
184
|
-
|
185
|
-
|
186
|
-
|
187
|
-
<option value="/docs/migrations/">Blog migrations</option>
|
188
|
-
|
189
|
-
|
190
159
|
</optgroup>
|
191
160
|
|
192
|
-
<optgroup label="
|
161
|
+
<optgroup label="Build">
|
162
|
+
|
163
|
+
|
164
|
+
<option value="/docs/usage/">
|
165
|
+
Command Line Usage
|
166
|
+
</option>
|
167
|
+
|
168
|
+
|
169
|
+
<option value="/docs/configuration/">
|
170
|
+
Configuration
|
171
|
+
</option>
|
193
172
|
|
194
|
-
|
195
|
-
|
196
|
-
<option value="/docs/templates/">Templates</option>
|
197
|
-
|
198
|
-
|
199
|
-
|
200
|
-
<option value="/docs/includes/">Includes</option>
|
201
|
-
|
202
|
-
|
203
|
-
|
204
|
-
<option value="/docs/permalinks/">Permalinks</option>
|
205
|
-
|
206
|
-
|
207
|
-
|
208
|
-
<option value="/docs/pagination/">Pagination</option>
|
209
|
-
|
210
|
-
|
211
|
-
|
212
|
-
<option value="/docs/plugins/">Plugins</option>
|
213
|
-
|
214
|
-
|
215
|
-
|
216
|
-
<option value="/docs/themes/">Themes</option>
|
217
|
-
|
218
|
-
|
219
|
-
|
220
|
-
<option value="/docs/extras/">Extras</option>
|
221
|
-
|
222
|
-
|
223
173
|
</optgroup>
|
224
174
|
|
225
|
-
<optgroup label="
|
175
|
+
<optgroup label="Content">
|
176
|
+
|
177
|
+
|
178
|
+
<option value="/docs/pages/">
|
179
|
+
Pages
|
180
|
+
</option>
|
181
|
+
|
182
|
+
|
183
|
+
<option value="/docs/posts/">
|
184
|
+
Posts
|
185
|
+
</option>
|
186
|
+
|
187
|
+
|
188
|
+
<option value="/docs/front-matter/">
|
189
|
+
Front Matter
|
190
|
+
</option>
|
191
|
+
|
192
|
+
|
193
|
+
<option value="/docs/collections/">
|
194
|
+
Collections
|
195
|
+
</option>
|
196
|
+
|
197
|
+
|
198
|
+
<option value="/docs/datafiles/">
|
199
|
+
Data Files
|
200
|
+
</option>
|
201
|
+
|
202
|
+
|
203
|
+
<option value="/docs/assets/">
|
204
|
+
Assets
|
205
|
+
</option>
|
206
|
+
|
207
|
+
|
208
|
+
<option value="/docs/static-files/">
|
209
|
+
Static Files
|
210
|
+
</option>
|
226
211
|
|
227
|
-
|
228
|
-
|
229
|
-
<option value="/docs/github-pages/">GitHub Pages</option>
|
230
|
-
|
231
|
-
|
232
|
-
|
233
|
-
<option value="/docs/deployment-methods/">Deployment methods</option>
|
234
|
-
|
235
|
-
|
236
|
-
|
237
|
-
<option value="/docs/continuous-integration/">Continuous Integration</option>
|
238
|
-
|
239
|
-
|
240
212
|
</optgroup>
|
241
213
|
|
242
|
-
<optgroup label="
|
214
|
+
<optgroup label="Site Structure">
|
215
|
+
|
216
|
+
|
217
|
+
<option value="/docs/structure/">
|
218
|
+
Directory Structure
|
219
|
+
</option>
|
220
|
+
|
221
|
+
|
222
|
+
<option value="/docs/liquid/">
|
223
|
+
Liquid
|
224
|
+
</option>
|
225
|
+
|
226
|
+
|
227
|
+
<option value="/docs/variables/">
|
228
|
+
Variables
|
229
|
+
</option>
|
230
|
+
|
231
|
+
|
232
|
+
<option value="/docs/includes/">
|
233
|
+
Includes
|
234
|
+
</option>
|
235
|
+
|
236
|
+
|
237
|
+
<option value="/docs/layouts/">
|
238
|
+
Layouts
|
239
|
+
</option>
|
240
|
+
|
241
|
+
|
242
|
+
<option value="/docs/permalinks/">
|
243
|
+
Permalinks
|
244
|
+
</option>
|
245
|
+
|
246
|
+
|
247
|
+
<option value="/docs/themes/">
|
248
|
+
Themes
|
249
|
+
</option>
|
250
|
+
|
251
|
+
|
252
|
+
<option value="/docs/pagination/">
|
253
|
+
Pagination
|
254
|
+
</option>
|
243
255
|
|
244
|
-
|
245
|
-
|
246
|
-
<option value="/docs/troubleshooting/">Troubleshooting</option>
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
<option value="/docs/sites/">Sites using Jekyll</option>
|
251
|
-
|
252
|
-
|
253
|
-
|
254
|
-
<option value="/docs/resources/">Resources</option>
|
255
|
-
|
256
|
-
|
257
|
-
|
258
|
-
<option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
|
259
|
-
|
260
|
-
|
261
|
-
|
262
|
-
<option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
|
263
|
-
|
264
|
-
|
265
256
|
</optgroup>
|
266
257
|
|
267
|
-
<optgroup label="
|
258
|
+
<optgroup label="Guides">
|
259
|
+
|
260
|
+
|
261
|
+
<option value="/docs/plugins/">
|
262
|
+
Plugins
|
263
|
+
</option>
|
264
|
+
|
265
|
+
|
266
|
+
<option value="/docs/migrations/">
|
267
|
+
Blog Migrations
|
268
|
+
</option>
|
269
|
+
|
270
|
+
|
271
|
+
<option value="/docs/upgrading/">
|
272
|
+
Upgrading
|
273
|
+
</option>
|
274
|
+
|
275
|
+
|
276
|
+
<option value="/docs/deployment/">
|
277
|
+
Deployment
|
278
|
+
</option>
|
268
279
|
|
269
|
-
|
270
|
-
|
271
|
-
<option value="/docs/contributing/">Contributing</option>
|
272
|
-
|
273
|
-
|
274
|
-
|
275
|
-
<option value="/docs/maintaining/">Maintaining Jekyll</option>
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
<option value="/docs/conduct/">Code of Conduct</option>
|
280
|
-
|
281
|
-
|
282
|
-
|
283
|
-
<option value="/docs/history/">History</option>
|
284
|
-
|
285
|
-
|
286
280
|
</optgroup>
|
287
281
|
|
288
282
|
</select>
|
@@ -292,14 +286,14 @@
|
|
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/contributing.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/contributing.md"><i class="fa fa-pencil"></i> Improve this page</a>
|
296
290
|
</div>
|
297
291
|
<h1>Contributing</h1>
|
298
292
|
<p>Hi there! Interested in contributing to Jekyll? We’d love your help. Jekyll is an open source project, built one contribution at a time by users like you.</p>
|
299
293
|
|
300
294
|
<h2 id="where-to-get-help-or-report-a-problem">Where to get help or report a problem</h2>
|
301
295
|
|
302
|
-
<p>See <a href="https://jekyllrb.com/docs/support/">
|
296
|
+
<p>See the <a href="https://jekyllrb.com/docs/support/">support guidelines</a></p>
|
303
297
|
|
304
298
|
<h2 id="ways-to-contribute">Ways to contribute</h2>
|
305
299
|
|
@@ -309,9 +303,9 @@
|
|
309
303
|
<li>
|
310
304
|
<a href="https://jekyllrb.com/docs/installation/">Install Jekyll on your computer</a> and kick the tires. Does it work? Does it do what you’d expect? If not, <a href="https://github.com/jekyll/jekyll/issues/new">open an issue</a> and let us know.</li>
|
311
305
|
<li>Comment on some of the project’s <a href="https://github.com/jekyll/jekyll/issues">open issues</a>. Have you experienced the same problem? Know a work around? Do you have a suggestion for how the feature could be better?</li>
|
312
|
-
<li>Read through <a href="https://jekyllrb.com/docs/home/">
|
313
|
-
<li>Browse through <a href="https://talk.jekyllrb.com/">
|
314
|
-
<li>Find <a href="https://github.com/jekyll/jekyll/issues">
|
306
|
+
<li>Read through the <a href="https://jekyllrb.com/docs/home/">documentation</a>, and click the “improve this page” button, any time you see something confusing, or have a suggestion for something that could be improved.</li>
|
307
|
+
<li>Browse through the <a href="https://talk.jekyllrb.com/">Jekyll discussion forum</a>, and lend a hand answering questions. There’s a good chance you’ve already experienced what another user is experiencing.</li>
|
308
|
+
<li>Find an <a href="https://github.com/jekyll/jekyll/issues">open issue</a> (especially <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aopen+is%3Aissue+label%3Ahelp-wanted">those labeled <code class="highlighter-rouge">help-wanted</code></a>), and submit a proposed fix. If it’s your first pull request, we promise we won’t bite, and are glad to answer any questions.</li>
|
315
309
|
<li>Help evaluate <a href="https://github.com/jekyll/jekyll/pulls">open pull requests</a>, by testing the changes locally and reviewing what’s proposed.</li>
|
316
310
|
</ul>
|
317
311
|
|
@@ -327,7 +321,7 @@
|
|
327
321
|
<p>The more information, the better. Make judicious use of the pull request body. Describe what changes were made, why you made them, and what impact they will have for users.</p>
|
328
322
|
</li>
|
329
323
|
<li>
|
330
|
-
<p>
|
324
|
+
<p>If this is your first pull request, it may help to <a href="https://guides.github.com/introduction/flow/">understand GitHub Flow</a>.</p>
|
331
325
|
</li>
|
332
326
|
<li>
|
333
327
|
<p>If you’re submitting a code contribution, be sure to read the <a href="#code-contributions">code contributions</a> section below.</p>
|
@@ -339,7 +333,7 @@
|
|
339
333
|
<p>Many small changes can be made entirely through the github.com web interface.</p>
|
340
334
|
|
341
335
|
<ol>
|
342
|
-
<li>Navigate to the file within <a href="https://github.com/jekyll/jekyll"><code class="
|
336
|
+
<li>Navigate to the file within <a href="https://github.com/jekyll/jekyll"><code class="highlighter-rouge">jekyll/jekyll</code></a> that you’d like to edit.</li>
|
343
337
|
<li>Click the pencil icon in the top right corner to edit the file</li>
|
344
338
|
<li>Make your proposed changes</li>
|
345
339
|
<li>Click “Propose file change”</li>
|
@@ -353,13 +347,13 @@
|
|
353
347
|
<h3 id="submitting-a-pull-request-via-git-command-line">Submitting a pull request via Git command line</h3>
|
354
348
|
|
355
349
|
<ol>
|
356
|
-
<li>Fork the project by clicking “Fork” in the top right corner of <a href="https://github.com/jekyll/jekyll"><code class="
|
357
|
-
<li>Clone the repository locally <code class="
|
358
|
-
<li>Create a new, descriptively named branch to contain your change ( <code class="
|
350
|
+
<li>Fork the project by clicking “Fork” in the top right corner of <a href="https://github.com/jekyll/jekyll"><code class="highlighter-rouge">jekyll/jekyll</code></a>.</li>
|
351
|
+
<li>Clone the repository locally <code class="highlighter-rouge">git clone https://github.com/<you-username>/jekyll</code>.</li>
|
352
|
+
<li>Create a new, descriptively named branch to contain your change ( <code class="highlighter-rouge">git checkout -b my-awesome-feature</code> ).</li>
|
359
353
|
<li>Hack away, add tests. Not necessarily in that order.</li>
|
360
|
-
<li>Make sure everything still passes by running <code class="
|
361
|
-
<li>Push the branch up ( <code class="
|
362
|
-
<li>Create a pull request by visiting <code class="
|
354
|
+
<li>Make sure everything still passes by running <code class="highlighter-rouge">script/cibuild</code> (see the <a href="#running-tests-locally">tests section</a> below)</li>
|
355
|
+
<li>Push the branch up ( <code class="highlighter-rouge">git push origin my-awesome-feature</code> ).</li>
|
356
|
+
<li>Create a pull request by visiting <code class="highlighter-rouge">https://github.com/<your-username>/jekyll</code> and following the instructions at the top of the screen.</li>
|
363
357
|
</ol>
|
364
358
|
|
365
359
|
<h2 id="proposing-updates-to-the-documentation">Proposing updates to the documentation</h2>
|
@@ -370,7 +364,7 @@
|
|
370
364
|
|
371
365
|
<p>You can find the documentation for jekyllrb.com in the <a href="https://github.com/jekyll/jekyll/tree/master/docs">docs</a> directory. See the section above, <a href="#submitting-a-pull-request">submitting a pull request</a> for information on how to propose a change.</p>
|
372
366
|
|
373
|
-
<p>One gotcha, all pull requests should be directed at the <code class="
|
367
|
+
<p>One gotcha, all pull requests should be directed at the <code class="highlighter-rouge">master</code> branch (the default branch).</p>
|
374
368
|
|
375
369
|
<h3 id="updating-fontawesome-iconset-for-jekyllrbcom">Updating FontAwesome iconset for jekyllrb.com</h3>
|
376
370
|
|
@@ -380,19 +374,19 @@
|
|
380
374
|
|
381
375
|
<ol>
|
382
376
|
<li>Go to <a href="https://icomoon.io/app/">https://icomoon.io/app/</a>.</li>
|
383
|
-
<li>Click <code class="
|
384
|
-
<li>Click <code class="
|
377
|
+
<li>Click <code class="highlighter-rouge">Import Icons</code> on the top-horizontal-bar and upload the existing <code class="highlighter-rouge"><jekyll>/docs/icomoon-selection.json</code>.</li>
|
378
|
+
<li>Click <code class="highlighter-rouge">Add Icons from Library..</code> further down on the page, and add ‘Font Awesome’.</li>
|
385
379
|
<li>Select the required icon(s) from the Library (make sure its the ‘FontAwesome’ library instead of ‘IcoMoon-Free’ library).</li>
|
386
|
-
<li>Click <code class="
|
387
|
-
<li>Inspect the included icons and proceed by clicking <code class="
|
380
|
+
<li>Click <code class="highlighter-rouge">Generate Font</code> on the bottom-horizontal-bar.</li>
|
381
|
+
<li>Inspect the included icons and proceed by clicking <code class="highlighter-rouge">Download</code>.</li>
|
388
382
|
<li>Extract the font files and adapt the CSS to the paths we use in Jekyll:
|
389
383
|
<ul>
|
390
|
-
<li>Copy the entire <code class="
|
391
|
-
<li>Copy the contents of <code class="
|
392
|
-
<li>Copy the entire <code class="
|
393
|
-
<code class="
|
394
|
-
<li>Fix paths in the <code class="
|
395
|
-
<code class="
|
384
|
+
<li>Copy the entire <code class="highlighter-rouge">fonts</code> directory over and overwrite existing ones at <code class="highlighter-rouge"><jekyll>/docs/</code>.</li>
|
385
|
+
<li>Copy the contents of <code class="highlighter-rouge">selection.json</code> and overwrite existing content inside <code class="highlighter-rouge"><jekyll>/docs/icomoon-selection.json</code>.</li>
|
386
|
+
<li>Copy the entire <code class="highlighter-rouge">@font-face {}</code> declaration and only the <strong>new-icon(s)’ css declarations</strong> further below, to update the
|
387
|
+
<code class="highlighter-rouge"><jekyll>/docs/_sass/_font-awesome.scss</code> sass partial.</li>
|
388
|
+
<li>Fix paths in the <code class="highlighter-rouge">@font-face {}</code> declaration by adding <code class="highlighter-rouge">../</code> before <code class="highlighter-rouge">fonts/FontAwesome.*</code> like so:
|
389
|
+
<code class="highlighter-rouge">('../fonts/Fontawesome.woff?9h6hxj')</code>.</li>
|
396
390
|
</ul>
|
397
391
|
</li>
|
398
392
|
</ol>
|
@@ -403,7 +397,7 @@
|
|
403
397
|
|
404
398
|
<h2 id="code-contributions">Code Contributions</h2>
|
405
399
|
|
406
|
-
<p>
|
400
|
+
<p>Interested in submitting a pull request? Awesome. Read on. There’s a few common gotchas that we’d love to help you avoid.</p>
|
407
401
|
|
408
402
|
<h3 id="tests-and-documentation">Tests and documentation</h3>
|
409
403
|
|
@@ -411,13 +405,13 @@
|
|
411
405
|
|
412
406
|
<h4 id="documentation">Documentation</h4>
|
413
407
|
|
414
|
-
<p>If your contribution changes any Jekyll behavior, make sure to update the documentation. Documentation lives in the <code class="
|
408
|
+
<p>If your contribution changes any Jekyll behavior, make sure to update the documentation. Documentation lives in the <code class="highlighter-rouge">docs/_docs</code> folder (spoiler alert: it’s a Jekyll site!). If the docs are missing information, please feel free to add it in. Great docs make a great project. Include changes to the documentation within your pull request, and once merged, <code class="highlighter-rouge">jekyllrb.com</code> will be updated.</p>
|
415
409
|
|
416
410
|
<h4 id="tests">Tests</h4>
|
417
411
|
|
418
412
|
<ul>
|
419
413
|
<li>
|
420
|
-
<p>If you’re creating a small fix or patch to an existing feature, a simple test is more than enough. You can usually copy/paste from an existing example in the <code class="
|
414
|
+
<p>If you’re creating a small fix or patch to an existing feature, a simple test is more than enough. You can usually copy/paste from an existing example in the <code class="highlighter-rouge">tests</code> folder, but if you need you can find out about our tests suites <a href="https://github.com/thoughtbot/shoulda/tree/master">Shoulda</a> and <a href="https://github.com/rspec/rspec-mocks">RSpec-Mocks</a>.</p>
|
421
415
|
</li>
|
422
416
|
<li>
|
423
417
|
<p>If it’s a brand new feature, create a new <a href="https://github.com/cucumber/cucumber/">Cucumber</a> feature, reusing existing steps where appropriate.</p>
|
@@ -428,16 +422,19 @@
|
|
428
422
|
|
429
423
|
<ul>
|
430
424
|
<li>
|
431
|
-
<p>Jekyll uses the <a href="https://github.com/bbatsov/rubocop">Rubocop</a> static analyzer to ensure that contributions follow the <a href="https://github.com/styleguide/ruby">GitHub Ruby Styleguide</a>. Please check your code using <code class="
|
425
|
+
<p>Jekyll uses the <a href="https://github.com/bbatsov/rubocop">Rubocop</a> static analyzer to ensure that contributions follow the <a href="https://github.com/styleguide/ruby">GitHub Ruby Styleguide</a>. Please check your code using <code class="highlighter-rouge">script/fmt</code> and resolve any errors before pushing your branch.</p>
|
432
426
|
</li>
|
433
427
|
<li>
|
434
428
|
<p>Don’t bump the Gem version in your pull request (if you don’t know what that means, you probably didn’t).</p>
|
435
429
|
</li>
|
436
430
|
<li>
|
437
|
-
<p>You can use the command <code class="
|
431
|
+
<p>You can use the command <code class="highlighter-rouge">script/console</code> to start a REPL to explore the result of
|
438
432
|
Jekyll’s methods. It also provides you with helpful methods to quickly create a
|
439
433
|
site or configuration. <a href="https://github.com/jekyll/jekyll/blob/master/script/console">Feel free to check it out!</a></p>
|
440
434
|
</li>
|
435
|
+
<li>
|
436
|
+
<p>Previously, we’ve used the WIP Probot app to help contributors determine whether their pull request is ready for review. Please use a <a href="https://help.github.com/en/articles/about-pull-requests#draft-pull-requests">draft pull request</a> instead. When you’re ready, <a href="https://help.github.com/en/articles/changing-the-stage-of-a-pull-request">mark the pull request as ready for review</a></p>
|
437
|
+
</li>
|
441
438
|
</ul>
|
442
439
|
|
443
440
|
<h2 id="running-tests-locally">Running tests locally</h2>
|
@@ -454,330 +451,235 @@ site or configuration. <a href="https://github.com/jekyll/jekyll/blob/master/scr
|
|
454
451
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>script/cibuild
|
455
452
|
</code></pre></div></div>
|
456
453
|
|
457
|
-
<p>If you are only updating a file in <code class="
|
454
|
+
<p>If you are only updating a file in <code class="highlighter-rouge">test/</code>, you can use the command:</p>
|
458
455
|
|
459
456
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>script/test <span class="nb">test</span>/blah_test.rb
|
460
457
|
</code></pre></div></div>
|
461
458
|
|
462
|
-
<p>If you are only updating a <code class="
|
459
|
+
<p>If you are only updating a <code class="highlighter-rouge">.feature</code> file, you can use the command:</p>
|
463
460
|
|
464
461
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>script/cucumber features/blah.feature
|
465
462
|
</code></pre></div></div>
|
466
463
|
|
467
|
-
<p>Both <code class="
|
464
|
+
<p>Both <code class="highlighter-rouge">script/test</code> and <code class="highlighter-rouge">script/cucumber</code> can be run without arguments to
|
468
465
|
run its entire respective suite.</p>
|
469
466
|
|
470
467
|
<h2 id="a-thank-you">A thank you</h2>
|
471
468
|
|
472
469
|
<p>Thanks! Hacking on Jekyll should be fun. If you find any of this hard to figure out, let us know so we can improve our process or documentation!</p>
|
473
470
|
|
474
|
-
|
475
|
-
|
476
|
-
|
477
|
-
|
478
|
-
|
479
|
-
|
480
|
-
|
481
|
-
|
482
|
-
|
483
|
-
|
484
|
-
|
485
|
-
|
486
|
-
|
487
|
-
|
488
|
-
|
489
|
-
|
490
|
-
|
491
|
-
|
492
|
-
|
493
|
-
|
494
|
-
|
495
|
-
|
496
|
-
|
497
|
-
|
498
|
-
|
499
|
-
|
500
|
-
|
501
|
-
|
502
|
-
|
503
|
-
|
504
|
-
|
505
|
-
|
506
|
-
|
507
|
-
|
508
|
-
|
509
|
-
|
510
|
-
|
511
|
-
|
512
|
-
|
513
|
-
|
514
|
-
|
515
|
-
|
516
|
-
|
517
|
-
|
518
|
-
|
519
|
-
|
520
|
-
|
521
|
-
|
522
|
-
|
523
|
-
|
524
|
-
|
525
|
-
|
526
|
-
|
527
|
-
|
528
|
-
|
529
|
-
|
530
|
-
|
531
|
-
|
532
|
-
|
533
|
-
|
534
|
-
|
535
|
-
|
536
|
-
|
537
|
-
|
538
|
-
|
539
|
-
|
540
|
-
|
541
|
-
|
542
|
-
|
543
|
-
|
544
|
-
|
545
|
-
|
546
|
-
|
547
|
-
|
548
|
-
|
549
|
-
|
550
|
-
|
551
|
-
|
552
|
-
|
553
|
-
|
554
|
-
|
555
|
-
|
556
|
-
|
557
|
-
|
558
|
-
|
559
|
-
|
560
|
-
|
561
|
-
|
562
|
-
|
563
|
-
|
564
|
-
|
565
|
-
|
566
|
-
|
567
|
-
|
568
|
-
|
569
|
-
|
570
|
-
|
571
|
-
|
572
|
-
|
573
|
-
|
574
|
-
|
575
|
-
|
576
|
-
|
577
|
-
|
578
|
-
<div class="section-nav">
|
579
|
-
<div class="left align-right">
|
580
|
-
|
581
|
-
|
582
|
-
|
583
|
-
<a href="/docs/upgrading/2-to-3/" class="prev">Back</a>
|
584
|
-
|
585
|
-
</div>
|
586
|
-
<div class="right align-left">
|
587
|
-
|
588
|
-
|
589
|
-
|
590
|
-
<a href="/docs/maintaining/" class="next">Next</a>
|
591
|
-
|
592
|
-
</div>
|
593
|
-
</div>
|
594
|
-
<div class="clear"></div>
|
595
|
-
|
596
471
|
</article>
|
597
472
|
</div>
|
598
473
|
|
599
474
|
<div class="unit one-fifth hide-on-mobiles">
|
600
475
|
<aside>
|
601
476
|
|
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
|
-
<li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
|
642
|
-
|
643
|
-
|
644
|
-
|
645
|
-
<li class=""><a href="/docs/posts/">Writing posts</a></li>
|
646
|
-
|
647
|
-
|
648
|
-
|
649
|
-
<li class=""><a href="/docs/drafts/">Working with drafts</a></li>
|
650
|
-
|
651
|
-
|
652
|
-
|
653
|
-
<li class=""><a href="/docs/pages/">Creating pages</a></li>
|
654
|
-
|
655
|
-
|
656
|
-
|
657
|
-
<li class=""><a href="/docs/static-files/">Static Files</a></li>
|
658
|
-
|
659
|
-
|
660
|
-
|
661
|
-
<li class=""><a href="/docs/variables/">Variables</a></li>
|
662
|
-
|
663
|
-
|
664
|
-
|
665
|
-
<li class=""><a href="/docs/collections/">Collections</a></li>
|
666
|
-
|
667
|
-
|
668
|
-
|
669
|
-
<li class=""><a href="/docs/datafiles/">Data Files</a></li>
|
670
|
-
|
671
|
-
|
672
|
-
|
673
|
-
<li class=""><a href="/docs/assets/">Assets</a></li>
|
674
|
-
|
675
|
-
|
676
|
-
|
677
|
-
<li class=""><a href="/docs/migrations/">Blog migrations</a></li>
|
678
|
-
|
679
|
-
</ul>
|
680
|
-
|
477
|
+
<h4>Getting Started</h4>
|
478
|
+
<ul>
|
479
|
+
|
480
|
+
|
481
|
+
<li>
|
482
|
+
<a href="/docs/">
|
483
|
+
Quickstart
|
484
|
+
</a>
|
485
|
+
</li>
|
486
|
+
|
487
|
+
|
488
|
+
<li>
|
489
|
+
<a href="/docs/ruby-101/">
|
490
|
+
Ruby 101
|
491
|
+
</a>
|
492
|
+
</li>
|
493
|
+
|
494
|
+
|
495
|
+
<li>
|
496
|
+
<a href="/docs/installation/">
|
497
|
+
Installation
|
498
|
+
</a>
|
499
|
+
</li>
|
500
|
+
|
501
|
+
|
502
|
+
<li>
|
503
|
+
<a href="/docs/community/">
|
504
|
+
Community
|
505
|
+
</a>
|
506
|
+
</li>
|
507
|
+
|
508
|
+
|
509
|
+
<li>
|
510
|
+
<a href="/docs/step-by-step/01-setup/">
|
511
|
+
Step by Step Tutorial
|
512
|
+
</a>
|
513
|
+
</li>
|
514
|
+
|
515
|
+
</ul>
|
681
516
|
|
682
|
-
|
683
|
-
|
684
|
-
|
685
|
-
|
686
|
-
|
687
|
-
|
688
|
-
|
689
|
-
|
690
|
-
|
691
|
-
|
692
|
-
|
693
|
-
|
694
|
-
|
695
|
-
|
696
|
-
|
697
|
-
|
698
|
-
|
699
|
-
|
700
|
-
|
701
|
-
|
702
|
-
|
703
|
-
<li class=""><a href="/docs/plugins/">Plugins</a></li>
|
704
|
-
|
705
|
-
|
706
|
-
|
707
|
-
<li class=""><a href="/docs/themes/">Themes</a></li>
|
708
|
-
|
709
|
-
|
710
|
-
|
711
|
-
<li class=""><a href="/docs/extras/">Extras</a></li>
|
712
|
-
|
713
|
-
</ul>
|
714
|
-
|
517
|
+
<h4>Build</h4>
|
518
|
+
<ul>
|
519
|
+
|
520
|
+
|
521
|
+
<li>
|
522
|
+
<a href="/docs/usage/">
|
523
|
+
Command Line Usage
|
524
|
+
</a>
|
525
|
+
</li>
|
526
|
+
|
527
|
+
|
528
|
+
<li>
|
529
|
+
<a href="/docs/configuration/">
|
530
|
+
Configuration
|
531
|
+
</a>
|
532
|
+
</li>
|
533
|
+
|
534
|
+
</ul>
|
715
535
|
|
716
|
-
|
717
|
-
|
718
|
-
|
719
|
-
|
720
|
-
|
721
|
-
|
722
|
-
|
723
|
-
|
724
|
-
|
725
|
-
|
726
|
-
|
727
|
-
|
728
|
-
|
729
|
-
|
730
|
-
|
731
|
-
</
|
732
|
-
|
536
|
+
<h4>Content</h4>
|
537
|
+
<ul>
|
538
|
+
|
539
|
+
|
540
|
+
<li>
|
541
|
+
<a href="/docs/pages/">
|
542
|
+
Pages
|
543
|
+
</a>
|
544
|
+
</li>
|
545
|
+
|
546
|
+
|
547
|
+
<li>
|
548
|
+
<a href="/docs/posts/">
|
549
|
+
Posts
|
550
|
+
</a>
|
551
|
+
</li>
|
552
|
+
|
553
|
+
|
554
|
+
<li>
|
555
|
+
<a href="/docs/front-matter/">
|
556
|
+
Front Matter
|
557
|
+
</a>
|
558
|
+
</li>
|
559
|
+
|
560
|
+
|
561
|
+
<li>
|
562
|
+
<a href="/docs/collections/">
|
563
|
+
Collections
|
564
|
+
</a>
|
565
|
+
</li>
|
566
|
+
|
567
|
+
|
568
|
+
<li>
|
569
|
+
<a href="/docs/datafiles/">
|
570
|
+
Data Files
|
571
|
+
</a>
|
572
|
+
</li>
|
573
|
+
|
574
|
+
|
575
|
+
<li>
|
576
|
+
<a href="/docs/assets/">
|
577
|
+
Assets
|
578
|
+
</a>
|
579
|
+
</li>
|
580
|
+
|
581
|
+
|
582
|
+
<li>
|
583
|
+
<a href="/docs/static-files/">
|
584
|
+
Static Files
|
585
|
+
</a>
|
586
|
+
</li>
|
587
|
+
|
588
|
+
</ul>
|
733
589
|
|
734
|
-
|
735
|
-
|
736
|
-
|
737
|
-
|
738
|
-
|
739
|
-
|
740
|
-
|
741
|
-
|
742
|
-
|
743
|
-
|
744
|
-
|
745
|
-
|
746
|
-
|
747
|
-
|
748
|
-
|
749
|
-
|
750
|
-
|
751
|
-
|
752
|
-
|
753
|
-
|
754
|
-
|
755
|
-
|
756
|
-
|
757
|
-
|
758
|
-
|
590
|
+
<h4>Site Structure</h4>
|
591
|
+
<ul>
|
592
|
+
|
593
|
+
|
594
|
+
<li>
|
595
|
+
<a href="/docs/structure/">
|
596
|
+
Directory Structure
|
597
|
+
</a>
|
598
|
+
</li>
|
599
|
+
|
600
|
+
|
601
|
+
<li>
|
602
|
+
<a href="/docs/liquid/">
|
603
|
+
Liquid
|
604
|
+
</a>
|
605
|
+
</li>
|
606
|
+
|
607
|
+
|
608
|
+
<li>
|
609
|
+
<a href="/docs/variables/">
|
610
|
+
Variables
|
611
|
+
</a>
|
612
|
+
</li>
|
613
|
+
|
614
|
+
|
615
|
+
<li>
|
616
|
+
<a href="/docs/includes/">
|
617
|
+
Includes
|
618
|
+
</a>
|
619
|
+
</li>
|
620
|
+
|
621
|
+
|
622
|
+
<li>
|
623
|
+
<a href="/docs/layouts/">
|
624
|
+
Layouts
|
625
|
+
</a>
|
626
|
+
</li>
|
627
|
+
|
628
|
+
|
629
|
+
<li>
|
630
|
+
<a href="/docs/permalinks/">
|
631
|
+
Permalinks
|
632
|
+
</a>
|
633
|
+
</li>
|
634
|
+
|
635
|
+
|
636
|
+
<li>
|
637
|
+
<a href="/docs/themes/">
|
638
|
+
Themes
|
639
|
+
</a>
|
640
|
+
</li>
|
641
|
+
|
642
|
+
|
643
|
+
<li>
|
644
|
+
<a href="/docs/pagination/">
|
645
|
+
Pagination
|
646
|
+
</a>
|
647
|
+
</li>
|
648
|
+
|
649
|
+
</ul>
|
759
650
|
|
760
|
-
|
761
|
-
|
762
|
-
|
763
|
-
|
764
|
-
|
765
|
-
|
766
|
-
|
767
|
-
|
768
|
-
|
769
|
-
|
770
|
-
|
771
|
-
|
772
|
-
|
773
|
-
|
774
|
-
|
775
|
-
|
776
|
-
|
777
|
-
|
778
|
-
|
779
|
-
|
780
|
-
|
651
|
+
<h4>Guides</h4>
|
652
|
+
<ul>
|
653
|
+
|
654
|
+
|
655
|
+
<li>
|
656
|
+
<a href="/docs/plugins/">
|
657
|
+
Plugins
|
658
|
+
</a>
|
659
|
+
</li>
|
660
|
+
|
661
|
+
|
662
|
+
<li>
|
663
|
+
<a href="/docs/migrations/">
|
664
|
+
Blog Migrations
|
665
|
+
</a>
|
666
|
+
</li>
|
667
|
+
|
668
|
+
|
669
|
+
<li>
|
670
|
+
<a href="/docs/upgrading/">
|
671
|
+
Upgrading
|
672
|
+
</a>
|
673
|
+
</li>
|
674
|
+
|
675
|
+
|
676
|
+
<li>
|
677
|
+
<a href="/docs/deployment/">
|
678
|
+
Deployment
|
679
|
+
</a>
|
680
|
+
</li>
|
681
|
+
|
682
|
+
</ul>
|
781
683
|
|
782
684
|
</aside>
|
783
685
|
</div>
|
@@ -792,7 +694,8 @@ run its entire respective suite.</p>
|
|
792
694
|
<footer>
|
793
695
|
<div class="grid">
|
794
696
|
<div class="unit one-third center-on-mobiles">
|
795
|
-
<p>
|
697
|
+
<p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
|
698
|
+
<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>
|
796
699
|
</div>
|
797
700
|
<div class="unit two-thirds align-right center-on-mobiles">
|
798
701
|
<p>
|
@@ -802,6 +705,14 @@ run its entire respective suite.</p>
|
|
802
705
|
</a>
|
803
706
|
</p>
|
804
707
|
</div>
|
708
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
709
|
+
<p>
|
710
|
+
Jekyll is funded thanks to its
|
711
|
+
<a href="https://github.com/jekyll/jekyll#sponsors">
|
712
|
+
sponsors!
|
713
|
+
</a>
|
714
|
+
</p>
|
715
|
+
</div>
|
805
716
|
</div>
|
806
717
|
</footer>
|
807
718
|
|