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>Releases | 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="Releases" />
|
18
19
|
<meta name="author" content="all" />
|
19
20
|
<meta property="og:locale" content="en_US" />
|
@@ -22,13 +23,15 @@
|
|
22
23
|
<link rel="canonical" href="https://jekyllrb.com/news/releases/" />
|
23
24
|
<meta property="og:url" content="https://jekyllrb.com/news/releases/" />
|
24
25
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
25
|
-
<meta
|
26
|
+
<meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
|
27
|
+
<meta name="twitter:card" content="summary_large_image" />
|
28
|
+
<meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
|
26
29
|
<meta property="twitter:title" content="Releases" />
|
27
30
|
<meta name="twitter:site" content="@jekyllrb" />
|
28
31
|
<meta name="twitter:creator" content="@all" />
|
29
32
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
30
33
|
<script type="application/ld+json">
|
31
|
-
{"
|
34
|
+
{"description":"Transform your plain text into static websites and blogs","@type":"WebPage","headline":"Releases","url":"https://jekyllrb.com/news/releases/","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"author":{"@type":"Person","name":"all"},"@context":"https://schema.org"}</script>
|
32
35
|
<!-- End Jekyll SEO tag -->
|
33
36
|
|
34
37
|
<!--[if lt IE 9]>
|
@@ -51,18 +54,27 @@
|
|
51
54
|
</div>
|
52
55
|
<nav class="main-nav hide-on-mobiles">
|
53
56
|
<ul>
|
54
|
-
|
57
|
+
|
58
|
+
<li>
|
55
59
|
<a href="/">Home</a>
|
56
60
|
</li>
|
57
|
-
|
58
|
-
|
61
|
+
|
62
|
+
<li>
|
63
|
+
<a href="/docs/">Docs</a>
|
64
|
+
</li>
|
65
|
+
|
66
|
+
<li>
|
67
|
+
<a href="/resources/">Resources</a>
|
68
|
+
</li>
|
69
|
+
|
70
|
+
<li>
|
71
|
+
<a href="/showcase/">Showcase</a>
|
59
72
|
</li>
|
73
|
+
|
60
74
|
<li class="current">
|
61
75
|
<a href="/news/">News</a>
|
62
76
|
</li>
|
63
|
-
|
64
|
-
<a href="/help/">Help</a>
|
65
|
-
</li>
|
77
|
+
|
66
78
|
</ul>
|
67
79
|
|
68
80
|
</nav>
|
@@ -73,7 +85,7 @@
|
|
73
85
|
<div class="meta hide-on-mobiles">
|
74
86
|
<ul>
|
75
87
|
<li>
|
76
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/
|
88
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
|
77
89
|
</li>
|
78
90
|
<li>
|
79
91
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
@@ -83,18 +95,24 @@
|
|
83
95
|
</div>
|
84
96
|
<nav class="mobile-nav show-on-mobiles">
|
85
97
|
<ul>
|
86
|
-
|
87
|
-
<
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
+
|
99
|
+
<li>
|
100
|
+
<a href="/">Home</a>
|
101
|
+
</li>
|
102
|
+
|
103
|
+
<li>
|
104
|
+
<a href="/docs/">Docs</a>
|
105
|
+
</li>
|
106
|
+
|
107
|
+
<li>
|
108
|
+
<a href="/resources/">Resources</a>
|
109
|
+
</li>
|
110
|
+
|
111
|
+
|
112
|
+
<li class="current">
|
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>
|
@@ -111,16 +129,32 @@
|
|
111
129
|
<select onchange="if (this.value) window.location.href=this.value">
|
112
130
|
<option value="">Navigate the blog…</option>
|
113
131
|
<option value="/news/">Home</option>
|
114
|
-
<optgroup label="
|
132
|
+
<optgroup label="posts">
|
133
|
+
|
134
|
+
<option value="/news/2019/08/20/jekyll-4-0-0-released/">Jekyll 4.0.0 Released</option>
|
135
|
+
|
136
|
+
<option value="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">Jekyll 4.0.0.pre.beta1 Released</option>
|
115
137
|
|
116
138
|
<option value="/news/2019/07/02/jekyll-3-8-6-released/">Jekyll 3.8.6 Released</option>
|
117
139
|
|
140
|
+
<option value="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">Jekyll 4.0.0.pre.alpha1 Released</option>
|
141
|
+
|
142
|
+
<option value="/news/2018/11/04/jekyll-3-8-5-released/">Jekyll 3.8.5 Released</option>
|
143
|
+
|
144
|
+
<option value="/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/">Security Fixes for series 3.6, 3.7 and 3.8</option>
|
145
|
+
|
146
|
+
<option value="/news/2018/08/01/jekyll-sponsoring/">Sponsoring Jekyll's development</option>
|
147
|
+
|
118
148
|
<option value="/news/2018/06/05/jekyll-3-8-3-released/">Jekyll 3.8.3 Released</option>
|
119
149
|
|
120
150
|
<option value="/news/2018/05/19/jekyll-3-8-2-released/">Jekyll 3.8.2 Released</option>
|
121
151
|
|
122
152
|
<option value="/news/2018/05/01/jekyll-3-8-1-released/">Jekyll 3.8.1 Released</option>
|
123
153
|
|
154
|
+
<option value="/news/2018/04/19/development-update/">Jekyll 4.0 is on the Horizon!</option>
|
155
|
+
|
156
|
+
<option value="/news/2018/04/19/jekyll-3-8-0-released/">Jekyll 3.8.0 Released</option>
|
157
|
+
|
124
158
|
<option value="/news/2018/02/24/jekyll-3-7-3-released/">Jekyll 3.7.3 Released</option>
|
125
159
|
|
126
160
|
<option value="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</option>
|
@@ -266,6 +300,229 @@
|
|
266
300
|
|
267
301
|
<div class="unit four-fifths">
|
268
302
|
|
303
|
+
<article>
|
304
|
+
<h2>
|
305
|
+
<a href="/news/2019/08/20/jekyll-4-0-0-released/">
|
306
|
+
Jekyll 4.0.0 Released
|
307
|
+
</a>
|
308
|
+
</h2>
|
309
|
+
<span class="post-category">
|
310
|
+
<span class="label">
|
311
|
+
release
|
312
|
+
</span>
|
313
|
+
</span>
|
314
|
+
<div class="post-meta">
|
315
|
+
<span class="post-date">
|
316
|
+
20 Aug 2019
|
317
|
+
</span>
|
318
|
+
|
319
|
+
<a href="https://github.com/mattr-" class="post-author">
|
320
|
+
<img class="avatar avatar-small" alt="mattr-" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/mattr-?v=3&s=24" srcset="https://avatars0.githubusercontent.com/mattr-?v=3&s=24 1x, https://avatars0.githubusercontent.com/mattr-?v=3&s=48 2x, https://avatars0.githubusercontent.com/mattr-?v=3&s=72 3x, https://avatars0.githubusercontent.com/mattr-?v=3&s=96 4x">
|
321
|
+
mattr-
|
322
|
+
</a>
|
323
|
+
</div>
|
324
|
+
<div class="post-content">
|
325
|
+
<p>Hi! 👋 I bring some good news! Jekyll 4.0.0 is finally here! 🎉</p>
|
326
|
+
|
327
|
+
<p>There’s quite a bit in this release to unpack, so let me hit the high points quickly:</p>
|
328
|
+
<ul>
|
329
|
+
<li>Ruby 2.4.0 or greater is now required.</li>
|
330
|
+
<li>Rouge 3.0 or greater is now required for syntax highlighting.</li>
|
331
|
+
<li>Jekyll builds should be much faster.</li>
|
332
|
+
<li>Kramdown 2.1 is now the default markdown engine.</li>
|
333
|
+
<li>Sass processing should be faster.</li>
|
334
|
+
<li>We dropped support for a lot of stuff, specifically:
|
335
|
+
<ul>
|
336
|
+
<li>Pygments</li>
|
337
|
+
<li>RedCarpet</li>
|
338
|
+
<li>RDiscount</li>
|
339
|
+
</ul>
|
340
|
+
</li>
|
341
|
+
</ul>
|
342
|
+
|
343
|
+
<p>Alright, so with the high points out of the way, let’s get into the details a little bit.</p>
|
344
|
+
|
345
|
+
<h3 id="cache-all-the-things-">Cache all the things! 💰</h3>
|
346
|
+
|
347
|
+
<p>While some optimizations first made an appearance with Jekyll 3.8.0, Jekyll 4.0 takes
|
348
|
+
it to another level altogether.</p>
|
349
|
+
|
350
|
+
<p>Jekyll 4.0 caches the processing done by Liquid in memory. So every Liquid
|
351
|
+
template is processed only as required. If you have 10 pages depending on a
|
352
|
+
single layout, the layout is cached and that data is then rendered as per the
|
353
|
+
10 different contexts of the individual files.</p>
|
354
|
+
|
355
|
+
<p>There’s also a disk cache! Jekyll can now cache data to disk to avoid repeated
|
356
|
+
processing of content that doesn’t change between build sessions. Currently,
|
357
|
+
this is limited to markdown. So while the very first build will take a certain
|
358
|
+
amount of time, consequent builds for content that hasn’t changed will take
|
359
|
+
much less time due to the disk-cache. Disk caching is disabled for <code class="highlighter-rouge">safe</code> mode,
|
360
|
+
however.</p>
|
361
|
+
|
362
|
+
<h3 id="super-powered-content-transformations-">Super-powered content transformations 💪</h3>
|
363
|
+
|
364
|
+
<p>We’ve upgraded Sass support so it should be faster and support. There’s also
|
365
|
+
support for sourcemaps now! Under the hood, our Sass support uses the <code class="highlighter-rouge">SassC</code>
|
366
|
+
library now, which is supported directly by the Sass team, which should mean
|
367
|
+
better support for everybody in the long run.</p>
|
368
|
+
|
369
|
+
<p>Kramdown is updated to version 2.1. This also brings with it a bunch of changes
|
370
|
+
to the Kramdown configuration, as the Kramdown team have extracted a fair
|
371
|
+
number of features into separate gems. Support for GitHub Flavored Markdown is
|
372
|
+
enabled by default, but if you’re using another Kramdown extension in your
|
373
|
+
site, you’ll likely need to update your plugin configuration. See the <a href="/docs/upgrading/3-to-4/">upgrade
|
374
|
+
guide</a> for more details.</p>
|
375
|
+
|
376
|
+
<p>The <code class="highlighter-rouge">link</code> and <code class="highlighter-rouge">post_url</code> tags no longer need <code class="highlighter-rouge">site.baseurl</code> prepended every
|
377
|
+
time they’re used. Those tags now use our <code class="highlighter-rouge">relative_url</code> filter to take care of
|
378
|
+
this for you. Existing uses of the prepending pattern will break though!
|
379
|
+
Sorry! <img class="emoji" title=":sweat_smile:" alt=":sweat_smile:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f605.png" height="20" width="20"></p>
|
380
|
+
|
381
|
+
<p>A few other smaller features when it comes to content:</p>
|
382
|
+
<ul>
|
383
|
+
<li>The <code class="highlighter-rouge">link</code> tag understands Liquid variables in the same fashion our
|
384
|
+
<code class="highlighter-rouge">include</code> tag does now.</li>
|
385
|
+
<li>Disable Liquid processing for a particular page / document by adding
|
386
|
+
<code class="highlighter-rouge">render_with_liquid: false</code> to it’s front matter.</li>
|
387
|
+
<li>Liquid’s binary <code class="highlighter-rouge">and</code> and <code class="highlighter-rouge">or</code> operations can be used in the <code class="highlighter-rouge">where_exp</code>
|
388
|
+
filter for more powerful filtering</li>
|
389
|
+
</ul>
|
390
|
+
|
391
|
+
<p>There’s some goodies for theme community as well. Developers may now bundle a
|
392
|
+
<code class="highlighter-rouge">config.yml</code> into their theme-gem to provide some boilerplate configurations for
|
393
|
+
the theme. Like other resources in the theme, these configuration values can also
|
394
|
+
be customized at the user’s end.</p>
|
395
|
+
|
396
|
+
<p>Check out the <a href="/docs/history/#v4-0-0">full history</a> and the various pull requests
|
397
|
+
for more details on all the enhancements and bug-fixes.</p>
|
398
|
+
|
399
|
+
<h3 id="upgrading-">Upgrading 📈</h3>
|
400
|
+
|
401
|
+
<p>First, read the <a href="/docs/upgrading/3-to-4/">upgrade guide</a>!</p>
|
402
|
+
|
403
|
+
<p>Next, Edit your project’s <code class="highlighter-rouge">Gemfile</code> to test Jekyll v4.x:</p>
|
404
|
+
|
405
|
+
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s2">"jekyll"</span><span class="p">,</span> <span class="s2">"~> 4.0"</span>
|
406
|
+
</code></pre></div></div>
|
407
|
+
|
408
|
+
<p>Then run <code class="highlighter-rouge">bundle update</code> to update all dependencies. Unless you’re using
|
409
|
+
third-party plugins that haven’t yet added support for Jekyll 4.0, you should be
|
410
|
+
good to go.</p>
|
411
|
+
|
412
|
+
<p>Plugins and themes authors must relax the jekyll dependency in their <code class="highlighter-rouge">gemspec</code> file
|
413
|
+
to allow for Jekyll v4.0:</p>
|
414
|
+
|
415
|
+
<p><code class="highlighter-rouge">spec.add_runtime_dependency "jekyll", ">= 3.6", "< 5.0"</code></p>
|
416
|
+
|
417
|
+
<p>If your favorite plugin hasn’t relaxed that dependency yet, please gently
|
418
|
+
encourage them to do so. <img class="emoji" title=":slightly_smiling_face:" alt=":slightly_smiling_face:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f642.png" height="20" width="20"></p>
|
419
|
+
|
420
|
+
<h3 id="have-questions">Have questions❓</h3>
|
421
|
+
|
422
|
+
<p>Please reach out on our <a href="https://talk.jekyllrb.com">community forum</a></p>
|
423
|
+
|
424
|
+
<h3 id="thank-you-">Thank you!! 🙇</h3>
|
425
|
+
|
426
|
+
<p>Jekyll would not be possible without the many people who have taken the time to write issues, submit pull requests, create themes, answer questions for other users, or make their own sites using our project. Thanks to all of you who contribute, no matter how small you think your contribution might have been.</p>
|
427
|
+
|
428
|
+
<p>In addition, special thanks to the 139 contributors who made this
|
429
|
+
release possible via a pull request submission (in alphabetical order): Aidan
|
430
|
+
Fitzgerald, Akshat Kedia, Ale Muñoz, Alex Wood,
|
431
|
+
Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez,
|
432
|
+
Ananthakumar, Andreas Möller, Andrew Lyndem, Andrew Marcuse, Andy Alt, Anne
|
433
|
+
Gentle, Anny, Anuj Bhatnagar, argv-minus-one, Arjun Thakur, Arthur Attwell,
|
434
|
+
Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed,
|
435
|
+
Bjorn Krols, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Chris
|
436
|
+
Oliver, chrisfinazzo, Christian Oliff, Christoph Päper, Damien Solodow, Dan
|
437
|
+
Allen, Dan Friedman, Daniel Höpfl, David J. Malan, David Kennell, David Zhang,
|
438
|
+
Denis McDonald, Derek Smart, Derpy, Dusty Candland, Edgar Tinajero, Elvio
|
439
|
+
Vicosa, ExE Boss, Fons van der Plas, Frank Taillandier, Gareth Cooper, Grzegorz
|
440
|
+
Kaczorek, Haris Bjelic, Hodong Kim, ikeji, Isaac Goodman, Jacob Byers, Jakob
|
441
|
+
Krigovsky, James Rhea, Jan Pobořil, jess, jingze_lu, Joe Shannon, Jordan Morgan,
|
442
|
+
Jörg Steinsträter, Jorie Tappa, Josue Caraballo, jpasholk, Justin Vallelonga,
|
443
|
+
Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, krissy,
|
444
|
+
Kyle Barbour, Lars Kanis, Leandro Facchinetti, Liam Rosenfeld, Luis Enrique
|
445
|
+
Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, makmm, Manu Mathew, Mario,
|
446
|
+
Martin Scharm, Matt Kraai, Matt Massicotte, Matt Rogers, Matthew Rathbone,
|
447
|
+
Maxwell Gerber, Mertcan Yücel, Michael Bishop, Michael Hiiva, Michelle Greer,
|
448
|
+
Mike Kasberg, Mike Neumegen, mo khan, Monica Powell, Nicolas Hoizey, Nikhil
|
449
|
+
Benesch, Nikhil Swaminathan, Nikita Skalkin, Niklas Eicker, ninevra, Olivia
|
450
|
+
Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, penguinpet,
|
451
|
+
Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes,
|
452
|
+
Sadik Kuzu, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer,
|
453
|
+
Stephen Weiss, Steven Westmoreland, strangehill, Sundaram Kalyan Vedala, Thanos
|
454
|
+
Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev,
|
455
|
+
Vinicius Flores, Vitor Oliveira, Wouter Schoot, XhmikosR, Yi Feng Xie, Zhang
|
456
|
+
Xiangze, 김정환, 104fps.</p>
|
457
|
+
|
458
|
+
<p>Happy Jekylling everyone!</p>
|
459
|
+
|
460
|
+
</div>
|
461
|
+
</article>
|
462
|
+
|
463
|
+
|
464
|
+
<article>
|
465
|
+
<h2>
|
466
|
+
<a href="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">
|
467
|
+
Jekyll 4.0.0.pre.beta1 Released
|
468
|
+
</a>
|
469
|
+
</h2>
|
470
|
+
<span class="post-category">
|
471
|
+
<span class="label">
|
472
|
+
release
|
473
|
+
</span>
|
474
|
+
</span>
|
475
|
+
<div class="post-meta">
|
476
|
+
<span class="post-date">
|
477
|
+
04 Aug 2019
|
478
|
+
</span>
|
479
|
+
|
480
|
+
<a href="https://github.com/mattr-" class="post-author">
|
481
|
+
<img class="avatar avatar-small" alt="mattr-" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/mattr-?v=3&s=24" srcset="https://avatars0.githubusercontent.com/mattr-?v=3&s=24 1x, https://avatars0.githubusercontent.com/mattr-?v=3&s=48 2x, https://avatars0.githubusercontent.com/mattr-?v=3&s=72 3x, https://avatars0.githubusercontent.com/mattr-?v=3&s=96 4x">
|
482
|
+
mattr-
|
483
|
+
</a>
|
484
|
+
</div>
|
485
|
+
<div class="post-content">
|
486
|
+
<p>Dear Jekyllers,</p>
|
487
|
+
|
488
|
+
<p>It’s time for another pre-release of Jekyll 4! 🎉</p>
|
489
|
+
|
490
|
+
<p>This pre-release moves us further down the path of releasing Jekyll 4.0.0. All the same goodies <a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">from the last pre-release</a> are here, along with a few more things I want to highlight:</p>
|
491
|
+
|
492
|
+
<p>Jekyll 4.0 is a new <em>major</em> version and it comes with a few breaking changes, notably :</p>
|
493
|
+
|
494
|
+
<ol>
|
495
|
+
<li>We dropped support for <a href="https://www.ruby-lang.org/en/downloads/">Ruby 2.3 which EOL at the end of March 2019</a>.
|
496
|
+
GitHub Pages runs Ruby 2.5.x, services like Netlify or Forestry already upgraded to latest Ruby 2.6.x.</li>
|
497
|
+
<li>
|
498
|
+
<code class="highlighter-rouge">link</code> tag now include <code class="highlighter-rouge">relative_url</code> filter, hurray <a href="https://github.com/jekyll/jekyll/pull/6727">no more need to prepend <code class="highlighter-rouge">{{ site.baseurl }}</code> </a>.</li>
|
499
|
+
<li>
|
500
|
+
<a href="https://github.com/jekyll/jekyll/pull/6821"><code class="highlighter-rouge">{% highlight %}</code> now behaves like <code class="highlighter-rouge">{% raw %}</code></a>, so you can no longer use <code class="highlighter-rouge">include</code> tags within.</li>
|
501
|
+
<li>We dropped support for Pygments, RedCarpet and rdiscount.</li>
|
502
|
+
<li>We bumped kramdown to v2.</li>
|
503
|
+
</ol>
|
504
|
+
|
505
|
+
<p>If you’re a plugin developer, we still need your feedback! Your plugin may not work with version 4 and we’d like to fix those issues before we release.</p>
|
506
|
+
|
507
|
+
<p>Checkout the complete <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0.pre.beta1">changelog</a> for more details.</p>
|
508
|
+
|
509
|
+
<p>To test this pre version run:</p>
|
510
|
+
|
511
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install </span>jekyll <span class="nt">--pre</span>
|
512
|
+
</code></pre></div></div>
|
513
|
+
|
514
|
+
<p>Please test this version thoroughly and file bugs as you encounter them.</p>
|
515
|
+
|
516
|
+
<p>Thanks to our dear contributors for helping making Jekyll better:</p>
|
517
|
+
|
518
|
+
<p>Aidan Fitzgerald, Akshat Kedia, Alex Wood, Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez, Ananthakumar, Andreas Möller, Andrew Lyndem, Andy Alt, Anne Gentle, Anny, Arjun Thakur, Arthur Attwell, Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Christian Oliff, Damien Solodow, Dan Allen, Dan Friedman, Daniel Höpfl, David J. Malan, Denis McDonald, Derek Smart, Derpy, Dusty Candland, ExE Boss, Frank Taillandier, Gareth Cooper, Grzegorz Kaczorek, Isaac Goodman, Jacob Byers, Jakob Krigovsky, Jan Pobořil, Joe Shannon, Jordan Morgan, Jorie Tappa, Josue Caraballo, Justin Vallelonga, Jörg Steinsträter, Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, Kyle Barbour, Lars Kanis, Leandro Facchinetti, Luis Enrique Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, Manu Mathew, Mario, Martin Scharm, Matt Massicotte, Matthew Rathbone, Maxwell Gerber, Mertcan Yücel, Michael Hiiva, Mike Kasberg, Mike Neumegen, Monica Powell, Nicolas Hoizey, Nikhil Swaminathan, Nikita Skalkin, Olivia Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer, Stephen Weiss, Steven Westmoreland, Sundaram Kalyan Vedala, Thanos Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev, Vitor Oliveira, Wouter Schoot, XhmikosR, Zhang Xiangze, _94gsc, argv-minus-one, chrisfinazzo, ikeji, jess, jpasholk, makmm, mo khan, ninevra, penguinpet, 김정환, 104fps</p>
|
519
|
+
|
520
|
+
<p>Happy Jekylling everyone!</p>
|
521
|
+
|
522
|
+
</div>
|
523
|
+
</article>
|
524
|
+
|
525
|
+
|
269
526
|
<article>
|
270
527
|
<h2>
|
271
528
|
<a href="/news/2019/07/02/jekyll-3-8-6-released/">
|
@@ -306,6 +563,148 @@ and a handful of bug patches, including:</p>
|
|
306
563
|
</article>
|
307
564
|
|
308
565
|
|
566
|
+
<article>
|
567
|
+
<h2>
|
568
|
+
<a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">
|
569
|
+
Jekyll 4.0.0.pre.alpha1 Released
|
570
|
+
</a>
|
571
|
+
</h2>
|
572
|
+
<span class="post-category">
|
573
|
+
<span class="label">
|
574
|
+
release
|
575
|
+
</span>
|
576
|
+
</span>
|
577
|
+
<div class="post-meta">
|
578
|
+
<span class="post-date">
|
579
|
+
18 Mar 2019
|
580
|
+
</span>
|
581
|
+
|
582
|
+
<a href="https://github.com/dirtyf" class="post-author">
|
583
|
+
<img class="avatar avatar-small" alt="dirtyf" width="24" height="24" data-proofer-ignore="true" src="https://avatars3.githubusercontent.com/dirtyf?v=3&s=24" srcset="https://avatars3.githubusercontent.com/dirtyf?v=3&s=24 1x, https://avatars3.githubusercontent.com/dirtyf?v=3&s=48 2x, https://avatars3.githubusercontent.com/dirtyf?v=3&s=72 3x, https://avatars3.githubusercontent.com/dirtyf?v=3&s=96 4x">
|
584
|
+
dirtyf
|
585
|
+
</a>
|
586
|
+
</div>
|
587
|
+
<div class="post-content">
|
588
|
+
<p>Dear Jekyllers,</p>
|
589
|
+
|
590
|
+
<p>Time has come to release a first alpha for Jekyll 4!</p>
|
591
|
+
|
592
|
+
<p>This pre version fixes many bugs, and should improve your build times. Some of you already shared <a href="https://forestry.io/blog/how-i-reduced-my-jekyll-build-time-by-61/">really</a> <a href="https://boris.schapira.dev/2018/11/jekyll-build-optimization/">good</a> results. We hope your Jekyll sites will also benefit from these optimizations.</p>
|
593
|
+
|
594
|
+
<p>If you’re a plugin developer, we definitely need your feedback, especially if your plugin does not work with v4.</p>
|
595
|
+
|
596
|
+
<p>Jekyll now exposes a <a href="/tutorials/cache-api/">caching API</a>, that some plugins could benefit from.</p>
|
597
|
+
|
598
|
+
<p>Also be aware that it’s a new <em>major</em> version, and it comes with a few breaking changes, notably :</p>
|
599
|
+
|
600
|
+
<ol>
|
601
|
+
<li>We dropped support for <a href="https://www.ruby-lang.org/en/downloads/">Ruby 2.3 who goes EOL at the end of the month</a>.
|
602
|
+
GitHub Pages runs Ruby 2.5.x, services like Netlify or Forestry already upgraded to latest Ruby 2.6.x.</li>
|
603
|
+
<li>
|
604
|
+
<code class="highlighter-rouge">link</code> tag now include <code class="highlighter-rouge">relative_url</code> filter, hurray <a href="https://github.com/jekyll/jekyll/pull/6727">no more need to prepend <code class="highlighter-rouge">{{ site.baseurl }}</code> </a>.</li>
|
605
|
+
<li>
|
606
|
+
<a href="https://github.com/jekyll/jekyll/pull/6821"><code class="highlighter-rouge">{% highlight %}</code> now behaves like <code class="highlighter-rouge">{% raw %}</code></a>, so you can no longer use <code class="highlighter-rouge">include</code> tags within.</li>
|
607
|
+
<li>We dropped support for Pygments, RedCarpet and rdiscount.</li>
|
608
|
+
<li>We bumped kramdown to v2.</li>
|
609
|
+
</ol>
|
610
|
+
|
611
|
+
<p>Checkout the complete <a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0.pre.alpha1">changelog</a> for more details.</p>
|
612
|
+
|
613
|
+
<p>To test this pre version run:</p>
|
614
|
+
|
615
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install </span>jekyll <span class="nt">--pre</span>
|
616
|
+
</code></pre></div></div>
|
617
|
+
|
618
|
+
<p>Please test this version thoroughly and file bugs as you encounter them.</p>
|
619
|
+
|
620
|
+
<p>Thanks to our dear contributors for helping making Jekyll better:</p>
|
621
|
+
|
622
|
+
<p>Aidan Fitzgerald, Akshat Kedia, Alex Wood, Alexey Kopytko, Alexey Pelykh, Ali Thompson, Ana María Martínez Gómez, Ananthakumar, Andreas Möller, Andrew Lyndem, Andy Alt, Anne Gentle, Anny, Arjun Thakur, Arthur Attwell, Ashwin Maroli, Behrang, Belhassen Chelbi, Ben Keith, Ben Otte, Bilawal Hameed, Boris Schapira, Boris van Hoytema, Brett C, Chris Finazzo, Christian Oliff, Damien Solodow, Dan Allen, Dan Friedman, Daniel Höpfl, David J. Malan, Denis McDonald, Derek Smart, Derpy, Dusty Candland, ExE Boss, Frank Taillandier, Gareth Cooper, Grzegorz Kaczorek, Isaac Goodman, Jacob Byers, Jakob Krigovsky, Jan Pobořil, Joe Shannon, Jordan Morgan, Jorie Tappa, Josue Caraballo, Justin Vallelonga, Jörg Steinsträter, Karel Bílek, Keith Mifsud, Kelly-Ann Green, Ken Salomon, Kevin Plattret, Kyle Barbour, Lars Kanis, Leandro Facchinetti, Luis Enrique Perez Alvarez, Luis Guillermo Yáñez, Ma HongJun, Manu Mathew, Mario, Martin Scharm, Matt Massicotte, Matthew Rathbone, Maxwell Gerber, Mertcan Yücel, Michael Hiiva, Mike Kasberg, Mike Neumegen, Monica Powell, Nicolas Hoizey, Nikhil Swaminathan, Nikita Skalkin, Olivia Hugger, Parker Moore, Pat Hawks, Patrick Favre-Bulle, Paul Kim, Philip Belesky, Preston Lim, Ralph, Robert Riemann, Rosário Pereira Fernandes, Samuel Gruetter, Scott Killen, Sri Pravan Paturi, Stephan Fischer, Stephen Weiss, Steven Westmoreland, Sundaram Kalyan Vedala, Thanos Kolovos, Timo Schuhmacher, Tobias, Tom Harvey, Tushar Prajapati, Victor Afanasev, Vitor Oliveira, Wouter Schoot, XhmikosR, Zhang Xiangze, _94gsc, argv-minus-one, chrisfinazzo, ikeji, jess, jpasholk, makmm, mo khan, ninevra, penguinpet, 김정환, 104fps</p>
|
623
|
+
|
624
|
+
<p>Happy Jekylling everyone!</p>
|
625
|
+
|
626
|
+
</div>
|
627
|
+
</article>
|
628
|
+
|
629
|
+
|
630
|
+
<article>
|
631
|
+
<h2>
|
632
|
+
<a href="/news/2018/11/04/jekyll-3-8-5-released/">
|
633
|
+
Jekyll 3.8.5 Released
|
634
|
+
</a>
|
635
|
+
</h2>
|
636
|
+
<span class="post-category">
|
637
|
+
<span class="label">
|
638
|
+
release
|
639
|
+
</span>
|
640
|
+
</span>
|
641
|
+
<div class="post-meta">
|
642
|
+
<span class="post-date">
|
643
|
+
04 Nov 2018
|
644
|
+
</span>
|
645
|
+
|
646
|
+
<a href="https://github.com/oe" class="post-author">
|
647
|
+
<img class="avatar avatar-small" alt="oe" width="24" height="24" data-proofer-ignore="true" src="https://avatars2.githubusercontent.com/oe?v=3&s=24" srcset="https://avatars2.githubusercontent.com/oe?v=3&s=24 1x, https://avatars2.githubusercontent.com/oe?v=3&s=48 2x, https://avatars2.githubusercontent.com/oe?v=3&s=72 3x, https://avatars2.githubusercontent.com/oe?v=3&s=96 4x">
|
648
|
+
oe
|
649
|
+
</a>
|
650
|
+
</div>
|
651
|
+
<div class="post-content">
|
652
|
+
<p>This release fixes a bug where multiple Liquid tags were not supported in
|
653
|
+
excerpts.</p>
|
654
|
+
|
655
|
+
<p>Thanks to <a href="https://github.com/ashmaroli" class="user-mention">@ashmaroli</a> for fixing this issue in <a href="https://github.com/jekyll/jekyll/pull/7250">#7250</a>.</p>
|
656
|
+
|
657
|
+
<p>Happy Jekylling!</p>
|
658
|
+
|
659
|
+
|
660
|
+
</div>
|
661
|
+
</article>
|
662
|
+
|
663
|
+
|
664
|
+
<article>
|
665
|
+
<h2>
|
666
|
+
<a href="/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/">
|
667
|
+
Security Fixes for series 3.6, 3.7 and 3.8
|
668
|
+
</a>
|
669
|
+
</h2>
|
670
|
+
<span class="post-category">
|
671
|
+
<span class="label">
|
672
|
+
release
|
673
|
+
</span>
|
674
|
+
</span>
|
675
|
+
<div class="post-meta">
|
676
|
+
<span class="post-date">
|
677
|
+
19 Sep 2018
|
678
|
+
</span>
|
679
|
+
|
680
|
+
<a href="https://github.com/ashmaroli" class="post-author">
|
681
|
+
<img class="avatar avatar-small" alt="ashmaroli" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/ashmaroli?v=3&s=24" srcset="https://avatars0.githubusercontent.com/ashmaroli?v=3&s=24 1x, https://avatars0.githubusercontent.com/ashmaroli?v=3&s=48 2x, https://avatars0.githubusercontent.com/ashmaroli?v=3&s=72 3x, https://avatars0.githubusercontent.com/ashmaroli?v=3&s=96 4x">
|
682
|
+
ashmaroli
|
683
|
+
</a>
|
684
|
+
</div>
|
685
|
+
<div class="post-content">
|
686
|
+
<p>Hi Jekyllers,</p>
|
687
|
+
|
688
|
+
<p>We have patched a <strong>critical vulnerability</strong> reported to GitHub a couple of weeks ago and have released a set of new gems to
|
689
|
+
bring that patch to you. The vulnerability allowed arbitrary file reads with the cunning use of the <code class="highlighter-rouge">include:</code> setting in the
|
690
|
+
config file.</p>
|
691
|
+
|
692
|
+
<p>By simply including a symlink in the <code class="highlighter-rouge">include</code> array allowed the symlinked file to be read into the build when they shouldn’t
|
693
|
+
actually be read in any circumstance.
|
694
|
+
Further details regarding the patch can be viewed at the <a href="https://github.com/jekyll/jekyll/pull/7224">pull request URL</a></p>
|
695
|
+
|
696
|
+
<p>The patch has been released as versions <code class="highlighter-rouge">3.6.3</code>, <code class="highlighter-rouge">3.7.4</code> and <code class="highlighter-rouge">3.8.4</code>.
|
697
|
+
Thanks to <a href="https://github.com/parkr" class="user-mention">@parkr</a> <code class="highlighter-rouge">v3.7.4</code> was released a couple of weeks prior and has been bundled with <code class="highlighter-rouge">github-pages-v192</code>.</p>
|
698
|
+
|
699
|
+
<p>Please keep in mind that this issue affects <em>all previously released Jekyll versions</em>. If you have not had
|
700
|
+
a good reason to upgrade to <code class="highlighter-rouge">3.6</code>, <code class="highlighter-rouge">3.7</code> or <code class="highlighter-rouge">3.8</code> yet, we advise that you do so at the earliest.</p>
|
701
|
+
|
702
|
+
<p>As always, Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
703
|
+
|
704
|
+
</div>
|
705
|
+
</article>
|
706
|
+
|
707
|
+
|
309
708
|
<article>
|
310
709
|
<h2>
|
311
710
|
<a href="/news/2018/06/05/jekyll-3-8-3-released/">
|
@@ -328,11 +727,11 @@ and a handful of bug patches, including:</p>
|
|
328
727
|
</a>
|
329
728
|
</div>
|
330
729
|
<div class="post-content">
|
331
|
-
<p>This release fixes a regression in 3.8 where collections with <code class="
|
332
|
-
do not show when using the <code class="
|
730
|
+
<p>This release fixes a regression in 3.8 where collections with <code class="highlighter-rouge">published: false</code>
|
731
|
+
do not show when using the <code class="highlighter-rouge">--unpublished</code> flag.</p>
|
333
732
|
|
334
733
|
<p>Thanks to <a href="https://github.com/philipbelesky" class="user-mention">@philipbelesky</a> for reporting and fixing this issue; collections with
|
335
|
-
<code class="
|
734
|
+
<code class="highlighter-rouge">published: false</code> now behave the same way as Posts.</p>
|
336
735
|
|
337
736
|
</div>
|
338
737
|
</article>
|
@@ -362,7 +761,7 @@ do not show when using the <code class="language-plaintext highlighter-rouge">--
|
|
362
761
|
<div class="post-content">
|
363
762
|
<p>Hello Jekyllers!!</p>
|
364
763
|
|
365
|
-
<p>Today we are releasing <code class="
|
764
|
+
<p>Today we are releasing <code class="highlighter-rouge">v3.8.2</code>, which fixes the way Jekyll generates excerpts
|
366
765
|
for posts when the first paragraph of the post contains Liquid tags that take
|
367
766
|
advantage of <a href="https://shopify.github.io/liquid/basics/whitespace/">Liquid’s whitespace control feature</a>.</p>
|
368
767
|
|
@@ -399,8 +798,8 @@ the latest version of Rubocop to lint our code.</p>
|
|
399
798
|
<div class="post-content">
|
400
799
|
<p>Happy May Day <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
|
401
800
|
|
402
|
-
<p>The Jekyll team is happy to announce the release of <code class="
|
403
|
-
a couple of bugs that were introduced two weeks ago in <code class="
|
801
|
+
<p>The Jekyll team is happy to announce the release of <code class="highlighter-rouge">v3.8.1</code>, which fixes
|
802
|
+
a couple of bugs that were introduced two weeks ago in <code class="highlighter-rouge">v3.8.0</code>. If you have
|
404
803
|
experienced trouble regarding post excerpts or non-published posts, this release
|
405
804
|
should be the remedy. Thanks to <a href="https://github.com/Chaosed0" class="user-mention">@Chaosed0</a> and <a href="https://github.com/domLocalHeroes" class="user-mention">@domLocalHeroes</a> for originally
|
406
805
|
reporting these issues, and to <a href="https://github.com/ashmaroli" class="user-mention">@ashmaroli</a> for fixing them so quickly.</p>
|
@@ -414,6 +813,73 @@ list</a>.</p>
|
|
414
813
|
</article>
|
415
814
|
|
416
815
|
|
816
|
+
<article>
|
817
|
+
<h2>
|
818
|
+
<a href="/news/2018/04/19/jekyll-3-8-0-released/">
|
819
|
+
Jekyll 3.8.0 Released
|
820
|
+
</a>
|
821
|
+
</h2>
|
822
|
+
<span class="post-category">
|
823
|
+
<span class="label">
|
824
|
+
release
|
825
|
+
</span>
|
826
|
+
</span>
|
827
|
+
<div class="post-meta">
|
828
|
+
<span class="post-date">
|
829
|
+
19 Apr 2018
|
830
|
+
</span>
|
831
|
+
|
832
|
+
<a href="https://github.com/ashmaroli" class="post-author">
|
833
|
+
<img class="avatar avatar-small" alt="ashmaroli" width="24" height="24" data-proofer-ignore="true" src="https://avatars0.githubusercontent.com/ashmaroli?v=3&s=24" srcset="https://avatars0.githubusercontent.com/ashmaroli?v=3&s=24 1x, https://avatars0.githubusercontent.com/ashmaroli?v=3&s=48 2x, https://avatars0.githubusercontent.com/ashmaroli?v=3&s=72 3x, https://avatars0.githubusercontent.com/ashmaroli?v=3&s=96 4x">
|
834
|
+
ashmaroli
|
835
|
+
</a>
|
836
|
+
</div>
|
837
|
+
<div class="post-content">
|
838
|
+
<p>Aloha Jekyllers!! <img class="emoji" title=":wave:" alt=":wave:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f44b.png" height="20" width="20"></p>
|
839
|
+
|
840
|
+
<p>After months of toiling on the codebase and shipping a couple of release-candidates, the Jekyll Team is delighted to finally
|
841
|
+
present <code class="highlighter-rouge">v3.8.0</code>, packed with optimizations, improvements, some new features and a couple of bug-fixes. Yay!!!</p>
|
842
|
+
|
843
|
+
<p>Under the hood, Jekyll has undergone many minor changes that will allow it to run more performantly in the coming years. <img class="emoji" title=":smiley:" alt=":smiley:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f603.png" height="20" width="20">
|
844
|
+
Rest assured, our users should see minor improvements in their site’s build times.</p>
|
845
|
+
|
846
|
+
<p>Speaking of improvements, users running a site containing a huge amount of posts or those who like to use our <code class="highlighter-rouge">where</code> filter
|
847
|
+
frequently in a single template, are going to see a massive reduction in their total build times!! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
|
848
|
+
|
849
|
+
<p>Hold on, this version is not just about optimizations, there are some new features as well..:</p>
|
850
|
+
<ul>
|
851
|
+
<li>Detect non-existent variables and filters specified in a template by enabling <code class="highlighter-rouge">strict_variables</code> and <code class="highlighter-rouge">strict_filters</code> under the
|
852
|
+
<code class="highlighter-rouge">liquid</code> key in your config file.</li>
|
853
|
+
<li>Allow <em>date filters</em> to output ordinal days.</li>
|
854
|
+
<li>
|
855
|
+
<code class="highlighter-rouge">jekyll doctor</code> now warns you if you have opted for custom <code class="highlighter-rouge">collections_dir</code> but placed <code class="highlighter-rouge">_posts</code> directory outside that
|
856
|
+
directory.</li>
|
857
|
+
</ul>
|
858
|
+
|
859
|
+
<p>..and yes, a couple of bug-fixes, notably:</p>
|
860
|
+
<ul>
|
861
|
+
<li>Jekyll now handles future-dated documents properly.</li>
|
862
|
+
<li>Jekyll is able to handle Liquid blocks intelligently in excerpts.</li>
|
863
|
+
<li>A few methods that were <em>not meant to be publically accessible</em> have been entombed properly.</li>
|
864
|
+
<li>A few bugs that still plagued our <code class="highlighter-rouge">collections_dir</code> feature from <code class="highlighter-rouge">v3.7</code> got crushed.</li>
|
865
|
+
</ul>
|
866
|
+
|
867
|
+
<p>As always, the full list of changes since last release can be viewed <a href="/docs/history/#v3-8-0">here</a>.</p>
|
868
|
+
|
869
|
+
<p>A big thanks to the following people who contributed to our repository with pull-requests that improved our codebase, documentation
|
870
|
+
and tests:</p>
|
871
|
+
|
872
|
+
<p>Ana María Martínez Gómez, Antonio Argote, Ashwin Maroli, Awjin Ahn, Ben Balter, Benjamin Høegh, Christian Oliff, Damien Solodow,
|
873
|
+
David Zhang, Delson Lima, Eric Cornelissen, Florian Thomas, Frank Taillandier, Heinrich Hartmann, Jakob Vad Nielsen, John Eismeier,
|
874
|
+
Kacper Duras, KajMagnus, Mario Cekic, Max Vilimpoc, Michael H, Mike Kasberg, Parker Moore, Pat Hawks, Paweł Kuna, Robert Riemann,
|
875
|
+
Roger Rohrbach, Semen Zhydenko, Stefan Dellmuth, Tim Carry, olivia, and steelman.</p>
|
876
|
+
|
877
|
+
<p>Happy Jekylling!! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
878
|
+
|
879
|
+
</div>
|
880
|
+
</article>
|
881
|
+
|
882
|
+
|
417
883
|
<article>
|
418
884
|
<h2>
|
419
885
|
<a href="/news/2018/02/24/jekyll-3-7-3-released/">
|
@@ -438,13 +904,13 @@ list</a>.</p>
|
|
438
904
|
<div class="post-content">
|
439
905
|
<p>Hello Jekyllers!! <img class="emoji" title=":wave:" alt=":wave:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f44b.png" height="20" width="20"></p>
|
440
906
|
|
441
|
-
<p>We’re pleased to announce the release of <code class="
|
442
|
-
Jekyll plugin that in turn uses the <code class="
|
907
|
+
<p>We’re pleased to announce the release of <code class="highlighter-rouge">v3.7.3</code> which fixes a bug one might encounter while using <code class="highlighter-rouge">Jekyll - 3.7.x</code> along with a
|
908
|
+
Jekyll plugin that in turn uses the <code class="highlighter-rouge">I18n</code> library.</p>
|
443
909
|
|
444
|
-
<p>When <a href="/news/2018/01/02/jekyll-3-7-0-released/">v3.7.0</a> enhanced our <code class="
|
445
|
-
hardcoded a default fallback locale for the <code class="
|
910
|
+
<p>When <a href="/news/2018/01/02/jekyll-3-7-0-released/">v3.7.0</a> enhanced our <code class="highlighter-rouge">slugify</code> filter with a <code class="highlighter-rouge">latin</code> option, we also
|
911
|
+
hardcoded a default fallback locale for the <code class="highlighter-rouge">I18n</code> library to avoid an exception raised in the event the library fails to find
|
446
912
|
any locale. This led to issues with third-party i18n plugins for Jekyll, especially since the default locale got assigned before
|
447
|
-
the plugin was loaded, irrespective of whether the <code class="
|
913
|
+
the plugin was loaded, irrespective of whether the <code class="highlighter-rouge">slugify</code> filter was used.</p>
|
448
914
|
|
449
915
|
<p>Jekyll will henceforth set the default locale if and only if necessary.</p>
|
450
916
|
|
@@ -478,23 +944,23 @@ the plugin was loaded, irrespective of whether the <code class="language-plainte
|
|
478
944
|
regressions due to the changes made in that release. In due time, Team Jekyll
|
479
945
|
set out to address those issues as early as possible.</p>
|
480
946
|
|
481
|
-
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
947
|
+
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
482
948
|
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20">
|
483
949
|
The highlights being:</p>
|
484
950
|
|
485
951
|
<ul>
|
486
952
|
<li>
|
487
953
|
<p>A major regression in 3.7.0 was that when a Front Matter Default was
|
488
|
-
configured with a <code class="
|
954
|
+
configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
489
955
|
that directory for any subfolders and files, for each document in that
|
490
|
-
<code class="
|
956
|
+
<code class="highlighter-rouge">path</code>.
|
491
957
|
Though this is intended, it increases build times in proportion to the size
|
492
958
|
of the directory.</p>
|
493
959
|
|
494
960
|
<p>We addressed this by having Jekyll scan the directory path only if the user
|
495
|
-
explicitly configures the <code class="
|
961
|
+
explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
496
962
|
|
497
|
-
<p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
|
963
|
+
<p>Read our <a href="/docs/configuration/front-matter-defaults/#glob-patterns-in-front-matter-defaults">documentation</a>
|
498
964
|
for more details.</p>
|
499
965
|
|
500
966
|
<p>A huge shout-out to <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> for bringing this to our notice and
|
@@ -504,7 +970,7 @@ additionally providing us with a test repository to aid in resolving the issue.<
|
|
504
970
|
<p>Another regression reported was related to our “Custom collections
|
505
971
|
directory” feature introduced in 3.7.0.</p>
|
506
972
|
|
507
|
-
<p>Users setting <code class="
|
973
|
+
<p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
508
974
|
paths to their posts still at the root of their site’s source. This
|
509
975
|
roughly translated to 404 errors on URLs to their posts.</p>
|
510
976
|
|
@@ -512,16 +978,16 @@ roughly translated to 404 errors on URLs to their posts.</p>
|
|
512
978
|
|
513
979
|
<p>We decided to resolve this by having Jekyll ignore posts and drafts at the
|
514
980
|
root of the site’s source directory if the user customizes the
|
515
|
-
<code class="
|
981
|
+
<code class="highlighter-rouge">collection_dir</code> setting.</p>
|
516
982
|
|
517
983
|
<p>Ergo, if you set a custom location for your collections, please ensure you
|
518
984
|
move all of your collections into that directory. <strong>This includes posts and
|
519
985
|
drafts as well</strong>. Your links generated by
|
520
|
-
<code class="
|
986
|
+
<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
|
521
987
|
will adapt automatically.</p>
|
522
988
|
</li>
|
523
989
|
<li>
|
524
|
-
<p>We also found out that <code class="
|
990
|
+
<p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
525
991
|
being watched on Windows. So we recommend having it included in your Gemfile
|
526
992
|
for a better development experience on Windows. (Newly generated Gemfiles
|
527
993
|
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f609.png" height="20" width="20">)</p>
|
@@ -570,11 +1036,11 @@ Paul Robert Lloyd.</p>
|
|
570
1036
|
Here are a few of the latest additions from our contributors:</p>
|
571
1037
|
|
572
1038
|
<ul>
|
573
|
-
<li>LiveReload is available as an option during development: with <code class="
|
574
|
-
<li>New <code class="
|
575
|
-
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="
|
1039
|
+
<li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
|
1040
|
+
<li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
|
1041
|
+
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
|
576
1042
|
<li>Jekyll will now check to determine whether host machine has internet connection.</li>
|
577
|
-
<li>A new <code class="
|
1043
|
+
<li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/liquid/filters/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
578
1044
|
<li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
|
579
1045
|
<li>
|
580
1046
|
<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
|
@@ -627,7 +1093,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
627
1093
|
</a>
|
628
1094
|
</div>
|
629
1095
|
<div class="post-content">
|
630
|
-
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="
|
1096
|
+
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="highlighter-rouge">bundle update</code>
|
631
1097
|
if you want to avoid possible build problems with:</p>
|
632
1098
|
|
633
1099
|
<ul>
|
@@ -635,7 +1101,7 @@ if you want to avoid possible build problems with:</p>
|
|
635
1101
|
<li>fully numeric layout names (we convert those to string for you now).</li>
|
636
1102
|
</ul>
|
637
1103
|
|
638
|
-
<p>Other changes include updates to our documentation, like this <a href="
|
1104
|
+
<p>Other changes include updates to our documentation, like this <a href="/tutorials/video-walkthroughs/">complete
|
639
1105
|
video series by Giraffe Academy</a> aimed at
|
640
1106
|
complete beginners. A big thanks to Mike for this.</p>
|
641
1107
|
|
@@ -647,7 +1113,7 @@ working on the next minor version 3.7.0 that will allow you to store all your
|
|
647
1113
|
collections in a single directory. Stay tuned.</p>
|
648
1114
|
|
649
1115
|
<p>Theme developers are invited to test the brand new
|
650
|
-
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="
|
1116
|
+
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
651
1117
|
and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
|
652
1118
|
GitHub hosted theme as a remote theme!</p>
|
653
1119
|
|
@@ -691,7 +1157,7 @@ today.</p>
|
|
691
1157
|
<div class="post-content">
|
692
1158
|
<p>Another much-anticipated release of Jekyll. This release comes with it Rouge 2 support, but note you can continue to use Rouge 1 if you’d prefer. We also now require Ruby 2.1.0 as 2.0.x is no longer supported by the Ruby team.</p>
|
693
1159
|
|
694
|
-
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="
|
1160
|
+
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
|
695
1161
|
|
696
1162
|
<p>Please let us know if you find any bugs! You can see <a href="/docs/history/#v3-6-0">the full history here</a>.</p>
|
697
1163
|
|
@@ -728,12 +1194,12 @@ today.</p>
|
|
728
1194
|
<p>3.5.2 is out with 6 great bug fixes, most notably one which should dramatically speed up generation of your site! In testing #6266, jekyllrb.com generation when from 18 seconds down to 8! Here is the full line-up of fixes:</p>
|
729
1195
|
|
730
1196
|
<ul>
|
731
|
-
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="
|
1197
|
+
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
|
732
1198
|
<li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
|
733
|
-
<li>Backport #6281 for v3.5.x: Fix <code class="
|
734
|
-
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="
|
735
|
-
<li>Backport #6273 for v3.5.x: delegate <code class="
|
736
|
-
<li>Backport #6226 for v3.5.x: <code class="
|
1199
|
+
<li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
1200
|
+
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
|
1201
|
+
<li>Backport #6273 for v3.5.x: delegate <code class="highlighter-rouge">StaticFile#to_json</code> to <code class="highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
|
1202
|
+
<li>Backport #6226 for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
|
737
1203
|
</ul>
|
738
1204
|
|
739
1205
|
<p>A <a href="/docs/history/#v3-5-2">full history</a> is available for your perusal. As always, please file bugs if you encounter them! Opening a pull request with a failing test for your expected behaviour is the easiest way for us to address the issue since we have a reproducible example to test again. Short of that, please fill out our issue template to the best of your ability and we’ll try to get to it quickly!</p>
|
@@ -772,8 +1238,8 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
772
1238
|
<p>We’ve released a few bugfixes in the form of v3.5.1 today:</p>
|
773
1239
|
|
774
1240
|
<ul>
|
775
|
-
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="
|
776
|
-
<li>A bug in <code class="
|
1241
|
+
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
1242
|
+
<li>A bug in <code class="highlighter-rouge">relative_url</code> when <code class="highlighter-rouge">baseurl</code> is <code class="highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
|
777
1243
|
<li>Static files’ liquid representations should now have all the keys you were expecting when serialized into JSON.</li>
|
778
1244
|
</ul>
|
779
1245
|
|
@@ -813,18 +1279,18 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
813
1279
|
the wild. Some new shiny things you might want to test out:</p>
|
814
1280
|
|
815
1281
|
<ul>
|
816
|
-
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="
|
1282
|
+
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> and <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
|
817
1283
|
</li>
|
818
1284
|
<li>Themes can specify runtime dependencies (in their gemspecs) and we’ll require those. This makes it easier for theme writers to use plugins.</li>
|
819
1285
|
<li>Speaking of themes, we’ll properly handle the discrepancy between a convertible file in the local site and a static file in the theme. Overriding a file locally now doesn’t matter if it’s convertible or static.</li>
|
820
|
-
<li>Pages, posts, and other documents can now access layout variables via <code class="
|
821
|
-
<li>The <code class="
|
822
|
-
<li>Filters like <code class="
|
1286
|
+
<li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
|
1287
|
+
<li>The <code class="highlighter-rouge">gems</code> key in the <code class="highlighter-rouge">_config.yml</code> is now <code class="highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="highlighter-rouge">gems</code> to <code class="highlighter-rouge">plugins</code> if you use the former.</li>
|
1288
|
+
<li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
|
823
1289
|
<li>You can now create tab-separated data files.</li>
|
824
|
-
<li>Using <code class="
|
1290
|
+
<li>Using <code class="highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="highlighter-rouge">layout: null</code>, with the exception that <code class="highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
|
825
1291
|
<li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
|
826
|
-
<li>We now automatically exclude the <code class="
|
827
|
-
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="
|
1292
|
+
<li>We now automatically exclude the <code class="highlighter-rouge">Gemfile</code> from the site manifest when compiling your site. No more <code class="highlighter-rouge">_site/Gemfile</code>!</li>
|
1293
|
+
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
|
828
1294
|
</ul>
|
829
1295
|
|
830
1296
|
<p>And <a href="/docs/history/">so much more!</a></p>
|
@@ -871,26 +1337,26 @@ how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://git
|
|
871
1337
|
<div class="post-content">
|
872
1338
|
<p>Another one-PR patch update as we continue our quest to destroy all bugs. A
|
873
1339
|
fairly technical debriefing follows, but the TLDR is that we have updated the
|
874
|
-
<code class="
|
1340
|
+
<code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
875
1341
|
|
876
1342
|
<p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
|
877
1343
|
moved away from using the deprecated
|
878
|
-
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="
|
1344
|
+
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="highlighter-rouge">URI.escape</code></a>
|
879
1345
|
in favor of
|
880
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="
|
881
|
-
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="
|
1346
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
|
1347
|
+
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
|
882
1348
|
filter</a>.</p>
|
883
1349
|
|
884
1350
|
<p>While this transition was mostly a smooth one, the two methods are not
|
885
|
-
identical. While <code class="
|
886
|
-
<code class="
|
1351
|
+
identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
|
1352
|
+
<code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
|
887
1353
|
object, and will then escape each component of that object. In most cases, this
|
888
1354
|
difference was insignificant, but there were a few cases where this caused some
|
889
1355
|
unintended regressions when encoding colons.</p>
|
890
1356
|
|
891
|
-
<p>While <strong>Addressable</strong> can understand that something like <code class="
|
1357
|
+
<p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
|
892
1358
|
relative URI, without the slash it cannot figure out how to turn
|
893
|
-
<code class="
|
1359
|
+
<code class="highlighter-rouge">"example :page"</code> into an <code class="highlighter-rouge">Addressable::URI</code> object. <code class="highlighter-rouge">URI.escape</code> had no such
|
894
1360
|
objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
|
895
1361
|
but breaking in 3.4.0:</p>
|
896
1362
|
|
@@ -900,8 +1366,8 @@ but breaking in 3.4.0:</p>
|
|
900
1366
|
<p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
|
901
1367
|
|
902
1368
|
<p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
|
903
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="
|
904
|
-
which will simply escape the characters in a string, much like <code class="
|
1369
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
1370
|
+
which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
|
905
1371
|
|
906
1372
|
<p>Thanks to <a href="https://github.com/cameronmcefee" class="user-mention">@cameronmcefee</a> and <a href="https://github.com/FriesFlorian" class="user-mention">@FriesFlorian</a> for reporting
|
907
1373
|
<a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
|
@@ -941,21 +1407,21 @@ previous release</a>.</p>
|
|
941
1407
|
<strong>static files now respect front matter defaults</strong>.</p>
|
942
1408
|
|
943
1409
|
<p>You might be asking yourself: “why would static files, files that are
|
944
|
-
static files explicitly because they <em>don’t</em> have
|
945
|
-
to respect
|
1410
|
+
static files explicitly because they <em>don’t</em> have front matter, want
|
1411
|
+
to respect front matter?” That’s a great question. Let me illustrate
|
946
1412
|
with an example.</p>
|
947
1413
|
|
948
|
-
<p>Let’s look at <code class="
|
1414
|
+
<p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
949
1415
|
pages, and static files, and some metadata for them in an XML file for a
|
950
1416
|
Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
|
951
|
-
file in this list, you set <code class="
|
952
|
-
what about static files, which don’t have
|
1417
|
+
file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in front matter. But
|
1418
|
+
what about static files, which don’t have front matter? Before this
|
953
1419
|
release, they could not be excluded because they had no properties in YAML
|
954
1420
|
other than <a href="https://github.com/jekyll/jekyll/blob/v3.4.1/lib/jekyll/static_file.rb#L98-L106">the ones we explicitly assigned</a>.
|
955
1421
|
So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
|
956
|
-
<code class="
|
1422
|
+
<code class="highlighter-rouge">jekyll-sitemap</code>.</p>
|
957
1423
|
|
958
|
-
<p>With this release, you can now set <a href="/docs/configuration
|
1424
|
+
<p>With this release, you can now set <a href="/docs/configuration/front-matter-defaults/">front matter
|
959
1425
|
defaults</a> for static files:</p>
|
960
1426
|
|
961
1427
|
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
|
@@ -966,8 +1432,8 @@ defaults</a> for static files:</p>
|
|
966
1432
|
<span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
|
967
1433
|
</code></pre></div></div>
|
968
1434
|
|
969
|
-
<p>Now, for every file in the Liquid <code class="
|
970
|
-
folder <code class="
|
1435
|
+
<p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
|
1436
|
+
folder <code class="highlighter-rouge">pdfs/</code>, you’ll see <code class="highlighter-rouge">sitemap</code> equal to <code class="highlighter-rouge">false</code>.</p>
|
971
1437
|
|
972
1438
|
<p>Many thanks to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a> for coming up with the solution and ensuring
|
973
1439
|
sitemaps everywhere are filled with just the right content.</p>
|
@@ -1054,7 +1520,7 @@ well.</p>
|
|
1054
1520
|
|
1055
1521
|
<p>Well, not so much.</p>
|
1056
1522
|
|
1057
|
-
<p>A very common way to specify the month of February is <code class="
|
1523
|
+
<p>A very common way to specify the month of February is <code class="highlighter-rouge">2</code>. This is true for
|
1058
1524
|
all single-digit months and days of the month. Notice anything about our
|
1059
1525
|
first regular expression versus our second? The second regular expression
|
1060
1526
|
imposes a <strong>minimum</strong>, as well as maximum, number of digits. This change
|
@@ -1128,10 +1594,10 @@ Packed full of bug fixes as usual, thanks to the tireless efforts of our
|
|
1128
1594
|
exceptional Jekyll community. Three changes to call out:</p>
|
1129
1595
|
|
1130
1596
|
<ol>
|
1131
|
-
<li>If you’re a big fan of <a href="/docs/
|
1132
|
-
even bigger fan of <a href="/docs/
|
1597
|
+
<li>If you’re a big fan of <a href="/docs/liquid/filters/"><code class="highlighter-rouge">where_by_exp</code></a>, you’ll be an
|
1598
|
+
even bigger fan of <a href="/docs/liquid/filters/"><code class="highlighter-rouge">group_by_exp</code></a>.</li>
|
1133
1599
|
<li>Using a custom timezone in Jekyll on Windows? Yeah, sorry that hasn’t ever worked
|
1134
|
-
properly. We made it possible to accurately <a href="
|
1600
|
+
properly. We made it possible to accurately <a href="/docs/installation/windows/#time-zone-management">set the timezone using IANA
|
1135
1601
|
timezone codes</a>.</li>
|
1136
1602
|
<li>Documentation has been improved, notably on themes, includes and permalinks.</li>
|
1137
1603
|
</ol>
|
@@ -1191,7 +1657,7 @@ fixes to call out:</p>
|
|
1191
1657
|
|
1192
1658
|
<ol>
|
1193
1659
|
<li>Only warn about auto-regeneration issues on Windows instead of disabling</li>
|
1194
|
-
<li>Exclude very specific <code class="
|
1660
|
+
<li>Exclude very specific <code class="highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="highlighter-rouge">vendor/</code>
|
1195
1661
|
</li>
|
1196
1662
|
<li>Allow permalink templates to have plaintext underscores</li>
|
1197
1663
|
</ol>
|
@@ -1229,66 +1695,66 @@ fixes to call out:</p>
|
|
1229
1695
|
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
1230
1696
|
Three key things you might want to try:</p>
|
1231
1697
|
|
1232
|
-
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="
|
1698
|
+
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
|
1233
1699
|
|
1234
1700
|
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
1235
1701
|
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
1236
1702
|
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
1237
1703
|
|
1238
1704
|
<p>In an effort to make theme management a bit easier, any files you put into
|
1239
|
-
<code class="
|
1705
|
+
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
1240
1706
|
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
1241
1707
|
webfonts, and so on – anything you’d consider a part of the
|
1242
1708
|
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
1243
|
-
front matter, it will be converted and rendered. No
|
1709
|
+
front matter, it will be converted and rendered. No front matter, and
|
1244
1710
|
it will simply be copied over like a static asset.</p>
|
1245
1711
|
|
1246
1712
|
<p>Note that if a user has a file of the same path, the theme content will not
|
1247
|
-
be included in the site, i.e. a user’s <code class="
|
1248
|
-
processed if present instead of a theme’s <code class="
|
1713
|
+
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
1714
|
+
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
1249
1715
|
|
1250
1716
|
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
1251
1717
|
for more info.</p>
|
1252
1718
|
|
1253
|
-
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="
|
1719
|
+
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
|
1254
1720
|
|
1255
|
-
<p>Want a clean way to prepend the <code class="
|
1721
|
+
<p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
|
1256
1722
|
new filters have you covered. When working locally, if you set your
|
1257
|
-
<code class="
|
1258
|
-
then <code class="
|
1723
|
+
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
1724
|
+
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
1259
1725
|
you pass it:</p>
|
1260
1726
|
|
1261
1727
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /myproject/docs/assets</code></pre></figure>
|
1262
1728
|
|
1263
|
-
<p>By default, <code class="
|
1264
|
-
<code class="
|
1729
|
+
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
1730
|
+
<code class="highlighter-rouge">"/"</code>):</p>
|
1265
1731
|
|
1266
1732
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /docs/assets</code></pre></figure>
|
1267
1733
|
|
1268
|
-
<p>A result of <code class="
|
1269
|
-
relative to the domain root. A similar principle applies to <code class="
|
1270
|
-
It prepends your <code class="
|
1734
|
+
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
1735
|
+
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
1736
|
+
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
|
1271
1737
|
easier to make:</p>
|
1272
1738
|
|
1273
1739
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> => https://jekyllrb.com/myproject/docs/assets</code></pre></figure>
|
1274
1740
|
|
1275
|
-
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="
|
1741
|
+
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
|
1276
1742
|
|
1277
|
-
<p>When you run <code class="
|
1278
|
-
<code class="
|
1279
|
-
development. If you are using the new <code class="
|
1280
|
-
<code class="
|
1281
|
-
which resets the <code class="
|
1743
|
+
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
1744
|
+
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
1745
|
+
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
1746
|
+
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
1747
|
+
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
1282
1748
|
|
1283
|
-
<p>No longer! When you run <code class="
|
1284
|
-
the value of the <code class="
|
1285
|
-
<code class="
|
1286
|
-
will yield <code class="
|
1749
|
+
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
1750
|
+
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
1751
|
+
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
1752
|
+
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
1287
1753
|
|
1288
1754
|
<p>This happens by default when running Jekyll locally. It will not be set if
|
1289
|
-
you set <code class="
|
1290
|
-
any value except <code class="
|
1291
|
-
overwrite the value of <code class="
|
1755
|
+
you set <code class="highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="highlighter-rouge">jekyll serve</code>. If <code class="highlighter-rouge">JEKYLL_ENV</code> is
|
1756
|
+
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
1757
|
+
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
1292
1758
|
to serving, not to building.</p>
|
1293
1759
|
|
1294
1760
|
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
@@ -1391,7 +1857,7 @@ say? Yes, proper, versionable, releasable, first-class themes. We’re pretty
|
|
1391
1857
|
stoked about it and we hope you like building and using them. For now, it
|
1392
1858
|
only supports layouts, includes, and sass, but we have plans to include
|
1393
1859
|
static assets like images and CSS/JS in a future release. <a href="/docs/themes/">Read more about
|
1394
|
-
it in the docs.</a> Our site template generated by <code class="
|
1860
|
+
it in the docs.</a> Our site template generated by <code class="highlighter-rouge">jekyll new</code>
|
1395
1861
|
now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">minima</a> theme.</p>
|
1396
1862
|
|
1397
1863
|
<p>Some other notable changes:</p>
|
@@ -1399,9 +1865,9 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
1399
1865
|
<ul>
|
1400
1866
|
<li>Symlinks are allowed as long as they target a file in the site source</li>
|
1401
1867
|
<li>Explicit support for Ruby 2.0.x was dropped</li>
|
1402
|
-
<li>Added an <code class="
|
1403
|
-
<li>Added a <code class="
|
1404
|
-
<li>Added a <code class="
|
1868
|
+
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
1869
|
+
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
1870
|
+
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
1405
1871
|
post or document based on its path relative to the site source</li>
|
1406
1872
|
<li>… and lots more!</li>
|
1407
1873
|
</ul>
|
@@ -1532,7 +1998,7 @@ release. Thank you!</p>
|
|
1532
1998
|
</div>
|
1533
1999
|
<div class="post-content">
|
1534
2000
|
<p>Upon releasing 3.1.5 and kicking the tires, we noticed a glaring bug: our
|
1535
|
-
beloved <code class="
|
2001
|
+
beloved <code class="highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
1536
2002
|
us and we decided a 3.1.6 was necessary. This release restores sanity to
|
1537
2003
|
our object-to-JSON generation in Liquid and we hope you enjoy.</p>
|
1538
2004
|
|
@@ -1571,7 +2037,7 @@ changelog</a>.</p>
|
|
1571
2037
|
<p>There’s always at least one bug, right? :)</p>
|
1572
2038
|
|
1573
2039
|
<p>Hot on the trails of <a href="/news/2016/05/18/jekyll-3-1-4-released/">v3.1.4</a>, we
|
1574
|
-
bring you v3.1.5! It fixes one bug around requiring the <code class="
|
2040
|
+
bring you v3.1.5! It fixes one bug around requiring the <code class="highlighter-rouge">ExcerptDrop</code>,
|
1575
2041
|
which only affects Linux. For the gory details, see <a href="https://github.com/jekyll/jekyll/pull/4912">the pull
|
1576
2042
|
request for the fix</a>.</p>
|
1577
2043
|
|
@@ -1608,15 +2074,15 @@ request for the fix</a>.</p>
|
|
1608
2074
|
<p>Today, we released v3.1.4 in an effort to bring more stability to the v3.1.x series. This bugfix release consists of:</p>
|
1609
2075
|
|
1610
2076
|
<ul>
|
1611
|
-
<li>A fix for <code class="
|
1612
|
-
<li>A fix for <code class="
|
1613
|
-
<li>A fix where <code class="
|
1614
|
-
<li>We added <code class="
|
2077
|
+
<li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
2078
|
+
<li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where a parent layout (e.g. <code class="highlighter-rouge">default</code> or <code class="highlighter-rouge">base</code>) would overwrite the metadata of the child layout (e.g. <code class="highlighter-rouge">post</code> or <code class="highlighter-rouge">special</code>).</li>
|
2079
|
+
<li>A fix where <code class="highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
2080
|
+
<li>We added <code class="highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
|
1615
2081
|
<li>
|
1616
|
-
<code class="
|
2082
|
+
<code class="highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="highlighter-rouge">docs</code> shows up before <code class="highlighter-rouge">posts</code> reliably.</li>
|
1617
2083
|
</ul>
|
1618
2084
|
|
1619
|
-
<p>The fixes for <code class="
|
2085
|
+
<p>The fixes for <code class="highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
|
1620
2086
|
|
1621
2087
|
<p>We are alwawys striving to make Jekyll more straight-forward to use. Please do open an issue if you believe an aspect of Jekyll’s user experience isn’t up to par.</p>
|
1622
2088
|
|
@@ -1697,7 +2163,7 @@ we think you’ll love.</p>
|
|
1697
2163
|
|
1698
2164
|
<ul>
|
1699
2165
|
<li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
|
1700
|
-
<li>Running <code class="
|
2166
|
+
<li>Running <code class="highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
1701
2167
|
</ul>
|
1702
2168
|
|
1703
2169
|
<p>Both of these issues have been resolved. For more information, check out <a href="/docs/history/#v3-1-3">the full history</a>.</p>
|
@@ -1734,7 +2200,7 @@ we think you’ll love.</p>
|
|
1734
2200
|
|
1735
2201
|
<ul>
|
1736
2202
|
<li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
|
1737
|
-
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="
|
2203
|
+
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
|
1738
2204
|
</ul>
|
1739
2205
|
|
1740
2206
|
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">collections</span><span class="pi">:</span>
|
@@ -1778,8 +2244,8 @@ we think you’ll love.</p>
|
|
1778
2244
|
<li>If a syntax error is encountered by Liquid, it will now print the line number.</li>
|
1779
2245
|
<li>A nasty war between symbols and strings in our configuration hash caused kramdown syntax highlighting to break. That has been resolved; you stand victorious!</li>
|
1780
2246
|
<li>A tilde at the beginning of a filename will no longer crash Jekyll.</li>
|
1781
|
-
<li>The <code class="
|
1782
|
-
<li>Permalinks which end in a slash will now always output as a folder with an <code class="
|
2247
|
+
<li>The <code class="highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
2248
|
+
<li>Permalinks which end in a slash will now always output as a folder with an <code class="highlighter-rouge">index.html</code> inside.</li>
|
1783
2249
|
</ul>
|
1784
2250
|
|
1785
2251
|
<p>Nitty-gritty details, like always, are available in the <a href="/docs/history/">history</a>.</p>
|
@@ -1819,7 +2285,7 @@ fixes:</p>
|
|
1819
2285
|
|
1820
2286
|
<ul>
|
1821
2287
|
<li>Fix problem where outputting to a folder would have two extensions</li>
|
1822
|
-
<li>Handle tildes (<code class="
|
2288
|
+
<li>Handle tildes (<code class="highlighter-rouge">~</code>) in filenames properly</li>
|
1823
2289
|
<li>Fix issue when comparing documents without dates</li>
|
1824
2290
|
<li>Include line numbers in liquid error output</li>
|
1825
2291
|
</ul>
|
@@ -1865,11 +2331,11 @@ you’re having.</p>
|
|
1865
2331
|
wonderful Jekyll users:</p>
|
1866
2332
|
|
1867
2333
|
<ul>
|
1868
|
-
<li>If your <code class="
|
2334
|
+
<li>If your <code class="highlighter-rouge">permalink</code> ended with a <code class="highlighter-rouge">/</code>, your URL didn’t have any extension,
|
1869
2335
|
even if you wanted one</li>
|
1870
|
-
<li>We now strip the BOM by default per Ruby’s <code class="
|
2336
|
+
<li>We now strip the BOM by default per Ruby’s <code class="highlighter-rouge">IO.open</code>.</li>
|
1871
2337
|
<li>
|
1872
|
-
<code class="
|
2338
|
+
<code class="highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
1873
2339
|
</ul>
|
1874
2340
|
|
1875
2341
|
<p>We also updated our <a href="/docs/conduct/">Code of Conduct</a> to the latest version of
|
@@ -1927,13 +2393,13 @@ considerably!</p>
|
|
1927
2393
|
<p>Some other highlights:</p>
|
1928
2394
|
|
1929
2395
|
<ul>
|
1930
|
-
<li>Fix: <code class="
|
1931
|
-
<li>Fix: <code class="
|
1932
|
-
<li>Enhancement: <code class="
|
1933
|
-
<li>Feature: adds new <code class="
|
1934
|
-
<li>Fix: Jekyll will read in files with
|
2396
|
+
<li>Fix: <code class="highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
2397
|
+
<li>Fix: <code class="highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="highlighter-rouge">--source</code>.</li>
|
2398
|
+
<li>Enhancement: <code class="highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
2399
|
+
<li>Feature: adds new <code class="highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
2400
|
+
<li>Fix: Jekyll will read in files with front matter that has extraneous
|
1935
2401
|
spaces after the first line</li>
|
1936
|
-
<li>Enhancement: extract the <code class="
|
2402
|
+
<li>Enhancement: extract the <code class="highlighter-rouge">title</code> attribute from the filename for
|
1937
2403
|
collection items without a date</li>
|
1938
2404
|
<li>Fix: gracefully handle empty configuration files</li>
|
1939
2405
|
</ul>
|
@@ -1988,8 +2454,8 @@ midnightSuyama, musoke, and rebornix</p>
|
|
1988
2454
|
<p>A crucial bug was found in v3.0.1 which caused invalid post dates to go
|
1989
2455
|
unnoticed in the build chain until the error that popped up was unhelpful.
|
1990
2456
|
v3.0.2 <a href="https://github.com/jekyll/jekyll/issues/4375">throws errors as you’d expect</a>
|
1991
|
-
when there is a post like <code class="
|
1992
|
-
invalid date like <code class="
|
2457
|
+
when there is a post like <code class="highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
2458
|
+
invalid date like <code class="highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
1993
2459
|
|
1994
2460
|
<p>This should make the experience of working with Jekyll just a little
|
1995
2461
|
better.</p>
|
@@ -2025,12 +2491,12 @@ better.</p>
|
|
2025
2491
|
<p>Hey, folks! Bunch of bug fixes here. Notables:</p>
|
2026
2492
|
|
2027
2493
|
<ul>
|
2028
|
-
<li>Only superdirectories of <code class="
|
2494
|
+
<li>Only superdirectories of <code class="highlighter-rouge">_posts</code> will be categories.</li>
|
2029
2495
|
<li>
|
2030
|
-
<code class="
|
2496
|
+
<code class="highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
2031
2497
|
<li>
|
2032
|
-
<code class="
|
2033
|
-
<li>Failure in liquid will now always fail the <code class="
|
2498
|
+
<code class="highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
2499
|
+
<li>Failure in liquid will now always fail the <code class="highlighter-rouge">jekyll</code> process.</li>
|
2034
2500
|
<li>All hooks should now be properly registered & documented</li>
|
2035
2501
|
</ul>
|
2036
2502
|
|
@@ -2072,20 +2538,20 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
|
|
2072
2538
|
<p>The much-anticipated Jekyll 3.0 has been released! Key changes:</p>
|
2073
2539
|
|
2074
2540
|
<ul>
|
2075
|
-
<li>Incremental regeneration (experimental, enable with <code class="
|
2076
|
-
<li>Liquid profiler (add <code class="
|
2541
|
+
<li>Incremental regeneration (experimental, enable with <code class="highlighter-rouge">--incremental</code>)</li>
|
2542
|
+
<li>Liquid profiler (add <code class="highlighter-rouge">--profile</code> to a build or serve)</li>
|
2077
2543
|
<li>Hook plugin API (no more monkey-patching!)</li>
|
2078
2544
|
<li>Dependencies reduced from 14 to 8, none contain C extensions. We’re hoping to reduce this even more in the future.</li>
|
2079
2545
|
<li>Changed version support: no support for Ruby 1.9.3, added basic JRuby support. Better Windows support.</li>
|
2080
2546
|
<li>Extension-less URLs</li>
|
2081
2547
|
<li>
|
2082
|
-
<code class="
|
2548
|
+
<code class="highlighter-rouge">site.collections</code> is an array of collections, thus:
|
2083
2549
|
<ul>
|
2084
2550
|
<li>
|
2085
|
-
<code class="
|
2551
|
+
<code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
|
2086
2552
|
</li>
|
2087
2553
|
<li>
|
2088
|
-
<code class="
|
2554
|
+
<code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
|
2089
2555
|
</li>
|
2090
2556
|
</ul>
|
2091
2557
|
</li>
|
@@ -2230,8 +2696,8 @@ Feel free to chime in over on GitHub.</p>
|
|
2230
2696
|
</div>
|
2231
2697
|
<div class="post-content">
|
2232
2698
|
<p>A very minor release, 2.5.2 fixes a bug with path sanitation that 2.5.1
|
2233
|
-
introduced. It also improves the <code class="
|
2234
|
-
posts’ name (e.g. <code class="
|
2699
|
+
introduced. It also improves the <code class="highlighter-rouge">post_url</code> tag such that it checks the
|
2700
|
+
posts’ name (e.g. <code class="highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
2235
2701
|
name. This fixes issues where posts are created and the day changes based
|
2236
2702
|
on timezone discrepancies.</p>
|
2237
2703
|
|
@@ -2318,17 +2784,17 @@ milestone with a pretty big release. What’s changed in 2.5.0? Here are some
|
|
2318
2784
|
highlights:</p>
|
2319
2785
|
|
2320
2786
|
<ul>
|
2321
|
-
<li>Require plugins in the <code class="
|
2322
|
-
<li>
|
2323
|
-
<li>The <code class="
|
2324
|
-
<li>Shorted <code class="
|
2787
|
+
<li>Require plugins in the <code class="highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
2788
|
+
<li>Front matter permalinks can now contain placeholders like <code class="highlighter-rouge">:name</code>. Check out all the placeholders on the <a href="/docs/permalinks/">Permalinks docs page</a>.</li>
|
2789
|
+
<li>The <code class="highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
2790
|
+
<li>Shorted <code class="highlighter-rouge">build</code> and <code class="highlighter-rouge">serve</code> commands with <code class="highlighter-rouge">b</code> and <code class="highlighter-rouge">s</code> aliases, respectively</li>
|
2325
2791
|
<li>WEBrick will now list your directory if it can’t find an index file.</li>
|
2326
|
-
<li>Any enumerable can be used with the <code class="
|
2792
|
+
<li>Any enumerable can be used with the <code class="highlighter-rouge">where</code> filter.</li>
|
2327
2793
|
<li>Performance optimizations thanks to <a href="https://github.com/tmm1" class="user-mention">@tmm1</a>’s <a href="https://github.com/tmm1/stackprof">stackprof</a>
|
2328
2794
|
</li>
|
2329
2795
|
<li>Fix for Rouge’s Redcarpet interface</li>
|
2330
2796
|
<li>Security auditors will love this: path sanitation has now been centralized.</li>
|
2331
|
-
<li>Specify a log level with <code class="
|
2797
|
+
<li>Specify a log level with <code class="highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
2332
2798
|
</ul>
|
2333
2799
|
|
2334
2800
|
<p>…and a whole bunch of other fixes and enhancements you can read more
|
@@ -2336,8 +2802,8 @@ about in <a href="/docs/history/">the changelog!</a></p>
|
|
2336
2802
|
|
2337
2803
|
<p>As always, if you run into issues, please <a href="https://github.com/jekyll/jekyll/issues">check the issues</a>
|
2338
2804
|
and <a href="https://github.com/jekyll/jekyll/issues/new">create an issue if one doesn’t exist for the bug you encountered</a>.
|
2339
|
-
If you just need some help, the extraordinary
|
2340
|
-
you!</
|
2805
|
+
If you just need some help, the extraordinary jekyll help team is here for
|
2806
|
+
you!</p>
|
2341
2807
|
|
2342
2808
|
<p><em>When was the <a href="https://github.com/jekyll/jekyll/commit/d189e05d236769c1e5594af9db4d6eacb86fc16e">first commit to Jekyll</a>?
|
2343
2809
|
All the way back on October 19, 2008. It features interesting historical
|
@@ -2382,14 +2848,14 @@ Custódio, Igor Kapkov, and Kevin Ndung’u!</p>
|
|
2382
2848
|
<p>Well, lookie here! A new release of Jekyll! v2.4.0 contains lots of goodies, including some brilliant new additions:</p>
|
2383
2849
|
|
2384
2850
|
<ul>
|
2385
|
-
<li>A new <code class="
|
2851
|
+
<li>A new <code class="highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
2386
2852
|
<li>Render Liquid in CoffeeScript files (<a href="https://github.com/jekyll/jekyll/issues/2830">#2830</a>)</li>
|
2387
|
-
<li>Add 4 new array Liquid filters: <code class="
|
2388
|
-
<li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="
|
2389
|
-
<li>Add <code class="
|
2390
|
-
<li>Add support for CSV files in the <code class="
|
2391
|
-
<li>Add <code class="
|
2392
|
-
<li>Add a <code class="
|
2853
|
+
<li>Add 4 new array Liquid filters: <code class="highlighter-rouge">push</code>, <code class="highlighter-rouge">pop</code>, <code class="highlighter-rouge">shift</code>, and <code class="highlighter-rouge">unshift</code> (<a href="https://github.com/jekyll/jekyll/pull/2895">#2895</a>)</li>
|
2854
|
+
<li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="highlighter-rouge">-w</code>!</li>
|
2855
|
+
<li>Add <code class="highlighter-rouge">:title</code> and <code class="highlighter-rouge">:name</code> to collection URL template fillers (<a href="https://github.com/jekyll/jekyll/issues/2864">#2864</a> & <a href="https://github.com/jekyll/jekyll/issues/2799">#2799</a>)</li>
|
2856
|
+
<li>Add support for CSV files in the <code class="highlighter-rouge">_data</code> directory (<a href="https://github.com/jekyll/jekyll/issues/2761">#2761</a>)</li>
|
2857
|
+
<li>Add <code class="highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
2858
|
+
<li>Add a <code class="highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
2393
2859
|
</ul>
|
2394
2860
|
|
2395
2861
|
<p>Some other wunderbar bug fixes in there as well. Check out the <a href="/docs/history/">full changelog</a> for the whole scoop.</p>
|
@@ -2433,22 +2899,22 @@ curious bug indeed.</a>
|
|
2433
2899
|
</li>
|
2434
2900
|
<li>Pages, Posts, and Drafts can now be converted by multiple converters.</li>
|
2435
2901
|
<li>Static files can now be safely included in collections. They’ll be placed
|
2436
|
-
in a <code class="
|
2437
|
-
content with
|
2902
|
+
in a <code class="highlighter-rouge">collection.files</code> array. <code class="highlighter-rouge">collection.docs</code> still holds exclusively
|
2903
|
+
content with front matter.</li>
|
2438
2904
|
<li>Sass files can once again be rendered by Liquid. However, neither Sass
|
2439
|
-
nor CoffeeScript can ever have a layout. Bonus: <code class="
|
2905
|
+
nor CoffeeScript can ever have a layout. Bonus: <code class="highlighter-rouge">scssify</code> and <code class="highlighter-rouge">sassify</code>
|
2440
2906
|
Liquid filters.</li>
|
2441
|
-
<li>Partial variables allowed now in the path argument of <code class="
|
2442
|
-
<li>We added a <code class="
|
2443
|
-
about that subcommand. Or don’t, to see the help for <code class="
|
2444
|
-
<li>Lots of fixes to the site template we use for <code class="
|
2907
|
+
<li>Partial variables allowed now in the path argument of <code class="highlighter-rouge">include</code> calls</li>
|
2908
|
+
<li>We added a <code class="highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
2909
|
+
about that subcommand. Or don’t, to see the help for <code class="highlighter-rouge">jekyll</code> itself.</li>
|
2910
|
+
<li>Lots of fixes to the site template we use for <code class="highlighter-rouge">jekyll new</code>, including
|
2445
2911
|
converting the CSS into SCSS.</li>
|
2446
|
-
<li>The <code class="
|
2912
|
+
<li>The <code class="highlighter-rouge">jsonify</code> filter will now call <code class="highlighter-rouge">#to_liquid</code> for you</li>
|
2447
2913
|
<li>Lots, lots more!</li>
|
2448
2914
|
</ul>
|
2449
2915
|
|
2450
2916
|
<p>One change deserves special note. In <a href="https://github.com/jekyll/jekyll/issues/2633">#2633</a>, subfolders <em>inside</em> a
|
2451
|
-
<code class="
|
2917
|
+
<code class="highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
2452
2918
|
turns out, this behaviour was unwanted by a large number of individuals, as
|
2453
2919
|
it is a handy way to organize posts. Ultimately, we decided to revert this
|
2454
2920
|
change in <a href="https://github.com/jekyll/jekyll/issues/2705">#2705</a>, because it was a change in behaviour that was already
|
@@ -2489,7 +2955,7 @@ page</a>! Happy Jekylling!</p>
|
|
2489
2955
|
<li>A warning will now fire if you specify a layout in any of your pages or
|
2490
2956
|
posts that doesn’t exist.</li>
|
2491
2957
|
<li>Certain Pygments options are now whitelisted in safe mode</li>
|
2492
|
-
<li>Categories in a post’s path are now respected (i.e. folders in <code class="
|
2958
|
+
<li>Categories in a post’s path are now respected (i.e. folders in <code class="highlighter-rouge">_posts</code>
|
2493
2959
|
will now work properly).</li>
|
2494
2960
|
</ol>
|
2495
2961
|
|
@@ -2529,7 +2995,7 @@ introduces fixes for a couple security-related issues.</p>
|
|
2529
2995
|
|
2530
2996
|
<ol>
|
2531
2997
|
<li>One in the reading of data</li>
|
2532
|
-
<li>One in the <code class="
|
2998
|
+
<li>One in the <code class="highlighter-rouge">layouts</code> setting</li>
|
2533
2999
|
</ol>
|
2534
3000
|
|
2535
3001
|
<p>They were identified in Jekyll 1.5.1 and has been confirmed as patched
|
@@ -2537,7 +3003,7 @@ in this version and the version used by GitHub Pages. If you are in the
|
|
2537
3003
|
business of building Jekyll sites, please ensure you upgrade to 2.1.1 as
|
2538
3004
|
soon as possible.</p>
|
2539
3005
|
|
2540
|
-
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="
|
3006
|
+
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
2541
3007
|
|
2542
3008
|
<p>Additionally, the dependency on Maruku has been loosened and a bug was
|
2543
3009
|
fixed with document URLs.</p>
|
@@ -2581,13 +3047,13 @@ things to look forward to:</p>
|
|
2581
3047
|
<li>Set front matter defaults for collections (#2419)</li>
|
2582
3048
|
<li>Set a collection-specific URL template (#2418)</li>
|
2583
3049
|
<li>
|
2584
|
-
<code class="
|
3050
|
+
<code class="highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
2585
3051
|
<li>
|
2586
|
-
<code class="
|
2587
|
-
<li>Allow subdirectories in <code class="
|
2588
|
-
<li>Add support for <code class="
|
3052
|
+
<code class="highlighter-rouge">.json</code> files in <code class="highlighter-rouge">_data</code> (#2369)</li>
|
3053
|
+
<li>Allow subdirectories in <code class="highlighter-rouge">_data</code> (#2395)</li>
|
3054
|
+
<li>Add support for <code class="highlighter-rouge">hl_lines</code> in <code class="highlighter-rouge">highlight</code> tag (#2532)</li>
|
2589
3055
|
<li>Post categories now merge with directory, front matter, and defaults (#2373)</li>
|
2590
|
-
<li>New <code class="
|
3056
|
+
<li>New <code class="highlighter-rouge">--skip_initial_build</code> flag for <code class="highlighter-rouge">jekyll serve</code> (#2477)</li>
|
2591
3057
|
<li>A bajilion bug fixes and site updates!</li>
|
2592
3058
|
</ul>
|
2593
3059
|
|
@@ -2669,15 +3135,15 @@ things to look forward to:</p>
|
|
2669
3135
|
<li>
|
2670
3136
|
<a href="/docs/collections/">Collections</a> - Collections allow you to define an unlimited number of custom document types (beyond just posts and pages) for different types of content you may want to author in Jekyll such as API documentation or a cookbook!</li>
|
2671
3137
|
<li>
|
2672
|
-
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="
|
3138
|
+
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
2673
3139
|
<li>
|
2674
3140
|
<a href="/docs/assets/">Native Sass & CoffeeScript support</a> - We love CSS and JavaScript as much as the next guy, but there will always be a special place in our hearts for Sass and CoffeeScript. We now offer native support for these file types — no more messing around with Rake or Grunt!</li>
|
2675
3141
|
<li>
|
2676
|
-
<a href="/docs/configuration
|
3142
|
+
<a href="/docs/configuration/front-matter-defaults/">Front Matter defaults</a> - If you’ve set <code class="highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
|
2677
3143
|
<li>
|
2678
|
-
<a href="/docs/configuration
|
3144
|
+
<a href="/docs/configuration/markdown/">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
|
2679
3145
|
<li>
|
2680
|
-
<a href="/docs/
|
3146
|
+
<a href="/docs/liquid/filters/">Addition of <code class="highlighter-rouge">where</code> and <code class="highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
|
2681
3147
|
<li>
|
2682
3148
|
<a href="https://github.com/jekyll/jekyll/pull/1988">Switch from Maruku to Kramdown as default markdown converter</a> - Maruku is dead. We’ve replaced it with the converter which has the closest feature parity: Kramdown!</li>
|
2683
3149
|
</ol>
|
@@ -2718,7 +3184,7 @@ things to look forward to:</p>
|
|
2718
3184
|
</div>
|
2719
3185
|
<div class="post-content">
|
2720
3186
|
<p>The hawk-eyed <a href="https://github.com/gregose">@gregose</a> spotted a bug in our
|
2721
|
-
<code class="
|
3187
|
+
<code class="highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
2722
3188
|
|
2723
3189
|
<figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="o">></span> <span class="n">sanitized_path</span><span class="p">(</span><span class="s2">"/tmp/foobar/jail"</span><span class="p">,</span> <span class="s2">"..c:/..c:/..c:/etc/passwd"</span><span class="p">)</span>
|
2724
3190
|
<span class="o">=></span> <span class="s2">"/tmp/foobar/jail/../../../etc/passwd"</span></code></pre></figure>
|
@@ -2758,7 +3224,7 @@ the masses. Thanks, Greg!</p>
|
|
2758
3224
|
</div>
|
2759
3225
|
<div class="post-content">
|
2760
3226
|
<p>As work continues on Jekyll 2.0.0, we felt it was important to address two key
|
2761
|
-
issues of Jekyll 1.4.3, namely the <code class="
|
3227
|
+
issues of Jekyll 1.4.3, namely the <code class="highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
2762
3228
|
inability to use Jekyll 1.4.3 on Windows due to a <a href="https://github.com/jekyll/jekyll/issues/1948">fun issue with path sanitizing</a>.</p>
|
2763
3229
|
|
2764
3230
|
<p>For a full changelog, check out our <a href="/docs/history/#v1-5-0">history</a> page.</p>
|
@@ -2803,7 +3269,7 @@ generated output via improper symlink sanitization, potentially resulting in an
|
|
2803
3269
|
inadvertent information disclosure.</p>
|
2804
3270
|
|
2805
3271
|
<p>Versions of Jekyll prior to 1.4.3 may also allow malicious users to write
|
2806
|
-
arbitrary <code class="
|
3272
|
+
arbitrary <code class="highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
2807
3273
|
traversal, potentially overwriting otherwise-trusted content with arbitrary HTML
|
2808
3274
|
or Javascript depending on your server’s configuration.</p>
|
2809
3275
|
|
@@ -2838,8 +3304,8 @@ these vulnerabilities, and to <a href="https://github.com/BenBalter" class="user
|
|
2838
3304
|
<div class="post-content">
|
2839
3305
|
<p>This release fixes <a href="https://github.com/jekyll/jekyll/pull/1830">a regression</a> where Maruku fenced code blocks were turned
|
2840
3306
|
off, instead of the previous default to on. We’ve added a new default
|
2841
|
-
configuration to our <code class="
|
2842
|
-
default to <code class="
|
3307
|
+
configuration to our <code class="highlighter-rouge">maruku</code> config key: <code class="highlighter-rouge">fenced_code_blocks</code> and set it to
|
3308
|
+
default to <code class="highlighter-rouge">true</code>.</p>
|
2843
3309
|
|
2844
3310
|
<p>If you do not wish to use Maruku fenced code blocks, you may turn this option
|
2845
3311
|
off in your site’s configuration file.</p>
|
@@ -2922,7 +3388,7 @@ Jekyll v1.4.0. This release will be the last non-patch release to support Ruby
|
|
2922
3388
|
a ton of bugfixes over the previous 0.6.x releases.</p>
|
2923
3389
|
</li>
|
2924
3390
|
<li>
|
2925
|
-
<p>Non-<code class="
|
3391
|
+
<p>Non-<code class="highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
2926
3392
|
processed, which can provide a rudimentary way to establish a load order for
|
2927
3393
|
plugins.</p>
|
2928
3394
|
</li>
|
@@ -2966,7 +3432,7 @@ Karékinian, Jordon Bedwell, Matthew Iversen, Persa Zula, and Yi Zeng.</p>
|
|
2966
3432
|
release of 1.3.0.</p>
|
2967
3433
|
|
2968
3434
|
<p>In addition to a couple of other smaller bug fixes, the biggest thing
|
2969
|
-
we’ve fixed is an issue with the <code class="
|
3435
|
+
we’ve fixed is an issue with the <code class="highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
2970
3436
|
full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
2971
3437
|
|
2972
3438
|
<p>Thanks to all the people who have contributed to this release! They are
|
@@ -3010,33 +3476,33 @@ love.</p>
|
|
3010
3476
|
<ul>
|
3011
3477
|
<li>
|
3012
3478
|
<p>You can add <a href="/docs/datafiles/">arbitrary data</a> to the site by adding YAML files under a
|
3013
|
-
site’s <code class="
|
3479
|
+
site’s <code class="highlighter-rouge">_data</code> directory. This will allow you to avoid
|
3014
3480
|
repetition in your templates and to set site specific options without
|
3015
|
-
changing <code class="
|
3481
|
+
changing <code class="highlighter-rouge">_config.yml</code>.</p>
|
3016
3482
|
</li>
|
3017
3483
|
<li>
|
3018
|
-
<p>You can now run <code class="
|
3019
|
-
background. <strong>Note:</strong> you’ll need to run <code class="
|
3484
|
+
<p>You can now run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
3485
|
+
background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut
|
3020
3486
|
the server down. When ran, you’ll get a process id that you can use in
|
3021
|
-
place of <code class="
|
3487
|
+
place of <code class="highlighter-rouge">[server_pid]</code></p>
|
3022
3488
|
</li>
|
3023
3489
|
<li>
|
3024
3490
|
<p>You can now <strong>disable automatically-generated excerpts</strong> if you set
|
3025
|
-
<code class="
|
3491
|
+
<code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</p>
|
3026
3492
|
</li>
|
3027
3493
|
<li>
|
3028
3494
|
<p>If you’re moving pages and posts, you can now check for <strong>URL
|
3029
|
-
conflicts</strong> by running <code class="
|
3495
|
+
conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</p>
|
3030
3496
|
</li>
|
3031
3497
|
<li>
|
3032
3498
|
<p>If you’re a fan of the drafts feature, you’ll be happy to know we’ve
|
3033
|
-
added <code class="
|
3499
|
+
added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</p>
|
3034
3500
|
</li>
|
3035
3501
|
<li>
|
3036
3502
|
<p>Permalinks with special characters should now generate without errors.</p>
|
3037
3503
|
</li>
|
3038
3504
|
<li>
|
3039
|
-
<p>Expose the current Jekyll version as the <code class="
|
3505
|
+
<p>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid
|
3040
3506
|
variable.</p>
|
3041
3507
|
</li>
|
3042
3508
|
</ul>
|
@@ -3107,11 +3573,11 @@ issues!</p>
|
|
3107
3573
|
<div class="post-content">
|
3108
3574
|
<p>Quick turnover, anyone? A <a href="https://github.com/jekyll/jekyll/pull/1525">recent incompatibility with Liquid
|
3109
3575
|
v2.5.2</a> produced a nasty bug in
|
3110
|
-
which <code class="
|
3576
|
+
which <code class="highlighter-rouge">include</code> tags were not rendered properly within <code class="highlighter-rouge">if</code> blocks.</p>
|
3111
3577
|
|
3112
3578
|
<p>This release also includes a better handling of detached servers (prints pid and
|
3113
|
-
the command for killing the process). <strong>Note</strong>: the <code class="
|
3114
|
-
<code class="
|
3579
|
+
the command for killing the process). <strong>Note</strong>: the <code class="highlighter-rouge">--detach</code> flag and
|
3580
|
+
<code class="highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
3115
3581
|
|
3116
3582
|
<p>For a full list of the fixes in this release, check out <a href="/docs/history/">the change
|
3117
3583
|
log</a>!</p>
|
@@ -3149,12 +3615,12 @@ enhancements that we think you’ll love.</p>
|
|
3149
3615
|
<p>Here are a few things we think you’ll want to know about this release:</p>
|
3150
3616
|
|
3151
3617
|
<ul>
|
3152
|
-
<li>Run <code class="
|
3153
|
-
<li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="
|
3154
|
-
<li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="
|
3155
|
-
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="
|
3618
|
+
<li>Run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut the server down.</li>
|
3619
|
+
<li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</li>
|
3620
|
+
<li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</li>
|
3621
|
+
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</li>
|
3156
3622
|
<li>Permalinks with special characters should now generate without errors.</li>
|
3157
|
-
<li>Expose the current Jekyll version as the <code class="
|
3623
|
+
<li>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
3158
3624
|
</ul>
|
3159
3625
|
|
3160
3626
|
<p>For a full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
@@ -3187,9 +3653,9 @@ enhancements that we think you’ll love.</p>
|
|
3187
3653
|
<div class="post-content">
|
3188
3654
|
<p>Version 1.1.2 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
|
3189
3655
|
|
3190
|
-
<p>Community and custom plugins extending the <code class="
|
3656
|
+
<p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
3191
3657
|
|
3192
|
-
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="
|
3658
|
+
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3193
3659
|
|
3194
3660
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
3195
3661
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
@@ -3223,9 +3689,9 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
|
|
3223
3689
|
<div class="post-content">
|
3224
3690
|
<p>Version 1.0.4 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
|
3225
3691
|
|
3226
|
-
<p>Community and custom plugins extending the <code class="
|
3692
|
+
<p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
3227
3693
|
|
3228
|
-
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="
|
3694
|
+
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3229
3695
|
|
3230
3696
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
3231
3697
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
@@ -3301,12 +3767,12 @@ more a more detailed changelog for this release.</p>
|
|
3301
3767
|
Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new additions:</p>
|
3302
3768
|
|
3303
3769
|
<ul>
|
3304
|
-
<li>Add <code class="
|
3305
|
-
<li>Support passing parameters to templates in <code class="
|
3770
|
+
<li>Add <code class="highlighter-rouge">docs</code> subcommand to read Jekyll’s docs when offline. (<a href="https://github.com/jekyll/jekyll/issues/1046">#1046</a>)</li>
|
3771
|
+
<li>Support passing parameters to templates in <code class="highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
|
3306
3772
|
<li>Add support for Liquid tags to post excerpts (<a href="https://github.com/jekyll/jekyll/issues/1302">#1302</a>)</li>
|
3307
3773
|
<li>Fix pagination for subdirectories (<a href="https://github.com/jekyll/jekyll/issues/1198">#1198</a>)</li>
|
3308
3774
|
<li>Provide better error reporting when generating sites (<a href="https://github.com/jekyll/jekyll/issues/1253">#1253</a>)</li>
|
3309
|
-
<li>Latest posts first in non-LSI <code class="
|
3775
|
+
<li>Latest posts first in non-LSI <code class="highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
|
3310
3776
|
</ul>
|
3311
3777
|
|
3312
3778
|
<p>See the <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.0">GitHub Release</a> page for more a more detailed changelog for this release.</p>
|
@@ -3342,10 +3808,10 @@ Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new add
|
|
3342
3808
|
|
3343
3809
|
<ul>
|
3344
3810
|
<li>Fail with non-zero exit code when MaRuKu errors (<a href="https://github.com/jekyll/jekyll/issues/1190">#1190</a>) or Liquid errors (<a href="https://github.com/jekyll/jekyll/issues/1121">#1121</a>)</li>
|
3345
|
-
<li>Add support for private gists to <code class="
|
3346
|
-
<li>Add <code class="
|
3347
|
-
<li>Fix compatibility with <code class="
|
3348
|
-
<li>Fix pagination issue regarding <code class="
|
3811
|
+
<li>Add support for private gists to <code class="highlighter-rouge">gist</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1189">#1189</a>)</li>
|
3812
|
+
<li>Add <code class="highlighter-rouge">--force</code> option to <code class="highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/1115">#1115</a>)</li>
|
3813
|
+
<li>Fix compatibility with <code class="highlighter-rouge">exclude</code> and <code class="highlighter-rouge">include</code> with pre-1.0 Jekyll (<a href="https://github.com/jekyll/jekyll/issues/1114">#1114</a>)</li>
|
3814
|
+
<li>Fix pagination issue regarding <code class="highlighter-rouge">File.basename</code> and <code class="highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
|
3349
3815
|
</ul>
|
3350
3816
|
|
3351
3817
|
<p>See the <a href="/docs/history/#v1-0-3">History</a> page for more information on this release.</p>
|
@@ -3382,11 +3848,11 @@ releases, and fix some other annoying bugs:</p>
|
|
3382
3848
|
|
3383
3849
|
<ul>
|
3384
3850
|
<li>Backwards-compatibilize relative permalinks (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
3385
|
-
<li>Add <code class="
|
3386
|
-
<li>Deprecate old config <code class="
|
3851
|
+
<li>Add <code class="highlighter-rouge">jekyll doctor</code> command to check site for any known compatibility problems (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
3852
|
+
<li>Deprecate old config <code class="highlighter-rouge">server_port</code>, match to <code class="highlighter-rouge">port</code> if <code class="highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
|
3387
3853
|
<li>Update pygments.rb and kramdon versions to 0.5.0 and 1.0.2, respectively (<a href="https://github.com/jekyll/jekyll/issues/1061">#1061</a>, <a href="https://github.com/jekyll/jekyll/issues/1067">#1067</a>)</li>
|
3388
3854
|
<li>Fix issue when post categories are numbers (<a href="https://github.com/jekyll/jekyll/issues/1078">#1078</a>)</li>
|
3389
|
-
<li>Add a <code class="
|
3855
|
+
<li>Add a <code class="highlighter-rouge">data-lang="<lang>"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
|
3390
3856
|
<li>Catching that Redcarpet gem isn’t installed (<a href="https://github.com/jekyll/jekyll/issues/1059">#1059</a>)</li>
|
3391
3857
|
</ul>
|
3392
3858
|
|
@@ -3422,13 +3888,13 @@ releases, and fix some other annoying bugs:</p>
|
|
3422
3888
|
<p>Hot on the trails of v1.0, v1.0.1 is out! Here are the highlights:</p>
|
3423
3889
|
|
3424
3890
|
<ul>
|
3425
|
-
<li>Add newer <code class="
|
3891
|
+
<li>Add newer <code class="highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
|
3426
3892
|
<li>Commander error message now preferred over process abort with incorrect args (<a href="https://github.com/jekyll/jekyll/issues/1040">#1040</a>)</li>
|
3427
3893
|
<li>Do not force use of toc_token when using generate_toc in RDiscount (<a href="https://github.com/jekyll/jekyll/issues/1048">#1048</a>)</li>
|
3428
3894
|
<li>Make Redcarpet respect the pygments configuration option (<a href="https://github.com/jekyll/jekyll/issues/1053">#1053</a>)</li>
|
3429
3895
|
<li>Fix the index build with LSI (<a href="https://github.com/jekyll/jekyll/issues/1045">#1045</a>)</li>
|
3430
3896
|
<li>Don’t print deprecation warning when no arguments are specified. (<a href="https://github.com/jekyll/jekyll/issues/1041">#1041</a>)</li>
|
3431
|
-
<li>Add missing <code class="
|
3897
|
+
<li>Add missing <code class="highlighter-rouge"></div></code> to site template used by <code class="highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
|
3432
3898
|
</ul>
|
3433
3899
|
|
3434
3900
|
<p>See the <a href="/docs/history/#v1-0-1">History</a> page for more information on this release.</p>
|
@@ -3485,7 +3951,7 @@ examples and for compiling this list):</p>
|
|
3485
3951
|
<div class="unit one-fifth hide-on-mobiles">
|
3486
3952
|
<aside>
|
3487
3953
|
<ul>
|
3488
|
-
<li
|
3954
|
+
<li>
|
3489
3955
|
<a href="/news/">All News</a>
|
3490
3956
|
</li>
|
3491
3957
|
<li class="current">
|
@@ -3495,24 +3961,24 @@ examples and for compiling this list):</p>
|
|
3495
3961
|
<h4>Recent Releases</h4>
|
3496
3962
|
<ul>
|
3497
3963
|
|
3498
|
-
<li
|
3499
|
-
<a href="/news/2019/
|
3964
|
+
<li>
|
3965
|
+
<a href="/news/2019/08/20/jekyll-4-0-0-released/">Version 4.0.0</a>
|
3500
3966
|
</li>
|
3501
3967
|
|
3502
|
-
<li
|
3503
|
-
<a href="/news/
|
3968
|
+
<li>
|
3969
|
+
<a href="/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/">Version 4.0.0.pre.beta1</a>
|
3504
3970
|
</li>
|
3505
3971
|
|
3506
|
-
<li
|
3507
|
-
<a href="/news/
|
3972
|
+
<li>
|
3973
|
+
<a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
|
3508
3974
|
</li>
|
3509
3975
|
|
3510
|
-
<li
|
3511
|
-
<a href="/news/
|
3976
|
+
<li>
|
3977
|
+
<a href="/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/">Version 4.0.0.pre.alpha1</a>
|
3512
3978
|
</li>
|
3513
3979
|
|
3514
|
-
<li
|
3515
|
-
<a href="/news/2018/
|
3980
|
+
<li>
|
3981
|
+
<a href="/news/2018/11/04/jekyll-3-8-5-released/">Version 3.8.5</a>
|
3516
3982
|
</li>
|
3517
3983
|
|
3518
3984
|
<li>
|
@@ -3521,189 +3987,213 @@ examples and for compiling this list):</p>
|
|
3521
3987
|
</ul>
|
3522
3988
|
<h4>Other News</h4>
|
3523
3989
|
<ul>
|
3990
|
+
|
3524
3991
|
|
3992
|
+
|
3525
3993
|
|
3994
|
+
|
3526
3995
|
|
3996
|
+
|
3527
3997
|
|
3998
|
+
|
3528
3999
|
|
4000
|
+
|
3529
4001
|
|
4002
|
+
|
3530
4003
|
|
4004
|
+
<li>
|
4005
|
+
<a href="/news/2018/08/01/jekyll-sponsoring/">Sponsoring Jekyll's development</a>
|
4006
|
+
</li>
|
3531
4007
|
|
4008
|
+
|
3532
4009
|
|
4010
|
+
|
3533
4011
|
|
4012
|
+
|
3534
4013
|
|
4014
|
+
|
3535
4015
|
|
3536
|
-
<li
|
3537
|
-
<a href="/news/2018/
|
4016
|
+
<li>
|
4017
|
+
<a href="/news/2018/04/19/development-update/">Jekyll 4.0 is on the Horizon!</a>
|
3538
4018
|
</li>
|
3539
4019
|
|
4020
|
+
|
3540
4021
|
|
4022
|
+
|
3541
4023
|
|
4024
|
+
|
3542
4025
|
|
4026
|
+
<li>
|
4027
|
+
<a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
|
4028
|
+
</li>
|
3543
4029
|
|
4030
|
+
|
3544
4031
|
|
4032
|
+
|
3545
4033
|
|
4034
|
+
|
3546
4035
|
|
4036
|
+
|
3547
4037
|
|
3548
|
-
<li
|
4038
|
+
<li>
|
3549
4039
|
<a href="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</a>
|
3550
4040
|
</li>
|
3551
4041
|
|
4042
|
+
|
3552
4043
|
|
4044
|
+
|
3553
4045
|
|
4046
|
+
|
3554
4047
|
|
4048
|
+
|
3555
4049
|
|
4050
|
+
|
3556
4051
|
|
4052
|
+
|
3557
4053
|
|
4054
|
+
|
3558
4055
|
|
4056
|
+
|
3559
4057
|
|
4058
|
+
|
3560
4059
|
|
4060
|
+
|
3561
4061
|
|
4062
|
+
|
3562
4063
|
|
3563
|
-
|
3564
|
-
|
3565
|
-
|
3566
|
-
|
3567
|
-
|
3568
|
-
|
3569
|
-
|
3570
|
-
|
3571
|
-
|
3572
|
-
|
3573
|
-
|
3574
|
-
<li class="">
|
4064
|
+
<li>
|
3575
4065
|
<a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
|
3576
4066
|
</li>
|
3577
4067
|
|
4068
|
+
|
3578
4069
|
|
4070
|
+
|
3579
4071
|
|
4072
|
+
|
3580
4073
|
|
3581
|
-
|
3582
|
-
|
3583
|
-
|
3584
|
-
<li class="">
|
4074
|
+
<li>
|
3585
4075
|
<a href="/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll's Google Summer of Code Project: The CMS You Always Wanted</a>
|
3586
4076
|
</li>
|
3587
4077
|
|
4078
|
+
|
3588
4079
|
|
4080
|
+
|
3589
4081
|
|
4082
|
+
|
3590
4083
|
|
4084
|
+
|
3591
4085
|
|
4086
|
+
|
3592
4087
|
|
4088
|
+
|
3593
4089
|
|
4090
|
+
|
3594
4091
|
|
3595
|
-
|
3596
|
-
|
3597
|
-
|
3598
|
-
|
3599
|
-
|
3600
|
-
|
3601
|
-
|
3602
|
-
<li class="">
|
4092
|
+
<li>
|
3603
4093
|
<a href="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</a>
|
3604
4094
|
</li>
|
3605
4095
|
|
4096
|
+
|
3606
4097
|
|
4098
|
+
|
3607
4099
|
|
4100
|
+
|
3608
4101
|
|
4102
|
+
|
3609
4103
|
|
4104
|
+
|
3610
4105
|
|
4106
|
+
|
3611
4107
|
|
4108
|
+
|
3612
4109
|
|
4110
|
+
|
3613
4111
|
|
3614
|
-
|
3615
|
-
|
3616
|
-
|
3617
|
-
|
3618
|
-
|
3619
|
-
|
3620
|
-
|
3621
|
-
|
3622
|
-
<li class="">
|
4112
|
+
<li>
|
3623
4113
|
<a href="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</a>
|
3624
4114
|
</li>
|
3625
4115
|
|
4116
|
+
|
3626
4117
|
|
4118
|
+
|
3627
4119
|
|
3628
|
-
|
3629
|
-
|
3630
|
-
<li class="">
|
4120
|
+
<li>
|
3631
4121
|
<a href="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet & Greet at GitHub HQ</a>
|
3632
4122
|
</li>
|
3633
4123
|
|
4124
|
+
|
3634
4125
|
|
4126
|
+
|
3635
4127
|
|
3636
|
-
|
3637
|
-
|
3638
|
-
<li class="">
|
4128
|
+
<li>
|
3639
4129
|
<a href="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</a>
|
3640
4130
|
</li>
|
3641
4131
|
|
4132
|
+
|
3642
4133
|
|
4134
|
+
|
3643
4135
|
|
4136
|
+
|
3644
4137
|
|
4138
|
+
|
3645
4139
|
|
4140
|
+
|
3646
4141
|
|
4142
|
+
|
3647
4143
|
|
4144
|
+
|
3648
4145
|
|
4146
|
+
|
3649
4147
|
|
4148
|
+
|
3650
4149
|
|
3651
|
-
|
3652
|
-
|
3653
|
-
|
3654
|
-
|
3655
|
-
|
3656
|
-
|
3657
|
-
|
3658
|
-
|
3659
|
-
|
3660
|
-
<li class="">
|
4150
|
+
<li>
|
3661
4151
|
<a href="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</a>
|
3662
4152
|
</li>
|
3663
4153
|
|
4154
|
+
|
3664
4155
|
|
4156
|
+
|
3665
4157
|
|
4158
|
+
|
3666
4159
|
|
4160
|
+
|
3667
4161
|
|
4162
|
+
|
3668
4163
|
|
4164
|
+
|
3669
4165
|
|
4166
|
+
|
3670
4167
|
|
4168
|
+
|
3671
4169
|
|
4170
|
+
|
3672
4171
|
|
4172
|
+
|
3673
4173
|
|
4174
|
+
|
3674
4175
|
|
4176
|
+
|
3675
4177
|
|
4178
|
+
|
3676
4179
|
|
4180
|
+
|
3677
4181
|
|
4182
|
+
|
3678
4183
|
|
4184
|
+
|
3679
4185
|
|
4186
|
+
|
3680
4187
|
|
4188
|
+
|
3681
4189
|
|
4190
|
+
|
3682
4191
|
|
4192
|
+
|
3683
4193
|
|
4194
|
+
|
3684
4195
|
|
3685
|
-
|
3686
|
-
|
3687
|
-
|
3688
|
-
|
3689
|
-
|
3690
|
-
|
3691
|
-
|
3692
|
-
|
3693
|
-
|
3694
|
-
|
3695
|
-
|
3696
|
-
|
3697
|
-
|
3698
|
-
|
3699
|
-
|
3700
|
-
|
3701
|
-
|
3702
|
-
|
3703
|
-
|
3704
|
-
|
3705
|
-
|
3706
|
-
|
4196
|
+
|
3707
4197
|
</ul>
|
3708
4198
|
</aside>
|
3709
4199
|
</div>
|
@@ -3718,7 +4208,8 @@ examples and for compiling this list):</p>
|
|
3718
4208
|
<footer>
|
3719
4209
|
<div class="grid">
|
3720
4210
|
<div class="unit one-third center-on-mobiles">
|
3721
|
-
<p>
|
4211
|
+
<p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
|
4212
|
+
<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>
|
3722
4213
|
</div>
|
3723
4214
|
<div class="unit two-thirds align-right center-on-mobiles">
|
3724
4215
|
<p>
|
@@ -3728,6 +4219,14 @@ examples and for compiling this list):</p>
|
|
3728
4219
|
</a>
|
3729
4220
|
</p>
|
3730
4221
|
</div>
|
4222
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
4223
|
+
<p>
|
4224
|
+
Jekyll is funded thanks to its
|
4225
|
+
<a href="https://github.com/jekyll/jekyll#sponsors">
|
4226
|
+
sponsors!
|
4227
|
+
</a>
|
4228
|
+
</p>
|
4229
|
+
</div>
|
3731
4230
|
</div>
|
3732
4231
|
</footer>
|
3733
4232
|
|