jekyll-docs 3.9.0 → 4.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/jekyll-docs.rb +3 -3
- data/site/404.html +10 -7
- data/site/css/screen.css +3 -1
- data/site/css/screen.css.map +28 -0
- data/site/docs/assets/index.html +412 -453
- data/site/docs/code_of_conduct/index.html +447 -501
- data/site/docs/collections/index.html +487 -674
- data/site/docs/community/bug/index.html +603 -0
- data/site/docs/community/index.html +635 -0
- data/site/docs/conduct/index.html +447 -515
- data/site/docs/configuration/default/index.html +682 -0
- data/site/docs/configuration/environments/index.html +641 -0
- data/site/docs/configuration/front-matter-defaults/index.html +738 -0
- data/site/docs/configuration/incremental-regeneration/index.html +631 -0
- data/site/docs/configuration/index.html +405 -1230
- data/site/docs/configuration/liquid/index.html +616 -0
- data/site/docs/configuration/markdown/index.html +766 -0
- data/site/docs/configuration/options/index.html +1011 -0
- data/site/docs/configuration/webrick/index.html +615 -0
- data/site/docs/continuous-integration/buddyworks/index.html +393 -479
- data/site/docs/continuous-integration/circleci/index.html +465 -481
- data/site/docs/continuous-integration/travis-ci/index.html +450 -507
- data/site/docs/contributing/index.html +425 -514
- data/site/docs/datafiles/index.html +411 -453
- data/site/docs/deployment-methods/index.html +9 -871
- data/site/docs/deployment/automated/index.html +663 -0
- data/site/docs/deployment/index.html +607 -0
- data/site/docs/deployment/manual/index.html +631 -0
- data/site/docs/deployment/third-party/index.html +639 -0
- data/site/docs/drafts/index.html +9 -634
- data/site/docs/extras/index.html +9 -687
- data/site/docs/front-matter/index.html +799 -0
- data/site/docs/frontmatter/index.html +9 -819
- data/site/docs/github-pages/index.html +407 -475
- data/site/docs/history/index.html +1370 -1154
- data/site/docs/home/index.html +9 -627
- data/site/docs/includes/index.html +425 -501
- data/site/docs/index.html +630 -9
- data/site/docs/installation/index.html +403 -540
- data/site/docs/installation/macos/index.html +716 -0
- data/site/docs/installation/other-linux/index.html +613 -0
- data/site/docs/installation/ubuntu/index.html +623 -0
- data/site/docs/installation/windows/index.html +733 -0
- data/site/docs/layouts/index.html +726 -0
- data/site/docs/liquid/filters/index.html +1169 -0
- data/site/docs/liquid/index.html +615 -0
- data/site/docs/liquid/tags/index.html +728 -0
- data/site/docs/maintaining/affinity-team-captain/index.html +395 -479
- data/site/docs/maintaining/avoiding-burnout/index.html +391 -475
- data/site/docs/maintaining/becoming-a-maintainer/index.html +391 -475
- data/site/docs/maintaining/index.html +391 -486
- data/site/docs/maintaining/merging-a-pull-request/index.html +406 -490
- data/site/docs/maintaining/releasing-a-new-version/index.html +409 -485
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +392 -476
- data/site/docs/maintaining/special-labels/index.html +397 -481
- data/site/docs/maintaining/triaging-an-issue/index.html +394 -478
- data/site/docs/markdown-101/index.html +601 -0
- data/site/docs/migrations/index.html +396 -440
- data/site/docs/pages/index.html +408 -482
- data/site/docs/pagination/index.html +450 -509
- data/site/docs/permalinks/index.html +552 -587
- data/site/docs/plugins/commands/index.html +656 -0
- data/site/docs/plugins/converters/index.html +685 -0
- data/site/docs/plugins/filters/index.html +624 -0
- data/site/docs/plugins/generators/index.html +697 -0
- data/site/docs/plugins/hooks/index.html +838 -0
- data/site/docs/plugins/index.html +415 -1565
- data/site/docs/plugins/installation/index.html +681 -0
- data/site/docs/plugins/tags/index.html +699 -0
- data/site/docs/plugins/your-first-plugin/index.html +741 -0
- data/site/docs/posts/index.html +491 -627
- data/site/docs/quickstart/index.html +9 -645
- data/site/docs/resources/index.html +9 -761
- data/site/docs/ruby-101/index.html +640 -0
- data/site/docs/sites/index.html +9 -696
- data/site/docs/static-files/index.html +401 -433
- data/site/docs/step-by-step/01-setup/index.html +771 -0
- data/site/docs/step-by-step/02-liquid/index.html +756 -0
- data/site/docs/step-by-step/03-front-matter/index.html +730 -0
- data/site/docs/step-by-step/04-layouts/index.html +770 -0
- data/site/docs/step-by-step/05-includes/index.html +768 -0
- data/site/docs/step-by-step/06-data-files/index.html +738 -0
- data/site/docs/step-by-step/07-assets/index.html +773 -0
- data/site/docs/step-by-step/08-blogging/index.html +835 -0
- data/site/docs/step-by-step/09-collections/index.html +932 -0
- data/site/docs/step-by-step/10-deployment/index.html +842 -0
- data/site/docs/structure/index.html +411 -430
- data/site/docs/support/index.html +392 -476
- data/site/docs/templates/index.html +9 -1232
- data/site/docs/themes/index.html +487 -521
- data/site/docs/troubleshooting/index.html +443 -520
- data/site/docs/upgrading/0-to-2/index.html +437 -523
- data/site/docs/upgrading/2-to-3/index.html +422 -507
- data/site/docs/upgrading/3-to-4/index.html +765 -0
- data/site/docs/upgrading/index.html +395 -478
- data/site/docs/usage/index.html +409 -506
- data/site/docs/variables/index.html +504 -652
- data/site/docs/windows/index.html +9 -784
- data/site/feed.xml +269 -188
- data/site/feed/release.xml +324 -0
- data/site/fonts/lato-v14-latin-300.woff +0 -0
- data/site/fonts/lato-v14-latin-300.woff2 +0 -0
- data/site/fonts/lato-v14-latin-300italic.woff +0 -0
- data/site/fonts/lato-v14-latin-300italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-700.woff +0 -0
- data/site/fonts/lato-v14-latin-700.woff2 +0 -0
- data/site/fonts/lato-v14-latin-700italic.woff +0 -0
- data/site/fonts/lato-v14-latin-700italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-900.woff +0 -0
- data/site/fonts/lato-v14-latin-900.woff2 +0 -0
- data/site/fonts/lato-v14-latin-900italic.woff +0 -0
- data/site/fonts/lato-v14-latin-900italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-italic.woff +0 -0
- data/site/fonts/lato-v14-latin-italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-regular.woff +0 -0
- data/site/fonts/lato-v14-latin-regular.woff2 +0 -0
- data/site/help/index.html +9 -247
- data/site/img/forestry-logo.svg +19 -0
- data/site/img/jekyll-og.png +0 -0
- data/site/img/spacer.gif +0 -0
- data/site/index.html +56 -29
- data/site/jekyllconf/index.html +62 -35
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +180 -115
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +182 -117
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +183 -118
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +184 -119
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +183 -118
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +180 -115
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +182 -117
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +182 -117
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +185 -120
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +183 -118
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +180 -115
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +189 -124
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +181 -116
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +181 -116
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +180 -115
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +182 -117
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +181 -116
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +181 -116
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +181 -116
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +184 -119
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +180 -115
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +181 -116
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +185 -120
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +182 -117
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +181 -116
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +189 -124
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +187 -122
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +188 -123
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +180 -115
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +182 -117
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +179 -114
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +180 -115
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +179 -114
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +180 -115
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +180 -115
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +185 -120
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +184 -119
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +182 -117
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +186 -121
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +183 -118
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +181 -116
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +182 -117
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +179 -114
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +181 -116
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +181 -116
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +180 -115
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +186 -121
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +181 -116
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +181 -116
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +179 -114
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +184 -119
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +180 -115
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +179 -114
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +207 -142
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +181 -116
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +183 -118
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +181 -116
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +189 -124
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +190 -125
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +187 -122
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +182 -117
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +185 -120
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +181 -116
- data/site/news/2017/10/19/diversity-open-source/index.html +181 -116
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +183 -118
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +184 -119
- data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +189 -124
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +180 -115
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +185 -120
- data/site/news/2018/04/19/development-update/index.html +699 -0
- data/site/news/2018/04/19/jekyll-3-8-0-released/index.html +715 -0
- data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +182 -117
- data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +181 -116
- data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +183 -118
- data/site/news/2018/08/01/jekyll-sponsoring/index.html +748 -0
- data/site/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/index.html +692 -0
- data/site/news/2018/11/04/jekyll-3-8-5-released/index.html +682 -0
- data/site/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/index.html +710 -0
- data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +180 -115
- data/site/news/2019/07/20/jekyll-4-0-0-pre-beta1-released/index.html +11 -0
- data/site/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/index.html +708 -0
- data/site/news/2019/08/20/jekyll-4-0-0-released/index.html +809 -0
- data/site/news/index.html +976 -326
- data/site/news/releases/index.html +820 -321
- data/site/{philosophy.html → philosophy/index.html} +1 -1
- data/site/redirects.json +1 -1
- data/site/resources/index.html +332 -0
- data/site/showcase/index.html +844 -0
- data/site/sitemap.xml +256 -81
- data/site/team/index.html +63 -77
- data/site/tutorials/cache-api/index.html +418 -0
- data/site/tutorials/convert-site-to-jekyll/index.html +155 -124
- data/site/tutorials/custom-404-page/index.html +76 -43
- data/site/tutorials/home/index.html +64 -37
- data/site/tutorials/navigation/index.html +186 -103
- data/site/tutorials/orderofinterpretation/index.html +80 -53
- data/site/tutorials/using-jekyll-with-bundler/index.html +80 -51
- data/site/tutorials/video-walkthroughs/index.html +62 -35
- metadata +102 -13
- data/site/community/index.html +0 -11
- data/site/docs/continuous-integration/index.html +0 -681
@@ -3,17 +3,18 @@
|
|
3
3
|
<head>
|
4
4
|
<meta charset="UTF-8">
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
6
|
-
<meta name="generator" content="Jekyll
|
6
|
+
<meta name="generator" content="Jekyll v4.0.0">
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
8
|
+
<link type="application/atom+xml" rel="alternate" href="/feed/release.xml" title="Jekyll releases posts" />
|
8
9
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
9
|
-
<link rel="
|
10
|
-
<link rel="
|
11
|
-
<link rel="
|
10
|
+
<link rel="preload" href="/fonts/lato-v14-latin-300.woff2" as="font" type="font/woff2" crossorigin />
|
11
|
+
<link rel="preload" href="/fonts/lato-v14-latin-700.woff2" as="font" type="font/woff2" crossorigin />
|
12
|
+
<link rel="preload" href="/css/screen.css" as="style">
|
12
13
|
<link rel="stylesheet" href="/css/screen.css">
|
13
14
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
14
15
|
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
15
16
|
<title>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
|
|