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
|
@@ -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>Releases | Jekyll • Simple, blog-aware, static sites</title>
|
|
17
|
-
<meta name="generator" content="Jekyll v3.
|
|
18
|
-
<meta property="og:title" content="Releases"
|
|
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/releases/"
|
|
24
|
-
<meta property="og:url" content="https://jekyllrb.com/news/releases/"
|
|
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="Releases" />
|
|
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/releases/" />
|
|
23
|
+
<meta property="og:url" content="https://jekyllrb.com/news/releases/" />
|
|
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="Releases" />
|
|
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/releases/","headline":"Releases","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
|
|
|
@@ -364,20 +479,20 @@ regressions due to the changes made in that release. In due time, Team Jekyll
|
|
|
364
479
|
set out to address those issues as early as possible.</p>
|
|
365
480
|
|
|
366
481
|
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
|
367
|
-
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
|
482
|
+
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">
|
|
368
483
|
The highlights being:</p>
|
|
369
484
|
|
|
370
485
|
<ul>
|
|
371
486
|
<li>
|
|
372
487
|
<p>A major regression in 3.7.0 was that when a Front Matter Default was
|
|
373
|
-
configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
|
488
|
+
configured with a <code class="language-plaintext highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
|
374
489
|
that directory for any subfolders and files, for each document in that
|
|
375
|
-
<code class="highlighter-rouge">path</code>.
|
|
490
|
+
<code class="language-plaintext highlighter-rouge">path</code>.
|
|
376
491
|
Though this is intended, it increases build times in proportion to the size
|
|
377
492
|
of the directory.</p>
|
|
378
493
|
|
|
379
494
|
<p>We addressed this by having Jekyll scan the directory path only if the user
|
|
380
|
-
explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
|
495
|
+
explicitly configures the <code class="language-plaintext highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
|
381
496
|
|
|
382
497
|
<p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
|
|
383
498
|
for more details.</p>
|
|
@@ -389,7 +504,7 @@ additionally providing us with a test repository to aid in resolving the issue.<
|
|
|
389
504
|
<p>Another regression reported was related to our “Custom collections
|
|
390
505
|
directory” feature introduced in 3.7.0.</p>
|
|
391
506
|
|
|
392
|
-
<p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
|
507
|
+
<p>Users setting <code class="language-plaintext highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
|
393
508
|
paths to their posts still at the root of their site’s source. This
|
|
394
509
|
roughly translated to 404 errors on URLs to their posts.</p>
|
|
395
510
|
|
|
@@ -397,19 +512,19 @@ roughly translated to 404 errors on URLs to their posts.</p>
|
|
|
397
512
|
|
|
398
513
|
<p>We decided to resolve this by having Jekyll ignore posts and drafts at the
|
|
399
514
|
root of the site’s source directory if the user customizes the
|
|
400
|
-
<code class="highlighter-rouge">collection_dir</code> setting.</p>
|
|
515
|
+
<code class="language-plaintext highlighter-rouge">collection_dir</code> setting.</p>
|
|
401
516
|
|
|
402
517
|
<p>Ergo, if you set a custom location for your collections, please ensure you
|
|
403
518
|
move all of your collections into that directory. <strong>This includes posts and
|
|
404
519
|
drafts as well</strong>. Your links generated by
|
|
405
|
-
<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
|
|
520
|
+
<code class="language-plaintext highlighter-rouge">{% post_url %}</code> or <code class="language-plaintext highlighter-rouge">{% link %}</code>
|
|
406
521
|
will adapt automatically.</p>
|
|
407
522
|
</li>
|
|
408
523
|
<li>
|
|
409
|
-
<p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
|
524
|
+
<p>We also found out that <code class="language-plaintext highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
|
410
525
|
being watched on Windows. So we recommend having it included in your Gemfile
|
|
411
526
|
for a better development experience on Windows. (Newly generated Gemfiles
|
|
412
|
-
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://
|
|
527
|
+
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>
|
|
413
528
|
</li>
|
|
414
529
|
</ul>
|
|
415
530
|
|
|
@@ -423,7 +538,7 @@ Paul Robert Lloyd.</p>
|
|
|
423
538
|
|
|
424
539
|
<p>As always, you can see our full changelog on <a href="/docs/history/">the History page</a>.</p>
|
|
425
540
|
|
|
426
|
-
<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
|
541
|
+
<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>
|
|
427
542
|
|
|
428
543
|
</div>
|
|
429
544
|
</article>
|
|
@@ -455,11 +570,11 @@ Paul Robert Lloyd.</p>
|
|
|
455
570
|
Here are a few of the latest additions from our contributors:</p>
|
|
456
571
|
|
|
457
572
|
<ul>
|
|
458
|
-
<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>
|
|
459
|
-
<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://
|
|
460
|
-
<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>
|
|
573
|
+
<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>
|
|
574
|
+
<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>
|
|
575
|
+
<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>
|
|
461
576
|
<li>Jekyll will now check to determine whether host machine has internet connection.</li>
|
|
462
|
-
<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>
|
|
577
|
+
<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>
|
|
463
578
|
<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>
|
|
464
579
|
<li>
|
|
465
580
|
<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
|
|
@@ -474,7 +589,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
|
474
589
|
<p>Oh, one last thing…</p>
|
|
475
590
|
|
|
476
591
|
<h3 id="pray-upgrade-your-ruby">
|
|
477
|
-
<img class="emoji" title=":pray:" alt=":pray:" src="https://
|
|
592
|
+
<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>
|
|
478
593
|
|
|
479
594
|
<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>
|
|
480
595
|
|
|
@@ -512,7 +627,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
|
512
627
|
</a>
|
|
513
628
|
</div>
|
|
514
629
|
<div class="post-content">
|
|
515
|
-
<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>
|
|
630
|
+
<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>
|
|
516
631
|
if you want to avoid possible build problems with:</p>
|
|
517
632
|
|
|
518
633
|
<ul>
|
|
@@ -532,7 +647,7 @@ working on the next minor version 3.7.0 that will allow you to store all your
|
|
|
532
647
|
collections in a single directory. Stay tuned.</p>
|
|
533
648
|
|
|
534
649
|
<p>Theme developers are invited to test the brand new
|
|
535
|
-
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
|
650
|
+
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="language-plaintext highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
|
536
651
|
and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
|
|
537
652
|
GitHub hosted theme as a remote theme!</p>
|
|
538
653
|
|
|
@@ -576,7 +691,7 @@ today.</p>
|
|
|
576
691
|
<div class="post-content">
|
|
577
692
|
<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>
|
|
578
693
|
|
|
579
|
-
<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>
|
|
694
|
+
<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>
|
|
580
695
|
|
|
581
696
|
<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>
|
|
582
697
|
|
|
@@ -613,12 +728,12 @@ today.</p>
|
|
|
613
728
|
<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>
|
|
614
729
|
|
|
615
730
|
<ul>
|
|
616
|
-
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
|
|
731
|
+
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="language-plaintext highlighter-rouge">Document#url</code> (#6301)</li>
|
|
617
732
|
<li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
|
|
618
|
-
<li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
|
619
|
-
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
|
|
620
|
-
<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>
|
|
621
|
-
<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>
|
|
733
|
+
<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>
|
|
734
|
+
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="language-plaintext highlighter-rouge">absolute_url</code> (#6287)</li>
|
|
735
|
+
<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>
|
|
736
|
+
<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>
|
|
622
737
|
</ul>
|
|
623
738
|
|
|
624
739
|
<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>
|
|
@@ -657,8 +772,8 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
|
657
772
|
<p>We’ve released a few bugfixes in the form of v3.5.1 today:</p>
|
|
658
773
|
|
|
659
774
|
<ul>
|
|
660
|
-
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
|
661
|
-
<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>
|
|
775
|
+
<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>
|
|
776
|
+
<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>
|
|
662
777
|
<li>Static files’ liquid representations should now have all the keys you were expecting when serialized into JSON.</li>
|
|
663
778
|
</ul>
|
|
664
779
|
|
|
@@ -698,18 +813,18 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
|
698
813
|
the wild. Some new shiny things you might want to test out:</p>
|
|
699
814
|
|
|
700
815
|
<ul>
|
|
701
|
-
<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>
|
|
816
|
+
<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>
|
|
702
817
|
</li>
|
|
703
818
|
<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>
|
|
704
819
|
<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>
|
|
705
|
-
<li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
|
|
706
|
-
<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>
|
|
707
|
-
<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>
|
|
820
|
+
<li>Pages, posts, and other documents can now access layout variables via <code class="language-plaintext highlighter-rouge">{{ layout }}</code>.</li>
|
|
821
|
+
<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>
|
|
822
|
+
<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>
|
|
708
823
|
<li>You can now create tab-separated data files.</li>
|
|
709
|
-
<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>
|
|
824
|
+
<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>
|
|
710
825
|
<li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
|
|
711
|
-
<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>
|
|
712
|
-
<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>
|
|
826
|
+
<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>
|
|
827
|
+
<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>
|
|
713
828
|
</ul>
|
|
714
829
|
|
|
715
830
|
<p>And <a href="/docs/history/">so much more!</a></p>
|
|
@@ -724,9 +839,9 @@ Thank you, all!</p>
|
|
|
724
839
|
|
|
725
840
|
<p>Please file any bugs with detailed replication instructions if you find any
|
|
726
841
|
bugs. Better yet, submit a patch if you find the bug in the code and know
|
|
727
|
-
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://
|
|
842
|
+
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>
|
|
728
843
|
|
|
729
|
-
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
|
844
|
+
<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>
|
|
730
845
|
|
|
731
846
|
</div>
|
|
732
847
|
</article>
|
|
@@ -756,26 +871,26 @@ how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://ass
|
|
|
756
871
|
<div class="post-content">
|
|
757
872
|
<p>Another one-PR patch update as we continue our quest to destroy all bugs. A
|
|
758
873
|
fairly technical debriefing follows, but the TLDR is that we have updated the
|
|
759
|
-
<code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
|
874
|
+
<code class="language-plaintext highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
|
760
875
|
|
|
761
876
|
<p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
|
|
762
877
|
moved away from using the deprecated
|
|
763
|
-
<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>
|
|
878
|
+
<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>
|
|
764
879
|
in favor of
|
|
765
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
|
|
766
|
-
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
|
|
880
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code></a>.
|
|
881
|
+
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="language-plaintext highlighter-rouge">uri_escape</code>
|
|
767
882
|
filter</a>.</p>
|
|
768
883
|
|
|
769
884
|
<p>While this transition was mostly a smooth one, the two methods are not
|
|
770
|
-
identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
|
|
771
|
-
<code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
|
|
885
|
+
identical. While <code class="language-plaintext highlighter-rouge">URI.escape</code> was happy to escape any string,
|
|
886
|
+
<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>
|
|
772
887
|
object, and will then escape each component of that object. In most cases, this
|
|
773
888
|
difference was insignificant, but there were a few cases where this caused some
|
|
774
889
|
unintended regressions when encoding colons.</p>
|
|
775
890
|
|
|
776
|
-
<p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
|
|
891
|
+
<p>While <strong>Addressable</strong> can understand that something like <code class="language-plaintext highlighter-rouge">"/example :page"</code> is a
|
|
777
892
|
relative URI, without the slash it cannot figure out how to turn
|
|
778
|
-
<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
|
|
893
|
+
<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
|
|
779
894
|
objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
|
|
780
895
|
but breaking in 3.4.0:</p>
|
|
781
896
|
|
|
@@ -785,8 +900,8 @@ but breaking in 3.4.0:</p>
|
|
|
785
900
|
<p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
|
|
786
901
|
|
|
787
902
|
<p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
|
|
788
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
|
789
|
-
which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
|
|
903
|
+
<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>
|
|
904
|
+
which will simply escape the characters in a string, much like <code class="language-plaintext highlighter-rouge">URI.escape</code>.</p>
|
|
790
905
|
|
|
791
906
|
<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
|
|
792
907
|
<a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
|
|
@@ -830,15 +945,15 @@ static files explicitly because they <em>don’t</em> have YAML front matter, wa
|
|
|
830
945
|
to respect YAML front matter?” That’s a great question. Let me illustrate
|
|
831
946
|
with an example.</p>
|
|
832
947
|
|
|
833
|
-
<p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
|
948
|
+
<p>Let’s look at <code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
|
834
949
|
pages, and static files, and some metadata for them in an XML file for a
|
|
835
950
|
Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
|
|
836
|
-
file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
|
951
|
+
file in this list, you set <code class="language-plaintext highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
|
837
952
|
what about static files, which don’t have YAML front matter? Before this
|
|
838
953
|
release, they could not be excluded because they had no properties in YAML
|
|
839
954
|
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>.
|
|
840
955
|
So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
|
|
841
|
-
<code class="highlighter-rouge">jekyll-sitemap</code>.</p>
|
|
956
|
+
<code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>.</p>
|
|
842
957
|
|
|
843
958
|
<p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
|
|
844
959
|
defaults</a> for static files:</p>
|
|
@@ -851,8 +966,8 @@ defaults</a> for static files:</p>
|
|
|
851
966
|
<span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
|
|
852
967
|
</code></pre></div></div>
|
|
853
968
|
|
|
854
|
-
<p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
|
|
855
|
-
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>
|
|
969
|
+
<p>Now, for every file in the Liquid <code class="language-plaintext highlighter-rouge">site.static_files</code> loop which is in the
|
|
970
|
+
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>
|
|
856
971
|
|
|
857
972
|
<p>Many thanks to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a> for coming up with the solution and ensuring
|
|
858
973
|
sitemaps everywhere are filled with just the right content.</p>
|
|
@@ -939,7 +1054,7 @@ well.</p>
|
|
|
939
1054
|
|
|
940
1055
|
<p>Well, not so much.</p>
|
|
941
1056
|
|
|
942
|
-
<p>A very common way to specify the month of February is <code class="highlighter-rouge">2</code>. This is true for
|
|
1057
|
+
<p>A very common way to specify the month of February is <code class="language-plaintext highlighter-rouge">2</code>. This is true for
|
|
943
1058
|
all single-digit months and days of the month. Notice anything about our
|
|
944
1059
|
first regular expression versus our second? The second regular expression
|
|
945
1060
|
imposes a <strong>minimum</strong>, as well as maximum, number of digits. This change
|
|
@@ -1013,8 +1128,8 @@ Packed full of bug fixes as usual, thanks to the tireless efforts of our
|
|
|
1013
1128
|
exceptional Jekyll community. Three changes to call out:</p>
|
|
1014
1129
|
|
|
1015
1130
|
<ol>
|
|
1016
|
-
<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
|
|
1017
|
-
even bigger fan of <a href="/docs/templates/#filters"><code class="highlighter-rouge">group_by_exp</code></a>.</li>
|
|
1131
|
+
<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
|
|
1132
|
+
even bigger fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">group_by_exp</code></a>.</li>
|
|
1018
1133
|
<li>Using a custom timezone in Jekyll on Windows? Yeah, sorry that hasn’t ever worked
|
|
1019
1134
|
properly. We made it possible to accurately <a href="https://jekyllrb.com/docs/windows/#timezone-management">set the timezone using IANA
|
|
1020
1135
|
timezone codes</a>.</li>
|
|
@@ -1076,7 +1191,7 @@ fixes to call out:</p>
|
|
|
1076
1191
|
|
|
1077
1192
|
<ol>
|
|
1078
1193
|
<li>Only warn about auto-regeneration issues on Windows instead of disabling</li>
|
|
1079
|
-
<li>Exclude very specific <code class="highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="highlighter-rouge">vendor/</code>
|
|
1194
|
+
<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>
|
|
1080
1195
|
</li>
|
|
1081
1196
|
<li>Allow permalink templates to have plaintext underscores</li>
|
|
1082
1197
|
</ol>
|
|
@@ -1114,14 +1229,14 @@ fixes to call out:</p>
|
|
|
1114
1229
|
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
|
1115
1230
|
Three key things you might want to try:</p>
|
|
1116
1231
|
|
|
1117
|
-
<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>
|
|
1232
|
+
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="language-plaintext highlighter-rouge">/assets</code> directory</h3>
|
|
1118
1233
|
|
|
1119
1234
|
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
|
1120
1235
|
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
|
1121
1236
|
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
|
1122
1237
|
|
|
1123
1238
|
<p>In an effort to make theme management a bit easier, any files you put into
|
|
1124
|
-
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
|
1239
|
+
<code class="language-plaintext highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
|
1125
1240
|
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
|
1126
1241
|
webfonts, and so on – anything you’d consider a part of the
|
|
1127
1242
|
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
|
@@ -1129,51 +1244,51 @@ front matter, it will be converted and rendered. No YAML front matter, and
|
|
|
1129
1244
|
it will simply be copied over like a static asset.</p>
|
|
1130
1245
|
|
|
1131
1246
|
<p>Note that if a user has a file of the same path, the theme content will not
|
|
1132
|
-
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
|
1133
|
-
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
|
1247
|
+
be included in the site, i.e. a user’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code> will be read and
|
|
1248
|
+
processed if present instead of a theme’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code>.</p>
|
|
1134
1249
|
|
|
1135
1250
|
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
|
1136
1251
|
for more info.</p>
|
|
1137
1252
|
|
|
1138
|
-
<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>
|
|
1253
|
+
<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>
|
|
1139
1254
|
|
|
1140
|
-
<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
|
|
1255
|
+
<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
|
|
1141
1256
|
new filters have you covered. When working locally, if you set your
|
|
1142
|
-
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
|
1143
|
-
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
|
1257
|
+
<code class="language-plaintext highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="language-plaintext highlighter-rouge">baseurl: "/myproject"</code>,
|
|
1258
|
+
then <code class="language-plaintext highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
|
1144
1259
|
you pass it:</p>
|
|
1145
1260
|
|
|
1146
1261
|
<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>
|
|
1147
1262
|
|
|
1148
|
-
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
|
1149
|
-
<code class="highlighter-rouge">"/"</code>):</p>
|
|
1263
|
+
<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
|
|
1264
|
+
<code class="language-plaintext highlighter-rouge">"/"</code>):</p>
|
|
1150
1265
|
|
|
1151
1266
|
<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>
|
|
1152
1267
|
|
|
1153
|
-
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
|
1154
|
-
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
|
1155
|
-
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
|
|
1268
|
+
<p>A result of <code class="language-plaintext highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
|
1269
|
+
relative to the domain root. A similar principle applies to <code class="language-plaintext highlighter-rouge">absolute_url</code>.
|
|
1270
|
+
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
|
|
1156
1271
|
easier to make:</p>
|
|
1157
1272
|
|
|
1158
1273
|
<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>
|
|
1159
1274
|
|
|
1160
|
-
<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>
|
|
1275
|
+
<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>
|
|
1161
1276
|
|
|
1162
|
-
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
|
1163
|
-
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
|
1164
|
-
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
|
1165
|
-
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
|
1166
|
-
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1277
|
+
<p>When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
|
1278
|
+
<code class="language-plaintext highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
|
1279
|
+
development. If you are using the new <code class="language-plaintext highlighter-rouge">absolute_url</code> filter, or using
|
|
1280
|
+
<code class="language-plaintext highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
|
1281
|
+
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>
|
|
1167
1282
|
|
|
1168
|
-
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
|
1169
|
-
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
|
1170
|
-
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
|
1171
|
-
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1283
|
+
<p>No longer! When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
|
1284
|
+
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
|
|
1285
|
+
<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>
|
|
1286
|
+
will yield <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1172
1287
|
|
|
1173
1288
|
<p>This happens by default when running Jekyll locally. It will not be set if
|
|
1174
|
-
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
|
|
1175
|
-
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
|
1176
|
-
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
|
1289
|
+
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
|
|
1290
|
+
any value except <code class="language-plaintext highlighter-rouge">development</code> (its default value), Jekyll will not
|
|
1291
|
+
overwrite the value of <code class="language-plaintext highlighter-rouge">url</code> in your config. And again, this only applies
|
|
1177
1292
|
to serving, not to building.</p>
|
|
1178
1293
|
|
|
1179
1294
|
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
|
@@ -1229,7 +1344,7 @@ bug report.</p>
|
|
|
1229
1344
|
<div class="post-content">
|
|
1230
1345
|
<p>Well, 3.2.0 has been a success, but with one fatal flaw: it doesn’t work on
|
|
1231
1346
|
Windows! Sorry, Windows users. Hot on the trail of 3.2.0, this release
|
|
1232
|
-
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
|
1347
|
+
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>
|
|
1233
1348
|
|
|
1234
1349
|
<p>This release also fixes an issue when using <a href="/docs/themes/">gem-based themes</a>
|
|
1235
1350
|
where the theme was rejected if it existed behind a symlink. This is a
|
|
@@ -1276,7 +1391,7 @@ say? Yes, proper, versionable, releasable, first-class themes. We’re pretty
|
|
|
1276
1391
|
stoked about it and we hope you like building and using them. For now, it
|
|
1277
1392
|
only supports layouts, includes, and sass, but we have plans to include
|
|
1278
1393
|
static assets like images and CSS/JS in a future release. <a href="/docs/themes/">Read more about
|
|
1279
|
-
it in the docs.</a> Our site template generated by <code class="highlighter-rouge">jekyll new</code>
|
|
1394
|
+
it in the docs.</a> Our site template generated by <code class="language-plaintext highlighter-rouge">jekyll new</code>
|
|
1280
1395
|
now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">minima</a> theme.</p>
|
|
1281
1396
|
|
|
1282
1397
|
<p>Some other notable changes:</p>
|
|
@@ -1284,9 +1399,9 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
|
1284
1399
|
<ul>
|
|
1285
1400
|
<li>Symlinks are allowed as long as they target a file in the site source</li>
|
|
1286
1401
|
<li>Explicit support for Ruby 2.0.x was dropped</li>
|
|
1287
|
-
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
|
1288
|
-
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
|
1289
|
-
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
|
1402
|
+
<li>Added an <code class="language-plaintext highlighter-rouge">:after_init</code> Hook</li>
|
|
1403
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
|
1404
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
|
1290
1405
|
post or document based on its path relative to the site source</li>
|
|
1291
1406
|
<li>… and lots more!</li>
|
|
1292
1407
|
</ul>
|
|
@@ -1417,7 +1532,7 @@ release. Thank you!</p>
|
|
|
1417
1532
|
</div>
|
|
1418
1533
|
<div class="post-content">
|
|
1419
1534
|
<p>Upon releasing 3.1.5 and kicking the tires, we noticed a glaring bug: our
|
|
1420
|
-
beloved <code class="highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
|
1535
|
+
beloved <code class="language-plaintext highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
|
1421
1536
|
us and we decided a 3.1.6 was necessary. This release restores sanity to
|
|
1422
1537
|
our object-to-JSON generation in Liquid and we hope you enjoy.</p>
|
|
1423
1538
|
|
|
@@ -1456,7 +1571,7 @@ changelog</a>.</p>
|
|
|
1456
1571
|
<p>There’s always at least one bug, right? :)</p>
|
|
1457
1572
|
|
|
1458
1573
|
<p>Hot on the trails of <a href="/news/2016/05/18/jekyll-3-1-4-released/">v3.1.4</a>, we
|
|
1459
|
-
bring you v3.1.5! It fixes one bug around requiring the <code class="highlighter-rouge">ExcerptDrop</code>,
|
|
1574
|
+
bring you v3.1.5! It fixes one bug around requiring the <code class="language-plaintext highlighter-rouge">ExcerptDrop</code>,
|
|
1460
1575
|
which only affects Linux. For the gory details, see <a href="https://github.com/jekyll/jekyll/pull/4912">the pull
|
|
1461
1576
|
request for the fix</a>.</p>
|
|
1462
1577
|
|
|
@@ -1493,15 +1608,15 @@ request for the fix</a>.</p>
|
|
|
1493
1608
|
<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>
|
|
1494
1609
|
|
|
1495
1610
|
<ul>
|
|
1496
|
-
<li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
|
1497
|
-
<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>
|
|
1498
|
-
<li>A fix where <code class="highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
|
1499
|
-
<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>
|
|
1611
|
+
<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>
|
|
1612
|
+
<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>
|
|
1613
|
+
<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>
|
|
1614
|
+
<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>
|
|
1500
1615
|
<li>
|
|
1501
|
-
<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>
|
|
1616
|
+
<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>
|
|
1502
1617
|
</ul>
|
|
1503
1618
|
|
|
1504
|
-
<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>
|
|
1619
|
+
<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>
|
|
1505
1620
|
|
|
1506
1621
|
<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>
|
|
1507
1622
|
|
|
@@ -1582,7 +1697,7 @@ we think you’ll love.</p>
|
|
|
1582
1697
|
|
|
1583
1698
|
<ul>
|
|
1584
1699
|
<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>
|
|
1585
|
-
<li>Running <code class="highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
|
1700
|
+
<li>Running <code class="language-plaintext highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
|
1586
1701
|
</ul>
|
|
1587
1702
|
|
|
1588
1703
|
<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>
|
|
@@ -1619,7 +1734,7 @@ we think you’ll love.</p>
|
|
|
1619
1734
|
|
|
1620
1735
|
<ul>
|
|
1621
1736
|
<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>
|
|
1622
|
-
<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>
|
|
1737
|
+
<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>
|
|
1623
1738
|
</ul>
|
|
1624
1739
|
|
|
1625
1740
|
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">collections</span><span class="pi">:</span>
|
|
@@ -1663,8 +1778,8 @@ we think you’ll love.</p>
|
|
|
1663
1778
|
<li>If a syntax error is encountered by Liquid, it will now print the line number.</li>
|
|
1664
1779
|
<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>
|
|
1665
1780
|
<li>A tilde at the beginning of a filename will no longer crash Jekyll.</li>
|
|
1666
|
-
<li>The <code class="highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
|
1667
|
-
<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>
|
|
1781
|
+
<li>The <code class="language-plaintext highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
|
1782
|
+
<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>
|
|
1668
1783
|
</ul>
|
|
1669
1784
|
|
|
1670
1785
|
<p>Nitty-gritty details, like always, are available in the <a href="/docs/history/">history</a>.</p>
|
|
@@ -1704,7 +1819,7 @@ fixes:</p>
|
|
|
1704
1819
|
|
|
1705
1820
|
<ul>
|
|
1706
1821
|
<li>Fix problem where outputting to a folder would have two extensions</li>
|
|
1707
|
-
<li>Handle tildes (<code class="highlighter-rouge">~</code>) in filenames properly</li>
|
|
1822
|
+
<li>Handle tildes (<code class="language-plaintext highlighter-rouge">~</code>) in filenames properly</li>
|
|
1708
1823
|
<li>Fix issue when comparing documents without dates</li>
|
|
1709
1824
|
<li>Include line numbers in liquid error output</li>
|
|
1710
1825
|
</ul>
|
|
@@ -1746,15 +1861,15 @@ you’re having.</p>
|
|
|
1746
1861
|
</a>
|
|
1747
1862
|
</div>
|
|
1748
1863
|
<div class="post-content">
|
|
1749
|
-
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
|
1864
|
+
<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
|
|
1750
1865
|
wonderful Jekyll users:</p>
|
|
1751
1866
|
|
|
1752
1867
|
<ul>
|
|
1753
|
-
<li>If your <code class="highlighter-rouge">permalink</code> ended with a <code class="highlighter-rouge">/</code>, your URL didn’t have any extension,
|
|
1868
|
+
<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,
|
|
1754
1869
|
even if you wanted one</li>
|
|
1755
|
-
<li>We now strip the BOM by default per Ruby’s <code class="highlighter-rouge">IO.open</code>.</li>
|
|
1870
|
+
<li>We now strip the BOM by default per Ruby’s <code class="language-plaintext highlighter-rouge">IO.open</code>.</li>
|
|
1756
1871
|
<li>
|
|
1757
|
-
<code class="highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
|
1872
|
+
<code class="language-plaintext highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
|
1758
1873
|
</ul>
|
|
1759
1874
|
|
|
1760
1875
|
<p>We also updated our <a href="/docs/conduct/">Code of Conduct</a> to the latest version of
|
|
@@ -1770,7 +1885,7 @@ that</a>.</p>
|
|
|
1770
1885
|
<p>See links to the PR’s on <a href="/docs/history/#v3-1-1">the history page</a>.</p>
|
|
1771
1886
|
|
|
1772
1887
|
<p>Thanks to Jordon Bedwell, chrisfinazzo, Kroum Tzanev, David Celis, and
|
|
1773
|
-
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
|
1888
|
+
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>
|
|
1774
1889
|
|
|
1775
1890
|
<p>Happy Jekylling!</p>
|
|
1776
1891
|
|
|
@@ -1812,13 +1927,13 @@ considerably!</p>
|
|
|
1812
1927
|
<p>Some other highlights:</p>
|
|
1813
1928
|
|
|
1814
1929
|
<ul>
|
|
1815
|
-
<li>Fix: <code class="highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
|
1816
|
-
<li>Fix: <code class="highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="highlighter-rouge">--source</code>.</li>
|
|
1817
|
-
<li>Enhancement: <code class="highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
|
1818
|
-
<li>Feature: adds new <code class="highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
|
1930
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
|
1931
|
+
<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>
|
|
1932
|
+
<li>Enhancement: <code class="language-plaintext highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
|
1933
|
+
<li>Feature: adds new <code class="language-plaintext highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
|
1819
1934
|
<li>Fix: Jekyll will read in files with YAML front matter that has extraneous
|
|
1820
1935
|
spaces after the first line</li>
|
|
1821
|
-
<li>Enhancement: extract the <code class="highlighter-rouge">title</code> attribute from the filename for
|
|
1936
|
+
<li>Enhancement: extract the <code class="language-plaintext highlighter-rouge">title</code> attribute from the filename for
|
|
1822
1937
|
collection items without a date</li>
|
|
1823
1938
|
<li>Fix: gracefully handle empty configuration files</li>
|
|
1824
1939
|
</ul>
|
|
@@ -1873,8 +1988,8 @@ midnightSuyama, musoke, and rebornix</p>
|
|
|
1873
1988
|
<p>A crucial bug was found in v3.0.1 which caused invalid post dates to go
|
|
1874
1989
|
unnoticed in the build chain until the error that popped up was unhelpful.
|
|
1875
1990
|
v3.0.2 <a href="https://github.com/jekyll/jekyll/issues/4375">throws errors as you’d expect</a>
|
|
1876
|
-
when there is a post like <code class="highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
|
1877
|
-
invalid date like <code class="highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
|
1991
|
+
when there is a post like <code class="language-plaintext highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
|
1992
|
+
invalid date like <code class="language-plaintext highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
|
1878
1993
|
|
|
1879
1994
|
<p>This should make the experience of working with Jekyll just a little
|
|
1880
1995
|
better.</p>
|
|
@@ -1910,12 +2025,12 @@ better.</p>
|
|
|
1910
2025
|
<p>Hey, folks! Bunch of bug fixes here. Notables:</p>
|
|
1911
2026
|
|
|
1912
2027
|
<ul>
|
|
1913
|
-
<li>Only superdirectories of <code class="highlighter-rouge">_posts</code> will be categories.</li>
|
|
2028
|
+
<li>Only superdirectories of <code class="language-plaintext highlighter-rouge">_posts</code> will be categories.</li>
|
|
1914
2029
|
<li>
|
|
1915
|
-
<code class="highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
|
2030
|
+
<code class="language-plaintext highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
|
1916
2031
|
<li>
|
|
1917
|
-
<code class="highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
|
1918
|
-
<li>Failure in liquid will now always fail the <code class="highlighter-rouge">jekyll</code> process.</li>
|
|
2032
|
+
<code class="language-plaintext highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
|
2033
|
+
<li>Failure in liquid will now always fail the <code class="language-plaintext highlighter-rouge">jekyll</code> process.</li>
|
|
1919
2034
|
<li>All hooks should now be properly registered & documented</li>
|
|
1920
2035
|
</ul>
|
|
1921
2036
|
|
|
@@ -1957,20 +2072,20 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
|
|
|
1957
2072
|
<p>The much-anticipated Jekyll 3.0 has been released! Key changes:</p>
|
|
1958
2073
|
|
|
1959
2074
|
<ul>
|
|
1960
|
-
<li>Incremental regeneration (experimental, enable with <code class="highlighter-rouge">--incremental</code>)</li>
|
|
1961
|
-
<li>Liquid profiler (add <code class="highlighter-rouge">--profile</code> to a build or serve)</li>
|
|
2075
|
+
<li>Incremental regeneration (experimental, enable with <code class="language-plaintext highlighter-rouge">--incremental</code>)</li>
|
|
2076
|
+
<li>Liquid profiler (add <code class="language-plaintext highlighter-rouge">--profile</code> to a build or serve)</li>
|
|
1962
2077
|
<li>Hook plugin API (no more monkey-patching!)</li>
|
|
1963
2078
|
<li>Dependencies reduced from 14 to 8, none contain C extensions. We’re hoping to reduce this even more in the future.</li>
|
|
1964
2079
|
<li>Changed version support: no support for Ruby 1.9.3, added basic JRuby support. Better Windows support.</li>
|
|
1965
2080
|
<li>Extension-less URLs</li>
|
|
1966
2081
|
<li>
|
|
1967
|
-
<code class="highlighter-rouge">site.collections</code> is an array of collections, thus:
|
|
2082
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> is an array of collections, thus:
|
|
1968
2083
|
<ul>
|
|
1969
2084
|
<li>
|
|
1970
|
-
<code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
|
|
2085
|
+
<code class="language-plaintext highlighter-rouge">collection[0]</code> becomes <code class="language-plaintext highlighter-rouge">collection.label</code>
|
|
1971
2086
|
</li>
|
|
1972
2087
|
<li>
|
|
1973
|
-
<code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
|
|
2088
|
+
<code class="language-plaintext highlighter-rouge">collection[1]</code> becomes <code class="language-plaintext highlighter-rouge">collection</code>
|
|
1974
2089
|
</li>
|
|
1975
2090
|
</ul>
|
|
1976
2091
|
</li>
|
|
@@ -2115,8 +2230,8 @@ Feel free to chime in over on GitHub.</p>
|
|
|
2115
2230
|
</div>
|
|
2116
2231
|
<div class="post-content">
|
|
2117
2232
|
<p>A very minor release, 2.5.2 fixes a bug with path sanitation that 2.5.1
|
|
2118
|
-
introduced. It also improves the <code class="highlighter-rouge">post_url</code> tag such that it checks the
|
|
2119
|
-
posts’ name (e.g. <code class="highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
|
2233
|
+
introduced. It also improves the <code class="language-plaintext highlighter-rouge">post_url</code> tag such that it checks the
|
|
2234
|
+
posts’ name (e.g. <code class="language-plaintext highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
|
2120
2235
|
name. This fixes issues where posts are created and the day changes based
|
|
2121
2236
|
on timezone discrepancies.</p>
|
|
2122
2237
|
|
|
@@ -2203,17 +2318,17 @@ milestone with a pretty big release. What’s changed in 2.5.0? Here are some
|
|
|
2203
2318
|
highlights:</p>
|
|
2204
2319
|
|
|
2205
2320
|
<ul>
|
|
2206
|
-
<li>Require plugins in the <code class="highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
|
2207
|
-
<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>
|
|
2208
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
|
2209
|
-
<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>
|
|
2321
|
+
<li>Require plugins in the <code class="language-plaintext highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
|
2322
|
+
<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>
|
|
2323
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
|
2324
|
+
<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>
|
|
2210
2325
|
<li>WEBrick will now list your directory if it can’t find an index file.</li>
|
|
2211
|
-
<li>Any enumerable can be used with the <code class="highlighter-rouge">where</code> filter.</li>
|
|
2326
|
+
<li>Any enumerable can be used with the <code class="language-plaintext highlighter-rouge">where</code> filter.</li>
|
|
2212
2327
|
<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>
|
|
2213
2328
|
</li>
|
|
2214
2329
|
<li>Fix for Rouge’s Redcarpet interface</li>
|
|
2215
2330
|
<li>Security auditors will love this: path sanitation has now been centralized.</li>
|
|
2216
|
-
<li>Specify a log level with <code class="highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
|
2331
|
+
<li>Specify a log level with <code class="language-plaintext highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
|
2217
2332
|
</ul>
|
|
2218
2333
|
|
|
2219
2334
|
<p>…and a whole bunch of other fixes and enhancements you can read more
|
|
@@ -2267,14 +2382,14 @@ Custódio, Igor Kapkov, and Kevin Ndung’u!</p>
|
|
|
2267
2382
|
<p>Well, lookie here! A new release of Jekyll! v2.4.0 contains lots of goodies, including some brilliant new additions:</p>
|
|
2268
2383
|
|
|
2269
2384
|
<ul>
|
|
2270
|
-
<li>A new <code class="highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
|
2385
|
+
<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>
|
|
2271
2386
|
<li>Render Liquid in CoffeeScript files (<a href="https://github.com/jekyll/jekyll/issues/2830">#2830</a>)</li>
|
|
2272
|
-
<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>
|
|
2273
|
-
<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>
|
|
2274
|
-
<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>
|
|
2275
|
-
<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>
|
|
2276
|
-
<li>Add <code class="highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
|
2277
|
-
<li>Add a <code class="highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
|
2387
|
+
<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>
|
|
2388
|
+
<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>
|
|
2389
|
+
<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>
|
|
2390
|
+
<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>
|
|
2391
|
+
<li>Add <code class="language-plaintext highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
|
2392
|
+
<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>
|
|
2278
2393
|
</ul>
|
|
2279
2394
|
|
|
2280
2395
|
<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>
|
|
@@ -2318,22 +2433,22 @@ curious bug indeed.</a>
|
|
|
2318
2433
|
</li>
|
|
2319
2434
|
<li>Pages, Posts, and Drafts can now be converted by multiple converters.</li>
|
|
2320
2435
|
<li>Static files can now be safely included in collections. They’ll be placed
|
|
2321
|
-
in a <code class="highlighter-rouge">collection.files</code> array. <code class="highlighter-rouge">collection.docs</code> still holds exclusively
|
|
2436
|
+
in a <code class="language-plaintext highlighter-rouge">collection.files</code> array. <code class="language-plaintext highlighter-rouge">collection.docs</code> still holds exclusively
|
|
2322
2437
|
content with YAML front matter.</li>
|
|
2323
2438
|
<li>Sass files can once again be rendered by Liquid. However, neither Sass
|
|
2324
|
-
nor CoffeeScript can ever have a layout. Bonus: <code class="highlighter-rouge">scssify</code> and <code class="highlighter-rouge">sassify</code>
|
|
2439
|
+
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>
|
|
2325
2440
|
Liquid filters.</li>
|
|
2326
|
-
<li>Partial variables allowed now in the path argument of <code class="highlighter-rouge">include</code> calls</li>
|
|
2327
|
-
<li>We added a <code class="highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
|
2328
|
-
about that subcommand. Or don’t, to see the help for <code class="highlighter-rouge">jekyll</code> itself.</li>
|
|
2329
|
-
<li>Lots of fixes to the site template we use for <code class="highlighter-rouge">jekyll new</code>, including
|
|
2441
|
+
<li>Partial variables allowed now in the path argument of <code class="language-plaintext highlighter-rouge">include</code> calls</li>
|
|
2442
|
+
<li>We added a <code class="language-plaintext highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
|
2443
|
+
about that subcommand. Or don’t, to see the help for <code class="language-plaintext highlighter-rouge">jekyll</code> itself.</li>
|
|
2444
|
+
<li>Lots of fixes to the site template we use for <code class="language-plaintext highlighter-rouge">jekyll new</code>, including
|
|
2330
2445
|
converting the CSS into SCSS.</li>
|
|
2331
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter will now call <code class="highlighter-rouge">#to_liquid</code> for you</li>
|
|
2446
|
+
<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>
|
|
2332
2447
|
<li>Lots, lots more!</li>
|
|
2333
2448
|
</ul>
|
|
2334
2449
|
|
|
2335
2450
|
<p>One change deserves special note. In <a href="https://github.com/jekyll/jekyll/issues/2633">#2633</a>, subfolders <em>inside</em> a
|
|
2336
|
-
<code class="highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
|
2451
|
+
<code class="language-plaintext highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
|
2337
2452
|
turns out, this behaviour was unwanted by a large number of individuals, as
|
|
2338
2453
|
it is a handy way to organize posts. Ultimately, we decided to revert this
|
|
2339
2454
|
change in <a href="https://github.com/jekyll/jekyll/issues/2705">#2705</a>, because it was a change in behaviour that was already
|
|
@@ -2374,7 +2489,7 @@ page</a>! Happy Jekylling!</p>
|
|
|
2374
2489
|
<li>A warning will now fire if you specify a layout in any of your pages or
|
|
2375
2490
|
posts that doesn’t exist.</li>
|
|
2376
2491
|
<li>Certain Pygments options are now whitelisted in safe mode</li>
|
|
2377
|
-
<li>Categories in a post’s path are now respected (i.e. folders in <code class="highlighter-rouge">_posts</code>
|
|
2492
|
+
<li>Categories in a post’s path are now respected (i.e. folders in <code class="language-plaintext highlighter-rouge">_posts</code>
|
|
2378
2493
|
will now work properly).</li>
|
|
2379
2494
|
</ol>
|
|
2380
2495
|
|
|
@@ -2414,7 +2529,7 @@ introduces fixes for a couple security-related issues.</p>
|
|
|
2414
2529
|
|
|
2415
2530
|
<ol>
|
|
2416
2531
|
<li>One in the reading of data</li>
|
|
2417
|
-
<li>One in the <code class="highlighter-rouge">layouts</code> setting</li>
|
|
2532
|
+
<li>One in the <code class="language-plaintext highlighter-rouge">layouts</code> setting</li>
|
|
2418
2533
|
</ol>
|
|
2419
2534
|
|
|
2420
2535
|
<p>They were identified in Jekyll 1.5.1 and has been confirmed as patched
|
|
@@ -2422,7 +2537,7 @@ in this version and the version used by GitHub Pages. If you are in the
|
|
|
2422
2537
|
business of building Jekyll sites, please ensure you upgrade to 2.1.1 as
|
|
2423
2538
|
soon as possible.</p>
|
|
2424
2539
|
|
|
2425
|
-
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
|
2540
|
+
<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>
|
|
2426
2541
|
|
|
2427
2542
|
<p>Additionally, the dependency on Maruku has been loosened and a bug was
|
|
2428
2543
|
fixed with document URLs.</p>
|
|
@@ -2466,13 +2581,13 @@ things to look forward to:</p>
|
|
|
2466
2581
|
<li>Set front matter defaults for collections (#2419)</li>
|
|
2467
2582
|
<li>Set a collection-specific URL template (#2418)</li>
|
|
2468
2583
|
<li>
|
|
2469
|
-
<code class="highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
|
2584
|
+
<code class="language-plaintext highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
|
2470
2585
|
<li>
|
|
2471
|
-
<code class="highlighter-rouge">.json</code> files in <code class="highlighter-rouge">_data</code> (#2369)</li>
|
|
2472
|
-
<li>Allow subdirectories in <code class="highlighter-rouge">_data</code> (#2395)</li>
|
|
2473
|
-
<li>Add support for <code class="highlighter-rouge">hl_lines</code> in <code class="highlighter-rouge">highlight</code> tag (#2532)</li>
|
|
2586
|
+
<code class="language-plaintext highlighter-rouge">.json</code> files in <code class="language-plaintext highlighter-rouge">_data</code> (#2369)</li>
|
|
2587
|
+
<li>Allow subdirectories in <code class="language-plaintext highlighter-rouge">_data</code> (#2395)</li>
|
|
2588
|
+
<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>
|
|
2474
2589
|
<li>Post categories now merge with directory, front matter, and defaults (#2373)</li>
|
|
2475
|
-
<li>New <code class="highlighter-rouge">--skip_initial_build</code> flag for <code class="highlighter-rouge">jekyll serve</code> (#2477)</li>
|
|
2590
|
+
<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>
|
|
2476
2591
|
<li>A bajilion bug fixes and site updates!</li>
|
|
2477
2592
|
</ul>
|
|
2478
2593
|
|
|
@@ -2554,15 +2669,15 @@ things to look forward to:</p>
|
|
|
2554
2669
|
<li>
|
|
2555
2670
|
<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>
|
|
2556
2671
|
<li>
|
|
2557
|
-
<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>
|
|
2672
|
+
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="language-plaintext highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
|
2558
2673
|
<li>
|
|
2559
2674
|
<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>
|
|
2560
2675
|
<li>
|
|
2561
|
-
<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>
|
|
2676
|
+
<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>
|
|
2562
2677
|
<li>
|
|
2563
|
-
<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>
|
|
2678
|
+
<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>
|
|
2564
2679
|
<li>
|
|
2565
|
-
<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>
|
|
2680
|
+
<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>
|
|
2566
2681
|
<li>
|
|
2567
2682
|
<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>
|
|
2568
2683
|
</ol>
|
|
@@ -2603,7 +2718,7 @@ things to look forward to:</p>
|
|
|
2603
2718
|
</div>
|
|
2604
2719
|
<div class="post-content">
|
|
2605
2720
|
<p>The hawk-eyed <a href="https://github.com/gregose">@gregose</a> spotted a bug in our
|
|
2606
|
-
<code class="highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
|
2721
|
+
<code class="language-plaintext highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
|
2607
2722
|
|
|
2608
2723
|
<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>
|
|
2609
2724
|
<span class="o">=></span> <span class="s2">"/tmp/foobar/jail/../../../etc/passwd"</span></code></pre></figure>
|
|
@@ -2643,7 +2758,7 @@ the masses. Thanks, Greg!</p>
|
|
|
2643
2758
|
</div>
|
|
2644
2759
|
<div class="post-content">
|
|
2645
2760
|
<p>As work continues on Jekyll 2.0.0, we felt it was important to address two key
|
|
2646
|
-
issues of Jekyll 1.4.3, namely the <code class="highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
|
2761
|
+
issues of Jekyll 1.4.3, namely the <code class="language-plaintext highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
|
2647
2762
|
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>
|
|
2648
2763
|
|
|
2649
2764
|
<p>For a full changelog, check out our <a href="/docs/history/#v1-5-0">history</a> page.</p>
|
|
@@ -2688,7 +2803,7 @@ generated output via improper symlink sanitization, potentially resulting in an
|
|
|
2688
2803
|
inadvertent information disclosure.</p>
|
|
2689
2804
|
|
|
2690
2805
|
<p>Versions of Jekyll prior to 1.4.3 may also allow malicious users to write
|
|
2691
|
-
arbitrary <code class="highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
|
2806
|
+
arbitrary <code class="language-plaintext highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
|
2692
2807
|
traversal, potentially overwriting otherwise-trusted content with arbitrary HTML
|
|
2693
2808
|
or Javascript depending on your server’s configuration.</p>
|
|
2694
2809
|
|
|
@@ -2723,8 +2838,8 @@ these vulnerabilities, and to <a href="https://github.com/BenBalter" class="user
|
|
|
2723
2838
|
<div class="post-content">
|
|
2724
2839
|
<p>This release fixes <a href="https://github.com/jekyll/jekyll/pull/1830">a regression</a> where Maruku fenced code blocks were turned
|
|
2725
2840
|
off, instead of the previous default to on. We’ve added a new default
|
|
2726
|
-
configuration to our <code class="highlighter-rouge">maruku</code> config key: <code class="highlighter-rouge">fenced_code_blocks</code> and set it to
|
|
2727
|
-
default to <code class="highlighter-rouge">true</code>.</p>
|
|
2841
|
+
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
|
|
2842
|
+
default to <code class="language-plaintext highlighter-rouge">true</code>.</p>
|
|
2728
2843
|
|
|
2729
2844
|
<p>If you do not wish to use Maruku fenced code blocks, you may turn this option
|
|
2730
2845
|
off in your site’s configuration file.</p>
|
|
@@ -2807,7 +2922,7 @@ Jekyll v1.4.0. This release will be the last non-patch release to support Ruby
|
|
|
2807
2922
|
a ton of bugfixes over the previous 0.6.x releases.</p>
|
|
2808
2923
|
</li>
|
|
2809
2924
|
<li>
|
|
2810
|
-
<p>Non-<code class="highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
|
2925
|
+
<p>Non-<code class="language-plaintext highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
|
2811
2926
|
processed, which can provide a rudimentary way to establish a load order for
|
|
2812
2927
|
plugins.</p>
|
|
2813
2928
|
</li>
|
|
@@ -2851,7 +2966,7 @@ Karékinian, Jordon Bedwell, Matthew Iversen, Persa Zula, and Yi Zeng.</p>
|
|
|
2851
2966
|
release of 1.3.0.</p>
|
|
2852
2967
|
|
|
2853
2968
|
<p>In addition to a couple of other smaller bug fixes, the biggest thing
|
|
2854
|
-
we’ve fixed is an issue with the <code class="highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
|
2969
|
+
we’ve fixed is an issue with the <code class="language-plaintext highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
|
2855
2970
|
full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
|
2856
2971
|
|
|
2857
2972
|
<p>Thanks to all the people who have contributed to this release! They are
|
|
@@ -2895,33 +3010,33 @@ love.</p>
|
|
|
2895
3010
|
<ul>
|
|
2896
3011
|
<li>
|
|
2897
3012
|
<p>You can add <a href="/docs/datafiles/">arbitrary data</a> to the site by adding YAML files under a
|
|
2898
|
-
site’s <code class="highlighter-rouge">_data</code> directory. This will allow you to avoid
|
|
3013
|
+
site’s <code class="language-plaintext highlighter-rouge">_data</code> directory. This will allow you to avoid
|
|
2899
3014
|
repetition in your templates and to set site specific options without
|
|
2900
|
-
changing <code class="highlighter-rouge">_config.yml</code>.</p>
|
|
3015
|
+
changing <code class="language-plaintext highlighter-rouge">_config.yml</code>.</p>
|
|
2901
3016
|
</li>
|
|
2902
3017
|
<li>
|
|
2903
|
-
<p>You can now run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
|
2904
|
-
background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut
|
|
3018
|
+
<p>You can now run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
|
3019
|
+
background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut
|
|
2905
3020
|
the server down. When ran, you’ll get a process id that you can use in
|
|
2906
|
-
place of <code class="highlighter-rouge">[server_pid]</code></p>
|
|
3021
|
+
place of <code class="language-plaintext highlighter-rouge">[server_pid]</code></p>
|
|
2907
3022
|
</li>
|
|
2908
3023
|
<li>
|
|
2909
3024
|
<p>You can now <strong>disable automatically-generated excerpts</strong> if you set
|
|
2910
|
-
<code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</p>
|
|
3025
|
+
<code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</p>
|
|
2911
3026
|
</li>
|
|
2912
3027
|
<li>
|
|
2913
3028
|
<p>If you’re moving pages and posts, you can now check for <strong>URL
|
|
2914
|
-
conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</p>
|
|
3029
|
+
conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</p>
|
|
2915
3030
|
</li>
|
|
2916
3031
|
<li>
|
|
2917
3032
|
<p>If you’re a fan of the drafts feature, you’ll be happy to know we’ve
|
|
2918
|
-
added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</p>
|
|
3033
|
+
added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</p>
|
|
2919
3034
|
</li>
|
|
2920
3035
|
<li>
|
|
2921
3036
|
<p>Permalinks with special characters should now generate without errors.</p>
|
|
2922
3037
|
</li>
|
|
2923
3038
|
<li>
|
|
2924
|
-
<p>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid
|
|
3039
|
+
<p>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid
|
|
2925
3040
|
variable.</p>
|
|
2926
3041
|
</li>
|
|
2927
3042
|
</ul>
|
|
@@ -2992,11 +3107,11 @@ issues!</p>
|
|
|
2992
3107
|
<div class="post-content">
|
|
2993
3108
|
<p>Quick turnover, anyone? A <a href="https://github.com/jekyll/jekyll/pull/1525">recent incompatibility with Liquid
|
|
2994
3109
|
v2.5.2</a> produced a nasty bug in
|
|
2995
|
-
which <code class="highlighter-rouge">include</code> tags were not rendered properly within <code class="highlighter-rouge">if</code> blocks.</p>
|
|
3110
|
+
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>
|
|
2996
3111
|
|
|
2997
3112
|
<p>This release also includes a better handling of detached servers (prints pid and
|
|
2998
|
-
the command for killing the process). <strong>Note</strong>: the <code class="highlighter-rouge">--detach</code> flag and
|
|
2999
|
-
<code class="highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
|
3113
|
+
the command for killing the process). <strong>Note</strong>: the <code class="language-plaintext highlighter-rouge">--detach</code> flag and
|
|
3114
|
+
<code class="language-plaintext highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
|
3000
3115
|
|
|
3001
3116
|
<p>For a full list of the fixes in this release, check out <a href="/docs/history/">the change
|
|
3002
3117
|
log</a>!</p>
|
|
@@ -3034,12 +3149,12 @@ enhancements that we think you’ll love.</p>
|
|
|
3034
3149
|
<p>Here are a few things we think you’ll want to know about this release:</p>
|
|
3035
3150
|
|
|
3036
3151
|
<ul>
|
|
3037
|
-
<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>
|
|
3038
|
-
<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>
|
|
3039
|
-
<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>
|
|
3040
|
-
<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>
|
|
3152
|
+
<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>
|
|
3153
|
+
<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>
|
|
3154
|
+
<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>
|
|
3155
|
+
<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>
|
|
3041
3156
|
<li>Permalinks with special characters should now generate without errors.</li>
|
|
3042
|
-
<li>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
|
3157
|
+
<li>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
|
3043
3158
|
</ul>
|
|
3044
3159
|
|
|
3045
3160
|
<p>For a full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
|
@@ -3072,9 +3187,9 @@ enhancements that we think you’ll love.</p>
|
|
|
3072
3187
|
<div class="post-content">
|
|
3073
3188
|
<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>
|
|
3074
3189
|
|
|
3075
|
-
<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>
|
|
3190
|
+
<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>
|
|
3076
3191
|
|
|
3077
|
-
<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>
|
|
3192
|
+
<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>
|
|
3078
3193
|
|
|
3079
3194
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
|
3080
3195
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
|
@@ -3108,9 +3223,9 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
|
|
|
3108
3223
|
<div class="post-content">
|
|
3109
3224
|
<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>
|
|
3110
3225
|
|
|
3111
|
-
<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>
|
|
3226
|
+
<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>
|
|
3112
3227
|
|
|
3113
|
-
<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>
|
|
3228
|
+
<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>
|
|
3114
3229
|
|
|
3115
3230
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
|
3116
3231
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
|
@@ -3186,12 +3301,12 @@ more a more detailed changelog for this release.</p>
|
|
|
3186
3301
|
Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new additions:</p>
|
|
3187
3302
|
|
|
3188
3303
|
<ul>
|
|
3189
|
-
<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>
|
|
3190
|
-
<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>
|
|
3304
|
+
<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>
|
|
3305
|
+
<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>
|
|
3191
3306
|
<li>Add support for Liquid tags to post excerpts (<a href="https://github.com/jekyll/jekyll/issues/1302">#1302</a>)</li>
|
|
3192
3307
|
<li>Fix pagination for subdirectories (<a href="https://github.com/jekyll/jekyll/issues/1198">#1198</a>)</li>
|
|
3193
3308
|
<li>Provide better error reporting when generating sites (<a href="https://github.com/jekyll/jekyll/issues/1253">#1253</a>)</li>
|
|
3194
|
-
<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>
|
|
3309
|
+
<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>
|
|
3195
3310
|
</ul>
|
|
3196
3311
|
|
|
3197
3312
|
<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>
|
|
@@ -3227,10 +3342,10 @@ Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new add
|
|
|
3227
3342
|
|
|
3228
3343
|
<ul>
|
|
3229
3344
|
<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>
|
|
3230
|
-
<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>
|
|
3231
|
-
<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>
|
|
3232
|
-
<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>
|
|
3233
|
-
<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>
|
|
3345
|
+
<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>
|
|
3346
|
+
<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>
|
|
3347
|
+
<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>
|
|
3348
|
+
<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>
|
|
3234
3349
|
</ul>
|
|
3235
3350
|
|
|
3236
3351
|
<p>See the <a href="/docs/history/#v1-0-3">History</a> page for more information on this release.</p>
|
|
@@ -3267,11 +3382,11 @@ releases, and fix some other annoying bugs:</p>
|
|
|
3267
3382
|
|
|
3268
3383
|
<ul>
|
|
3269
3384
|
<li>Backwards-compatibilize relative permalinks (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
|
3270
|
-
<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>
|
|
3271
|
-
<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>
|
|
3385
|
+
<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>
|
|
3386
|
+
<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>
|
|
3272
3387
|
<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>
|
|
3273
3388
|
<li>Fix issue when post categories are numbers (<a href="https://github.com/jekyll/jekyll/issues/1078">#1078</a>)</li>
|
|
3274
|
-
<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>
|
|
3389
|
+
<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>
|
|
3275
3390
|
<li>Catching that Redcarpet gem isn’t installed (<a href="https://github.com/jekyll/jekyll/issues/1059">#1059</a>)</li>
|
|
3276
3391
|
</ul>
|
|
3277
3392
|
|
|
@@ -3307,13 +3422,13 @@ releases, and fix some other annoying bugs:</p>
|
|
|
3307
3422
|
<p>Hot on the trails of v1.0, v1.0.1 is out! Here are the highlights:</p>
|
|
3308
3423
|
|
|
3309
3424
|
<ul>
|
|
3310
|
-
<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>
|
|
3425
|
+
<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>
|
|
3311
3426
|
<li>Commander error message now preferred over process abort with incorrect args (<a href="https://github.com/jekyll/jekyll/issues/1040">#1040</a>)</li>
|
|
3312
3427
|
<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>
|
|
3313
3428
|
<li>Make Redcarpet respect the pygments configuration option (<a href="https://github.com/jekyll/jekyll/issues/1053">#1053</a>)</li>
|
|
3314
3429
|
<li>Fix the index build with LSI (<a href="https://github.com/jekyll/jekyll/issues/1045">#1045</a>)</li>
|
|
3315
3430
|
<li>Don’t print deprecation warning when no arguments are specified. (<a href="https://github.com/jekyll/jekyll/issues/1041">#1041</a>)</li>
|
|
3316
|
-
<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>
|
|
3431
|
+
<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>
|
|
3317
3432
|
</ul>
|
|
3318
3433
|
|
|
3319
3434
|
<p>See the <a href="/docs/history/#v1-0-1">History</a> page for more information on this release.</p>
|
|
@@ -3381,23 +3496,23 @@ examples and for compiling this list):</p>
|
|
|
3381
3496
|
<ul>
|
|
3382
3497
|
|
|
3383
3498
|
<li class="">
|
|
3384
|
-
<a href="/news/
|
|
3499
|
+
<a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
|
|
3385
3500
|
</li>
|
|
3386
3501
|
|
|
3387
3502
|
<li class="">
|
|
3388
|
-
<a href="/news/2018/
|
|
3503
|
+
<a href="/news/2018/06/05/jekyll-3-8-3-released/">Version 3.8.3</a>
|
|
3389
3504
|
</li>
|
|
3390
3505
|
|
|
3391
3506
|
<li class="">
|
|
3392
|
-
<a href="/news/2018/
|
|
3507
|
+
<a href="/news/2018/05/19/jekyll-3-8-2-released/">Version 3.8.2</a>
|
|
3393
3508
|
</li>
|
|
3394
3509
|
|
|
3395
3510
|
<li class="">
|
|
3396
|
-
<a href="/news/2018/01/
|
|
3511
|
+
<a href="/news/2018/05/01/jekyll-3-8-1-released/">Version 3.8.1</a>
|
|
3397
3512
|
</li>
|
|
3398
3513
|
|
|
3399
3514
|
<li class="">
|
|
3400
|
-
<a href="/news/
|
|
3515
|
+
<a href="/news/2018/02/24/jekyll-3-7-3-released/">Version 3.7.3</a>
|
|
3401
3516
|
</li>
|
|
3402
3517
|
|
|
3403
3518
|
<li>
|
|
@@ -3412,6 +3527,12 @@ examples and for compiling this list):</p>
|
|
|
3412
3527
|
|
|
3413
3528
|
|
|
3414
3529
|
|
|
3530
|
+
|
|
3531
|
+
|
|
3532
|
+
|
|
3533
|
+
|
|
3534
|
+
|
|
3535
|
+
|
|
3415
3536
|
<li class="">
|
|
3416
3537
|
<a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
|
|
3417
3538
|
</li>
|
|
@@ -3597,7 +3718,7 @@ examples and for compiling this list):</p>
|
|
|
3597
3718
|
<footer>
|
|
3598
3719
|
<div class="grid">
|
|
3599
3720
|
<div class="unit one-third center-on-mobiles">
|
|
3600
|
-
<p>The contents of this website are <br>©
|
|
3721
|
+
<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>
|
|
3601
3722
|
</div>
|
|
3602
3723
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
3603
3724
|
<p>
|