jekyll-docs 3.8.5 → 3.9.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/site/404.html +5 -4
- data/site/docs/assets/index.html +22 -21
- 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 +68 -67
- 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 +34 -33
- 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 +19 -18
- data/site/docs/history/index.html +674 -645
- data/site/docs/home/index.html +8 -7
- data/site/docs/includes/index.html +44 -43
- data/site/docs/installation/index.html +16 -15
- data/site/docs/maintaining/affinity-team-captain/index.html +11 -10
- data/site/docs/maintaining/avoiding-burnout/index.html +8 -7
- data/site/docs/maintaining/becoming-a-maintainer/index.html +9 -8
- data/site/docs/maintaining/index.html +8 -7
- data/site/docs/maintaining/merging-a-pull-request/index.html +23 -22
- data/site/docs/maintaining/releasing-a-new-version/index.html +19 -18
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +10 -9
- data/site/docs/maintaining/special-labels/index.html +14 -13
- data/site/docs/maintaining/triaging-an-issue/index.html +12 -11
- 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 +57 -56
- data/site/docs/posts/index.html +37 -36
- 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 +63 -62
- 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 +45 -41
- data/site/help/index.html +7 -6
- data/site/index.html +7 -6
- 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 +16 -10
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -12
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +19 -13
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +20 -14
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +19 -13
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -10
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -12
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -12
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +21 -15
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +19 -13
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -10
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +25 -19
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +17 -11
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +17 -11
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -10
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -12
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +17 -11
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +17 -11
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +17 -11
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +20 -14
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -10
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -10
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +21 -15
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -12
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +17 -11
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +24 -18
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +23 -17
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +22 -16
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -10
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -12
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -10
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -10
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -10
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +16 -10
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -10
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +21 -15
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +20 -14
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -12
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +21 -15
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +21 -15
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +17 -11
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -12
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -10
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +17 -11
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +17 -11
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -10
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +22 -16
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +17 -11
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +17 -11
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -10
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +20 -14
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +17 -11
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -10
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +42 -36
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +17 -11
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +18 -12
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +17 -11
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +21 -15
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +26 -20
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +25 -19
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -12
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +21 -15
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +17 -11
- data/site/news/2017/10/19/diversity-open-source/index.html +18 -12
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +18 -12
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +21 -15
- data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +26 -20
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +16 -10
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +22 -16
- data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +19 -13
- data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +17 -11
- data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +19 -13
- data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +623 -0
- data/site/news/index.html +263 -218
- data/site/news/releases/index.html +261 -216
- data/site/philosophy.html +1 -1
- data/site/sitemap.xml +61 -57
- data/site/team/index.html +7 -6
- 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/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 +10 -24
data/site/news/index.html
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
-
<meta name="generator" content="Jekyll v3.
|
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
|
8
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">
|
|
9
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
12
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
13
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
14
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
15
15
|
<title>News | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
|
17
17
|
<meta property="og:title" content="News" />
|
|
18
18
|
<meta name="author" content="all" />
|
|
19
19
|
<meta property="og:locale" content="en_US" />
|
|
@@ -23,11 +23,12 @@
|
|
|
23
23
|
<meta property="og:url" content="https://jekyllrb.com/news/" />
|
|
24
24
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
25
25
|
<meta name="twitter:card" content="summary" />
|
|
26
|
+
<meta property="twitter:title" content="News" />
|
|
26
27
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
27
28
|
<meta name="twitter:creator" content="@all" />
|
|
28
29
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
29
30
|
<script type="application/ld+json">
|
|
30
|
-
{"
|
|
31
|
+
{"url":"https://jekyllrb.com/news/","headline":"News","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"https://schema.org"}</script>
|
|
31
32
|
<!-- End Jekyll SEO tag -->
|
|
32
33
|
|
|
33
34
|
<!--[if lt IE 9]>
|
|
@@ -72,7 +73,7 @@
|
|
|
72
73
|
<div class="meta hide-on-mobiles">
|
|
73
74
|
<ul>
|
|
74
75
|
<li>
|
|
75
|
-
<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>
|
|
76
77
|
</li>
|
|
77
78
|
<li>
|
|
78
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -112,6 +113,8 @@
|
|
|
112
113
|
<option value="/news/">Home</option>
|
|
113
114
|
<optgroup label="v1.x">
|
|
114
115
|
|
|
116
|
+
<option value="/news/2019/07/02/jekyll-3-8-6-released/">Jekyll 3.8.6 Released</option>
|
|
117
|
+
|
|
115
118
|
<option value="/news/2018/06/05/jekyll-3-8-3-released/">Jekyll 3.8.3 Released</option>
|
|
116
119
|
|
|
117
120
|
<option value="/news/2018/05/19/jekyll-3-8-2-released/">Jekyll 3.8.2 Released</option>
|
|
@@ -263,6 +266,46 @@
|
|
|
263
266
|
|
|
264
267
|
<div class="unit four-fifths">
|
|
265
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
|
+
|
|
266
309
|
<article>
|
|
267
310
|
<h2>
|
|
268
311
|
<a href="/news/2018/06/05/jekyll-3-8-3-released/">
|
|
@@ -285,11 +328,11 @@
|
|
|
285
328
|
</a>
|
|
286
329
|
</div>
|
|
287
330
|
<div class="post-content">
|
|
288
|
-
<p>This release fixes a regression in 3.8 where collections with <code class="highlighter-rouge">published: false</code>
|
|
289
|
-
do not show when using the <code class="highlighter-rouge">--unpublished</code> flag.</p>
|
|
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>
|
|
290
333
|
|
|
291
334
|
<p>Thanks to <a href="https://github.com/philipbelesky" class="user-mention">@philipbelesky</a> for reporting and fixing this issue; collections with
|
|
292
|
-
<code class="highlighter-rouge">published: false</code> now behave the same way as Posts.</p>
|
|
335
|
+
<code class="language-plaintext highlighter-rouge">published: false</code> now behave the same way as Posts.</p>
|
|
293
336
|
|
|
294
337
|
</div>
|
|
295
338
|
</article>
|
|
@@ -319,7 +362,7 @@ do not show when using the <code class="highlighter-rouge">--unpublished</code>
|
|
|
319
362
|
<div class="post-content">
|
|
320
363
|
<p>Hello Jekyllers!!</p>
|
|
321
364
|
|
|
322
|
-
<p>Today we are releasing <code class="highlighter-rouge">v3.8.2</code>, which fixes the way Jekyll generates excerpts
|
|
365
|
+
<p>Today we are releasing <code class="language-plaintext highlighter-rouge">v3.8.2</code>, which fixes the way Jekyll generates excerpts
|
|
323
366
|
for posts when the first paragraph of the post contains Liquid tags that take
|
|
324
367
|
advantage of <a href="https://shopify.github.io/liquid/basics/whitespace/">Liquid’s whitespace control feature</a>.</p>
|
|
325
368
|
|
|
@@ -354,10 +397,10 @@ the latest version of Rubocop to lint our code.</p>
|
|
|
354
397
|
</a>
|
|
355
398
|
</div>
|
|
356
399
|
<div class="post-content">
|
|
357
|
-
<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>
|
|
358
401
|
|
|
359
|
-
<p>The Jekyll team is happy to announce the release of <code class="highlighter-rouge">v3.8.1</code>, which fixes
|
|
360
|
-
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
|
|
361
404
|
experienced trouble regarding post excerpts or non-published posts, this release
|
|
362
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
|
|
363
406
|
reporting these issues, and to <a href="https://github.com/ashmaroli" class="user-mention">@ashmaroli</a> for fixing them so quickly.</p>
|
|
@@ -393,15 +436,15 @@ list</a>.</p>
|
|
|
393
436
|
</a>
|
|
394
437
|
</div>
|
|
395
438
|
<div class="post-content">
|
|
396
|
-
<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>
|
|
397
440
|
|
|
398
|
-
<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
|
|
399
|
-
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>
|
|
400
443
|
|
|
401
|
-
<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
|
|
402
|
-
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
|
|
403
446
|
any locale. This led to issues with third-party i18n plugins for Jekyll, especially since the default locale got assigned before
|
|
404
|
-
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>
|
|
405
448
|
|
|
406
449
|
<p>Jekyll will henceforth set the default locale if and only if necessary.</p>
|
|
407
450
|
|
|
@@ -498,20 +541,20 @@ regressions due to the changes made in that release. In due time, Team Jekyll
|
|
|
498
541
|
set out to address those issues as early as possible.</p>
|
|
499
542
|
|
|
500
543
|
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
|
501
|
-
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
|
544
|
+
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20">
|
|
502
545
|
The highlights being:</p>
|
|
503
546
|
|
|
504
547
|
<ul>
|
|
505
548
|
<li>
|
|
506
549
|
<p>A major regression in 3.7.0 was that when a Front Matter Default was
|
|
507
|
-
configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
|
550
|
+
configured with a <code class="language-plaintext highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
|
508
551
|
that directory for any subfolders and files, for each document in that
|
|
509
|
-
<code class="highlighter-rouge">path</code>.
|
|
552
|
+
<code class="language-plaintext highlighter-rouge">path</code>.
|
|
510
553
|
Though this is intended, it increases build times in proportion to the size
|
|
511
554
|
of the directory.</p>
|
|
512
555
|
|
|
513
556
|
<p>We addressed this by having Jekyll scan the directory path only if the user
|
|
514
|
-
explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
|
557
|
+
explicitly configures the <code class="language-plaintext highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
|
515
558
|
|
|
516
559
|
<p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
|
|
517
560
|
for more details.</p>
|
|
@@ -523,7 +566,7 @@ additionally providing us with a test repository to aid in resolving the issue.<
|
|
|
523
566
|
<p>Another regression reported was related to our “Custom collections
|
|
524
567
|
directory” feature introduced in 3.7.0.</p>
|
|
525
568
|
|
|
526
|
-
<p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
|
569
|
+
<p>Users setting <code class="language-plaintext highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
|
527
570
|
paths to their posts still at the root of their site’s source. This
|
|
528
571
|
roughly translated to 404 errors on URLs to their posts.</p>
|
|
529
572
|
|
|
@@ -531,19 +574,19 @@ roughly translated to 404 errors on URLs to their posts.</p>
|
|
|
531
574
|
|
|
532
575
|
<p>We decided to resolve this by having Jekyll ignore posts and drafts at the
|
|
533
576
|
root of the site’s source directory if the user customizes the
|
|
534
|
-
<code class="highlighter-rouge">collection_dir</code> setting.</p>
|
|
577
|
+
<code class="language-plaintext highlighter-rouge">collection_dir</code> setting.</p>
|
|
535
578
|
|
|
536
579
|
<p>Ergo, if you set a custom location for your collections, please ensure you
|
|
537
580
|
move all of your collections into that directory. <strong>This includes posts and
|
|
538
581
|
drafts as well</strong>. Your links generated by
|
|
539
|
-
<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
|
|
582
|
+
<code class="language-plaintext highlighter-rouge">{% post_url %}</code> or <code class="language-plaintext highlighter-rouge">{% link %}</code>
|
|
540
583
|
will adapt automatically.</p>
|
|
541
584
|
</li>
|
|
542
585
|
<li>
|
|
543
|
-
<p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
|
586
|
+
<p>We also found out that <code class="language-plaintext highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
|
544
587
|
being watched on Windows. So we recommend having it included in your Gemfile
|
|
545
588
|
for a better development experience on Windows. (Newly generated Gemfiles
|
|
546
|
-
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://
|
|
589
|
+
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f609.png" height="20" width="20">)</p>
|
|
547
590
|
</li>
|
|
548
591
|
</ul>
|
|
549
592
|
|
|
@@ -557,7 +600,7 @@ Paul Robert Lloyd.</p>
|
|
|
557
600
|
|
|
558
601
|
<p>As always, you can see our full changelog on <a href="/docs/history/">the History page</a>.</p>
|
|
559
602
|
|
|
560
|
-
<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
|
603
|
+
<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
|
561
604
|
|
|
562
605
|
</div>
|
|
563
606
|
</article>
|
|
@@ -589,11 +632,11 @@ Paul Robert Lloyd.</p>
|
|
|
589
632
|
Here are a few of the latest additions from our contributors:</p>
|
|
590
633
|
|
|
591
634
|
<ul>
|
|
592
|
-
<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>
|
|
593
|
-
<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://
|
|
594
|
-
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
|
|
635
|
+
<li>LiveReload is available as an option during development: with <code class="language-plaintext highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
|
|
636
|
+
<li>New <code class="language-plaintext highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
|
|
637
|
+
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="language-plaintext highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
|
|
595
638
|
<li>Jekyll will now check to determine whether host machine has internet connection.</li>
|
|
596
|
-
<li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
|
639
|
+
<li>A new <code class="language-plaintext highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
|
597
640
|
<li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
|
|
598
641
|
<li>
|
|
599
642
|
<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
|
|
@@ -608,7 +651,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
|
608
651
|
<p>Oh, one last thing…</p>
|
|
609
652
|
|
|
610
653
|
<h3 id="pray-upgrade-your-ruby">
|
|
611
|
-
<img class="emoji" title=":pray:" alt=":pray:" src="https://
|
|
654
|
+
<img class="emoji" title=":pray:" alt=":pray:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
|
|
612
655
|
|
|
613
656
|
<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
|
|
614
657
|
|
|
@@ -646,7 +689,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
|
646
689
|
</a>
|
|
647
690
|
</div>
|
|
648
691
|
<div class="post-content">
|
|
649
|
-
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="highlighter-rouge">bundle update</code>
|
|
692
|
+
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="language-plaintext highlighter-rouge">bundle update</code>
|
|
650
693
|
if you want to avoid possible build problems with:</p>
|
|
651
694
|
|
|
652
695
|
<ul>
|
|
@@ -666,7 +709,7 @@ working on the next minor version 3.7.0 that will allow you to store all your
|
|
|
666
709
|
collections in a single directory. Stay tuned.</p>
|
|
667
710
|
|
|
668
711
|
<p>Theme developers are invited to test the brand new
|
|
669
|
-
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
|
712
|
+
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="language-plaintext highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
|
670
713
|
and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
|
|
671
714
|
GitHub hosted theme as a remote theme!</p>
|
|
672
715
|
|
|
@@ -728,7 +771,7 @@ today.</p>
|
|
|
728
771
|
|
|
729
772
|
<h2 id="create-newcomer-friendly-issues">Create newcomer-friendly issues</h2>
|
|
730
773
|
|
|
731
|
-
<p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="highlighter-rouge">first timers only</code> issues:</p>
|
|
774
|
+
<p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="language-plaintext highlighter-rouge">first timers only</code> issues:</p>
|
|
732
775
|
|
|
733
776
|
<ul>
|
|
734
777
|
<li><a href="https://github.com/jekyll/jekyll/issues/6437">Issue #6437</a></li>
|
|
@@ -736,7 +779,7 @@ today.</p>
|
|
|
736
779
|
<li><a href="https://github.com/jekyll/jekyll/issues/6439">Issue #6439</a></li>
|
|
737
780
|
</ul>
|
|
738
781
|
|
|
739
|
-
<p>(There’s also an up-to-date listing of all of our <code class="highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
|
|
782
|
+
<p>(There’s also an up-to-date listing of all of our <code class="language-plaintext highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
|
|
740
783
|
|
|
741
784
|
<p>These issues are designed to be taken on only by someone who has had little to no exposure to contributing to open source before, and additionally, project maintainers offer support in case a question arises.</p>
|
|
742
785
|
|
|
@@ -776,7 +819,7 @@ today.</p>
|
|
|
776
819
|
<div class="post-content">
|
|
777
820
|
<p>Another much-anticipated release of Jekyll. This release comes with it Rouge 2 support, but note you can continue to use Rouge 1 if you’d prefer. We also now require Ruby 2.1.0 as 2.0.x is no longer supported by the Ruby team.</p>
|
|
778
821
|
|
|
779
|
-
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
|
|
822
|
+
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="language-plaintext highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
|
|
780
823
|
|
|
781
824
|
<p>Please let us know if you find any bugs! You can see <a href="/docs/history/#v3-6-0">the full history here</a>.</p>
|
|
782
825
|
|
|
@@ -813,12 +856,12 @@ today.</p>
|
|
|
813
856
|
<p>3.5.2 is out with 6 great bug fixes, most notably one which should dramatically speed up generation of your site! In testing #6266, jekyllrb.com generation when from 18 seconds down to 8! Here is the full line-up of fixes:</p>
|
|
814
857
|
|
|
815
858
|
<ul>
|
|
816
|
-
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
|
|
859
|
+
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="language-plaintext highlighter-rouge">Document#url</code> (#6301)</li>
|
|
817
860
|
<li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
|
|
818
|
-
<li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
|
819
|
-
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
|
|
820
|
-
<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>
|
|
821
|
-
<li>Backport #6226 for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
|
|
861
|
+
<li>Backport #6281 for v3.5.x: Fix <code class="language-plaintext highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
|
862
|
+
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="language-plaintext highlighter-rouge">absolute_url</code> (#6287)</li>
|
|
863
|
+
<li>Backport #6273 for v3.5.x: delegate <code class="language-plaintext highlighter-rouge">StaticFile#to_json</code> to <code class="language-plaintext highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
|
|
864
|
+
<li>Backport #6226 for v3.5.x: <code class="language-plaintext highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
|
|
822
865
|
</ul>
|
|
823
866
|
|
|
824
867
|
<p>A <a href="/docs/history/#v3-5-2">full history</a> is available for your perusal. As always, please file bugs if you encounter them! Opening a pull request with a failing test for your expected behaviour is the easiest way for us to address the issue since we have a reproducible example to test again. Short of that, please fill out our issue template to the best of your ability and we’ll try to get to it quickly!</p>
|
|
@@ -857,8 +900,8 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
|
857
900
|
<p>We’ve released a few bugfixes in the form of v3.5.1 today:</p>
|
|
858
901
|
|
|
859
902
|
<ul>
|
|
860
|
-
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
|
861
|
-
<li>A bug in <code class="highlighter-rouge">relative_url</code> when <code class="highlighter-rouge">baseurl</code> is <code class="highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
|
|
903
|
+
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="language-plaintext highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
|
904
|
+
<li>A bug in <code class="language-plaintext highlighter-rouge">relative_url</code> when <code class="language-plaintext highlighter-rouge">baseurl</code> is <code class="language-plaintext highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
|
|
862
905
|
<li>Static files’ liquid representations should now have all the keys you were expecting when serialized into JSON.</li>
|
|
863
906
|
</ul>
|
|
864
907
|
|
|
@@ -898,18 +941,18 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
|
898
941
|
the wild. Some new shiny things you might want to test out:</p>
|
|
899
942
|
|
|
900
943
|
<ul>
|
|
901
|
-
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> and <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
|
|
944
|
+
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="language-plaintext highlighter-rouge">concat</code> and <code class="language-plaintext highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
|
|
902
945
|
</li>
|
|
903
946
|
<li>Themes can specify runtime dependencies (in their gemspecs) and we’ll require those. This makes it easier for theme writers to use plugins.</li>
|
|
904
947
|
<li>Speaking of themes, we’ll properly handle the discrepancy between a convertible file in the local site and a static file in the theme. Overriding a file locally now doesn’t matter if it’s convertible or static.</li>
|
|
905
|
-
<li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
|
|
906
|
-
<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>
|
|
907
|
-
<li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
|
|
948
|
+
<li>Pages, posts, and other documents can now access layout variables via <code class="language-plaintext highlighter-rouge">{{ layout }}</code>.</li>
|
|
949
|
+
<li>The <code class="language-plaintext highlighter-rouge">gems</code> key in the <code class="language-plaintext highlighter-rouge">_config.yml</code> is now <code class="language-plaintext highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="language-plaintext highlighter-rouge">gems</code> to <code class="language-plaintext highlighter-rouge">plugins</code> if you use the former.</li>
|
|
950
|
+
<li>Filters like <code class="language-plaintext highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="language-plaintext highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
|
|
908
951
|
<li>You can now create tab-separated data files.</li>
|
|
909
|
-
<li>Using <code class="highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="highlighter-rouge">layout: null</code>, with the exception that <code class="highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
|
|
952
|
+
<li>Using <code class="language-plaintext highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="language-plaintext highlighter-rouge">layout: null</code>, with the exception that <code class="language-plaintext highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
|
|
910
953
|
<li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
|
|
911
|
-
<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>
|
|
912
|
-
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
|
|
954
|
+
<li>We now automatically exclude the <code class="language-plaintext highlighter-rouge">Gemfile</code> from the site manifest when compiling your site. No more <code class="language-plaintext highlighter-rouge">_site/Gemfile</code>!</li>
|
|
955
|
+
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="language-plaintext highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
|
|
913
956
|
</ul>
|
|
914
957
|
|
|
915
958
|
<p>And <a href="/docs/history/">so much more!</a></p>
|
|
@@ -924,9 +967,9 @@ Thank you, all!</p>
|
|
|
924
967
|
|
|
925
968
|
<p>Please file any bugs with detailed replication instructions if you find any
|
|
926
969
|
bugs. Better yet, submit a patch if you find the bug in the code and know
|
|
927
|
-
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://
|
|
970
|
+
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://github.githubassets.com/images/icons/emoji/unicode/2764.png" height="20" width="20"></p>
|
|
928
971
|
|
|
929
|
-
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
|
972
|
+
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
|
|
930
973
|
|
|
931
974
|
</div>
|
|
932
975
|
</article>
|
|
@@ -956,26 +999,26 @@ how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://ass
|
|
|
956
999
|
<div class="post-content">
|
|
957
1000
|
<p>Another one-PR patch update as we continue our quest to destroy all bugs. A
|
|
958
1001
|
fairly technical debriefing follows, but the TLDR is that we have updated the
|
|
959
|
-
<code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
|
1002
|
+
<code class="language-plaintext highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
|
960
1003
|
|
|
961
1004
|
<p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
|
|
962
1005
|
moved away from using the deprecated
|
|
963
|
-
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="highlighter-rouge">URI.escape</code></a>
|
|
1006
|
+
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="language-plaintext highlighter-rouge">URI.escape</code></a>
|
|
964
1007
|
in favor of
|
|
965
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
|
|
966
|
-
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
|
|
1008
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code></a>.
|
|
1009
|
+
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="language-plaintext highlighter-rouge">uri_escape</code>
|
|
967
1010
|
filter</a>.</p>
|
|
968
1011
|
|
|
969
1012
|
<p>While this transition was mostly a smooth one, the two methods are not
|
|
970
|
-
identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
|
|
971
|
-
<code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
|
|
1013
|
+
identical. While <code class="language-plaintext highlighter-rouge">URI.escape</code> was happy to escape any string,
|
|
1014
|
+
<code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code>
|
|
972
1015
|
object, and will then escape each component of that object. In most cases, this
|
|
973
1016
|
difference was insignificant, but there were a few cases where this caused some
|
|
974
1017
|
unintended regressions when encoding colons.</p>
|
|
975
1018
|
|
|
976
|
-
<p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
|
|
1019
|
+
<p>While <strong>Addressable</strong> can understand that something like <code class="language-plaintext highlighter-rouge">"/example :page"</code> is a
|
|
977
1020
|
relative URI, without the slash it cannot figure out how to turn
|
|
978
|
-
<code class="highlighter-rouge">"example :page"</code> into an <code class="highlighter-rouge">Addressable::URI</code> object. <code class="highlighter-rouge">URI.escape</code> had no such
|
|
1021
|
+
<code class="language-plaintext highlighter-rouge">"example :page"</code> into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code> object. <code class="language-plaintext highlighter-rouge">URI.escape</code> had no such
|
|
979
1022
|
objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
|
|
980
1023
|
but breaking in 3.4.0:</p>
|
|
981
1024
|
|
|
@@ -985,8 +1028,8 @@ but breaking in 3.4.0:</p>
|
|
|
985
1028
|
<p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
|
|
986
1029
|
|
|
987
1030
|
<p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
|
|
988
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
|
989
|
-
which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
|
|
1031
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
|
1032
|
+
which will simply escape the characters in a string, much like <code class="language-plaintext highlighter-rouge">URI.escape</code>.</p>
|
|
990
1033
|
|
|
991
1034
|
<p>Thanks to <a href="https://github.com/cameronmcefee" class="user-mention">@cameronmcefee</a> and <a href="https://github.com/FriesFlorian" class="user-mention">@FriesFlorian</a> for reporting
|
|
992
1035
|
<a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
|
|
@@ -1030,15 +1073,15 @@ static files explicitly because they <em>don’t</em> have YAML front matter, wa
|
|
|
1030
1073
|
to respect YAML front matter?” That’s a great question. Let me illustrate
|
|
1031
1074
|
with an example.</p>
|
|
1032
1075
|
|
|
1033
|
-
<p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
|
1076
|
+
<p>Let’s look at <code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
|
1034
1077
|
pages, and static files, and some metadata for them in an XML file for a
|
|
1035
1078
|
Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
|
|
1036
|
-
file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
|
1079
|
+
file in this list, you set <code class="language-plaintext highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
|
1037
1080
|
what about static files, which don’t have YAML front matter? Before this
|
|
1038
1081
|
release, they could not be excluded because they had no properties in YAML
|
|
1039
1082
|
other than <a href="https://github.com/jekyll/jekyll/blob/v3.4.1/lib/jekyll/static_file.rb#L98-L106">the ones we explicitly assigned</a>.
|
|
1040
1083
|
So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
|
|
1041
|
-
<code class="highlighter-rouge">jekyll-sitemap</code>.</p>
|
|
1084
|
+
<code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>.</p>
|
|
1042
1085
|
|
|
1043
1086
|
<p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
|
|
1044
1087
|
defaults</a> for static files:</p>
|
|
@@ -1051,8 +1094,8 @@ defaults</a> for static files:</p>
|
|
|
1051
1094
|
<span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
|
|
1052
1095
|
</code></pre></div></div>
|
|
1053
1096
|
|
|
1054
|
-
<p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
|
|
1055
|
-
folder <code class="highlighter-rouge">pdfs/</code>, you’ll see <code class="highlighter-rouge">sitemap</code> equal to <code class="highlighter-rouge">false</code>.</p>
|
|
1097
|
+
<p>Now, for every file in the Liquid <code class="language-plaintext highlighter-rouge">site.static_files</code> loop which is in the
|
|
1098
|
+
folder <code class="language-plaintext highlighter-rouge">pdfs/</code>, you’ll see <code class="language-plaintext highlighter-rouge">sitemap</code> equal to <code class="language-plaintext highlighter-rouge">false</code>.</p>
|
|
1056
1099
|
|
|
1057
1100
|
<p>Many thanks to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a> for coming up with the solution and ensuring
|
|
1058
1101
|
sitemaps everywhere are filled with just the right content.</p>
|
|
@@ -1139,7 +1182,7 @@ well.</p>
|
|
|
1139
1182
|
|
|
1140
1183
|
<p>Well, not so much.</p>
|
|
1141
1184
|
|
|
1142
|
-
<p>A very common way to specify the month of February is <code class="highlighter-rouge">2</code>. This is true for
|
|
1185
|
+
<p>A very common way to specify the month of February is <code class="language-plaintext highlighter-rouge">2</code>. This is true for
|
|
1143
1186
|
all single-digit months and days of the month. Notice anything about our
|
|
1144
1187
|
first regular expression versus our second? The second regular expression
|
|
1145
1188
|
imposes a <strong>minimum</strong>, as well as maximum, number of digits. This change
|
|
@@ -1213,8 +1256,8 @@ Packed full of bug fixes as usual, thanks to the tireless efforts of our
|
|
|
1213
1256
|
exceptional Jekyll community. Three changes to call out:</p>
|
|
1214
1257
|
|
|
1215
1258
|
<ol>
|
|
1216
|
-
<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
|
|
1217
|
-
even bigger fan of <a href="/docs/templates/#filters"><code class="highlighter-rouge">group_by_exp</code></a>.</li>
|
|
1259
|
+
<li>If you’re a big fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">where_by_exp</code></a>, you’ll be an
|
|
1260
|
+
even bigger fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">group_by_exp</code></a>.</li>
|
|
1218
1261
|
<li>Using a custom timezone in Jekyll on Windows? Yeah, sorry that hasn’t ever worked
|
|
1219
1262
|
properly. We made it possible to accurately <a href="https://jekyllrb.com/docs/windows/#timezone-management">set the timezone using IANA
|
|
1220
1263
|
timezone codes</a>.</li>
|
|
@@ -1276,7 +1319,7 @@ fixes to call out:</p>
|
|
|
1276
1319
|
|
|
1277
1320
|
<ol>
|
|
1278
1321
|
<li>Only warn about auto-regeneration issues on Windows instead of disabling</li>
|
|
1279
|
-
<li>Exclude very specific <code class="highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="highlighter-rouge">vendor/</code>
|
|
1322
|
+
<li>Exclude very specific <code class="language-plaintext highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="language-plaintext highlighter-rouge">vendor/</code>
|
|
1280
1323
|
</li>
|
|
1281
1324
|
<li>Allow permalink templates to have plaintext underscores</li>
|
|
1282
1325
|
</ol>
|
|
@@ -1314,14 +1357,14 @@ fixes to call out:</p>
|
|
|
1314
1357
|
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
|
1315
1358
|
Three key things you might want to try:</p>
|
|
1316
1359
|
|
|
1317
|
-
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
|
|
1360
|
+
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="language-plaintext highlighter-rouge">/assets</code> directory</h3>
|
|
1318
1361
|
|
|
1319
1362
|
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
|
1320
1363
|
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
|
1321
1364
|
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
|
1322
1365
|
|
|
1323
1366
|
<p>In an effort to make theme management a bit easier, any files you put into
|
|
1324
|
-
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
|
1367
|
+
<code class="language-plaintext highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
|
1325
1368
|
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
|
1326
1369
|
webfonts, and so on – anything you’d consider a part of the
|
|
1327
1370
|
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
|
@@ -1329,51 +1372,51 @@ front matter, it will be converted and rendered. No YAML front matter, and
|
|
|
1329
1372
|
it will simply be copied over like a static asset.</p>
|
|
1330
1373
|
|
|
1331
1374
|
<p>Note that if a user has a file of the same path, the theme content will not
|
|
1332
|
-
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
|
1333
|
-
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
|
1375
|
+
be included in the site, i.e. a user’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code> will be read and
|
|
1376
|
+
processed if present instead of a theme’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code>.</p>
|
|
1334
1377
|
|
|
1335
1378
|
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
|
1336
1379
|
for more info.</p>
|
|
1337
1380
|
|
|
1338
|
-
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
|
|
1381
|
+
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="language-plaintext highlighter-rouge">relative_url</code> and <code class="language-plaintext highlighter-rouge">absolute_url</code> filters</h3>
|
|
1339
1382
|
|
|
1340
|
-
<p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
|
|
1383
|
+
<p>Want a clean way to prepend the <code class="language-plaintext highlighter-rouge">baseurl</code> or <code class="language-plaintext highlighter-rouge">url</code> in your config? These
|
|
1341
1384
|
new filters have you covered. When working locally, if you set your
|
|
1342
|
-
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
|
1343
|
-
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
|
1385
|
+
<code class="language-plaintext highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="language-plaintext highlighter-rouge">baseurl: "/myproject"</code>,
|
|
1386
|
+
then <code class="language-plaintext highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
|
1344
1387
|
you pass it:</p>
|
|
1345
1388
|
|
|
1346
1389
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /myproject/docs/assets</code></pre></figure>
|
|
1347
1390
|
|
|
1348
|
-
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
|
1349
|
-
<code class="highlighter-rouge">"/"</code>):</p>
|
|
1391
|
+
<p>By default, <code class="language-plaintext highlighter-rouge">baseurl</code> is set to <code class="language-plaintext highlighter-rouge">""</code> and therefore yields (never set to
|
|
1392
|
+
<code class="language-plaintext highlighter-rouge">"/"</code>):</p>
|
|
1350
1393
|
|
|
1351
1394
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /docs/assets</code></pre></figure>
|
|
1352
1395
|
|
|
1353
|
-
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
|
1354
|
-
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
|
1355
|
-
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
|
|
1396
|
+
<p>A result of <code class="language-plaintext highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
|
1397
|
+
relative to the domain root. A similar principle applies to <code class="language-plaintext highlighter-rouge">absolute_url</code>.
|
|
1398
|
+
It prepends your <code class="language-plaintext highlighter-rouge">baseurl</code> and <code class="language-plaintext highlighter-rouge">url</code> values, making absolute URLs all the
|
|
1356
1399
|
easier to make:</p>
|
|
1357
1400
|
|
|
1358
1401
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> => https://jekyllrb.com/myproject/docs/assets</code></pre></figure>
|
|
1359
1402
|
|
|
1360
|
-
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
|
|
1403
|
+
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="language-plaintext highlighter-rouge">site.url</code> is set by the development server</h3>
|
|
1361
1404
|
|
|
1362
|
-
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
|
1363
|
-
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
|
1364
|
-
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
|
1365
|
-
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
|
1366
|
-
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1405
|
+
<p>When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
|
1406
|
+
<code class="language-plaintext highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
|
1407
|
+
development. If you are using the new <code class="language-plaintext highlighter-rouge">absolute_url</code> filter, or using
|
|
1408
|
+
<code class="language-plaintext highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
|
1409
|
+
which resets the <code class="language-plaintext highlighter-rouge">url</code> value to point to <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1367
1410
|
|
|
1368
|
-
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
|
1369
|
-
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
|
1370
|
-
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
|
1371
|
-
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1411
|
+
<p>No longer! When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
|
1412
|
+
the value of the <code class="language-plaintext highlighter-rouge">host</code>, <code class="language-plaintext highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
|
1413
|
+
<code class="language-plaintext highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="language-plaintext highlighter-rouge">site.url</code>
|
|
1414
|
+
will yield <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
|
1372
1415
|
|
|
1373
1416
|
<p>This happens by default when running Jekyll locally. It will not be set if
|
|
1374
|
-
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
|
|
1375
|
-
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
|
1376
|
-
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
|
1417
|
+
you set <code class="language-plaintext highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="language-plaintext highlighter-rouge">jekyll serve</code>. If <code class="language-plaintext highlighter-rouge">JEKYLL_ENV</code> is
|
|
1418
|
+
any value except <code class="language-plaintext highlighter-rouge">development</code> (its default value), Jekyll will not
|
|
1419
|
+
overwrite the value of <code class="language-plaintext highlighter-rouge">url</code> in your config. And again, this only applies
|
|
1377
1420
|
to serving, not to building.</p>
|
|
1378
1421
|
|
|
1379
1422
|
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
|
@@ -1466,7 +1509,7 @@ prior to its release. I’m sure that they will support Jekyll Admin as much as
|
|
|
1466
1509
|
<div class="post-content">
|
|
1467
1510
|
<p>Well, 3.2.0 has been a success, but with one fatal flaw: it doesn’t work on
|
|
1468
1511
|
Windows! Sorry, Windows users. Hot on the trail of 3.2.0, this release
|
|
1469
|
-
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
|
1512
|
+
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20">. Sorry about that!</p>
|
|
1470
1513
|
|
|
1471
1514
|
<p>This release also fixes an issue when using <a href="/docs/themes/">gem-based themes</a>
|
|
1472
1515
|
where the theme was rejected if it existed behind a symlink. This is a
|
|
@@ -1513,7 +1556,7 @@ say? Yes, proper, versionable, releasable, first-class themes. We’re pretty
|
|
|
1513
1556
|
stoked about it and we hope you like building and using them. For now, it
|
|
1514
1557
|
only supports layouts, includes, and sass, but we have plans to include
|
|
1515
1558
|
static assets like images and CSS/JS in a future release. <a href="/docs/themes/">Read more about
|
|
1516
|
-
it in the docs.</a> Our site template generated by <code class="highlighter-rouge">jekyll new</code>
|
|
1559
|
+
it in the docs.</a> Our site template generated by <code class="language-plaintext highlighter-rouge">jekyll new</code>
|
|
1517
1560
|
now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">minima</a> theme.</p>
|
|
1518
1561
|
|
|
1519
1562
|
<p>Some other notable changes:</p>
|
|
@@ -1521,9 +1564,9 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
|
1521
1564
|
<ul>
|
|
1522
1565
|
<li>Symlinks are allowed as long as they target a file in the site source</li>
|
|
1523
1566
|
<li>Explicit support for Ruby 2.0.x was dropped</li>
|
|
1524
|
-
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
|
1525
|
-
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
|
1526
|
-
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
|
1567
|
+
<li>Added an <code class="language-plaintext highlighter-rouge">:after_init</code> Hook</li>
|
|
1568
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
|
1569
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
|
1527
1570
|
post or document based on its path relative to the site source</li>
|
|
1528
1571
|
<li>… and lots more!</li>
|
|
1529
1572
|
</ul>
|
|
@@ -1692,7 +1735,7 @@ release. Thank you!</p>
|
|
|
1692
1735
|
</div>
|
|
1693
1736
|
<div class="post-content">
|
|
1694
1737
|
<p>Upon releasing 3.1.5 and kicking the tires, we noticed a glaring bug: our
|
|
1695
|
-
beloved <code class="highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
|
1738
|
+
beloved <code class="language-plaintext highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
|
1696
1739
|
us and we decided a 3.1.6 was necessary. This release restores sanity to
|
|
1697
1740
|
our object-to-JSON generation in Liquid and we hope you enjoy.</p>
|
|
1698
1741
|
|
|
@@ -1731,7 +1774,7 @@ changelog</a>.</p>
|
|
|
1731
1774
|
<p>There’s always at least one bug, right? :)</p>
|
|
1732
1775
|
|
|
1733
1776
|
<p>Hot on the trails of <a href="/news/2016/05/18/jekyll-3-1-4-released/">v3.1.4</a>, we
|
|
1734
|
-
bring you v3.1.5! It fixes one bug around requiring the <code class="highlighter-rouge">ExcerptDrop</code>,
|
|
1777
|
+
bring you v3.1.5! It fixes one bug around requiring the <code class="language-plaintext highlighter-rouge">ExcerptDrop</code>,
|
|
1735
1778
|
which only affects Linux. For the gory details, see <a href="https://github.com/jekyll/jekyll/pull/4912">the pull
|
|
1736
1779
|
request for the fix</a>.</p>
|
|
1737
1780
|
|
|
@@ -1768,15 +1811,15 @@ request for the fix</a>.</p>
|
|
|
1768
1811
|
<p>Today, we released v3.1.4 in an effort to bring more stability to the v3.1.x series. This bugfix release consists of:</p>
|
|
1769
1812
|
|
|
1770
1813
|
<ul>
|
|
1771
|
-
<li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
|
1772
|
-
<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>
|
|
1773
|
-
<li>A fix where <code class="highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
|
1774
|
-
<li>We added <code class="highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
|
|
1814
|
+
<li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
|
1815
|
+
<li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where a parent layout (e.g. <code class="language-plaintext highlighter-rouge">default</code> or <code class="language-plaintext highlighter-rouge">base</code>) would overwrite the metadata of the child layout (e.g. <code class="language-plaintext highlighter-rouge">post</code> or <code class="language-plaintext highlighter-rouge">special</code>).</li>
|
|
1816
|
+
<li>A fix where <code class="language-plaintext highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
|
1817
|
+
<li>We added <code class="language-plaintext highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
|
|
1775
1818
|
<li>
|
|
1776
|
-
<code class="highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="highlighter-rouge">docs</code> shows up before <code class="highlighter-rouge">posts</code> reliably.</li>
|
|
1819
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="language-plaintext highlighter-rouge">docs</code> shows up before <code class="language-plaintext highlighter-rouge">posts</code> reliably.</li>
|
|
1777
1820
|
</ul>
|
|
1778
1821
|
|
|
1779
|
-
<p>The fixes for <code class="highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
|
|
1822
|
+
<p>The fixes for <code class="language-plaintext highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
|
|
1780
1823
|
|
|
1781
1824
|
<p>We are alwawys striving to make Jekyll more straight-forward to use. Please do open an issue if you believe an aspect of Jekyll’s user experience isn’t up to par.</p>
|
|
1782
1825
|
|
|
@@ -1857,7 +1900,7 @@ we think you’ll love.</p>
|
|
|
1857
1900
|
|
|
1858
1901
|
<ul>
|
|
1859
1902
|
<li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
|
|
1860
|
-
<li>Running <code class="highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
|
1903
|
+
<li>Running <code class="language-plaintext highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
|
1861
1904
|
</ul>
|
|
1862
1905
|
|
|
1863
1906
|
<p>Both of these issues have been resolved. For more information, check out <a href="/docs/history/#v3-1-3">the full history</a>.</p>
|
|
@@ -1894,7 +1937,7 @@ we think you’ll love.</p>
|
|
|
1894
1937
|
|
|
1895
1938
|
<ul>
|
|
1896
1939
|
<li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
|
|
1897
|
-
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
|
|
1940
|
+
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="language-plaintext highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="language-plaintext highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
|
|
1898
1941
|
</ul>
|
|
1899
1942
|
|
|
1900
1943
|
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">collections</span><span class="pi">:</span>
|
|
@@ -1974,8 +2017,8 @@ we think you’ll love.</p>
|
|
|
1974
2017
|
<li>If a syntax error is encountered by Liquid, it will now print the line number.</li>
|
|
1975
2018
|
<li>A nasty war between symbols and strings in our configuration hash caused kramdown syntax highlighting to break. That has been resolved; you stand victorious!</li>
|
|
1976
2019
|
<li>A tilde at the beginning of a filename will no longer crash Jekyll.</li>
|
|
1977
|
-
<li>The <code class="highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
|
1978
|
-
<li>Permalinks which end in a slash will now always output as a folder with an <code class="highlighter-rouge">index.html</code> inside.</li>
|
|
2020
|
+
<li>The <code class="language-plaintext highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
|
2021
|
+
<li>Permalinks which end in a slash will now always output as a folder with an <code class="language-plaintext highlighter-rouge">index.html</code> inside.</li>
|
|
1979
2022
|
</ul>
|
|
1980
2023
|
|
|
1981
2024
|
<p>Nitty-gritty details, like always, are available in the <a href="/docs/history/">history</a>.</p>
|
|
@@ -2015,7 +2058,7 @@ fixes:</p>
|
|
|
2015
2058
|
|
|
2016
2059
|
<ul>
|
|
2017
2060
|
<li>Fix problem where outputting to a folder would have two extensions</li>
|
|
2018
|
-
<li>Handle tildes (<code class="highlighter-rouge">~</code>) in filenames properly</li>
|
|
2061
|
+
<li>Handle tildes (<code class="language-plaintext highlighter-rouge">~</code>) in filenames properly</li>
|
|
2019
2062
|
<li>Fix issue when comparing documents without dates</li>
|
|
2020
2063
|
<li>Include line numbers in liquid error output</li>
|
|
2021
2064
|
</ul>
|
|
@@ -2057,15 +2100,15 @@ you’re having.</p>
|
|
|
2057
2100
|
</a>
|
|
2058
2101
|
</div>
|
|
2059
2102
|
<div class="post-content">
|
|
2060
|
-
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
|
2103
|
+
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> noticed by a few
|
|
2061
2104
|
wonderful Jekyll users:</p>
|
|
2062
2105
|
|
|
2063
2106
|
<ul>
|
|
2064
|
-
<li>If your <code class="highlighter-rouge">permalink</code> ended with a <code class="highlighter-rouge">/</code>, your URL didn’t have any extension,
|
|
2107
|
+
<li>If your <code class="language-plaintext highlighter-rouge">permalink</code> ended with a <code class="language-plaintext highlighter-rouge">/</code>, your URL didn’t have any extension,
|
|
2065
2108
|
even if you wanted one</li>
|
|
2066
|
-
<li>We now strip the BOM by default per Ruby’s <code class="highlighter-rouge">IO.open</code>.</li>
|
|
2109
|
+
<li>We now strip the BOM by default per Ruby’s <code class="language-plaintext highlighter-rouge">IO.open</code>.</li>
|
|
2067
2110
|
<li>
|
|
2068
|
-
<code class="highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
|
2111
|
+
<code class="language-plaintext highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
|
2069
2112
|
</ul>
|
|
2070
2113
|
|
|
2071
2114
|
<p>We also updated our <a href="/docs/conduct/">Code of Conduct</a> to the latest version of
|
|
@@ -2081,7 +2124,7 @@ that</a>.</p>
|
|
|
2081
2124
|
<p>See links to the PR’s on <a href="/docs/history/#v3-1-1">the history page</a>.</p>
|
|
2082
2125
|
|
|
2083
2126
|
<p>Thanks to Jordon Bedwell, chrisfinazzo, Kroum Tzanev, David Celis, and
|
|
2084
|
-
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
|
2127
|
+
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
|
2085
2128
|
|
|
2086
2129
|
<p>Happy Jekylling!</p>
|
|
2087
2130
|
|
|
@@ -2123,13 +2166,13 @@ considerably!</p>
|
|
|
2123
2166
|
<p>Some other highlights:</p>
|
|
2124
2167
|
|
|
2125
2168
|
<ul>
|
|
2126
|
-
<li>Fix: <code class="highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
|
2127
|
-
<li>Fix: <code class="highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="highlighter-rouge">--source</code>.</li>
|
|
2128
|
-
<li>Enhancement: <code class="highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
|
2129
|
-
<li>Feature: adds new <code class="highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
|
2169
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
|
2170
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="language-plaintext highlighter-rouge">--source</code>.</li>
|
|
2171
|
+
<li>Enhancement: <code class="language-plaintext highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
|
2172
|
+
<li>Feature: adds new <code class="language-plaintext highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
|
2130
2173
|
<li>Fix: Jekyll will read in files with YAML front matter that has extraneous
|
|
2131
2174
|
spaces after the first line</li>
|
|
2132
|
-
<li>Enhancement: extract the <code class="highlighter-rouge">title</code> attribute from the filename for
|
|
2175
|
+
<li>Enhancement: extract the <code class="language-plaintext highlighter-rouge">title</code> attribute from the filename for
|
|
2133
2176
|
collection items without a date</li>
|
|
2134
2177
|
<li>Fix: gracefully handle empty configuration files</li>
|
|
2135
2178
|
</ul>
|
|
@@ -2184,8 +2227,8 @@ midnightSuyama, musoke, and rebornix</p>
|
|
|
2184
2227
|
<p>A crucial bug was found in v3.0.1 which caused invalid post dates to go
|
|
2185
2228
|
unnoticed in the build chain until the error that popped up was unhelpful.
|
|
2186
2229
|
v3.0.2 <a href="https://github.com/jekyll/jekyll/issues/4375">throws errors as you’d expect</a>
|
|
2187
|
-
when there is a post like <code class="highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
|
2188
|
-
invalid date like <code class="highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
|
2230
|
+
when there is a post like <code class="language-plaintext highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
|
2231
|
+
invalid date like <code class="language-plaintext highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
|
2189
2232
|
|
|
2190
2233
|
<p>This should make the experience of working with Jekyll just a little
|
|
2191
2234
|
better.</p>
|
|
@@ -2221,12 +2264,12 @@ better.</p>
|
|
|
2221
2264
|
<p>Hey, folks! Bunch of bug fixes here. Notables:</p>
|
|
2222
2265
|
|
|
2223
2266
|
<ul>
|
|
2224
|
-
<li>Only superdirectories of <code class="highlighter-rouge">_posts</code> will be categories.</li>
|
|
2267
|
+
<li>Only superdirectories of <code class="language-plaintext highlighter-rouge">_posts</code> will be categories.</li>
|
|
2225
2268
|
<li>
|
|
2226
|
-
<code class="highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
|
2269
|
+
<code class="language-plaintext highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
|
2227
2270
|
<li>
|
|
2228
|
-
<code class="highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
|
2229
|
-
<li>Failure in liquid will now always fail the <code class="highlighter-rouge">jekyll</code> process.</li>
|
|
2271
|
+
<code class="language-plaintext highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
|
2272
|
+
<li>Failure in liquid will now always fail the <code class="language-plaintext highlighter-rouge">jekyll</code> process.</li>
|
|
2230
2273
|
<li>All hooks should now be properly registered & documented</li>
|
|
2231
2274
|
</ul>
|
|
2232
2275
|
|
|
@@ -2268,20 +2311,20 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
|
|
|
2268
2311
|
<p>The much-anticipated Jekyll 3.0 has been released! Key changes:</p>
|
|
2269
2312
|
|
|
2270
2313
|
<ul>
|
|
2271
|
-
<li>Incremental regeneration (experimental, enable with <code class="highlighter-rouge">--incremental</code>)</li>
|
|
2272
|
-
<li>Liquid profiler (add <code class="highlighter-rouge">--profile</code> to a build or serve)</li>
|
|
2314
|
+
<li>Incremental regeneration (experimental, enable with <code class="language-plaintext highlighter-rouge">--incremental</code>)</li>
|
|
2315
|
+
<li>Liquid profiler (add <code class="language-plaintext highlighter-rouge">--profile</code> to a build or serve)</li>
|
|
2273
2316
|
<li>Hook plugin API (no more monkey-patching!)</li>
|
|
2274
2317
|
<li>Dependencies reduced from 14 to 8, none contain C extensions. We’re hoping to reduce this even more in the future.</li>
|
|
2275
2318
|
<li>Changed version support: no support for Ruby 1.9.3, added basic JRuby support. Better Windows support.</li>
|
|
2276
2319
|
<li>Extension-less URLs</li>
|
|
2277
2320
|
<li>
|
|
2278
|
-
<code class="highlighter-rouge">site.collections</code> is an array of collections, thus:
|
|
2321
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> is an array of collections, thus:
|
|
2279
2322
|
<ul>
|
|
2280
2323
|
<li>
|
|
2281
|
-
<code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
|
|
2324
|
+
<code class="language-plaintext highlighter-rouge">collection[0]</code> becomes <code class="language-plaintext highlighter-rouge">collection.label</code>
|
|
2282
2325
|
</li>
|
|
2283
2326
|
<li>
|
|
2284
|
-
<code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
|
|
2327
|
+
<code class="language-plaintext highlighter-rouge">collection[1]</code> becomes <code class="language-plaintext highlighter-rouge">collection</code>
|
|
2285
2328
|
</li>
|
|
2286
2329
|
</ul>
|
|
2287
2330
|
</li>
|
|
@@ -2542,8 +2585,8 @@ place!</p>
|
|
|
2542
2585
|
</div>
|
|
2543
2586
|
<div class="post-content">
|
|
2544
2587
|
<p>A very minor release, 2.5.2 fixes a bug with path sanitation that 2.5.1
|
|
2545
|
-
introduced. It also improves the <code class="highlighter-rouge">post_url</code> tag such that it checks the
|
|
2546
|
-
posts’ name (e.g. <code class="highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
|
2588
|
+
introduced. It also improves the <code class="language-plaintext highlighter-rouge">post_url</code> tag such that it checks the
|
|
2589
|
+
posts’ name (e.g. <code class="language-plaintext highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
|
2547
2590
|
name. This fixes issues where posts are created and the day changes based
|
|
2548
2591
|
on timezone discrepancies.</p>
|
|
2549
2592
|
|
|
@@ -2630,17 +2673,17 @@ milestone with a pretty big release. What’s changed in 2.5.0? Here are some
|
|
|
2630
2673
|
highlights:</p>
|
|
2631
2674
|
|
|
2632
2675
|
<ul>
|
|
2633
|
-
<li>Require plugins in the <code class="highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
|
2634
|
-
<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>
|
|
2635
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
|
2636
|
-
<li>Shorted <code class="highlighter-rouge">build</code> and <code class="highlighter-rouge">serve</code> commands with <code class="highlighter-rouge">b</code> and <code class="highlighter-rouge">s</code> aliases, respectively</li>
|
|
2676
|
+
<li>Require plugins in the <code class="language-plaintext highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
|
2677
|
+
<li>YAML Front Matter permalinks can now contain placeholders like <code class="language-plaintext highlighter-rouge">:name</code>. Check out all the placeholders on the <a href="/docs/permalinks/">Permalinks docs page</a>.</li>
|
|
2678
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
|
2679
|
+
<li>Shorted <code class="language-plaintext highlighter-rouge">build</code> and <code class="language-plaintext highlighter-rouge">serve</code> commands with <code class="language-plaintext highlighter-rouge">b</code> and <code class="language-plaintext highlighter-rouge">s</code> aliases, respectively</li>
|
|
2637
2680
|
<li>WEBrick will now list your directory if it can’t find an index file.</li>
|
|
2638
|
-
<li>Any enumerable can be used with the <code class="highlighter-rouge">where</code> filter.</li>
|
|
2681
|
+
<li>Any enumerable can be used with the <code class="language-plaintext highlighter-rouge">where</code> filter.</li>
|
|
2639
2682
|
<li>Performance optimizations thanks to <a href="https://github.com/tmm1" class="user-mention">@tmm1</a>’s <a href="https://github.com/tmm1/stackprof">stackprof</a>
|
|
2640
2683
|
</li>
|
|
2641
2684
|
<li>Fix for Rouge’s Redcarpet interface</li>
|
|
2642
2685
|
<li>Security auditors will love this: path sanitation has now been centralized.</li>
|
|
2643
|
-
<li>Specify a log level with <code class="highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
|
2686
|
+
<li>Specify a log level with <code class="language-plaintext highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
|
2644
2687
|
</ul>
|
|
2645
2688
|
|
|
2646
2689
|
<p>…and a whole bunch of other fixes and enhancements you can read more
|
|
@@ -2694,14 +2737,14 @@ Custódio, Igor Kapkov, and Kevin Ndung’u!</p>
|
|
|
2694
2737
|
<p>Well, lookie here! A new release of Jekyll! v2.4.0 contains lots of goodies, including some brilliant new additions:</p>
|
|
2695
2738
|
|
|
2696
2739
|
<ul>
|
|
2697
|
-
<li>A new <code class="highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
|
2740
|
+
<li>A new <code class="language-plaintext highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
|
2698
2741
|
<li>Render Liquid in CoffeeScript files (<a href="https://github.com/jekyll/jekyll/issues/2830">#2830</a>)</li>
|
|
2699
|
-
<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>
|
|
2700
|
-
<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>
|
|
2701
|
-
<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>
|
|
2702
|
-
<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>
|
|
2703
|
-
<li>Add <code class="highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
|
2704
|
-
<li>Add a <code class="highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
|
2742
|
+
<li>Add 4 new array Liquid filters: <code class="language-plaintext highlighter-rouge">push</code>, <code class="language-plaintext highlighter-rouge">pop</code>, <code class="language-plaintext highlighter-rouge">shift</code>, and <code class="language-plaintext highlighter-rouge">unshift</code> (<a href="https://github.com/jekyll/jekyll/pull/2895">#2895</a>)</li>
|
|
2743
|
+
<li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="language-plaintext highlighter-rouge">-w</code>!</li>
|
|
2744
|
+
<li>Add <code class="language-plaintext highlighter-rouge">:title</code> and <code class="language-plaintext highlighter-rouge">:name</code> to collection URL template fillers (<a href="https://github.com/jekyll/jekyll/issues/2864">#2864</a> & <a href="https://github.com/jekyll/jekyll/issues/2799">#2799</a>)</li>
|
|
2745
|
+
<li>Add support for CSV files in the <code class="language-plaintext highlighter-rouge">_data</code> directory (<a href="https://github.com/jekyll/jekyll/issues/2761">#2761</a>)</li>
|
|
2746
|
+
<li>Add <code class="language-plaintext highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
|
2747
|
+
<li>Add a <code class="language-plaintext highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
|
2705
2748
|
</ul>
|
|
2706
2749
|
|
|
2707
2750
|
<p>Some other wunderbar bug fixes in there as well. Check out the <a href="/docs/history/">full changelog</a> for the whole scoop.</p>
|
|
@@ -2745,22 +2788,22 @@ curious bug indeed.</a>
|
|
|
2745
2788
|
</li>
|
|
2746
2789
|
<li>Pages, Posts, and Drafts can now be converted by multiple converters.</li>
|
|
2747
2790
|
<li>Static files can now be safely included in collections. They’ll be placed
|
|
2748
|
-
in a <code class="highlighter-rouge">collection.files</code> array. <code class="highlighter-rouge">collection.docs</code> still holds exclusively
|
|
2791
|
+
in a <code class="language-plaintext highlighter-rouge">collection.files</code> array. <code class="language-plaintext highlighter-rouge">collection.docs</code> still holds exclusively
|
|
2749
2792
|
content with YAML front matter.</li>
|
|
2750
2793
|
<li>Sass files can once again be rendered by Liquid. However, neither Sass
|
|
2751
|
-
nor CoffeeScript can ever have a layout. Bonus: <code class="highlighter-rouge">scssify</code> and <code class="highlighter-rouge">sassify</code>
|
|
2794
|
+
nor CoffeeScript can ever have a layout. Bonus: <code class="language-plaintext highlighter-rouge">scssify</code> and <code class="language-plaintext highlighter-rouge">sassify</code>
|
|
2752
2795
|
Liquid filters.</li>
|
|
2753
|
-
<li>Partial variables allowed now in the path argument of <code class="highlighter-rouge">include</code> calls</li>
|
|
2754
|
-
<li>We added a <code class="highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
|
2755
|
-
about that subcommand. Or don’t, to see the help for <code class="highlighter-rouge">jekyll</code> itself.</li>
|
|
2756
|
-
<li>Lots of fixes to the site template we use for <code class="highlighter-rouge">jekyll new</code>, including
|
|
2796
|
+
<li>Partial variables allowed now in the path argument of <code class="language-plaintext highlighter-rouge">include</code> calls</li>
|
|
2797
|
+
<li>We added a <code class="language-plaintext highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
|
2798
|
+
about that subcommand. Or don’t, to see the help for <code class="language-plaintext highlighter-rouge">jekyll</code> itself.</li>
|
|
2799
|
+
<li>Lots of fixes to the site template we use for <code class="language-plaintext highlighter-rouge">jekyll new</code>, including
|
|
2757
2800
|
converting the CSS into SCSS.</li>
|
|
2758
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter will now call <code class="highlighter-rouge">#to_liquid</code> for you</li>
|
|
2801
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter will now call <code class="language-plaintext highlighter-rouge">#to_liquid</code> for you</li>
|
|
2759
2802
|
<li>Lots, lots more!</li>
|
|
2760
2803
|
</ul>
|
|
2761
2804
|
|
|
2762
2805
|
<p>One change deserves special note. In <a href="https://github.com/jekyll/jekyll/issues/2633">#2633</a>, subfolders <em>inside</em> a
|
|
2763
|
-
<code class="highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
|
2806
|
+
<code class="language-plaintext highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
|
2764
2807
|
turns out, this behaviour was unwanted by a large number of individuals, as
|
|
2765
2808
|
it is a handy way to organize posts. Ultimately, we decided to revert this
|
|
2766
2809
|
change in <a href="https://github.com/jekyll/jekyll/issues/2705">#2705</a>, because it was a change in behaviour that was already
|
|
@@ -2801,7 +2844,7 @@ page</a>! Happy Jekylling!</p>
|
|
|
2801
2844
|
<li>A warning will now fire if you specify a layout in any of your pages or
|
|
2802
2845
|
posts that doesn’t exist.</li>
|
|
2803
2846
|
<li>Certain Pygments options are now whitelisted in safe mode</li>
|
|
2804
|
-
<li>Categories in a post’s path are now respected (i.e. folders in <code class="highlighter-rouge">_posts</code>
|
|
2847
|
+
<li>Categories in a post’s path are now respected (i.e. folders in <code class="language-plaintext highlighter-rouge">_posts</code>
|
|
2805
2848
|
will now work properly).</li>
|
|
2806
2849
|
</ol>
|
|
2807
2850
|
|
|
@@ -2841,7 +2884,7 @@ introduces fixes for a couple security-related issues.</p>
|
|
|
2841
2884
|
|
|
2842
2885
|
<ol>
|
|
2843
2886
|
<li>One in the reading of data</li>
|
|
2844
|
-
<li>One in the <code class="highlighter-rouge">layouts</code> setting</li>
|
|
2887
|
+
<li>One in the <code class="language-plaintext highlighter-rouge">layouts</code> setting</li>
|
|
2845
2888
|
</ol>
|
|
2846
2889
|
|
|
2847
2890
|
<p>They were identified in Jekyll 1.5.1 and has been confirmed as patched
|
|
@@ -2849,7 +2892,7 @@ in this version and the version used by GitHub Pages. If you are in the
|
|
|
2849
2892
|
business of building Jekyll sites, please ensure you upgrade to 2.1.1 as
|
|
2850
2893
|
soon as possible.</p>
|
|
2851
2894
|
|
|
2852
|
-
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
|
2895
|
+
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="language-plaintext highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
|
2853
2896
|
|
|
2854
2897
|
<p>Additionally, the dependency on Maruku has been loosened and a bug was
|
|
2855
2898
|
fixed with document URLs.</p>
|
|
@@ -2893,13 +2936,13 @@ things to look forward to:</p>
|
|
|
2893
2936
|
<li>Set front matter defaults for collections (#2419)</li>
|
|
2894
2937
|
<li>Set a collection-specific URL template (#2418)</li>
|
|
2895
2938
|
<li>
|
|
2896
|
-
<code class="highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
|
2939
|
+
<code class="language-plaintext highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
|
2897
2940
|
<li>
|
|
2898
|
-
<code class="highlighter-rouge">.json</code> files in <code class="highlighter-rouge">_data</code> (#2369)</li>
|
|
2899
|
-
<li>Allow subdirectories in <code class="highlighter-rouge">_data</code> (#2395)</li>
|
|
2900
|
-
<li>Add support for <code class="highlighter-rouge">hl_lines</code> in <code class="highlighter-rouge">highlight</code> tag (#2532)</li>
|
|
2941
|
+
<code class="language-plaintext highlighter-rouge">.json</code> files in <code class="language-plaintext highlighter-rouge">_data</code> (#2369)</li>
|
|
2942
|
+
<li>Allow subdirectories in <code class="language-plaintext highlighter-rouge">_data</code> (#2395)</li>
|
|
2943
|
+
<li>Add support for <code class="language-plaintext highlighter-rouge">hl_lines</code> in <code class="language-plaintext highlighter-rouge">highlight</code> tag (#2532)</li>
|
|
2901
2944
|
<li>Post categories now merge with directory, front matter, and defaults (#2373)</li>
|
|
2902
|
-
<li>New <code class="highlighter-rouge">--skip_initial_build</code> flag for <code class="highlighter-rouge">jekyll serve</code> (#2477)</li>
|
|
2945
|
+
<li>New <code class="language-plaintext highlighter-rouge">--skip_initial_build</code> flag for <code class="language-plaintext highlighter-rouge">jekyll serve</code> (#2477)</li>
|
|
2903
2946
|
<li>A bajilion bug fixes and site updates!</li>
|
|
2904
2947
|
</ul>
|
|
2905
2948
|
|
|
@@ -3019,15 +3062,15 @@ swell on your favourite hardware.</a></p>
|
|
|
3019
3062
|
<li>
|
|
3020
3063
|
<a href="/docs/collections/">Collections</a> - Collections allow you to define an unlimited number of custom document types (beyond just posts and pages) for different types of content you may want to author in Jekyll such as API documentation or a cookbook!</li>
|
|
3021
3064
|
<li>
|
|
3022
|
-
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
|
3065
|
+
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="language-plaintext highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
|
3023
3066
|
<li>
|
|
3024
3067
|
<a href="/docs/assets/">Native Sass & CoffeeScript support</a> - We love CSS and JavaScript as much as the next guy, but there will always be a special place in our hearts for Sass and CoffeeScript. We now offer native support for these file types — no more messing around with Rake or Grunt!</li>
|
|
3025
3068
|
<li>
|
|
3026
|
-
<a href="/docs/configuration/#front-matter-defaults">YAML Front Matter defaults</a> - If you’ve set <code class="highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
|
|
3069
|
+
<a href="/docs/configuration/#front-matter-defaults">YAML Front Matter defaults</a> - If you’ve set <code class="language-plaintext highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
|
|
3027
3070
|
<li>
|
|
3028
|
-
<a href="/docs/configuration/#custom-markdown-processors">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
|
|
3071
|
+
<a href="/docs/configuration/#custom-markdown-processors">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="language-plaintext highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
|
|
3029
3072
|
<li>
|
|
3030
|
-
<a href="/docs/templates/#filters">Addition of <code class="highlighter-rouge">where</code> and <code class="highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
|
|
3073
|
+
<a href="/docs/templates/#filters">Addition of <code class="language-plaintext highlighter-rouge">where</code> and <code class="language-plaintext highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="language-plaintext highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="language-plaintext highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
|
|
3031
3074
|
<li>
|
|
3032
3075
|
<a href="https://github.com/jekyll/jekyll/pull/1988">Switch from Maruku to Kramdown as default markdown converter</a> - Maruku is dead. We’ve replaced it with the converter which has the closest feature parity: Kramdown!</li>
|
|
3033
3076
|
</ol>
|
|
@@ -3068,7 +3111,7 @@ swell on your favourite hardware.</a></p>
|
|
|
3068
3111
|
</div>
|
|
3069
3112
|
<div class="post-content">
|
|
3070
3113
|
<p>The hawk-eyed <a href="https://github.com/gregose">@gregose</a> spotted a bug in our
|
|
3071
|
-
<code class="highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
|
3114
|
+
<code class="language-plaintext highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
|
3072
3115
|
|
|
3073
3116
|
<figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="o">></span> <span class="n">sanitized_path</span><span class="p">(</span><span class="s2">"/tmp/foobar/jail"</span><span class="p">,</span> <span class="s2">"..c:/..c:/..c:/etc/passwd"</span><span class="p">)</span>
|
|
3074
3117
|
<span class="o">=></span> <span class="s2">"/tmp/foobar/jail/../../../etc/passwd"</span></code></pre></figure>
|
|
@@ -3108,7 +3151,7 @@ the masses. Thanks, Greg!</p>
|
|
|
3108
3151
|
</div>
|
|
3109
3152
|
<div class="post-content">
|
|
3110
3153
|
<p>As work continues on Jekyll 2.0.0, we felt it was important to address two key
|
|
3111
|
-
issues of Jekyll 1.4.3, namely the <code class="highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
|
3154
|
+
issues of Jekyll 1.4.3, namely the <code class="language-plaintext highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
|
3112
3155
|
inability to use Jekyll 1.4.3 on Windows due to a <a href="https://github.com/jekyll/jekyll/issues/1948">fun issue with path sanitizing</a>.</p>
|
|
3113
3156
|
|
|
3114
3157
|
<p>For a full changelog, check out our <a href="/docs/history/#v1-5-0">history</a> page.</p>
|
|
@@ -3153,7 +3196,7 @@ generated output via improper symlink sanitization, potentially resulting in an
|
|
|
3153
3196
|
inadvertent information disclosure.</p>
|
|
3154
3197
|
|
|
3155
3198
|
<p>Versions of Jekyll prior to 1.4.3 may also allow malicious users to write
|
|
3156
|
-
arbitrary <code class="highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
|
3199
|
+
arbitrary <code class="language-plaintext highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
|
3157
3200
|
traversal, potentially overwriting otherwise-trusted content with arbitrary HTML
|
|
3158
3201
|
or Javascript depending on your server’s configuration.</p>
|
|
3159
3202
|
|
|
@@ -3188,8 +3231,8 @@ these vulnerabilities, and to <a href="https://github.com/BenBalter" class="user
|
|
|
3188
3231
|
<div class="post-content">
|
|
3189
3232
|
<p>This release fixes <a href="https://github.com/jekyll/jekyll/pull/1830">a regression</a> where Maruku fenced code blocks were turned
|
|
3190
3233
|
off, instead of the previous default to on. We’ve added a new default
|
|
3191
|
-
configuration to our <code class="highlighter-rouge">maruku</code> config key: <code class="highlighter-rouge">fenced_code_blocks</code> and set it to
|
|
3192
|
-
default to <code class="highlighter-rouge">true</code>.</p>
|
|
3234
|
+
configuration to our <code class="language-plaintext highlighter-rouge">maruku</code> config key: <code class="language-plaintext highlighter-rouge">fenced_code_blocks</code> and set it to
|
|
3235
|
+
default to <code class="language-plaintext highlighter-rouge">true</code>.</p>
|
|
3193
3236
|
|
|
3194
3237
|
<p>If you do not wish to use Maruku fenced code blocks, you may turn this option
|
|
3195
3238
|
off in your site’s configuration file.</p>
|
|
@@ -3272,7 +3315,7 @@ Jekyll v1.4.0. This release will be the last non-patch release to support Ruby
|
|
|
3272
3315
|
a ton of bugfixes over the previous 0.6.x releases.</p>
|
|
3273
3316
|
</li>
|
|
3274
3317
|
<li>
|
|
3275
|
-
<p>Non-<code class="highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
|
3318
|
+
<p>Non-<code class="language-plaintext highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
|
3276
3319
|
processed, which can provide a rudimentary way to establish a load order for
|
|
3277
3320
|
plugins.</p>
|
|
3278
3321
|
</li>
|
|
@@ -3316,7 +3359,7 @@ Karékinian, Jordon Bedwell, Matthew Iversen, Persa Zula, and Yi Zeng.</p>
|
|
|
3316
3359
|
release of 1.3.0.</p>
|
|
3317
3360
|
|
|
3318
3361
|
<p>In addition to a couple of other smaller bug fixes, the biggest thing
|
|
3319
|
-
we’ve fixed is an issue with the <code class="highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
|
3362
|
+
we’ve fixed is an issue with the <code class="language-plaintext highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
|
3320
3363
|
full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
|
3321
3364
|
|
|
3322
3365
|
<p>Thanks to all the people who have contributed to this release! They are
|
|
@@ -3360,33 +3403,33 @@ love.</p>
|
|
|
3360
3403
|
<ul>
|
|
3361
3404
|
<li>
|
|
3362
3405
|
<p>You can add <a href="/docs/datafiles/">arbitrary data</a> to the site by adding YAML files under a
|
|
3363
|
-
site’s <code class="highlighter-rouge">_data</code> directory. This will allow you to avoid
|
|
3406
|
+
site’s <code class="language-plaintext highlighter-rouge">_data</code> directory. This will allow you to avoid
|
|
3364
3407
|
repetition in your templates and to set site specific options without
|
|
3365
|
-
changing <code class="highlighter-rouge">_config.yml</code>.</p>
|
|
3408
|
+
changing <code class="language-plaintext highlighter-rouge">_config.yml</code>.</p>
|
|
3366
3409
|
</li>
|
|
3367
3410
|
<li>
|
|
3368
|
-
<p>You can now run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
|
3369
|
-
background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut
|
|
3411
|
+
<p>You can now run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
|
3412
|
+
background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut
|
|
3370
3413
|
the server down. When ran, you’ll get a process id that you can use in
|
|
3371
|
-
place of <code class="highlighter-rouge">[server_pid]</code></p>
|
|
3414
|
+
place of <code class="language-plaintext highlighter-rouge">[server_pid]</code></p>
|
|
3372
3415
|
</li>
|
|
3373
3416
|
<li>
|
|
3374
3417
|
<p>You can now <strong>disable automatically-generated excerpts</strong> if you set
|
|
3375
|
-
<code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</p>
|
|
3418
|
+
<code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</p>
|
|
3376
3419
|
</li>
|
|
3377
3420
|
<li>
|
|
3378
3421
|
<p>If you’re moving pages and posts, you can now check for <strong>URL
|
|
3379
|
-
conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</p>
|
|
3422
|
+
conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</p>
|
|
3380
3423
|
</li>
|
|
3381
3424
|
<li>
|
|
3382
3425
|
<p>If you’re a fan of the drafts feature, you’ll be happy to know we’ve
|
|
3383
|
-
added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</p>
|
|
3426
|
+
added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</p>
|
|
3384
3427
|
</li>
|
|
3385
3428
|
<li>
|
|
3386
3429
|
<p>Permalinks with special characters should now generate without errors.</p>
|
|
3387
3430
|
</li>
|
|
3388
3431
|
<li>
|
|
3389
|
-
<p>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid
|
|
3432
|
+
<p>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid
|
|
3390
3433
|
variable.</p>
|
|
3391
3434
|
</li>
|
|
3392
3435
|
</ul>
|
|
@@ -3457,11 +3500,11 @@ issues!</p>
|
|
|
3457
3500
|
<div class="post-content">
|
|
3458
3501
|
<p>Quick turnover, anyone? A <a href="https://github.com/jekyll/jekyll/pull/1525">recent incompatibility with Liquid
|
|
3459
3502
|
v2.5.2</a> produced a nasty bug in
|
|
3460
|
-
which <code class="highlighter-rouge">include</code> tags were not rendered properly within <code class="highlighter-rouge">if</code> blocks.</p>
|
|
3503
|
+
which <code class="language-plaintext highlighter-rouge">include</code> tags were not rendered properly within <code class="language-plaintext highlighter-rouge">if</code> blocks.</p>
|
|
3461
3504
|
|
|
3462
3505
|
<p>This release also includes a better handling of detached servers (prints pid and
|
|
3463
|
-
the command for killing the process). <strong>Note</strong>: the <code class="highlighter-rouge">--detach</code> flag and
|
|
3464
|
-
<code class="highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
|
3506
|
+
the command for killing the process). <strong>Note</strong>: the <code class="language-plaintext highlighter-rouge">--detach</code> flag and
|
|
3507
|
+
<code class="language-plaintext highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
|
3465
3508
|
|
|
3466
3509
|
<p>For a full list of the fixes in this release, check out <a href="/docs/history/">the change
|
|
3467
3510
|
log</a>!</p>
|
|
@@ -3499,12 +3542,12 @@ enhancements that we think you’ll love.</p>
|
|
|
3499
3542
|
<p>Here are a few things we think you’ll want to know about this release:</p>
|
|
3500
3543
|
|
|
3501
3544
|
<ul>
|
|
3502
|
-
<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>
|
|
3503
|
-
<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>
|
|
3504
|
-
<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>
|
|
3505
|
-
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</li>
|
|
3545
|
+
<li>Run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut the server down.</li>
|
|
3546
|
+
<li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</li>
|
|
3547
|
+
<li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</li>
|
|
3548
|
+
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</li>
|
|
3506
3549
|
<li>Permalinks with special characters should now generate without errors.</li>
|
|
3507
|
-
<li>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
|
3550
|
+
<li>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
|
3508
3551
|
</ul>
|
|
3509
3552
|
|
|
3510
3553
|
<p>For a full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
|
@@ -3537,9 +3580,9 @@ enhancements that we think you’ll love.</p>
|
|
|
3537
3580
|
<div class="post-content">
|
|
3538
3581
|
<p>Version 1.1.2 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
|
|
3539
3582
|
|
|
3540
|
-
<p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
|
3583
|
+
<p>Community and custom plugins extending the <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
|
3541
3584
|
|
|
3542
|
-
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
|
3585
|
+
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
|
3543
3586
|
|
|
3544
3587
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
|
3545
3588
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
|
@@ -3573,9 +3616,9 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
|
|
|
3573
3616
|
<div class="post-content">
|
|
3574
3617
|
<p>Version 1.0.4 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
|
|
3575
3618
|
|
|
3576
|
-
<p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
|
3619
|
+
<p>Community and custom plugins extending the <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
|
3577
3620
|
|
|
3578
|
-
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
|
3621
|
+
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
|
3579
3622
|
|
|
3580
3623
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
|
3581
3624
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
|
@@ -3651,12 +3694,12 @@ more a more detailed changelog for this release.</p>
|
|
|
3651
3694
|
Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new additions:</p>
|
|
3652
3695
|
|
|
3653
3696
|
<ul>
|
|
3654
|
-
<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>
|
|
3655
|
-
<li>Support passing parameters to templates in <code class="highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
|
|
3697
|
+
<li>Add <code class="language-plaintext highlighter-rouge">docs</code> subcommand to read Jekyll’s docs when offline. (<a href="https://github.com/jekyll/jekyll/issues/1046">#1046</a>)</li>
|
|
3698
|
+
<li>Support passing parameters to templates in <code class="language-plaintext highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
|
|
3656
3699
|
<li>Add support for Liquid tags to post excerpts (<a href="https://github.com/jekyll/jekyll/issues/1302">#1302</a>)</li>
|
|
3657
3700
|
<li>Fix pagination for subdirectories (<a href="https://github.com/jekyll/jekyll/issues/1198">#1198</a>)</li>
|
|
3658
3701
|
<li>Provide better error reporting when generating sites (<a href="https://github.com/jekyll/jekyll/issues/1253">#1253</a>)</li>
|
|
3659
|
-
<li>Latest posts first in non-LSI <code class="highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
|
|
3702
|
+
<li>Latest posts first in non-LSI <code class="language-plaintext highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
|
|
3660
3703
|
</ul>
|
|
3661
3704
|
|
|
3662
3705
|
<p>See the <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.0">GitHub Release</a> page for more a more detailed changelog for this release.</p>
|
|
@@ -3692,10 +3735,10 @@ Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new add
|
|
|
3692
3735
|
|
|
3693
3736
|
<ul>
|
|
3694
3737
|
<li>Fail with non-zero exit code when MaRuKu errors (<a href="https://github.com/jekyll/jekyll/issues/1190">#1190</a>) or Liquid errors (<a href="https://github.com/jekyll/jekyll/issues/1121">#1121</a>)</li>
|
|
3695
|
-
<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>
|
|
3696
|
-
<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>
|
|
3697
|
-
<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>
|
|
3698
|
-
<li>Fix pagination issue regarding <code class="highlighter-rouge">File.basename</code> and <code class="highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
|
|
3738
|
+
<li>Add support for private gists to <code class="language-plaintext highlighter-rouge">gist</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1189">#1189</a>)</li>
|
|
3739
|
+
<li>Add <code class="language-plaintext highlighter-rouge">--force</code> option to <code class="language-plaintext highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/1115">#1115</a>)</li>
|
|
3740
|
+
<li>Fix compatibility with <code class="language-plaintext highlighter-rouge">exclude</code> and <code class="language-plaintext highlighter-rouge">include</code> with pre-1.0 Jekyll (<a href="https://github.com/jekyll/jekyll/issues/1114">#1114</a>)</li>
|
|
3741
|
+
<li>Fix pagination issue regarding <code class="language-plaintext highlighter-rouge">File.basename</code> and <code class="language-plaintext highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
|
|
3699
3742
|
</ul>
|
|
3700
3743
|
|
|
3701
3744
|
<p>See the <a href="/docs/history/#v1-0-3">History</a> page for more information on this release.</p>
|
|
@@ -3732,11 +3775,11 @@ releases, and fix some other annoying bugs:</p>
|
|
|
3732
3775
|
|
|
3733
3776
|
<ul>
|
|
3734
3777
|
<li>Backwards-compatibilize relative permalinks (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
|
3735
|
-
<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>
|
|
3736
|
-
<li>Deprecate old config <code class="highlighter-rouge">server_port</code>, match to <code class="highlighter-rouge">port</code> if <code class="highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
|
|
3778
|
+
<li>Add <code class="language-plaintext highlighter-rouge">jekyll doctor</code> command to check site for any known compatibility problems (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
|
3779
|
+
<li>Deprecate old config <code class="language-plaintext highlighter-rouge">server_port</code>, match to <code class="language-plaintext highlighter-rouge">port</code> if <code class="language-plaintext highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
|
|
3737
3780
|
<li>Update pygments.rb and kramdon versions to 0.5.0 and 1.0.2, respectively (<a href="https://github.com/jekyll/jekyll/issues/1061">#1061</a>, <a href="https://github.com/jekyll/jekyll/issues/1067">#1067</a>)</li>
|
|
3738
3781
|
<li>Fix issue when post categories are numbers (<a href="https://github.com/jekyll/jekyll/issues/1078">#1078</a>)</li>
|
|
3739
|
-
<li>Add a <code class="highlighter-rouge">data-lang="<lang>"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
|
|
3782
|
+
<li>Add a <code class="language-plaintext highlighter-rouge">data-lang="<lang>"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
|
|
3740
3783
|
<li>Catching that Redcarpet gem isn’t installed (<a href="https://github.com/jekyll/jekyll/issues/1059">#1059</a>)</li>
|
|
3741
3784
|
</ul>
|
|
3742
3785
|
|
|
@@ -3772,13 +3815,13 @@ releases, and fix some other annoying bugs:</p>
|
|
|
3772
3815
|
<p>Hot on the trails of v1.0, v1.0.1 is out! Here are the highlights:</p>
|
|
3773
3816
|
|
|
3774
3817
|
<ul>
|
|
3775
|
-
<li>Add newer <code class="highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
|
|
3818
|
+
<li>Add newer <code class="language-plaintext highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
|
|
3776
3819
|
<li>Commander error message now preferred over process abort with incorrect args (<a href="https://github.com/jekyll/jekyll/issues/1040">#1040</a>)</li>
|
|
3777
3820
|
<li>Do not force use of toc_token when using generate_toc in RDiscount (<a href="https://github.com/jekyll/jekyll/issues/1048">#1048</a>)</li>
|
|
3778
3821
|
<li>Make Redcarpet respect the pygments configuration option (<a href="https://github.com/jekyll/jekyll/issues/1053">#1053</a>)</li>
|
|
3779
3822
|
<li>Fix the index build with LSI (<a href="https://github.com/jekyll/jekyll/issues/1045">#1045</a>)</li>
|
|
3780
3823
|
<li>Don’t print deprecation warning when no arguments are specified. (<a href="https://github.com/jekyll/jekyll/issues/1041">#1041</a>)</li>
|
|
3781
|
-
<li>Add missing <code class="highlighter-rouge"></div></code> to site template used by <code class="highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
|
|
3824
|
+
<li>Add missing <code class="language-plaintext highlighter-rouge"></div></code> to site template used by <code class="language-plaintext highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
|
|
3782
3825
|
</ul>
|
|
3783
3826
|
|
|
3784
3827
|
<p>See the <a href="/docs/history/#v1-0-1">History</a> page for more information on this release.</p>
|
|
@@ -3845,6 +3888,10 @@ examples and for compiling this list):</p>
|
|
|
3845
3888
|
<h4>Recent Releases</h4>
|
|
3846
3889
|
<ul>
|
|
3847
3890
|
|
|
3891
|
+
<li class="">
|
|
3892
|
+
<a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
|
|
3893
|
+
</li>
|
|
3894
|
+
|
|
3848
3895
|
<li class="">
|
|
3849
3896
|
<a href="/news/2018/06/05/jekyll-3-8-3-released/">Version 3.8.3</a>
|
|
3850
3897
|
</li>
|
|
@@ -3861,10 +3908,6 @@ examples and for compiling this list):</p>
|
|
|
3861
3908
|
<a href="/news/2018/02/24/jekyll-3-7-3-released/">Version 3.7.3</a>
|
|
3862
3909
|
</li>
|
|
3863
3910
|
|
|
3864
|
-
<li class="">
|
|
3865
|
-
<a href="/news/2018/01/25/jekyll-3-7-2-released/">Version 3.7.2</a>
|
|
3866
|
-
</li>
|
|
3867
|
-
|
|
3868
3911
|
<li>
|
|
3869
3912
|
<a href="/docs/history/">History »</a>
|
|
3870
3913
|
</li>
|
|
@@ -3881,6 +3924,8 @@ examples and for compiling this list):</p>
|
|
|
3881
3924
|
|
|
3882
3925
|
|
|
3883
3926
|
|
|
3927
|
+
|
|
3928
|
+
|
|
3884
3929
|
<li class="">
|
|
3885
3930
|
<a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
|
|
3886
3931
|
</li>
|
|
@@ -4066,7 +4111,7 @@ examples and for compiling this list):</p>
|
|
|
4066
4111
|
<footer>
|
|
4067
4112
|
<div class="grid">
|
|
4068
4113
|
<div class="unit one-third center-on-mobiles">
|
|
4069
|
-
<p>The contents of this website are <br>©
|
|
4114
|
+
<p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
4070
4115
|
</div>
|
|
4071
4116
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
4072
4117
|
<p>
|