jekyll-docs 3.8.1 → 3.9.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/site/404.html +5 -4
- data/site/community/index.html +1 -1
- data/site/conduct/index.html +1 -1
- data/site/docs/assets/index.html +35 -35
- data/site/docs/code_of_conduct/index.html +8 -7
- data/site/docs/collections/index.html +44 -43
- data/site/docs/conduct/index.html +8 -7
- data/site/docs/configuration/index.html +81 -81
- data/site/docs/continuous-integration/buddyworks/index.html +10 -9
- data/site/docs/continuous-integration/circleci/index.html +13 -12
- data/site/docs/continuous-integration/index.html +8 -7
- data/site/docs/continuous-integration/travis-ci/index.html +32 -31
- data/site/docs/contributing/index.html +47 -47
- data/site/docs/datafiles/index.html +24 -23
- data/site/docs/deployment-methods/index.html +30 -29
- data/site/docs/drafts/index.html +11 -10
- data/site/docs/extras/index.html +9 -8
- data/site/docs/frontmatter/index.html +8 -7
- data/site/docs/github-pages/index.html +32 -32
- data/site/docs/history/index.html +722 -656
- data/site/docs/home/index.html +8 -7
- data/site/docs/includes/index.html +44 -43
- data/site/docs/index.html +1 -1
- data/site/docs/installation/index.html +16 -15
- data/site/docs/maintaining/affinity-team-captain/index.html +24 -24
- data/site/docs/maintaining/avoiding-burnout/index.html +8 -7
- data/site/docs/maintaining/becoming-a-maintainer/index.html +22 -22
- data/site/docs/maintaining/index.html +8 -7
- data/site/docs/maintaining/merging-a-pull-request/index.html +36 -36
- data/site/docs/maintaining/releasing-a-new-version/index.html +32 -32
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +23 -23
- data/site/docs/maintaining/special-labels/index.html +27 -27
- data/site/docs/maintaining/triaging-an-issue/index.html +25 -25
- data/site/docs/migrations/index.html +9 -8
- data/site/docs/pages/index.html +12 -11
- data/site/docs/pagination/index.html +25 -24
- data/site/docs/permalinks/index.html +33 -32
- data/site/docs/plugins/index.html +70 -70
- data/site/docs/posts/index.html +50 -50
- data/site/docs/quickstart/index.html +18 -17
- data/site/docs/resources/index.html +9 -8
- data/site/docs/sites/index.html +8 -7
- data/site/docs/static-files/index.html +14 -13
- data/site/docs/structure/index.html +8 -7
- data/site/docs/support/index.html +9 -8
- data/site/docs/templates/index.html +44 -43
- data/site/docs/themes/index.html +76 -76
- data/site/docs/troubleshooting/index.html +48 -47
- data/site/docs/upgrading/0-to-2/index.html +51 -50
- data/site/docs/upgrading/2-to-3/index.html +35 -34
- data/site/docs/upgrading/index.html +11 -10
- data/site/docs/usage/index.html +15 -14
- data/site/docs/variables/index.html +8 -7
- data/site/docs/windows/index.html +29 -28
- data/site/feed.xml +53 -65
- data/site/github.html +1 -1
- data/site/help/index.html +19 -19
- data/site/index.html +7 -6
- data/site/issues.html +1 -1
- data/site/jekyllconf/index.html +9 -8
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +42 -29
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +27 -13
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +28 -14
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +29 -15
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +28 -14
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +25 -11
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +27 -13
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +27 -13
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +30 -16
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +28 -14
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +25 -11
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +34 -20
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +26 -12
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +26 -12
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +25 -11
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +27 -13
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +43 -30
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +26 -12
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +43 -30
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +46 -33
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +25 -11
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +42 -29
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +30 -16
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +27 -13
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +26 -12
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +33 -19
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +32 -18
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +48 -35
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +25 -11
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +27 -13
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +42 -29
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +25 -11
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +42 -29
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +25 -11
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +42 -29
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +30 -16
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +29 -15
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +27 -13
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +30 -16
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +47 -34
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +26 -12
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +27 -13
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +25 -11
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +26 -12
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +26 -12
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +25 -11
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +31 -17
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +26 -12
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +26 -12
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +42 -29
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +29 -15
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +43 -30
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +42 -29
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +51 -37
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +26 -12
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +27 -13
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +43 -30
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +47 -34
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +52 -39
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +51 -38
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +27 -13
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +30 -16
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +26 -12
- data/site/news/2017/10/19/diversity-open-source/index.html +27 -13
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +45 -32
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +48 -35
- data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +53 -40
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +42 -29
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +50 -37
- data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +47 -34
- data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +620 -0
- data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +615 -0
- data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +623 -0
- data/site/news/index.html +351 -230
- data/site/news/releases/index.html +349 -228
- data/site/philosophy.html +1 -1
- data/site/sitemap.xml +72 -60
- data/site/team/index.html +19 -19
- data/site/tutorials/convert-site-to-jekyll/index.html +97 -96
- data/site/tutorials/custom-404-page/index.html +16 -15
- data/site/tutorials/home/index.html +10 -9
- data/site/tutorials/index.html +1 -1
- data/site/tutorials/navigation/index.html +102 -101
- data/site/tutorials/orderofinterpretation/index.html +32 -31
- data/site/tutorials/using-jekyll-with-bundler/index.html +19 -18
- data/site/tutorials/video-walkthroughs/index.html +8 -7
- metadata +13 -25
data/site/news/index.html
CHANGED
@@ -1,34 +1,34 @@
|
|
1
1
|
<!DOCTYPE HTML>
|
2
2
|
<html lang="en-US">
|
3
3
|
<head>
|
4
|
-
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
4
|
<meta charset="UTF-8">
|
6
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
7
|
-
<meta name="generator" content="Jekyll v3.
|
8
|
-
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites"
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
7
|
+
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
9
8
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
10
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
11
10
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
12
|
-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css"
|
11
|
+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
13
12
|
<link rel="stylesheet" href="/css/screen.css">
|
14
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
15
|
-
<!-- Begin Jekyll SEO tag v2.
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
16
15
|
<title>News | Jekyll • Simple, blog-aware, static sites</title>
|
17
|
-
<meta name="generator" content="Jekyll v3.
|
18
|
-
<meta property="og:title" content="News"
|
19
|
-
<meta name="author" content="all"
|
20
|
-
<meta property="og:locale" content="en_US"
|
21
|
-
<meta name="description" content="Transform your plain text into static websites and blogs"
|
22
|
-
<meta property="og:description" content="Transform your plain text into static websites and blogs"
|
23
|
-
<link rel="canonical" href="https://jekyllrb.com/news/"
|
24
|
-
<meta property="og:url" content="https://jekyllrb.com/news/"
|
25
|
-
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites"
|
26
|
-
<meta name="twitter:card" content="summary"
|
27
|
-
<meta
|
28
|
-
<meta name="twitter:
|
29
|
-
<meta name="
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
17
|
+
<meta property="og:title" content="News" />
|
18
|
+
<meta name="author" content="all" />
|
19
|
+
<meta property="og:locale" content="en_US" />
|
20
|
+
<meta name="description" content="Transform your plain text into static websites and blogs" />
|
21
|
+
<meta property="og:description" content="Transform your plain text into static websites and blogs" />
|
22
|
+
<link rel="canonical" href="https://jekyllrb.com/news/" />
|
23
|
+
<meta property="og:url" content="https://jekyllrb.com/news/" />
|
24
|
+
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
25
|
+
<meta name="twitter:card" content="summary" />
|
26
|
+
<meta property="twitter:title" content="News" />
|
27
|
+
<meta name="twitter:site" content="@jekyllrb" />
|
28
|
+
<meta name="twitter:creator" content="@all" />
|
29
|
+
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
30
30
|
<script type="application/ld+json">
|
31
|
-
{"
|
31
|
+
{"url":"https://jekyllrb.com/news/","headline":"News","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"https://schema.org"}</script>
|
32
32
|
<!-- End Jekyll SEO tag -->
|
33
33
|
|
34
34
|
<!--[if lt IE 9]>
|
@@ -73,7 +73,7 @@
|
|
73
73
|
<div class="meta hide-on-mobiles">
|
74
74
|
<ul>
|
75
75
|
<li>
|
76
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
76
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
|
77
77
|
</li>
|
78
78
|
<li>
|
79
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
@@ -113,6 +113,12 @@
|
|
113
113
|
<option value="/news/">Home</option>
|
114
114
|
<optgroup label="v1.x">
|
115
115
|
|
116
|
+
<option value="/news/2019/07/02/jekyll-3-8-6-released/">Jekyll 3.8.6 Released</option>
|
117
|
+
|
118
|
+
<option value="/news/2018/06/05/jekyll-3-8-3-released/">Jekyll 3.8.3 Released</option>
|
119
|
+
|
120
|
+
<option value="/news/2018/05/19/jekyll-3-8-2-released/">Jekyll 3.8.2 Released</option>
|
121
|
+
|
116
122
|
<option value="/news/2018/05/01/jekyll-3-8-1-released/">Jekyll 3.8.1 Released</option>
|
117
123
|
|
118
124
|
<option value="/news/2018/02/24/jekyll-3-7-3-released/">Jekyll 3.7.3 Released</option>
|
@@ -260,6 +266,115 @@
|
|
260
266
|
|
261
267
|
<div class="unit four-fifths">
|
262
268
|
|
269
|
+
<article>
|
270
|
+
<h2>
|
271
|
+
<a href="/news/2019/07/02/jekyll-3-8-6-released/">
|
272
|
+
Jekyll 3.8.6 Released
|
273
|
+
</a>
|
274
|
+
</h2>
|
275
|
+
<span class="post-category">
|
276
|
+
<span class="label">
|
277
|
+
release
|
278
|
+
</span>
|
279
|
+
</span>
|
280
|
+
<div class="post-meta">
|
281
|
+
<span class="post-date">
|
282
|
+
02 Jul 2019
|
283
|
+
</span>
|
284
|
+
|
285
|
+
<a href="https://github.com/parkr" class="post-author">
|
286
|
+
<img class="avatar avatar-small" alt="parkr" width="24" height="24" data-proofer-ignore="true" src="https://avatars3.githubusercontent.com/parkr?v=3&s=24" srcset="https://avatars3.githubusercontent.com/parkr?v=3&s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&s=96 4x">
|
287
|
+
parkr
|
288
|
+
</a>
|
289
|
+
</div>
|
290
|
+
<div class="post-content">
|
291
|
+
<p>We have another patch release in the 3.8 series! This time, we have one security patch
|
292
|
+
and a handful of bug patches, including:</p>
|
293
|
+
|
294
|
+
<ul>
|
295
|
+
<li>Filter symlinks from theme gems</li>
|
296
|
+
<li>Fix excerpt handling of some Liquid tags</li>
|
297
|
+
<li>Handle case where a theme directory doesn’t exist</li>
|
298
|
+
<li>A few internal optimizations to reduce memory overhead</li>
|
299
|
+
</ul>
|
300
|
+
|
301
|
+
<p>… and a few more! You can check out the patches and see all the details in <a href="/docs/history/#v3-8-6">the release notes</a></p>
|
302
|
+
|
303
|
+
<p>Happy Jekylling!</p>
|
304
|
+
|
305
|
+
</div>
|
306
|
+
</article>
|
307
|
+
|
308
|
+
|
309
|
+
<article>
|
310
|
+
<h2>
|
311
|
+
<a href="/news/2018/06/05/jekyll-3-8-3-released/">
|
312
|
+
Jekyll 3.8.3 Released
|
313
|
+
</a>
|
314
|
+
</h2>
|
315
|
+
<span class="post-category">
|
316
|
+
<span class="label">
|
317
|
+
release
|
318
|
+
</span>
|
319
|
+
</span>
|
320
|
+
<div class="post-meta">
|
321
|
+
<span class="post-date">
|
322
|
+
05 Jun 2018
|
323
|
+
</span>
|
324
|
+
|
325
|
+
<a href="https://github.com/pathawks" class="post-author">
|
326
|
+
<img class="avatar avatar-small" alt="pathawks" width="24" height="24" data-proofer-ignore="true" src="https://avatars3.githubusercontent.com/pathawks?v=3&s=24" srcset="https://avatars3.githubusercontent.com/pathawks?v=3&s=24 1x, https://avatars3.githubusercontent.com/pathawks?v=3&s=48 2x, https://avatars3.githubusercontent.com/pathawks?v=3&s=72 3x, https://avatars3.githubusercontent.com/pathawks?v=3&s=96 4x">
|
327
|
+
pathawks
|
328
|
+
</a>
|
329
|
+
</div>
|
330
|
+
<div class="post-content">
|
331
|
+
<p>This release fixes a regression in 3.8 where collections with <code class="language-plaintext highlighter-rouge">published: false</code>
|
332
|
+
do not show when using the <code class="language-plaintext highlighter-rouge">--unpublished</code> flag.</p>
|
333
|
+
|
334
|
+
<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="language-plaintext highlighter-rouge">published: false</code> now behave the same way as Posts.</p>
|
336
|
+
|
337
|
+
</div>
|
338
|
+
</article>
|
339
|
+
|
340
|
+
|
341
|
+
<article>
|
342
|
+
<h2>
|
343
|
+
<a href="/news/2018/05/19/jekyll-3-8-2-released/">
|
344
|
+
Jekyll 3.8.2 Released
|
345
|
+
</a>
|
346
|
+
</h2>
|
347
|
+
<span class="post-category">
|
348
|
+
<span class="label">
|
349
|
+
release
|
350
|
+
</span>
|
351
|
+
</span>
|
352
|
+
<div class="post-meta">
|
353
|
+
<span class="post-date">
|
354
|
+
19 May 2018
|
355
|
+
</span>
|
356
|
+
|
357
|
+
<a href="https://github.com/pathawks" class="post-author">
|
358
|
+
<img class="avatar avatar-small" alt="pathawks" width="24" height="24" data-proofer-ignore="true" src="https://avatars3.githubusercontent.com/pathawks?v=3&s=24" srcset="https://avatars3.githubusercontent.com/pathawks?v=3&s=24 1x, https://avatars3.githubusercontent.com/pathawks?v=3&s=48 2x, https://avatars3.githubusercontent.com/pathawks?v=3&s=72 3x, https://avatars3.githubusercontent.com/pathawks?v=3&s=96 4x">
|
359
|
+
pathawks
|
360
|
+
</a>
|
361
|
+
</div>
|
362
|
+
<div class="post-content">
|
363
|
+
<p>Hello Jekyllers!!</p>
|
364
|
+
|
365
|
+
<p>Today we are releasing <code class="language-plaintext highlighter-rouge">v3.8.2</code>, which fixes the way Jekyll generates excerpts
|
366
|
+
for posts when the first paragraph of the post contains Liquid tags that take
|
367
|
+
advantage of <a href="https://shopify.github.io/liquid/basics/whitespace/">Liquid’s whitespace control feature</a>.</p>
|
368
|
+
|
369
|
+
<p>Big thanks to <a href="https://github.com/kylebarbour" class="user-mention">@kylebarbour</a>, who first reported this issue and also very quickly
|
370
|
+
submitted a fix. Also thanks to <a href="https://github.com/nickskalkin" class="user-mention">@nickskalkin</a> for making sure that we are using
|
371
|
+
the latest version of Rubocop to lint our code.</p>
|
372
|
+
|
373
|
+
|
374
|
+
</div>
|
375
|
+
</article>
|
376
|
+
|
377
|
+
|
263
378
|
<article>
|
264
379
|
<h2>
|
265
380
|
<a href="/news/2018/05/01/jekyll-3-8-1-released/">
|
@@ -282,10 +397,10 @@
|
|
282
397
|
</a>
|
283
398
|
</div>
|
284
399
|
<div class="post-content">
|
285
|
-
<p>Happy May Day <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
400
|
+
<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>
|
286
401
|
|
287
|
-
<p>The Jekyll team is happy to announce the release of <code class="highlighter-rouge">v3.8.1</code>, which fixes
|
288
|
-
a couple of bugs that were introduced two weeks ago in <code class="highlighter-rouge">v3.8.0</code>. If you have
|
402
|
+
<p>The Jekyll team is happy to announce the release of <code class="language-plaintext highlighter-rouge">v3.8.1</code>, which fixes
|
403
|
+
a couple of bugs that were introduced two weeks ago in <code class="language-plaintext highlighter-rouge">v3.8.0</code>. If you have
|
289
404
|
experienced trouble regarding post excerpts or non-published posts, this release
|
290
405
|
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
|
291
406
|
reporting these issues, and to <a href="https://github.com/ashmaroli" class="user-mention">@ashmaroli</a> for fixing them so quickly.</p>
|
@@ -321,15 +436,15 @@ list</a>.</p>
|
|
321
436
|
</a>
|
322
437
|
</div>
|
323
438
|
<div class="post-content">
|
324
|
-
<p>Hello Jekyllers!! <img class="emoji" title=":wave:" alt=":wave:" src="https://
|
439
|
+
<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>
|
325
440
|
|
326
|
-
<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
|
327
|
-
Jekyll plugin that in turn uses the <code class="highlighter-rouge">I18n</code> library.</p>
|
441
|
+
<p>We’re pleased to announce the release of <code class="language-plaintext highlighter-rouge">v3.7.3</code> which fixes a bug one might encounter while using <code class="language-plaintext highlighter-rouge">Jekyll - 3.7.x</code> along with a
|
442
|
+
Jekyll plugin that in turn uses the <code class="language-plaintext highlighter-rouge">I18n</code> library.</p>
|
328
443
|
|
329
|
-
<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
|
330
|
-
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
|
444
|
+
<p>When <a href="/news/2018/01/02/jekyll-3-7-0-released/">v3.7.0</a> enhanced our <code class="language-plaintext highlighter-rouge">slugify</code> filter with a <code class="language-plaintext highlighter-rouge">latin</code> option, we also
|
445
|
+
hardcoded a default fallback locale for the <code class="language-plaintext highlighter-rouge">I18n</code> library to avoid an exception raised in the event the library fails to find
|
331
446
|
any locale. This led to issues with third-party i18n plugins for Jekyll, especially since the default locale got assigned before
|
332
|
-
the plugin was loaded, irrespective of whether the <code class="highlighter-rouge">slugify</code> filter was used.</p>
|
447
|
+
the plugin was loaded, irrespective of whether the <code class="language-plaintext highlighter-rouge">slugify</code> filter was used.</p>
|
333
448
|
|
334
449
|
<p>Jekyll will henceforth set the default locale if and only if necessary.</p>
|
335
450
|
|
@@ -426,20 +541,20 @@ regressions due to the changes made in that release. In due time, Team Jekyll
|
|
426
541
|
set out to address those issues as early as possible.</p>
|
427
542
|
|
428
543
|
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
429
|
-
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
544
|
+
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">
|
430
545
|
The highlights being:</p>
|
431
546
|
|
432
547
|
<ul>
|
433
548
|
<li>
|
434
549
|
<p>A major regression in 3.7.0 was that when a Front Matter Default was
|
435
|
-
configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
550
|
+
configured with a <code class="language-plaintext highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
436
551
|
that directory for any subfolders and files, for each document in that
|
437
|
-
<code class="highlighter-rouge">path</code>.
|
552
|
+
<code class="language-plaintext highlighter-rouge">path</code>.
|
438
553
|
Though this is intended, it increases build times in proportion to the size
|
439
554
|
of the directory.</p>
|
440
555
|
|
441
556
|
<p>We addressed this by having Jekyll scan the directory path only if the user
|
442
|
-
explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
557
|
+
explicitly configures the <code class="language-plaintext highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
443
558
|
|
444
559
|
<p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
|
445
560
|
for more details.</p>
|
@@ -451,7 +566,7 @@ additionally providing us with a test repository to aid in resolving the issue.<
|
|
451
566
|
<p>Another regression reported was related to our “Custom collections
|
452
567
|
directory” feature introduced in 3.7.0.</p>
|
453
568
|
|
454
|
-
<p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
569
|
+
<p>Users setting <code class="language-plaintext highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
455
570
|
paths to their posts still at the root of their site’s source. This
|
456
571
|
roughly translated to 404 errors on URLs to their posts.</p>
|
457
572
|
|
@@ -459,19 +574,19 @@ roughly translated to 404 errors on URLs to their posts.</p>
|
|
459
574
|
|
460
575
|
<p>We decided to resolve this by having Jekyll ignore posts and drafts at the
|
461
576
|
root of the site’s source directory if the user customizes the
|
462
|
-
<code class="highlighter-rouge">collection_dir</code> setting.</p>
|
577
|
+
<code class="language-plaintext highlighter-rouge">collection_dir</code> setting.</p>
|
463
578
|
|
464
579
|
<p>Ergo, if you set a custom location for your collections, please ensure you
|
465
580
|
move all of your collections into that directory. <strong>This includes posts and
|
466
581
|
drafts as well</strong>. Your links generated by
|
467
|
-
<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
|
582
|
+
<code class="language-plaintext highlighter-rouge">{% post_url %}</code> or <code class="language-plaintext highlighter-rouge">{% link %}</code>
|
468
583
|
will adapt automatically.</p>
|
469
584
|
</li>
|
470
585
|
<li>
|
471
|
-
<p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
586
|
+
<p>We also found out that <code class="language-plaintext highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
472
587
|
being watched on Windows. So we recommend having it included in your Gemfile
|
473
588
|
for a better development experience on Windows. (Newly generated Gemfiles
|
474
|
-
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://
|
589
|
+
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>
|
475
590
|
</li>
|
476
591
|
</ul>
|
477
592
|
|
@@ -485,7 +600,7 @@ Paul Robert Lloyd.</p>
|
|
485
600
|
|
486
601
|
<p>As always, you can see our full changelog on <a href="/docs/history/">the History page</a>.</p>
|
487
602
|
|
488
|
-
<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
603
|
+
<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>
|
489
604
|
|
490
605
|
</div>
|
491
606
|
</article>
|
@@ -517,11 +632,11 @@ Paul Robert Lloyd.</p>
|
|
517
632
|
Here are a few of the latest additions from our contributors:</p>
|
518
633
|
|
519
634
|
<ul>
|
520
|
-
<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>
|
521
|
-
<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://
|
522
|
-
<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>
|
635
|
+
<li>LiveReload is available as an option during development: with <code class="language-plaintext 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>
|
636
|
+
<li>New <code class="language-plaintext 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>
|
637
|
+
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="language-plaintext 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>
|
523
638
|
<li>Jekyll will now check to determine whether host machine has internet connection.</li>
|
524
|
-
<li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
639
|
+
<li>A new <code class="language-plaintext highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
525
640
|
<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>
|
526
641
|
<li>
|
527
642
|
<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
|
@@ -536,7 +651,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
536
651
|
<p>Oh, one last thing…</p>
|
537
652
|
|
538
653
|
<h3 id="pray-upgrade-your-ruby">
|
539
|
-
<img class="emoji" title=":pray:" alt=":pray:" src="https://
|
654
|
+
<img class="emoji" title=":pray:" alt=":pray:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
|
540
655
|
|
541
656
|
<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
|
542
657
|
|
@@ -574,7 +689,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
574
689
|
</a>
|
575
690
|
</div>
|
576
691
|
<div class="post-content">
|
577
|
-
<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>
|
692
|
+
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="language-plaintext highlighter-rouge">bundle update</code>
|
578
693
|
if you want to avoid possible build problems with:</p>
|
579
694
|
|
580
695
|
<ul>
|
@@ -594,7 +709,7 @@ working on the next minor version 3.7.0 that will allow you to store all your
|
|
594
709
|
collections in a single directory. Stay tuned.</p>
|
595
710
|
|
596
711
|
<p>Theme developers are invited to test the brand new
|
597
|
-
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
712
|
+
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="language-plaintext highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
598
713
|
and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
|
599
714
|
GitHub hosted theme as a remote theme!</p>
|
600
715
|
|
@@ -656,7 +771,7 @@ today.</p>
|
|
656
771
|
|
657
772
|
<h2 id="create-newcomer-friendly-issues">Create newcomer-friendly issues</h2>
|
658
773
|
|
659
|
-
<p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="highlighter-rouge">first timers only</code> issues:</p>
|
774
|
+
<p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="language-plaintext highlighter-rouge">first timers only</code> issues:</p>
|
660
775
|
|
661
776
|
<ul>
|
662
777
|
<li><a href="https://github.com/jekyll/jekyll/issues/6437">Issue #6437</a></li>
|
@@ -664,7 +779,7 @@ today.</p>
|
|
664
779
|
<li><a href="https://github.com/jekyll/jekyll/issues/6439">Issue #6439</a></li>
|
665
780
|
</ul>
|
666
781
|
|
667
|
-
<p>(There’s also an up-to-date listing of all of our <code class="highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
|
782
|
+
<p>(There’s also an up-to-date listing of all of our <code class="language-plaintext highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
|
668
783
|
|
669
784
|
<p>These issues are designed to be taken on only by someone who has had little to no exposure to contributing to open source before, and additionally, project maintainers offer support in case a question arises.</p>
|
670
785
|
|
@@ -704,7 +819,7 @@ today.</p>
|
|
704
819
|
<div class="post-content">
|
705
820
|
<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>
|
706
821
|
|
707
|
-
<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>
|
822
|
+
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="language-plaintext 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>
|
708
823
|
|
709
824
|
<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>
|
710
825
|
|
@@ -741,12 +856,12 @@ today.</p>
|
|
741
856
|
<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>
|
742
857
|
|
743
858
|
<ul>
|
744
|
-
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
|
859
|
+
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="language-plaintext highlighter-rouge">Document#url</code> (#6301)</li>
|
745
860
|
<li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
|
746
|
-
<li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
747
|
-
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
|
748
|
-
<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>
|
749
|
-
<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>
|
861
|
+
<li>Backport #6281 for v3.5.x: Fix <code class="language-plaintext highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
862
|
+
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="language-plaintext highlighter-rouge">absolute_url</code> (#6287)</li>
|
863
|
+
<li>Backport #6273 for v3.5.x: delegate <code class="language-plaintext highlighter-rouge">StaticFile#to_json</code> to <code class="language-plaintext highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
|
864
|
+
<li>Backport #6226 for v3.5.x: <code class="language-plaintext highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
|
750
865
|
</ul>
|
751
866
|
|
752
867
|
<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>
|
@@ -785,8 +900,8 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
785
900
|
<p>We’ve released a few bugfixes in the form of v3.5.1 today:</p>
|
786
901
|
|
787
902
|
<ul>
|
788
|
-
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
789
|
-
<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>
|
903
|
+
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="language-plaintext highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
904
|
+
<li>A bug in <code class="language-plaintext highlighter-rouge">relative_url</code> when <code class="language-plaintext highlighter-rouge">baseurl</code> is <code class="language-plaintext highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
|
790
905
|
<li>Static files’ liquid representations should now have all the keys you were expecting when serialized into JSON.</li>
|
791
906
|
</ul>
|
792
907
|
|
@@ -826,18 +941,18 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
826
941
|
the wild. Some new shiny things you might want to test out:</p>
|
827
942
|
|
828
943
|
<ul>
|
829
|
-
<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>
|
944
|
+
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="language-plaintext highlighter-rouge">concat</code> and <code class="language-plaintext 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>
|
830
945
|
</li>
|
831
946
|
<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>
|
832
947
|
<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>
|
833
|
-
<li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
|
834
|
-
<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>
|
835
|
-
<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>
|
948
|
+
<li>Pages, posts, and other documents can now access layout variables via <code class="language-plaintext highlighter-rouge">{{ layout }}</code>.</li>
|
949
|
+
<li>The <code class="language-plaintext highlighter-rouge">gems</code> key in the <code class="language-plaintext highlighter-rouge">_config.yml</code> is now <code class="language-plaintext highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="language-plaintext highlighter-rouge">gems</code> to <code class="language-plaintext highlighter-rouge">plugins</code> if you use the former.</li>
|
950
|
+
<li>Filters like <code class="language-plaintext highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="language-plaintext highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
|
836
951
|
<li>You can now create tab-separated data files.</li>
|
837
|
-
<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>
|
952
|
+
<li>Using <code class="language-plaintext highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="language-plaintext highlighter-rouge">layout: null</code>, with the exception that <code class="language-plaintext highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
|
838
953
|
<li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
|
839
|
-
<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>
|
840
|
-
<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>
|
954
|
+
<li>We now automatically exclude the <code class="language-plaintext highlighter-rouge">Gemfile</code> from the site manifest when compiling your site. No more <code class="language-plaintext highlighter-rouge">_site/Gemfile</code>!</li>
|
955
|
+
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="language-plaintext highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
|
841
956
|
</ul>
|
842
957
|
|
843
958
|
<p>And <a href="/docs/history/">so much more!</a></p>
|
@@ -852,9 +967,9 @@ Thank you, all!</p>
|
|
852
967
|
|
853
968
|
<p>Please file any bugs with detailed replication instructions if you find any
|
854
969
|
bugs. Better yet, submit a patch if you find the bug in the code and know
|
855
|
-
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://
|
970
|
+
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://github.githubassets.com/images/icons/emoji/unicode/2764.png" height="20" width="20"></p>
|
856
971
|
|
857
|
-
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
972
|
+
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
|
858
973
|
|
859
974
|
</div>
|
860
975
|
</article>
|
@@ -884,26 +999,26 @@ how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://ass
|
|
884
999
|
<div class="post-content">
|
885
1000
|
<p>Another one-PR patch update as we continue our quest to destroy all bugs. A
|
886
1001
|
fairly technical debriefing follows, but the TLDR is that we have updated the
|
887
|
-
<code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
1002
|
+
<code class="language-plaintext highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
888
1003
|
|
889
1004
|
<p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
|
890
1005
|
moved away from using the deprecated
|
891
|
-
<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>
|
1006
|
+
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="language-plaintext highlighter-rouge">URI.escape</code></a>
|
892
1007
|
in favor of
|
893
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
|
894
|
-
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
|
1008
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code></a>.
|
1009
|
+
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="language-plaintext highlighter-rouge">uri_escape</code>
|
895
1010
|
filter</a>.</p>
|
896
1011
|
|
897
1012
|
<p>While this transition was mostly a smooth one, the two methods are not
|
898
|
-
identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
|
899
|
-
<code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
|
1013
|
+
identical. While <code class="language-plaintext highlighter-rouge">URI.escape</code> was happy to escape any string,
|
1014
|
+
<code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code>
|
900
1015
|
object, and will then escape each component of that object. In most cases, this
|
901
1016
|
difference was insignificant, but there were a few cases where this caused some
|
902
1017
|
unintended regressions when encoding colons.</p>
|
903
1018
|
|
904
|
-
<p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
|
1019
|
+
<p>While <strong>Addressable</strong> can understand that something like <code class="language-plaintext highlighter-rouge">"/example :page"</code> is a
|
905
1020
|
relative URI, without the slash it cannot figure out how to turn
|
906
|
-
<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
|
1021
|
+
<code class="language-plaintext highlighter-rouge">"example :page"</code> into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code> object. <code class="language-plaintext highlighter-rouge">URI.escape</code> had no such
|
907
1022
|
objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
|
908
1023
|
but breaking in 3.4.0:</p>
|
909
1024
|
|
@@ -913,8 +1028,8 @@ but breaking in 3.4.0:</p>
|
|
913
1028
|
<p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
|
914
1029
|
|
915
1030
|
<p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
|
916
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
917
|
-
which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
|
1031
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
1032
|
+
which will simply escape the characters in a string, much like <code class="language-plaintext highlighter-rouge">URI.escape</code>.</p>
|
918
1033
|
|
919
1034
|
<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
|
920
1035
|
<a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
|
@@ -958,15 +1073,15 @@ static files explicitly because they <em>don’t</em> have YAML front matter, wa
|
|
958
1073
|
to respect YAML front matter?” That’s a great question. Let me illustrate
|
959
1074
|
with an example.</p>
|
960
1075
|
|
961
|
-
<p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
1076
|
+
<p>Let’s look at <code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
962
1077
|
pages, and static files, and some metadata for them in an XML file for a
|
963
1078
|
Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
|
964
|
-
file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
1079
|
+
file in this list, you set <code class="language-plaintext highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
965
1080
|
what about static files, which don’t have YAML front matter? Before this
|
966
1081
|
release, they could not be excluded because they had no properties in YAML
|
967
1082
|
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>.
|
968
1083
|
So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
|
969
|
-
<code class="highlighter-rouge">jekyll-sitemap</code>.</p>
|
1084
|
+
<code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>.</p>
|
970
1085
|
|
971
1086
|
<p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
|
972
1087
|
defaults</a> for static files:</p>
|
@@ -979,8 +1094,8 @@ defaults</a> for static files:</p>
|
|
979
1094
|
<span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
|
980
1095
|
</code></pre></div></div>
|
981
1096
|
|
982
|
-
<p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
|
983
|
-
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>
|
1097
|
+
<p>Now, for every file in the Liquid <code class="language-plaintext highlighter-rouge">site.static_files</code> loop which is in the
|
1098
|
+
folder <code class="language-plaintext highlighter-rouge">pdfs/</code>, you’ll see <code class="language-plaintext highlighter-rouge">sitemap</code> equal to <code class="language-plaintext highlighter-rouge">false</code>.</p>
|
984
1099
|
|
985
1100
|
<p>Many thanks to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a> for coming up with the solution and ensuring
|
986
1101
|
sitemaps everywhere are filled with just the right content.</p>
|
@@ -1067,7 +1182,7 @@ well.</p>
|
|
1067
1182
|
|
1068
1183
|
<p>Well, not so much.</p>
|
1069
1184
|
|
1070
|
-
<p>A very common way to specify the month of February is <code class="highlighter-rouge">2</code>. This is true for
|
1185
|
+
<p>A very common way to specify the month of February is <code class="language-plaintext highlighter-rouge">2</code>. This is true for
|
1071
1186
|
all single-digit months and days of the month. Notice anything about our
|
1072
1187
|
first regular expression versus our second? The second regular expression
|
1073
1188
|
imposes a <strong>minimum</strong>, as well as maximum, number of digits. This change
|
@@ -1141,8 +1256,8 @@ Packed full of bug fixes as usual, thanks to the tireless efforts of our
|
|
1141
1256
|
exceptional Jekyll community. Three changes to call out:</p>
|
1142
1257
|
|
1143
1258
|
<ol>
|
1144
|
-
<li>If you’re a big fan of <a href="/docs/templates/#filters"><code class="highlighter-rouge">where_by_exp</code></a>, you’ll be an
|
1145
|
-
even bigger fan of <a href="/docs/templates/#filters"><code class="highlighter-rouge">group_by_exp</code></a>.</li>
|
1259
|
+
<li>If you’re a big fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">where_by_exp</code></a>, you’ll be an
|
1260
|
+
even bigger fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">group_by_exp</code></a>.</li>
|
1146
1261
|
<li>Using a custom timezone in Jekyll on Windows? Yeah, sorry that hasn’t ever worked
|
1147
1262
|
properly. We made it possible to accurately <a href="https://jekyllrb.com/docs/windows/#timezone-management">set the timezone using IANA
|
1148
1263
|
timezone codes</a>.</li>
|
@@ -1204,7 +1319,7 @@ fixes to call out:</p>
|
|
1204
1319
|
|
1205
1320
|
<ol>
|
1206
1321
|
<li>Only warn about auto-regeneration issues on Windows instead of disabling</li>
|
1207
|
-
<li>Exclude very specific <code class="highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="highlighter-rouge">vendor/</code>
|
1322
|
+
<li>Exclude very specific <code class="language-plaintext highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="language-plaintext highlighter-rouge">vendor/</code>
|
1208
1323
|
</li>
|
1209
1324
|
<li>Allow permalink templates to have plaintext underscores</li>
|
1210
1325
|
</ol>
|
@@ -1242,14 +1357,14 @@ fixes to call out:</p>
|
|
1242
1357
|
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
1243
1358
|
Three key things you might want to try:</p>
|
1244
1359
|
|
1245
|
-
<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>
|
1360
|
+
<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="language-plaintext highlighter-rouge">/assets</code> directory</h3>
|
1246
1361
|
|
1247
1362
|
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
1248
1363
|
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
1249
1364
|
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
1250
1365
|
|
1251
1366
|
<p>In an effort to make theme management a bit easier, any files you put into
|
1252
|
-
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
1367
|
+
<code class="language-plaintext highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
1253
1368
|
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
1254
1369
|
webfonts, and so on – anything you’d consider a part of the
|
1255
1370
|
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
@@ -1257,51 +1372,51 @@ front matter, it will be converted and rendered. No YAML front matter, and
|
|
1257
1372
|
it will simply be copied over like a static asset.</p>
|
1258
1373
|
|
1259
1374
|
<p>Note that if a user has a file of the same path, the theme content will not
|
1260
|
-
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
1261
|
-
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
1375
|
+
be included in the site, i.e. a user’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code> will be read and
|
1376
|
+
processed if present instead of a theme’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code>.</p>
|
1262
1377
|
|
1263
1378
|
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
1264
1379
|
for more info.</p>
|
1265
1380
|
|
1266
|
-
<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>
|
1381
|
+
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="language-plaintext highlighter-rouge">relative_url</code> and <code class="language-plaintext highlighter-rouge">absolute_url</code> filters</h3>
|
1267
1382
|
|
1268
|
-
<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
|
1383
|
+
<p>Want a clean way to prepend the <code class="language-plaintext highlighter-rouge">baseurl</code> or <code class="language-plaintext highlighter-rouge">url</code> in your config? These
|
1269
1384
|
new filters have you covered. When working locally, if you set your
|
1270
|
-
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
1271
|
-
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
1385
|
+
<code class="language-plaintext highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="language-plaintext highlighter-rouge">baseurl: "/myproject"</code>,
|
1386
|
+
then <code class="language-plaintext highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
1272
1387
|
you pass it:</p>
|
1273
1388
|
|
1274
1389
|
<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>
|
1275
1390
|
|
1276
|
-
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
1277
|
-
<code class="highlighter-rouge">"/"</code>):</p>
|
1391
|
+
<p>By default, <code class="language-plaintext highlighter-rouge">baseurl</code> is set to <code class="language-plaintext highlighter-rouge">""</code> and therefore yields (never set to
|
1392
|
+
<code class="language-plaintext highlighter-rouge">"/"</code>):</p>
|
1278
1393
|
|
1279
1394
|
<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>
|
1280
1395
|
|
1281
|
-
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
1282
|
-
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
1283
|
-
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
|
1396
|
+
<p>A result of <code class="language-plaintext highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
1397
|
+
relative to the domain root. A similar principle applies to <code class="language-plaintext highlighter-rouge">absolute_url</code>.
|
1398
|
+
It prepends your <code class="language-plaintext highlighter-rouge">baseurl</code> and <code class="language-plaintext highlighter-rouge">url</code> values, making absolute URLs all the
|
1284
1399
|
easier to make:</p>
|
1285
1400
|
|
1286
1401
|
<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>
|
1287
1402
|
|
1288
|
-
<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>
|
1403
|
+
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="language-plaintext highlighter-rouge">site.url</code> is set by the development server</h3>
|
1289
1404
|
|
1290
|
-
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
1291
|
-
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
1292
|
-
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
1293
|
-
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
1294
|
-
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
1405
|
+
<p>When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
1406
|
+
<code class="language-plaintext highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
1407
|
+
development. If you are using the new <code class="language-plaintext highlighter-rouge">absolute_url</code> filter, or using
|
1408
|
+
<code class="language-plaintext highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
1409
|
+
which resets the <code class="language-plaintext highlighter-rouge">url</code> value to point to <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
1295
1410
|
|
1296
|
-
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
1297
|
-
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
1298
|
-
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
1299
|
-
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
1411
|
+
<p>No longer! When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
1412
|
+
the value of the <code class="language-plaintext highlighter-rouge">host</code>, <code class="language-plaintext highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
1413
|
+
<code class="language-plaintext highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="language-plaintext highlighter-rouge">site.url</code>
|
1414
|
+
will yield <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
1300
1415
|
|
1301
1416
|
<p>This happens by default when running Jekyll locally. It will not be set if
|
1302
|
-
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
|
1303
|
-
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
1304
|
-
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
1417
|
+
you set <code class="language-plaintext highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="language-plaintext highlighter-rouge">jekyll serve</code>. If <code class="language-plaintext highlighter-rouge">JEKYLL_ENV</code> is
|
1418
|
+
any value except <code class="language-plaintext highlighter-rouge">development</code> (its default value), Jekyll will not
|
1419
|
+
overwrite the value of <code class="language-plaintext highlighter-rouge">url</code> in your config. And again, this only applies
|
1305
1420
|
to serving, not to building.</p>
|
1306
1421
|
|
1307
1422
|
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
@@ -1394,7 +1509,7 @@ prior to its release. I’m sure that they will support Jekyll Admin as much as
|
|
1394
1509
|
<div class="post-content">
|
1395
1510
|
<p>Well, 3.2.0 has been a success, but with one fatal flaw: it doesn’t work on
|
1396
1511
|
Windows! Sorry, Windows users. Hot on the trail of 3.2.0, this release
|
1397
|
-
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
1512
|
+
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20">. Sorry about that!</p>
|
1398
1513
|
|
1399
1514
|
<p>This release also fixes an issue when using <a href="/docs/themes/">gem-based themes</a>
|
1400
1515
|
where the theme was rejected if it existed behind a symlink. This is a
|
@@ -1441,7 +1556,7 @@ say? Yes, proper, versionable, releasable, first-class themes. We’re pretty
|
|
1441
1556
|
stoked about it and we hope you like building and using them. For now, it
|
1442
1557
|
only supports layouts, includes, and sass, but we have plans to include
|
1443
1558
|
static assets like images and CSS/JS in a future release. <a href="/docs/themes/">Read more about
|
1444
|
-
it in the docs.</a> Our site template generated by <code class="highlighter-rouge">jekyll new</code>
|
1559
|
+
it in the docs.</a> Our site template generated by <code class="language-plaintext highlighter-rouge">jekyll new</code>
|
1445
1560
|
now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">minima</a> theme.</p>
|
1446
1561
|
|
1447
1562
|
<p>Some other notable changes:</p>
|
@@ -1449,9 +1564,9 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
1449
1564
|
<ul>
|
1450
1565
|
<li>Symlinks are allowed as long as they target a file in the site source</li>
|
1451
1566
|
<li>Explicit support for Ruby 2.0.x was dropped</li>
|
1452
|
-
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
1453
|
-
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
1454
|
-
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
1567
|
+
<li>Added an <code class="language-plaintext highlighter-rouge">:after_init</code> Hook</li>
|
1568
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
1569
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
1455
1570
|
post or document based on its path relative to the site source</li>
|
1456
1571
|
<li>… and lots more!</li>
|
1457
1572
|
</ul>
|
@@ -1620,7 +1735,7 @@ release. Thank you!</p>
|
|
1620
1735
|
</div>
|
1621
1736
|
<div class="post-content">
|
1622
1737
|
<p>Upon releasing 3.1.5 and kicking the tires, we noticed a glaring bug: our
|
1623
|
-
beloved <code class="highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
1738
|
+
beloved <code class="language-plaintext highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
1624
1739
|
us and we decided a 3.1.6 was necessary. This release restores sanity to
|
1625
1740
|
our object-to-JSON generation in Liquid and we hope you enjoy.</p>
|
1626
1741
|
|
@@ -1659,7 +1774,7 @@ changelog</a>.</p>
|
|
1659
1774
|
<p>There’s always at least one bug, right? :)</p>
|
1660
1775
|
|
1661
1776
|
<p>Hot on the trails of <a href="/news/2016/05/18/jekyll-3-1-4-released/">v3.1.4</a>, we
|
1662
|
-
bring you v3.1.5! It fixes one bug around requiring the <code class="highlighter-rouge">ExcerptDrop</code>,
|
1777
|
+
bring you v3.1.5! It fixes one bug around requiring the <code class="language-plaintext highlighter-rouge">ExcerptDrop</code>,
|
1663
1778
|
which only affects Linux. For the gory details, see <a href="https://github.com/jekyll/jekyll/pull/4912">the pull
|
1664
1779
|
request for the fix</a>.</p>
|
1665
1780
|
|
@@ -1696,15 +1811,15 @@ request for the fix</a>.</p>
|
|
1696
1811
|
<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>
|
1697
1812
|
|
1698
1813
|
<ul>
|
1699
|
-
<li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
1700
|
-
<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>
|
1701
|
-
<li>A fix where <code class="highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
1702
|
-
<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>
|
1814
|
+
<li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
1815
|
+
<li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where a parent layout (e.g. <code class="language-plaintext highlighter-rouge">default</code> or <code class="language-plaintext highlighter-rouge">base</code>) would overwrite the metadata of the child layout (e.g. <code class="language-plaintext highlighter-rouge">post</code> or <code class="language-plaintext highlighter-rouge">special</code>).</li>
|
1816
|
+
<li>A fix where <code class="language-plaintext highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
1817
|
+
<li>We added <code class="language-plaintext 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>
|
1703
1818
|
<li>
|
1704
|
-
<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>
|
1819
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="language-plaintext highlighter-rouge">docs</code> shows up before <code class="language-plaintext highlighter-rouge">posts</code> reliably.</li>
|
1705
1820
|
</ul>
|
1706
1821
|
|
1707
|
-
<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>
|
1822
|
+
<p>The fixes for <code class="language-plaintext highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
|
1708
1823
|
|
1709
1824
|
<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>
|
1710
1825
|
|
@@ -1785,7 +1900,7 @@ we think you’ll love.</p>
|
|
1785
1900
|
|
1786
1901
|
<ul>
|
1787
1902
|
<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>
|
1788
|
-
<li>Running <code class="highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
1903
|
+
<li>Running <code class="language-plaintext highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
1789
1904
|
</ul>
|
1790
1905
|
|
1791
1906
|
<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>
|
@@ -1822,7 +1937,7 @@ we think you’ll love.</p>
|
|
1822
1937
|
|
1823
1938
|
<ul>
|
1824
1939
|
<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>
|
1825
|
-
<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>
|
1940
|
+
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="language-plaintext highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="language-plaintext 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>
|
1826
1941
|
</ul>
|
1827
1942
|
|
1828
1943
|
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">collections</span><span class="pi">:</span>
|
@@ -1902,8 +2017,8 @@ we think you’ll love.</p>
|
|
1902
2017
|
<li>If a syntax error is encountered by Liquid, it will now print the line number.</li>
|
1903
2018
|
<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>
|
1904
2019
|
<li>A tilde at the beginning of a filename will no longer crash Jekyll.</li>
|
1905
|
-
<li>The <code class="highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
1906
|
-
<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>
|
2020
|
+
<li>The <code class="language-plaintext highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
2021
|
+
<li>Permalinks which end in a slash will now always output as a folder with an <code class="language-plaintext highlighter-rouge">index.html</code> inside.</li>
|
1907
2022
|
</ul>
|
1908
2023
|
|
1909
2024
|
<p>Nitty-gritty details, like always, are available in the <a href="/docs/history/">history</a>.</p>
|
@@ -1943,7 +2058,7 @@ fixes:</p>
|
|
1943
2058
|
|
1944
2059
|
<ul>
|
1945
2060
|
<li>Fix problem where outputting to a folder would have two extensions</li>
|
1946
|
-
<li>Handle tildes (<code class="highlighter-rouge">~</code>) in filenames properly</li>
|
2061
|
+
<li>Handle tildes (<code class="language-plaintext highlighter-rouge">~</code>) in filenames properly</li>
|
1947
2062
|
<li>Fix issue when comparing documents without dates</li>
|
1948
2063
|
<li>Include line numbers in liquid error output</li>
|
1949
2064
|
</ul>
|
@@ -1985,15 +2100,15 @@ you’re having.</p>
|
|
1985
2100
|
</a>
|
1986
2101
|
</div>
|
1987
2102
|
<div class="post-content">
|
1988
|
-
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
2103
|
+
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> noticed by a few
|
1989
2104
|
wonderful Jekyll users:</p>
|
1990
2105
|
|
1991
2106
|
<ul>
|
1992
|
-
<li>If your <code class="highlighter-rouge">permalink</code> ended with a <code class="highlighter-rouge">/</code>, your URL didn’t have any extension,
|
2107
|
+
<li>If your <code class="language-plaintext highlighter-rouge">permalink</code> ended with a <code class="language-plaintext highlighter-rouge">/</code>, your URL didn’t have any extension,
|
1993
2108
|
even if you wanted one</li>
|
1994
|
-
<li>We now strip the BOM by default per Ruby’s <code class="highlighter-rouge">IO.open</code>.</li>
|
2109
|
+
<li>We now strip the BOM by default per Ruby’s <code class="language-plaintext highlighter-rouge">IO.open</code>.</li>
|
1995
2110
|
<li>
|
1996
|
-
<code class="highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
2111
|
+
<code class="language-plaintext highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
1997
2112
|
</ul>
|
1998
2113
|
|
1999
2114
|
<p>We also updated our <a href="/docs/conduct/">Code of Conduct</a> to the latest version of
|
@@ -2009,7 +2124,7 @@ that</a>.</p>
|
|
2009
2124
|
<p>See links to the PR’s on <a href="/docs/history/#v3-1-1">the history page</a>.</p>
|
2010
2125
|
|
2011
2126
|
<p>Thanks to Jordon Bedwell, chrisfinazzo, Kroum Tzanev, David Celis, and
|
2012
|
-
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
2127
|
+
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
2013
2128
|
|
2014
2129
|
<p>Happy Jekylling!</p>
|
2015
2130
|
|
@@ -2051,13 +2166,13 @@ considerably!</p>
|
|
2051
2166
|
<p>Some other highlights:</p>
|
2052
2167
|
|
2053
2168
|
<ul>
|
2054
|
-
<li>Fix: <code class="highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
2055
|
-
<li>Fix: <code class="highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="highlighter-rouge">--source</code>.</li>
|
2056
|
-
<li>Enhancement: <code class="highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
2057
|
-
<li>Feature: adds new <code class="highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
2169
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
2170
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="language-plaintext highlighter-rouge">--source</code>.</li>
|
2171
|
+
<li>Enhancement: <code class="language-plaintext highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
2172
|
+
<li>Feature: adds new <code class="language-plaintext highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
2058
2173
|
<li>Fix: Jekyll will read in files with YAML front matter that has extraneous
|
2059
2174
|
spaces after the first line</li>
|
2060
|
-
<li>Enhancement: extract the <code class="highlighter-rouge">title</code> attribute from the filename for
|
2175
|
+
<li>Enhancement: extract the <code class="language-plaintext highlighter-rouge">title</code> attribute from the filename for
|
2061
2176
|
collection items without a date</li>
|
2062
2177
|
<li>Fix: gracefully handle empty configuration files</li>
|
2063
2178
|
</ul>
|
@@ -2112,8 +2227,8 @@ midnightSuyama, musoke, and rebornix</p>
|
|
2112
2227
|
<p>A crucial bug was found in v3.0.1 which caused invalid post dates to go
|
2113
2228
|
unnoticed in the build chain until the error that popped up was unhelpful.
|
2114
2229
|
v3.0.2 <a href="https://github.com/jekyll/jekyll/issues/4375">throws errors as you’d expect</a>
|
2115
|
-
when there is a post like <code class="highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
2116
|
-
invalid date like <code class="highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
2230
|
+
when there is a post like <code class="language-plaintext highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
2231
|
+
invalid date like <code class="language-plaintext highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
2117
2232
|
|
2118
2233
|
<p>This should make the experience of working with Jekyll just a little
|
2119
2234
|
better.</p>
|
@@ -2149,12 +2264,12 @@ better.</p>
|
|
2149
2264
|
<p>Hey, folks! Bunch of bug fixes here. Notables:</p>
|
2150
2265
|
|
2151
2266
|
<ul>
|
2152
|
-
<li>Only superdirectories of <code class="highlighter-rouge">_posts</code> will be categories.</li>
|
2267
|
+
<li>Only superdirectories of <code class="language-plaintext highlighter-rouge">_posts</code> will be categories.</li>
|
2153
2268
|
<li>
|
2154
|
-
<code class="highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
2269
|
+
<code class="language-plaintext highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
2155
2270
|
<li>
|
2156
|
-
<code class="highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
2157
|
-
<li>Failure in liquid will now always fail the <code class="highlighter-rouge">jekyll</code> process.</li>
|
2271
|
+
<code class="language-plaintext highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
2272
|
+
<li>Failure in liquid will now always fail the <code class="language-plaintext highlighter-rouge">jekyll</code> process.</li>
|
2158
2273
|
<li>All hooks should now be properly registered & documented</li>
|
2159
2274
|
</ul>
|
2160
2275
|
|
@@ -2196,20 +2311,20 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
|
|
2196
2311
|
<p>The much-anticipated Jekyll 3.0 has been released! Key changes:</p>
|
2197
2312
|
|
2198
2313
|
<ul>
|
2199
|
-
<li>Incremental regeneration (experimental, enable with <code class="highlighter-rouge">--incremental</code>)</li>
|
2200
|
-
<li>Liquid profiler (add <code class="highlighter-rouge">--profile</code> to a build or serve)</li>
|
2314
|
+
<li>Incremental regeneration (experimental, enable with <code class="language-plaintext highlighter-rouge">--incremental</code>)</li>
|
2315
|
+
<li>Liquid profiler (add <code class="language-plaintext highlighter-rouge">--profile</code> to a build or serve)</li>
|
2201
2316
|
<li>Hook plugin API (no more monkey-patching!)</li>
|
2202
2317
|
<li>Dependencies reduced from 14 to 8, none contain C extensions. We’re hoping to reduce this even more in the future.</li>
|
2203
2318
|
<li>Changed version support: no support for Ruby 1.9.3, added basic JRuby support. Better Windows support.</li>
|
2204
2319
|
<li>Extension-less URLs</li>
|
2205
2320
|
<li>
|
2206
|
-
<code class="highlighter-rouge">site.collections</code> is an array of collections, thus:
|
2321
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> is an array of collections, thus:
|
2207
2322
|
<ul>
|
2208
2323
|
<li>
|
2209
|
-
<code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
|
2324
|
+
<code class="language-plaintext highlighter-rouge">collection[0]</code> becomes <code class="language-plaintext highlighter-rouge">collection.label</code>
|
2210
2325
|
</li>
|
2211
2326
|
<li>
|
2212
|
-
<code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
|
2327
|
+
<code class="language-plaintext highlighter-rouge">collection[1]</code> becomes <code class="language-plaintext highlighter-rouge">collection</code>
|
2213
2328
|
</li>
|
2214
2329
|
</ul>
|
2215
2330
|
</li>
|
@@ -2470,8 +2585,8 @@ place!</p>
|
|
2470
2585
|
</div>
|
2471
2586
|
<div class="post-content">
|
2472
2587
|
<p>A very minor release, 2.5.2 fixes a bug with path sanitation that 2.5.1
|
2473
|
-
introduced. It also improves the <code class="highlighter-rouge">post_url</code> tag such that it checks the
|
2474
|
-
posts’ name (e.g. <code class="highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
2588
|
+
introduced. It also improves the <code class="language-plaintext highlighter-rouge">post_url</code> tag such that it checks the
|
2589
|
+
posts’ name (e.g. <code class="language-plaintext highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
2475
2590
|
name. This fixes issues where posts are created and the day changes based
|
2476
2591
|
on timezone discrepancies.</p>
|
2477
2592
|
|
@@ -2558,17 +2673,17 @@ milestone with a pretty big release. What’s changed in 2.5.0? Here are some
|
|
2558
2673
|
highlights:</p>
|
2559
2674
|
|
2560
2675
|
<ul>
|
2561
|
-
<li>Require plugins in the <code class="highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
2562
|
-
<li>YAML 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>
|
2563
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
2564
|
-
<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>
|
2676
|
+
<li>Require plugins in the <code class="language-plaintext highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
2677
|
+
<li>YAML Front Matter permalinks can now contain placeholders like <code class="language-plaintext highlighter-rouge">:name</code>. Check out all the placeholders on the <a href="/docs/permalinks/">Permalinks docs page</a>.</li>
|
2678
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
2679
|
+
<li>Shorted <code class="language-plaintext highlighter-rouge">build</code> and <code class="language-plaintext highlighter-rouge">serve</code> commands with <code class="language-plaintext highlighter-rouge">b</code> and <code class="language-plaintext highlighter-rouge">s</code> aliases, respectively</li>
|
2565
2680
|
<li>WEBrick will now list your directory if it can’t find an index file.</li>
|
2566
|
-
<li>Any enumerable can be used with the <code class="highlighter-rouge">where</code> filter.</li>
|
2681
|
+
<li>Any enumerable can be used with the <code class="language-plaintext highlighter-rouge">where</code> filter.</li>
|
2567
2682
|
<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>
|
2568
2683
|
</li>
|
2569
2684
|
<li>Fix for Rouge’s Redcarpet interface</li>
|
2570
2685
|
<li>Security auditors will love this: path sanitation has now been centralized.</li>
|
2571
|
-
<li>Specify a log level with <code class="highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
2686
|
+
<li>Specify a log level with <code class="language-plaintext highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
2572
2687
|
</ul>
|
2573
2688
|
|
2574
2689
|
<p>…and a whole bunch of other fixes and enhancements you can read more
|
@@ -2622,14 +2737,14 @@ Custódio, Igor Kapkov, and Kevin Ndung’u!</p>
|
|
2622
2737
|
<p>Well, lookie here! A new release of Jekyll! v2.4.0 contains lots of goodies, including some brilliant new additions:</p>
|
2623
2738
|
|
2624
2739
|
<ul>
|
2625
|
-
<li>A new <code class="highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
2740
|
+
<li>A new <code class="language-plaintext highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
2626
2741
|
<li>Render Liquid in CoffeeScript files (<a href="https://github.com/jekyll/jekyll/issues/2830">#2830</a>)</li>
|
2627
|
-
<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>
|
2628
|
-
<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>
|
2629
|
-
<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>
|
2630
|
-
<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>
|
2631
|
-
<li>Add <code class="highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
2632
|
-
<li>Add a <code class="highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
2742
|
+
<li>Add 4 new array Liquid filters: <code class="language-plaintext highlighter-rouge">push</code>, <code class="language-plaintext highlighter-rouge">pop</code>, <code class="language-plaintext highlighter-rouge">shift</code>, and <code class="language-plaintext highlighter-rouge">unshift</code> (<a href="https://github.com/jekyll/jekyll/pull/2895">#2895</a>)</li>
|
2743
|
+
<li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="language-plaintext highlighter-rouge">-w</code>!</li>
|
2744
|
+
<li>Add <code class="language-plaintext highlighter-rouge">:title</code> and <code class="language-plaintext 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>
|
2745
|
+
<li>Add support for CSV files in the <code class="language-plaintext highlighter-rouge">_data</code> directory (<a href="https://github.com/jekyll/jekyll/issues/2761">#2761</a>)</li>
|
2746
|
+
<li>Add <code class="language-plaintext highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
2747
|
+
<li>Add a <code class="language-plaintext highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
2633
2748
|
</ul>
|
2634
2749
|
|
2635
2750
|
<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>
|
@@ -2673,22 +2788,22 @@ curious bug indeed.</a>
|
|
2673
2788
|
</li>
|
2674
2789
|
<li>Pages, Posts, and Drafts can now be converted by multiple converters.</li>
|
2675
2790
|
<li>Static files can now be safely included in collections. They’ll be placed
|
2676
|
-
in a <code class="highlighter-rouge">collection.files</code> array. <code class="highlighter-rouge">collection.docs</code> still holds exclusively
|
2791
|
+
in a <code class="language-plaintext highlighter-rouge">collection.files</code> array. <code class="language-plaintext highlighter-rouge">collection.docs</code> still holds exclusively
|
2677
2792
|
content with YAML front matter.</li>
|
2678
2793
|
<li>Sass files can once again be rendered by Liquid. However, neither Sass
|
2679
|
-
nor CoffeeScript can ever have a layout. Bonus: <code class="highlighter-rouge">scssify</code> and <code class="highlighter-rouge">sassify</code>
|
2794
|
+
nor CoffeeScript can ever have a layout. Bonus: <code class="language-plaintext highlighter-rouge">scssify</code> and <code class="language-plaintext highlighter-rouge">sassify</code>
|
2680
2795
|
Liquid filters.</li>
|
2681
|
-
<li>Partial variables allowed now in the path argument of <code class="highlighter-rouge">include</code> calls</li>
|
2682
|
-
<li>We added a <code class="highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
2683
|
-
about that subcommand. Or don’t, to see the help for <code class="highlighter-rouge">jekyll</code> itself.</li>
|
2684
|
-
<li>Lots of fixes to the site template we use for <code class="highlighter-rouge">jekyll new</code>, including
|
2796
|
+
<li>Partial variables allowed now in the path argument of <code class="language-plaintext highlighter-rouge">include</code> calls</li>
|
2797
|
+
<li>We added a <code class="language-plaintext highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
2798
|
+
about that subcommand. Or don’t, to see the help for <code class="language-plaintext highlighter-rouge">jekyll</code> itself.</li>
|
2799
|
+
<li>Lots of fixes to the site template we use for <code class="language-plaintext highlighter-rouge">jekyll new</code>, including
|
2685
2800
|
converting the CSS into SCSS.</li>
|
2686
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter will now call <code class="highlighter-rouge">#to_liquid</code> for you</li>
|
2801
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter will now call <code class="language-plaintext highlighter-rouge">#to_liquid</code> for you</li>
|
2687
2802
|
<li>Lots, lots more!</li>
|
2688
2803
|
</ul>
|
2689
2804
|
|
2690
2805
|
<p>One change deserves special note. In <a href="https://github.com/jekyll/jekyll/issues/2633">#2633</a>, subfolders <em>inside</em> a
|
2691
|
-
<code class="highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
2806
|
+
<code class="language-plaintext highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
2692
2807
|
turns out, this behaviour was unwanted by a large number of individuals, as
|
2693
2808
|
it is a handy way to organize posts. Ultimately, we decided to revert this
|
2694
2809
|
change in <a href="https://github.com/jekyll/jekyll/issues/2705">#2705</a>, because it was a change in behaviour that was already
|
@@ -2729,7 +2844,7 @@ page</a>! Happy Jekylling!</p>
|
|
2729
2844
|
<li>A warning will now fire if you specify a layout in any of your pages or
|
2730
2845
|
posts that doesn’t exist.</li>
|
2731
2846
|
<li>Certain Pygments options are now whitelisted in safe mode</li>
|
2732
|
-
<li>Categories in a post’s path are now respected (i.e. folders in <code class="highlighter-rouge">_posts</code>
|
2847
|
+
<li>Categories in a post’s path are now respected (i.e. folders in <code class="language-plaintext highlighter-rouge">_posts</code>
|
2733
2848
|
will now work properly).</li>
|
2734
2849
|
</ol>
|
2735
2850
|
|
@@ -2769,7 +2884,7 @@ introduces fixes for a couple security-related issues.</p>
|
|
2769
2884
|
|
2770
2885
|
<ol>
|
2771
2886
|
<li>One in the reading of data</li>
|
2772
|
-
<li>One in the <code class="highlighter-rouge">layouts</code> setting</li>
|
2887
|
+
<li>One in the <code class="language-plaintext highlighter-rouge">layouts</code> setting</li>
|
2773
2888
|
</ol>
|
2774
2889
|
|
2775
2890
|
<p>They were identified in Jekyll 1.5.1 and has been confirmed as patched
|
@@ -2777,7 +2892,7 @@ in this version and the version used by GitHub Pages. If you are in the
|
|
2777
2892
|
business of building Jekyll sites, please ensure you upgrade to 2.1.1 as
|
2778
2893
|
soon as possible.</p>
|
2779
2894
|
|
2780
|
-
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
2895
|
+
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="language-plaintext highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
2781
2896
|
|
2782
2897
|
<p>Additionally, the dependency on Maruku has been loosened and a bug was
|
2783
2898
|
fixed with document URLs.</p>
|
@@ -2821,13 +2936,13 @@ things to look forward to:</p>
|
|
2821
2936
|
<li>Set front matter defaults for collections (#2419)</li>
|
2822
2937
|
<li>Set a collection-specific URL template (#2418)</li>
|
2823
2938
|
<li>
|
2824
|
-
<code class="highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
2939
|
+
<code class="language-plaintext highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
2825
2940
|
<li>
|
2826
|
-
<code class="highlighter-rouge">.json</code> files in <code class="highlighter-rouge">_data</code> (#2369)</li>
|
2827
|
-
<li>Allow subdirectories in <code class="highlighter-rouge">_data</code> (#2395)</li>
|
2828
|
-
<li>Add support for <code class="highlighter-rouge">hl_lines</code> in <code class="highlighter-rouge">highlight</code> tag (#2532)</li>
|
2941
|
+
<code class="language-plaintext highlighter-rouge">.json</code> files in <code class="language-plaintext highlighter-rouge">_data</code> (#2369)</li>
|
2942
|
+
<li>Allow subdirectories in <code class="language-plaintext highlighter-rouge">_data</code> (#2395)</li>
|
2943
|
+
<li>Add support for <code class="language-plaintext highlighter-rouge">hl_lines</code> in <code class="language-plaintext highlighter-rouge">highlight</code> tag (#2532)</li>
|
2829
2944
|
<li>Post categories now merge with directory, front matter, and defaults (#2373)</li>
|
2830
|
-
<li>New <code class="highlighter-rouge">--skip_initial_build</code> flag for <code class="highlighter-rouge">jekyll serve</code> (#2477)</li>
|
2945
|
+
<li>New <code class="language-plaintext highlighter-rouge">--skip_initial_build</code> flag for <code class="language-plaintext highlighter-rouge">jekyll serve</code> (#2477)</li>
|
2831
2946
|
<li>A bajilion bug fixes and site updates!</li>
|
2832
2947
|
</ul>
|
2833
2948
|
|
@@ -2947,15 +3062,15 @@ swell on your favourite hardware.</a></p>
|
|
2947
3062
|
<li>
|
2948
3063
|
<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>
|
2949
3064
|
<li>
|
2950
|
-
<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>
|
3065
|
+
<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="language-plaintext highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
2951
3066
|
<li>
|
2952
3067
|
<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>
|
2953
3068
|
<li>
|
2954
|
-
<a href="/docs/configuration/#front-matter-defaults">YAML 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>
|
3069
|
+
<a href="/docs/configuration/#front-matter-defaults">YAML Front Matter defaults</a> - If you’ve set <code class="language-plaintext 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>
|
2955
3070
|
<li>
|
2956
|
-
<a href="/docs/configuration/#custom-markdown-processors">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>
|
3071
|
+
<a href="/docs/configuration/#custom-markdown-processors">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="language-plaintext highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
|
2957
3072
|
<li>
|
2958
|
-
<a href="/docs/templates/#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>
|
3073
|
+
<a href="/docs/templates/#filters">Addition of <code class="language-plaintext highlighter-rouge">where</code> and <code class="language-plaintext highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="language-plaintext highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="language-plaintext highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
|
2959
3074
|
<li>
|
2960
3075
|
<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>
|
2961
3076
|
</ol>
|
@@ -2996,7 +3111,7 @@ swell on your favourite hardware.</a></p>
|
|
2996
3111
|
</div>
|
2997
3112
|
<div class="post-content">
|
2998
3113
|
<p>The hawk-eyed <a href="https://github.com/gregose">@gregose</a> spotted a bug in our
|
2999
|
-
<code class="highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
3114
|
+
<code class="language-plaintext highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
3000
3115
|
|
3001
3116
|
<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>
|
3002
3117
|
<span class="o">=></span> <span class="s2">"/tmp/foobar/jail/../../../etc/passwd"</span></code></pre></figure>
|
@@ -3036,7 +3151,7 @@ the masses. Thanks, Greg!</p>
|
|
3036
3151
|
</div>
|
3037
3152
|
<div class="post-content">
|
3038
3153
|
<p>As work continues on Jekyll 2.0.0, we felt it was important to address two key
|
3039
|
-
issues of Jekyll 1.4.3, namely the <code class="highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
3154
|
+
issues of Jekyll 1.4.3, namely the <code class="language-plaintext highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
3040
3155
|
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>
|
3041
3156
|
|
3042
3157
|
<p>For a full changelog, check out our <a href="/docs/history/#v1-5-0">history</a> page.</p>
|
@@ -3081,7 +3196,7 @@ generated output via improper symlink sanitization, potentially resulting in an
|
|
3081
3196
|
inadvertent information disclosure.</p>
|
3082
3197
|
|
3083
3198
|
<p>Versions of Jekyll prior to 1.4.3 may also allow malicious users to write
|
3084
|
-
arbitrary <code class="highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
3199
|
+
arbitrary <code class="language-plaintext highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
3085
3200
|
traversal, potentially overwriting otherwise-trusted content with arbitrary HTML
|
3086
3201
|
or Javascript depending on your server’s configuration.</p>
|
3087
3202
|
|
@@ -3116,8 +3231,8 @@ these vulnerabilities, and to <a href="https://github.com/BenBalter" class="user
|
|
3116
3231
|
<div class="post-content">
|
3117
3232
|
<p>This release fixes <a href="https://github.com/jekyll/jekyll/pull/1830">a regression</a> where Maruku fenced code blocks were turned
|
3118
3233
|
off, instead of the previous default to on. We’ve added a new default
|
3119
|
-
configuration to our <code class="highlighter-rouge">maruku</code> config key: <code class="highlighter-rouge">fenced_code_blocks</code> and set it to
|
3120
|
-
default to <code class="highlighter-rouge">true</code>.</p>
|
3234
|
+
configuration to our <code class="language-plaintext highlighter-rouge">maruku</code> config key: <code class="language-plaintext highlighter-rouge">fenced_code_blocks</code> and set it to
|
3235
|
+
default to <code class="language-plaintext highlighter-rouge">true</code>.</p>
|
3121
3236
|
|
3122
3237
|
<p>If you do not wish to use Maruku fenced code blocks, you may turn this option
|
3123
3238
|
off in your site’s configuration file.</p>
|
@@ -3200,7 +3315,7 @@ Jekyll v1.4.0. This release will be the last non-patch release to support Ruby
|
|
3200
3315
|
a ton of bugfixes over the previous 0.6.x releases.</p>
|
3201
3316
|
</li>
|
3202
3317
|
<li>
|
3203
|
-
<p>Non-<code class="highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
3318
|
+
<p>Non-<code class="language-plaintext highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
3204
3319
|
processed, which can provide a rudimentary way to establish a load order for
|
3205
3320
|
plugins.</p>
|
3206
3321
|
</li>
|
@@ -3244,7 +3359,7 @@ Karékinian, Jordon Bedwell, Matthew Iversen, Persa Zula, and Yi Zeng.</p>
|
|
3244
3359
|
release of 1.3.0.</p>
|
3245
3360
|
|
3246
3361
|
<p>In addition to a couple of other smaller bug fixes, the biggest thing
|
3247
|
-
we’ve fixed is an issue with the <code class="highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
3362
|
+
we’ve fixed is an issue with the <code class="language-plaintext highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
3248
3363
|
full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
3249
3364
|
|
3250
3365
|
<p>Thanks to all the people who have contributed to this release! They are
|
@@ -3288,33 +3403,33 @@ love.</p>
|
|
3288
3403
|
<ul>
|
3289
3404
|
<li>
|
3290
3405
|
<p>You can add <a href="/docs/datafiles/">arbitrary data</a> to the site by adding YAML files under a
|
3291
|
-
site’s <code class="highlighter-rouge">_data</code> directory. This will allow you to avoid
|
3406
|
+
site’s <code class="language-plaintext highlighter-rouge">_data</code> directory. This will allow you to avoid
|
3292
3407
|
repetition in your templates and to set site specific options without
|
3293
|
-
changing <code class="highlighter-rouge">_config.yml</code>.</p>
|
3408
|
+
changing <code class="language-plaintext highlighter-rouge">_config.yml</code>.</p>
|
3294
3409
|
</li>
|
3295
3410
|
<li>
|
3296
|
-
<p>You can now run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
3297
|
-
background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut
|
3411
|
+
<p>You can now run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
3412
|
+
background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut
|
3298
3413
|
the server down. When ran, you’ll get a process id that you can use in
|
3299
|
-
place of <code class="highlighter-rouge">[server_pid]</code></p>
|
3414
|
+
place of <code class="language-plaintext highlighter-rouge">[server_pid]</code></p>
|
3300
3415
|
</li>
|
3301
3416
|
<li>
|
3302
3417
|
<p>You can now <strong>disable automatically-generated excerpts</strong> if you set
|
3303
|
-
<code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</p>
|
3418
|
+
<code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</p>
|
3304
3419
|
</li>
|
3305
3420
|
<li>
|
3306
3421
|
<p>If you’re moving pages and posts, you can now check for <strong>URL
|
3307
|
-
conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</p>
|
3422
|
+
conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</p>
|
3308
3423
|
</li>
|
3309
3424
|
<li>
|
3310
3425
|
<p>If you’re a fan of the drafts feature, you’ll be happy to know we’ve
|
3311
|
-
added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</p>
|
3426
|
+
added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</p>
|
3312
3427
|
</li>
|
3313
3428
|
<li>
|
3314
3429
|
<p>Permalinks with special characters should now generate without errors.</p>
|
3315
3430
|
</li>
|
3316
3431
|
<li>
|
3317
|
-
<p>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid
|
3432
|
+
<p>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid
|
3318
3433
|
variable.</p>
|
3319
3434
|
</li>
|
3320
3435
|
</ul>
|
@@ -3385,11 +3500,11 @@ issues!</p>
|
|
3385
3500
|
<div class="post-content">
|
3386
3501
|
<p>Quick turnover, anyone? A <a href="https://github.com/jekyll/jekyll/pull/1525">recent incompatibility with Liquid
|
3387
3502
|
v2.5.2</a> produced a nasty bug in
|
3388
|
-
which <code class="highlighter-rouge">include</code> tags were not rendered properly within <code class="highlighter-rouge">if</code> blocks.</p>
|
3503
|
+
which <code class="language-plaintext highlighter-rouge">include</code> tags were not rendered properly within <code class="language-plaintext highlighter-rouge">if</code> blocks.</p>
|
3389
3504
|
|
3390
3505
|
<p>This release also includes a better handling of detached servers (prints pid and
|
3391
|
-
the command for killing the process). <strong>Note</strong>: the <code class="highlighter-rouge">--detach</code> flag and
|
3392
|
-
<code class="highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
3506
|
+
the command for killing the process). <strong>Note</strong>: the <code class="language-plaintext highlighter-rouge">--detach</code> flag and
|
3507
|
+
<code class="language-plaintext highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
3393
3508
|
|
3394
3509
|
<p>For a full list of the fixes in this release, check out <a href="/docs/history/">the change
|
3395
3510
|
log</a>!</p>
|
@@ -3427,12 +3542,12 @@ enhancements that we think you’ll love.</p>
|
|
3427
3542
|
<p>Here are a few things we think you’ll want to know about this release:</p>
|
3428
3543
|
|
3429
3544
|
<ul>
|
3430
|
-
<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>
|
3431
|
-
<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>
|
3432
|
-
<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>
|
3433
|
-
<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>
|
3545
|
+
<li>Run <code class="language-plaintext 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="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut the server down.</li>
|
3546
|
+
<li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</li>
|
3547
|
+
<li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</li>
|
3548
|
+
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</li>
|
3434
3549
|
<li>Permalinks with special characters should now generate without errors.</li>
|
3435
|
-
<li>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
3550
|
+
<li>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
3436
3551
|
</ul>
|
3437
3552
|
|
3438
3553
|
<p>For a full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
@@ -3465,9 +3580,9 @@ enhancements that we think you’ll love.</p>
|
|
3465
3580
|
<div class="post-content">
|
3466
3581
|
<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>
|
3467
3582
|
|
3468
|
-
<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>
|
3583
|
+
<p>Community and custom plugins extending the <code class="language-plaintext 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>
|
3469
3584
|
|
3470
|
-
<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>
|
3585
|
+
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3471
3586
|
|
3472
3587
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
3473
3588
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
@@ -3501,9 +3616,9 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
|
|
3501
3616
|
<div class="post-content">
|
3502
3617
|
<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>
|
3503
3618
|
|
3504
|
-
<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>
|
3619
|
+
<p>Community and custom plugins extending the <code class="language-plaintext 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>
|
3505
3620
|
|
3506
|
-
<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>
|
3621
|
+
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3507
3622
|
|
3508
3623
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
3509
3624
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
@@ -3579,12 +3694,12 @@ more a more detailed changelog for this release.</p>
|
|
3579
3694
|
Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new additions:</p>
|
3580
3695
|
|
3581
3696
|
<ul>
|
3582
|
-
<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>
|
3583
|
-
<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>
|
3697
|
+
<li>Add <code class="language-plaintext highlighter-rouge">docs</code> subcommand to read Jekyll’s docs when offline. (<a href="https://github.com/jekyll/jekyll/issues/1046">#1046</a>)</li>
|
3698
|
+
<li>Support passing parameters to templates in <code class="language-plaintext highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
|
3584
3699
|
<li>Add support for Liquid tags to post excerpts (<a href="https://github.com/jekyll/jekyll/issues/1302">#1302</a>)</li>
|
3585
3700
|
<li>Fix pagination for subdirectories (<a href="https://github.com/jekyll/jekyll/issues/1198">#1198</a>)</li>
|
3586
3701
|
<li>Provide better error reporting when generating sites (<a href="https://github.com/jekyll/jekyll/issues/1253">#1253</a>)</li>
|
3587
|
-
<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>
|
3702
|
+
<li>Latest posts first in non-LSI <code class="language-plaintext highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
|
3588
3703
|
</ul>
|
3589
3704
|
|
3590
3705
|
<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>
|
@@ -3620,10 +3735,10 @@ Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new add
|
|
3620
3735
|
|
3621
3736
|
<ul>
|
3622
3737
|
<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>
|
3623
|
-
<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>
|
3624
|
-
<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>
|
3625
|
-
<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>
|
3626
|
-
<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>
|
3738
|
+
<li>Add support for private gists to <code class="language-plaintext highlighter-rouge">gist</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1189">#1189</a>)</li>
|
3739
|
+
<li>Add <code class="language-plaintext highlighter-rouge">--force</code> option to <code class="language-plaintext highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/1115">#1115</a>)</li>
|
3740
|
+
<li>Fix compatibility with <code class="language-plaintext highlighter-rouge">exclude</code> and <code class="language-plaintext highlighter-rouge">include</code> with pre-1.0 Jekyll (<a href="https://github.com/jekyll/jekyll/issues/1114">#1114</a>)</li>
|
3741
|
+
<li>Fix pagination issue regarding <code class="language-plaintext highlighter-rouge">File.basename</code> and <code class="language-plaintext highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
|
3627
3742
|
</ul>
|
3628
3743
|
|
3629
3744
|
<p>See the <a href="/docs/history/#v1-0-3">History</a> page for more information on this release.</p>
|
@@ -3660,11 +3775,11 @@ releases, and fix some other annoying bugs:</p>
|
|
3660
3775
|
|
3661
3776
|
<ul>
|
3662
3777
|
<li>Backwards-compatibilize relative permalinks (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
3663
|
-
<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>
|
3664
|
-
<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>
|
3778
|
+
<li>Add <code class="language-plaintext 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>
|
3779
|
+
<li>Deprecate old config <code class="language-plaintext highlighter-rouge">server_port</code>, match to <code class="language-plaintext highlighter-rouge">port</code> if <code class="language-plaintext highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
|
3665
3780
|
<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>
|
3666
3781
|
<li>Fix issue when post categories are numbers (<a href="https://github.com/jekyll/jekyll/issues/1078">#1078</a>)</li>
|
3667
|
-
<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>
|
3782
|
+
<li>Add a <code class="language-plaintext highlighter-rouge">data-lang="<lang>"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
|
3668
3783
|
<li>Catching that Redcarpet gem isn’t installed (<a href="https://github.com/jekyll/jekyll/issues/1059">#1059</a>)</li>
|
3669
3784
|
</ul>
|
3670
3785
|
|
@@ -3700,13 +3815,13 @@ releases, and fix some other annoying bugs:</p>
|
|
3700
3815
|
<p>Hot on the trails of v1.0, v1.0.1 is out! Here are the highlights:</p>
|
3701
3816
|
|
3702
3817
|
<ul>
|
3703
|
-
<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>
|
3818
|
+
<li>Add newer <code class="language-plaintext highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
|
3704
3819
|
<li>Commander error message now preferred over process abort with incorrect args (<a href="https://github.com/jekyll/jekyll/issues/1040">#1040</a>)</li>
|
3705
3820
|
<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>
|
3706
3821
|
<li>Make Redcarpet respect the pygments configuration option (<a href="https://github.com/jekyll/jekyll/issues/1053">#1053</a>)</li>
|
3707
3822
|
<li>Fix the index build with LSI (<a href="https://github.com/jekyll/jekyll/issues/1045">#1045</a>)</li>
|
3708
3823
|
<li>Don’t print deprecation warning when no arguments are specified. (<a href="https://github.com/jekyll/jekyll/issues/1041">#1041</a>)</li>
|
3709
|
-
<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>
|
3824
|
+
<li>Add missing <code class="language-plaintext highlighter-rouge"></div></code> to site template used by <code class="language-plaintext highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
|
3710
3825
|
</ul>
|
3711
3826
|
|
3712
3827
|
<p>See the <a href="/docs/history/#v1-0-1">History</a> page for more information on this release.</p>
|
@@ -3774,23 +3889,23 @@ examples and for compiling this list):</p>
|
|
3774
3889
|
<ul>
|
3775
3890
|
|
3776
3891
|
<li class="">
|
3777
|
-
<a href="/news/
|
3892
|
+
<a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
|
3778
3893
|
</li>
|
3779
3894
|
|
3780
3895
|
<li class="">
|
3781
|
-
<a href="/news/2018/
|
3896
|
+
<a href="/news/2018/06/05/jekyll-3-8-3-released/">Version 3.8.3</a>
|
3782
3897
|
</li>
|
3783
3898
|
|
3784
3899
|
<li class="">
|
3785
|
-
<a href="/news/2018/
|
3900
|
+
<a href="/news/2018/05/19/jekyll-3-8-2-released/">Version 3.8.2</a>
|
3786
3901
|
</li>
|
3787
3902
|
|
3788
3903
|
<li class="">
|
3789
|
-
<a href="/news/2018/01/
|
3904
|
+
<a href="/news/2018/05/01/jekyll-3-8-1-released/">Version 3.8.1</a>
|
3790
3905
|
</li>
|
3791
3906
|
|
3792
3907
|
<li class="">
|
3793
|
-
<a href="/news/
|
3908
|
+
<a href="/news/2018/02/24/jekyll-3-7-3-released/">Version 3.7.3</a>
|
3794
3909
|
</li>
|
3795
3910
|
|
3796
3911
|
<li>
|
@@ -3805,6 +3920,12 @@ examples and for compiling this list):</p>
|
|
3805
3920
|
|
3806
3921
|
|
3807
3922
|
|
3923
|
+
|
3924
|
+
|
3925
|
+
|
3926
|
+
|
3927
|
+
|
3928
|
+
|
3808
3929
|
<li class="">
|
3809
3930
|
<a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
|
3810
3931
|
</li>
|
@@ -3990,7 +4111,7 @@ examples and for compiling this list):</p>
|
|
3990
4111
|
<footer>
|
3991
4112
|
<div class="grid">
|
3992
4113
|
<div class="unit one-third center-on-mobiles">
|
3993
|
-
<p>The contents of this website are <br>©
|
4114
|
+
<p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
3994
4115
|
</div>
|
3995
4116
|
<div class="unit two-thirds align-right center-on-mobiles">
|
3996
4117
|
<p>
|