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
@@ -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>Releases | 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="Releases" />
|
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/releases/" />
|
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="Releases" />
|
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/releases/","headline":"Releases","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"https://schema.org"}</script>
|
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
|
|
@@ -436,20 +479,20 @@ regressions due to the changes made in that release. In due time, Team Jekyll
|
|
436
479
|
set out to address those issues as early as possible.</p>
|
437
480
|
|
438
481
|
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
439
|
-
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
482
|
+
RubyGems didn’t want to play nice) that fixes numerous issues! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20">
|
440
483
|
The highlights being:</p>
|
441
484
|
|
442
485
|
<ul>
|
443
486
|
<li>
|
444
487
|
<p>A major regression in 3.7.0 was that when a Front Matter Default was
|
445
|
-
configured with a <code class="highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
488
|
+
configured with a <code class="language-plaintext highlighter-rouge">scope["path"]</code> set to a directory, Jekyll would scan
|
446
489
|
that directory for any subfolders and files, for each document in that
|
447
|
-
<code class="highlighter-rouge">path</code>.
|
490
|
+
<code class="language-plaintext highlighter-rouge">path</code>.
|
448
491
|
Though this is intended, it increases build times in proportion to the size
|
449
492
|
of the directory.</p>
|
450
493
|
|
451
494
|
<p>We addressed this by having Jekyll scan the directory path only if the user
|
452
|
-
explicitly configures the <code class="highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
495
|
+
explicitly configures the <code class="language-plaintext highlighter-rouge">scope["path"]</code> using wildcards.</p>
|
453
496
|
|
454
497
|
<p>Read our <a href="/docs/configuration/#glob-patterns-in-front-matter-defaults">documentation</a>
|
455
498
|
for more details.</p>
|
@@ -461,7 +504,7 @@ additionally providing us with a test repository to aid in resolving the issue.<
|
|
461
504
|
<p>Another regression reported was related to our “Custom collections
|
462
505
|
directory” feature introduced in 3.7.0.</p>
|
463
506
|
|
464
|
-
<p>Users setting <code class="highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
507
|
+
<p>Users setting <code class="language-plaintext highlighter-rouge">collection_dir</code> to a certain directory would have <em>altered</em>
|
465
508
|
paths to their posts still at the root of their site’s source. This
|
466
509
|
roughly translated to 404 errors on URLs to their posts.</p>
|
467
510
|
|
@@ -469,19 +512,19 @@ roughly translated to 404 errors on URLs to their posts.</p>
|
|
469
512
|
|
470
513
|
<p>We decided to resolve this by having Jekyll ignore posts and drafts at the
|
471
514
|
root of the site’s source directory if the user customizes the
|
472
|
-
<code class="highlighter-rouge">collection_dir</code> setting.</p>
|
515
|
+
<code class="language-plaintext highlighter-rouge">collection_dir</code> setting.</p>
|
473
516
|
|
474
517
|
<p>Ergo, if you set a custom location for your collections, please ensure you
|
475
518
|
move all of your collections into that directory. <strong>This includes posts and
|
476
519
|
drafts as well</strong>. Your links generated by
|
477
|
-
<code class="highlighter-rouge">{% post_url %}</code> or <code class="highlighter-rouge">{% link %}</code>
|
520
|
+
<code class="language-plaintext highlighter-rouge">{% post_url %}</code> or <code class="language-plaintext highlighter-rouge">{% link %}</code>
|
478
521
|
will adapt automatically.</p>
|
479
522
|
</li>
|
480
523
|
<li>
|
481
|
-
<p>We also found out that <code class="highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
524
|
+
<p>We also found out that <code class="language-plaintext highlighter-rouge">gem "wdm"</code> boosts performance while directories are
|
482
525
|
being watched on Windows. So we recommend having it included in your Gemfile
|
483
526
|
for a better development experience on Windows. (Newly generated Gemfiles
|
484
|
-
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://
|
527
|
+
will hereafter have that gem listed automatically <img class="emoji" title=":wink:" alt=":wink:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f609.png" height="20" width="20">)</p>
|
485
528
|
</li>
|
486
529
|
</ul>
|
487
530
|
|
@@ -495,7 +538,7 @@ Paul Robert Lloyd.</p>
|
|
495
538
|
|
496
539
|
<p>As always, you can see our full changelog on <a href="/docs/history/">the History page</a>.</p>
|
497
540
|
|
498
|
-
<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
541
|
+
<p>Happy Jekylling! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
499
542
|
|
500
543
|
</div>
|
501
544
|
</article>
|
@@ -527,11 +570,11 @@ Paul Robert Lloyd.</p>
|
|
527
570
|
Here are a few of the latest additions from our contributors:</p>
|
528
571
|
|
529
572
|
<ul>
|
530
|
-
<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>
|
531
|
-
<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://
|
532
|
-
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
|
573
|
+
<li>LiveReload is available as an option during development: with <code class="language-plaintext highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
|
574
|
+
<li>New <code class="language-plaintext highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
|
575
|
+
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="language-plaintext highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
|
533
576
|
<li>Jekyll will now check to determine whether host machine has internet connection.</li>
|
534
|
-
<li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
577
|
+
<li>A new <code class="language-plaintext highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
535
578
|
<li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
|
536
579
|
<li>
|
537
580
|
<a href="/docs/history/#v3-7-0">Full history is here</a>.</li>
|
@@ -546,7 +589,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
546
589
|
<p>Oh, one last thing…</p>
|
547
590
|
|
548
591
|
<h3 id="pray-upgrade-your-ruby">
|
549
|
-
<img class="emoji" title=":pray:" alt=":pray:" src="https://
|
592
|
+
<img class="emoji" title=":pray:" alt=":pray:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
|
550
593
|
|
551
594
|
<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
|
552
595
|
|
@@ -584,7 +627,7 @@ Here are a few of the latest additions from our contributors:</p>
|
|
584
627
|
</a>
|
585
628
|
</div>
|
586
629
|
<div class="post-content">
|
587
|
-
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="highlighter-rouge">bundle update</code>
|
630
|
+
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="language-plaintext highlighter-rouge">bundle update</code>
|
588
631
|
if you want to avoid possible build problems with:</p>
|
589
632
|
|
590
633
|
<ul>
|
@@ -604,7 +647,7 @@ working on the next minor version 3.7.0 that will allow you to store all your
|
|
604
647
|
collections in a single directory. Stay tuned.</p>
|
605
648
|
|
606
649
|
<p>Theme developers are invited to test the brand new
|
607
|
-
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
650
|
+
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="language-plaintext highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
608
651
|
and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
|
609
652
|
GitHub hosted theme as a remote theme!</p>
|
610
653
|
|
@@ -648,7 +691,7 @@ today.</p>
|
|
648
691
|
<div class="post-content">
|
649
692
|
<p>Another much-anticipated release of Jekyll. This release comes with it Rouge 2 support, but note you can continue to use Rouge 1 if you’d prefer. We also now require Ruby 2.1.0 as 2.0.x is no longer supported by the Ruby team.</p>
|
650
693
|
|
651
|
-
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
|
694
|
+
<p>Otherwise, it’s a massive bug-fix release! A few bugs were found and squashed with our <code class="language-plaintext highlighter-rouge">Drop</code> implementation. We’re using the Schwartzian transform to speed up our custom sorting (thanks, Perl community!). We now protect against images that are named like posts and we generally worked on guarding our code to enforce requirements, instead of assuming the input was as expected.</p>
|
652
695
|
|
653
696
|
<p>Please let us know if you find any bugs! You can see <a href="/docs/history/#v3-6-0">the full history here</a>.</p>
|
654
697
|
|
@@ -685,12 +728,12 @@ today.</p>
|
|
685
728
|
<p>3.5.2 is out with 6 great bug fixes, most notably one which should dramatically speed up generation of your site! In testing #6266, jekyllrb.com generation when from 18 seconds down to 8! Here is the full line-up of fixes:</p>
|
686
729
|
|
687
730
|
<ul>
|
688
|
-
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (#6301)</li>
|
731
|
+
<li>Backport #6266 for v3.5.x: Memoize the return value of <code class="language-plaintext highlighter-rouge">Document#url</code> (#6301)</li>
|
689
732
|
<li>Backport #6247 for v3.5.x: kramdown: symbolize keys in-place (#6303)</li>
|
690
|
-
<li>Backport #6281 for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
691
|
-
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (#6287)</li>
|
692
|
-
<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>
|
693
|
-
<li>Backport #6226 for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
|
733
|
+
<li>Backport #6281 for v3.5.x: Fix <code class="language-plaintext highlighter-rouge">Drop#key?</code> so it can handle a nil argument (#6288)</li>
|
734
|
+
<li>Backport #6280 for v3.5.x: Guard against type error in <code class="language-plaintext highlighter-rouge">absolute_url</code> (#6287)</li>
|
735
|
+
<li>Backport #6273 for v3.5.x: delegate <code class="language-plaintext highlighter-rouge">StaticFile#to_json</code> to <code class="language-plaintext highlighter-rouge">StaticFile#to_liquid</code> (#6302)</li>
|
736
|
+
<li>Backport #6226 for v3.5.x: <code class="language-plaintext highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (#6304</li>
|
694
737
|
</ul>
|
695
738
|
|
696
739
|
<p>A <a href="/docs/history/#v3-5-2">full history</a> is available for your perusal. As always, please file bugs if you encounter them! Opening a pull request with a failing test for your expected behaviour is the easiest way for us to address the issue since we have a reproducible example to test again. Short of that, please fill out our issue template to the best of your ability and we’ll try to get to it quickly!</p>
|
@@ -729,8 +772,8 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
729
772
|
<p>We’ve released a few bugfixes in the form of v3.5.1 today:</p>
|
730
773
|
|
731
774
|
<ul>
|
732
|
-
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
733
|
-
<li>A bug in <code class="highlighter-rouge">relative_url</code> when <code class="highlighter-rouge">baseurl</code> is <code class="highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
|
775
|
+
<li>Some plugins stopped functioning properly due to a NoMethodError for <code class="language-plaintext highlighter-rouge">registers</code> on NilClass. That’s been fixed.</li>
|
776
|
+
<li>A bug in <code class="language-plaintext highlighter-rouge">relative_url</code> when <code class="language-plaintext highlighter-rouge">baseurl</code> is <code class="language-plaintext highlighter-rouge">nil</code> caused URL’s to come out wrong. Squashed.</li>
|
734
777
|
<li>Static files’ liquid representations should now have all the keys you were expecting when serialized into JSON.</li>
|
735
778
|
</ul>
|
736
779
|
|
@@ -770,18 +813,18 @@ possible: Ben Balter & Kyle Zhao.</p>
|
|
770
813
|
the wild. Some new shiny things you might want to test out:</p>
|
771
814
|
|
772
815
|
<ul>
|
773
|
-
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="highlighter-rouge">concat</code> and <code class="highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
|
816
|
+
<li>Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters <code class="language-plaintext highlighter-rouge">concat</code> and <code class="language-plaintext highlighter-rouge">compact</code>, loop performance improvements and <a href="https://github.com/Shopify/liquid/blob/master/History.md#400--2016-12-14--branch-4-0-stable">many fixes</a>
|
774
817
|
</li>
|
775
818
|
<li>Themes can specify runtime dependencies (in their gemspecs) and we’ll require those. This makes it easier for theme writers to use plugins.</li>
|
776
819
|
<li>Speaking of themes, we’ll properly handle the discrepancy between a convertible file in the local site and a static file in the theme. Overriding a file locally now doesn’t matter if it’s convertible or static.</li>
|
777
|
-
<li>Pages, posts, and other documents can now access layout variables via <code class="highlighter-rouge">{{ layout }}</code>.</li>
|
778
|
-
<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>
|
779
|
-
<li>Filters like <code class="highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
|
820
|
+
<li>Pages, posts, and other documents can now access layout variables via <code class="language-plaintext highlighter-rouge">{{ layout }}</code>.</li>
|
821
|
+
<li>The <code class="language-plaintext highlighter-rouge">gems</code> key in the <code class="language-plaintext highlighter-rouge">_config.yml</code> is now <code class="language-plaintext highlighter-rouge">plugins</code>. This is backwards-compatible, as Jekyll will gracefully upgrade <code class="language-plaintext highlighter-rouge">gems</code> to <code class="language-plaintext highlighter-rouge">plugins</code> if you use the former.</li>
|
822
|
+
<li>Filters like <code class="language-plaintext highlighter-rouge">sort</code> now allow you to sort based on a subvalue, e.g. <code class="language-plaintext highlighter-rouge">{% assign sorted = site.posts | sort: "image.alt_text" %}</code>.</li>
|
780
823
|
<li>You can now create tab-separated data files.</li>
|
781
|
-
<li>Using <code class="highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="highlighter-rouge">layout: null</code>, with the exception that <code class="highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
|
824
|
+
<li>Using <code class="language-plaintext highlighter-rouge">layout: none</code> will now produce a file with no layout. Equivalent to <code class="language-plaintext highlighter-rouge">layout: null</code>, with the exception that <code class="language-plaintext highlighter-rouge">none</code> is a truthy value and won’t be overwritten by front matter defaults.</li>
|
782
825
|
<li>No more pesky errors if your URL contains a colon (sorry about those!)</li>
|
783
|
-
<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>
|
784
|
-
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
|
826
|
+
<li>We now automatically exclude the <code class="language-plaintext highlighter-rouge">Gemfile</code> from the site manifest when compiling your site. No more <code class="language-plaintext highlighter-rouge">_site/Gemfile</code>!</li>
|
827
|
+
<li>We fixed a bug where abbreviated post dates were ignored, e.g. <code class="language-plaintext highlighter-rouge">_posts/2016-4-4-april-fourth.md</code>.</li>
|
785
828
|
</ul>
|
786
829
|
|
787
830
|
<p>And <a href="/docs/history/">so much more!</a></p>
|
@@ -796,9 +839,9 @@ Thank you, all!</p>
|
|
796
839
|
|
797
840
|
<p>Please file any bugs with detailed replication instructions if you find any
|
798
841
|
bugs. Better yet, submit a patch if you find the bug in the code and know
|
799
|
-
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://
|
842
|
+
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://github.githubassets.com/images/icons/emoji/unicode/2764.png" height="20" width="20"></p>
|
800
843
|
|
801
|
-
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://
|
844
|
+
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
|
802
845
|
|
803
846
|
</div>
|
804
847
|
</article>
|
@@ -828,26 +871,26 @@ how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://ass
|
|
828
871
|
<div class="post-content">
|
829
872
|
<p>Another one-PR patch update as we continue our quest to destroy all bugs. A
|
830
873
|
fairly technical debriefing follows, but the TLDR is that we have updated the
|
831
|
-
<code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
874
|
+
<code class="language-plaintext highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
832
875
|
|
833
876
|
<p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
|
834
877
|
moved away from using the deprecated
|
835
|
-
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="highlighter-rouge">URI.escape</code></a>
|
878
|
+
<a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="language-plaintext highlighter-rouge">URI.escape</code></a>
|
836
879
|
in favor of
|
837
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
|
838
|
-
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
|
880
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code></a>.
|
881
|
+
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="language-plaintext highlighter-rouge">uri_escape</code>
|
839
882
|
filter</a>.</p>
|
840
883
|
|
841
884
|
<p>While this transition was mostly a smooth one, the two methods are not
|
842
|
-
identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
|
843
|
-
<code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
|
885
|
+
identical. While <code class="language-plaintext highlighter-rouge">URI.escape</code> was happy to escape any string,
|
886
|
+
<code class="language-plaintext highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code>
|
844
887
|
object, and will then escape each component of that object. In most cases, this
|
845
888
|
difference was insignificant, but there were a few cases where this caused some
|
846
889
|
unintended regressions when encoding colons.</p>
|
847
890
|
|
848
|
-
<p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
|
891
|
+
<p>While <strong>Addressable</strong> can understand that something like <code class="language-plaintext highlighter-rouge">"/example :page"</code> is a
|
849
892
|
relative URI, without the slash it cannot figure out how to turn
|
850
|
-
<code class="highlighter-rouge">"example :page"</code> into an <code class="highlighter-rouge">Addressable::URI</code> object. <code class="highlighter-rouge">URI.escape</code> had no such
|
893
|
+
<code class="language-plaintext highlighter-rouge">"example :page"</code> into an <code class="language-plaintext highlighter-rouge">Addressable::URI</code> object. <code class="language-plaintext highlighter-rouge">URI.escape</code> had no such
|
851
894
|
objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
|
852
895
|
but breaking in 3.4.0:</p>
|
853
896
|
|
@@ -857,8 +900,8 @@ but breaking in 3.4.0:</p>
|
|
857
900
|
<p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
|
858
901
|
|
859
902
|
<p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
|
860
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
861
|
-
which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
|
903
|
+
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="language-plaintext highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
904
|
+
which will simply escape the characters in a string, much like <code class="language-plaintext highlighter-rouge">URI.escape</code>.</p>
|
862
905
|
|
863
906
|
<p>Thanks to <a href="https://github.com/cameronmcefee" class="user-mention">@cameronmcefee</a> and <a href="https://github.com/FriesFlorian" class="user-mention">@FriesFlorian</a> for reporting
|
864
907
|
<a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
|
@@ -902,15 +945,15 @@ static files explicitly because they <em>don’t</em> have YAML front matter, wa
|
|
902
945
|
to respect YAML front matter?” That’s a great question. Let me illustrate
|
903
946
|
with an example.</p>
|
904
947
|
|
905
|
-
<p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
948
|
+
<p>Let’s look at <code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
906
949
|
pages, and static files, and some metadata for them in an XML file for a
|
907
950
|
Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
|
908
|
-
file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
951
|
+
file in this list, you set <code class="language-plaintext highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
909
952
|
what about static files, which don’t have YAML front matter? Before this
|
910
953
|
release, they could not be excluded because they had no properties in YAML
|
911
954
|
other than <a href="https://github.com/jekyll/jekyll/blob/v3.4.1/lib/jekyll/static_file.rb#L98-L106">the ones we explicitly assigned</a>.
|
912
955
|
So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
|
913
|
-
<code class="highlighter-rouge">jekyll-sitemap</code>.</p>
|
956
|
+
<code class="language-plaintext highlighter-rouge">jekyll-sitemap</code>.</p>
|
914
957
|
|
915
958
|
<p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
|
916
959
|
defaults</a> for static files:</p>
|
@@ -923,8 +966,8 @@ defaults</a> for static files:</p>
|
|
923
966
|
<span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
|
924
967
|
</code></pre></div></div>
|
925
968
|
|
926
|
-
<p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
|
927
|
-
folder <code class="highlighter-rouge">pdfs/</code>, you’ll see <code class="highlighter-rouge">sitemap</code> equal to <code class="highlighter-rouge">false</code>.</p>
|
969
|
+
<p>Now, for every file in the Liquid <code class="language-plaintext highlighter-rouge">site.static_files</code> loop which is in the
|
970
|
+
folder <code class="language-plaintext highlighter-rouge">pdfs/</code>, you’ll see <code class="language-plaintext highlighter-rouge">sitemap</code> equal to <code class="language-plaintext highlighter-rouge">false</code>.</p>
|
928
971
|
|
929
972
|
<p>Many thanks to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a> for coming up with the solution and ensuring
|
930
973
|
sitemaps everywhere are filled with just the right content.</p>
|
@@ -1011,7 +1054,7 @@ well.</p>
|
|
1011
1054
|
|
1012
1055
|
<p>Well, not so much.</p>
|
1013
1056
|
|
1014
|
-
<p>A very common way to specify the month of February is <code class="highlighter-rouge">2</code>. This is true for
|
1057
|
+
<p>A very common way to specify the month of February is <code class="language-plaintext highlighter-rouge">2</code>. This is true for
|
1015
1058
|
all single-digit months and days of the month. Notice anything about our
|
1016
1059
|
first regular expression versus our second? The second regular expression
|
1017
1060
|
imposes a <strong>minimum</strong>, as well as maximum, number of digits. This change
|
@@ -1085,8 +1128,8 @@ Packed full of bug fixes as usual, thanks to the tireless efforts of our
|
|
1085
1128
|
exceptional Jekyll community. Three changes to call out:</p>
|
1086
1129
|
|
1087
1130
|
<ol>
|
1088
|
-
<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
|
1089
|
-
even bigger fan of <a href="/docs/templates/#filters"><code class="highlighter-rouge">group_by_exp</code></a>.</li>
|
1131
|
+
<li>If you’re a big fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">where_by_exp</code></a>, you’ll be an
|
1132
|
+
even bigger fan of <a href="/docs/templates/#filters"><code class="language-plaintext highlighter-rouge">group_by_exp</code></a>.</li>
|
1090
1133
|
<li>Using a custom timezone in Jekyll on Windows? Yeah, sorry that hasn’t ever worked
|
1091
1134
|
properly. We made it possible to accurately <a href="https://jekyllrb.com/docs/windows/#timezone-management">set the timezone using IANA
|
1092
1135
|
timezone codes</a>.</li>
|
@@ -1148,7 +1191,7 @@ fixes to call out:</p>
|
|
1148
1191
|
|
1149
1192
|
<ol>
|
1150
1193
|
<li>Only warn about auto-regeneration issues on Windows instead of disabling</li>
|
1151
|
-
<li>Exclude very specific <code class="highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="highlighter-rouge">vendor/</code>
|
1194
|
+
<li>Exclude very specific <code class="language-plaintext highlighter-rouge">vendor/</code> subdirectories instead of all of <code class="language-plaintext highlighter-rouge">vendor/</code>
|
1152
1195
|
</li>
|
1153
1196
|
<li>Allow permalink templates to have plaintext underscores</li>
|
1154
1197
|
</ol>
|
@@ -1186,14 +1229,14 @@ fixes to call out:</p>
|
|
1186
1229
|
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
1187
1230
|
Three key things you might want to try:</p>
|
1188
1231
|
|
1189
|
-
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
|
1232
|
+
<h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="language-plaintext highlighter-rouge">/assets</code> directory</h3>
|
1190
1233
|
|
1191
1234
|
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
1192
1235
|
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
1193
1236
|
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
1194
1237
|
|
1195
1238
|
<p>In an effort to make theme management a bit easier, any files you put into
|
1196
|
-
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
1239
|
+
<code class="language-plaintext highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
1197
1240
|
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
1198
1241
|
webfonts, and so on – anything you’d consider a part of the
|
1199
1242
|
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
@@ -1201,51 +1244,51 @@ front matter, it will be converted and rendered. No YAML front matter, and
|
|
1201
1244
|
it will simply be copied over like a static asset.</p>
|
1202
1245
|
|
1203
1246
|
<p>Note that if a user has a file of the same path, the theme content will not
|
1204
|
-
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
1205
|
-
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
1247
|
+
be included in the site, i.e. a user’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code> will be read and
|
1248
|
+
processed if present instead of a theme’s <code class="language-plaintext highlighter-rouge">/assets/main.scss</code>.</p>
|
1206
1249
|
|
1207
1250
|
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
1208
1251
|
for more info.</p>
|
1209
1252
|
|
1210
|
-
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
|
1253
|
+
<h3 id="2-relative_url-and-absolute_url-filters">2. <code class="language-plaintext highlighter-rouge">relative_url</code> and <code class="language-plaintext highlighter-rouge">absolute_url</code> filters</h3>
|
1211
1254
|
|
1212
|
-
<p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
|
1255
|
+
<p>Want a clean way to prepend the <code class="language-plaintext highlighter-rouge">baseurl</code> or <code class="language-plaintext highlighter-rouge">url</code> in your config? These
|
1213
1256
|
new filters have you covered. When working locally, if you set your
|
1214
|
-
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
1215
|
-
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
1257
|
+
<code class="language-plaintext highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="language-plaintext highlighter-rouge">baseurl: "/myproject"</code>,
|
1258
|
+
then <code class="language-plaintext highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
1216
1259
|
you pass it:</p>
|
1217
1260
|
|
1218
1261
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /myproject/docs/assets</code></pre></figure>
|
1219
1262
|
|
1220
|
-
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
1221
|
-
<code class="highlighter-rouge">"/"</code>):</p>
|
1263
|
+
<p>By default, <code class="language-plaintext highlighter-rouge">baseurl</code> is set to <code class="language-plaintext highlighter-rouge">""</code> and therefore yields (never set to
|
1264
|
+
<code class="language-plaintext highlighter-rouge">"/"</code>):</p>
|
1222
1265
|
|
1223
1266
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /docs/assets</code></pre></figure>
|
1224
1267
|
|
1225
|
-
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
1226
|
-
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
1227
|
-
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
|
1268
|
+
<p>A result of <code class="language-plaintext highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
1269
|
+
relative to the domain root. A similar principle applies to <code class="language-plaintext highlighter-rouge">absolute_url</code>.
|
1270
|
+
It prepends your <code class="language-plaintext highlighter-rouge">baseurl</code> and <code class="language-plaintext highlighter-rouge">url</code> values, making absolute URLs all the
|
1228
1271
|
easier to make:</p>
|
1229
1272
|
|
1230
1273
|
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> => https://jekyllrb.com/myproject/docs/assets</code></pre></figure>
|
1231
1274
|
|
1232
|
-
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
|
1275
|
+
<h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="language-plaintext highlighter-rouge">site.url</code> is set by the development server</h3>
|
1233
1276
|
|
1234
|
-
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
1235
|
-
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
1236
|
-
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
1237
|
-
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
1238
|
-
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
1277
|
+
<p>When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
1278
|
+
<code class="language-plaintext highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
1279
|
+
development. If you are using the new <code class="language-plaintext highlighter-rouge">absolute_url</code> filter, or using
|
1280
|
+
<code class="language-plaintext highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
1281
|
+
which resets the <code class="language-plaintext highlighter-rouge">url</code> value to point to <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
1239
1282
|
|
1240
|
-
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
1241
|
-
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
1242
|
-
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
1243
|
-
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
1283
|
+
<p>No longer! When you run <code class="language-plaintext highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
1284
|
+
the value of the <code class="language-plaintext highlighter-rouge">host</code>, <code class="language-plaintext highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
1285
|
+
<code class="language-plaintext highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="language-plaintext highlighter-rouge">site.url</code>
|
1286
|
+
will yield <code class="language-plaintext highlighter-rouge">http://localhost:4000</code>.</p>
|
1244
1287
|
|
1245
1288
|
<p>This happens by default when running Jekyll locally. It will not be set if
|
1246
|
-
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
|
1247
|
-
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
1248
|
-
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
1289
|
+
you set <code class="language-plaintext highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="language-plaintext highlighter-rouge">jekyll serve</code>. If <code class="language-plaintext highlighter-rouge">JEKYLL_ENV</code> is
|
1290
|
+
any value except <code class="language-plaintext highlighter-rouge">development</code> (its default value), Jekyll will not
|
1291
|
+
overwrite the value of <code class="language-plaintext highlighter-rouge">url</code> in your config. And again, this only applies
|
1249
1292
|
to serving, not to building.</p>
|
1250
1293
|
|
1251
1294
|
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
@@ -1301,7 +1344,7 @@ bug report.</p>
|
|
1301
1344
|
<div class="post-content">
|
1302
1345
|
<p>Well, 3.2.0 has been a success, but with one fatal flaw: it doesn’t work on
|
1303
1346
|
Windows! Sorry, Windows users. Hot on the trail of 3.2.0, this release
|
1304
|
-
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
1347
|
+
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20">. Sorry about that!</p>
|
1305
1348
|
|
1306
1349
|
<p>This release also fixes an issue when using <a href="/docs/themes/">gem-based themes</a>
|
1307
1350
|
where the theme was rejected if it existed behind a symlink. This is a
|
@@ -1348,7 +1391,7 @@ say? Yes, proper, versionable, releasable, first-class themes. We’re pretty
|
|
1348
1391
|
stoked about it and we hope you like building and using them. For now, it
|
1349
1392
|
only supports layouts, includes, and sass, but we have plans to include
|
1350
1393
|
static assets like images and CSS/JS in a future release. <a href="/docs/themes/">Read more about
|
1351
|
-
it in the docs.</a> Our site template generated by <code class="highlighter-rouge">jekyll new</code>
|
1394
|
+
it in the docs.</a> Our site template generated by <code class="language-plaintext highlighter-rouge">jekyll new</code>
|
1352
1395
|
now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">minima</a> theme.</p>
|
1353
1396
|
|
1354
1397
|
<p>Some other notable changes:</p>
|
@@ -1356,9 +1399,9 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
1356
1399
|
<ul>
|
1357
1400
|
<li>Symlinks are allowed as long as they target a file in the site source</li>
|
1358
1401
|
<li>Explicit support for Ruby 2.0.x was dropped</li>
|
1359
|
-
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
1360
|
-
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
1361
|
-
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
1402
|
+
<li>Added an <code class="language-plaintext highlighter-rouge">:after_init</code> Hook</li>
|
1403
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
1404
|
+
<li>Added a <code class="language-plaintext highlighter-rouge">link</code> liquid tag which can be used to generate URLs for any
|
1362
1405
|
post or document based on its path relative to the site source</li>
|
1363
1406
|
<li>… and lots more!</li>
|
1364
1407
|
</ul>
|
@@ -1489,7 +1532,7 @@ release. Thank you!</p>
|
|
1489
1532
|
</div>
|
1490
1533
|
<div class="post-content">
|
1491
1534
|
<p>Upon releasing 3.1.5 and kicking the tires, we noticed a glaring bug: our
|
1492
|
-
beloved <code class="highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
1535
|
+
beloved <code class="language-plaintext highlighter-rouge">jsonify</code> filter doesn’t work! With that, our work was cut out for
|
1493
1536
|
us and we decided a 3.1.6 was necessary. This release restores sanity to
|
1494
1537
|
our object-to-JSON generation in Liquid and we hope you enjoy.</p>
|
1495
1538
|
|
@@ -1528,7 +1571,7 @@ changelog</a>.</p>
|
|
1528
1571
|
<p>There’s always at least one bug, right? :)</p>
|
1529
1572
|
|
1530
1573
|
<p>Hot on the trails of <a href="/news/2016/05/18/jekyll-3-1-4-released/">v3.1.4</a>, we
|
1531
|
-
bring you v3.1.5! It fixes one bug around requiring the <code class="highlighter-rouge">ExcerptDrop</code>,
|
1574
|
+
bring you v3.1.5! It fixes one bug around requiring the <code class="language-plaintext highlighter-rouge">ExcerptDrop</code>,
|
1532
1575
|
which only affects Linux. For the gory details, see <a href="https://github.com/jekyll/jekyll/pull/4912">the pull
|
1533
1576
|
request for the fix</a>.</p>
|
1534
1577
|
|
@@ -1565,15 +1608,15 @@ request for the fix</a>.</p>
|
|
1565
1608
|
<p>Today, we released v3.1.4 in an effort to bring more stability to the v3.1.x series. This bugfix release consists of:</p>
|
1566
1609
|
|
1567
1610
|
<ul>
|
1568
|
-
<li>A fix for <code class="highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
1569
|
-
<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>
|
1570
|
-
<li>A fix where <code class="highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
1571
|
-
<li>We added <code class="highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
|
1611
|
+
<li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where values would carry over from one document to the next</li>
|
1612
|
+
<li>A fix for <code class="language-plaintext highlighter-rouge">layout</code> in Liquid where a parent layout (e.g. <code class="language-plaintext highlighter-rouge">default</code> or <code class="language-plaintext highlighter-rouge">base</code>) would overwrite the metadata of the child layout (e.g. <code class="language-plaintext highlighter-rouge">post</code> or <code class="language-plaintext highlighter-rouge">special</code>).</li>
|
1613
|
+
<li>A fix where <code class="language-plaintext highlighter-rouge">page.excerpt</code> referencing its excerpt would cause an infinite loop of recursive horror.</li>
|
1614
|
+
<li>We added <code class="language-plaintext highlighter-rouge">Configuration.from</code> and the great permalink fix from <a href="/news/2016/04/19/jekyll-3-0-4-released/">v3.0.4</a> to the v3.1.x series</li>
|
1572
1615
|
<li>
|
1573
|
-
<code class="highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="highlighter-rouge">docs</code> shows up before <code class="highlighter-rouge">posts</code> reliably.</li>
|
1616
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> in Liquid is now sorted alphabetically by label, so <code class="language-plaintext highlighter-rouge">docs</code> shows up before <code class="language-plaintext highlighter-rouge">posts</code> reliably.</li>
|
1574
1617
|
</ul>
|
1575
1618
|
|
1576
|
-
<p>The fixes for <code class="highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
|
1619
|
+
<p>The fixes for <code class="language-plaintext highlighter-rouge">layout</code> may not be seamless for everyone, but we believe they will be the “right thing to do” going forward.</p>
|
1577
1620
|
|
1578
1621
|
<p>We are alwawys striving to make Jekyll more straight-forward to use. Please do open an issue if you believe an aspect of Jekyll’s user experience isn’t up to par.</p>
|
1579
1622
|
|
@@ -1654,7 +1697,7 @@ we think you’ll love.</p>
|
|
1654
1697
|
|
1655
1698
|
<ul>
|
1656
1699
|
<li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
|
1657
|
-
<li>Running <code class="highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
1700
|
+
<li>Running <code class="language-plaintext highlighter-rouge">jekyll serve</code> with SSL enabled was broken due to a bad configuration.</li>
|
1658
1701
|
</ul>
|
1659
1702
|
|
1660
1703
|
<p>Both of these issues have been resolved. For more information, check out <a href="/docs/history/#v3-1-3">the full history</a>.</p>
|
@@ -1691,7 +1734,7 @@ we think you’ll love.</p>
|
|
1691
1734
|
|
1692
1735
|
<ul>
|
1693
1736
|
<li>Front matter defaults may not have worked for collection documents and posts due to a problem where they were looked up by their URL rather than their path relative to the site source</li>
|
1694
|
-
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
|
1737
|
+
<li>Configuration for the posts permalink might be borked when a user specified a value for <code class="language-plaintext highlighter-rouge">collections.posts.permalink</code> directly. This forced the use of <code class="language-plaintext highlighter-rouge">permalink</code> at the top level, which also affected pages. To configure a permalink <em>just for posts</em>, you can do so with:</li>
|
1695
1738
|
</ul>
|
1696
1739
|
|
1697
1740
|
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">collections</span><span class="pi">:</span>
|
@@ -1735,8 +1778,8 @@ we think you’ll love.</p>
|
|
1735
1778
|
<li>If a syntax error is encountered by Liquid, it will now print the line number.</li>
|
1736
1779
|
<li>A nasty war between symbols and strings in our configuration hash caused kramdown syntax highlighting to break. That has been resolved; you stand victorious!</li>
|
1737
1780
|
<li>A tilde at the beginning of a filename will no longer crash Jekyll.</li>
|
1738
|
-
<li>The <code class="highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
1739
|
-
<li>Permalinks which end in a slash will now always output as a folder with an <code class="highlighter-rouge">index.html</code> inside.</li>
|
1781
|
+
<li>The <code class="language-plaintext highlighter-rouge">titleize</code> filter mistakenly dropped words that were already capitalized. Fixed!</li>
|
1782
|
+
<li>Permalinks which end in a slash will now always output as a folder with an <code class="language-plaintext highlighter-rouge">index.html</code> inside.</li>
|
1740
1783
|
</ul>
|
1741
1784
|
|
1742
1785
|
<p>Nitty-gritty details, like always, are available in the <a href="/docs/history/">history</a>.</p>
|
@@ -1776,7 +1819,7 @@ fixes:</p>
|
|
1776
1819
|
|
1777
1820
|
<ul>
|
1778
1821
|
<li>Fix problem where outputting to a folder would have two extensions</li>
|
1779
|
-
<li>Handle tildes (<code class="highlighter-rouge">~</code>) in filenames properly</li>
|
1822
|
+
<li>Handle tildes (<code class="language-plaintext highlighter-rouge">~</code>) in filenames properly</li>
|
1780
1823
|
<li>Fix issue when comparing documents without dates</li>
|
1781
1824
|
<li>Include line numbers in liquid error output</li>
|
1782
1825
|
</ul>
|
@@ -1818,15 +1861,15 @@ you’re having.</p>
|
|
1818
1861
|
</a>
|
1819
1862
|
</div>
|
1820
1863
|
<div class="post-content">
|
1821
|
-
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://
|
1864
|
+
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> noticed by a few
|
1822
1865
|
wonderful Jekyll users:</p>
|
1823
1866
|
|
1824
1867
|
<ul>
|
1825
|
-
<li>If your <code class="highlighter-rouge">permalink</code> ended with a <code class="highlighter-rouge">/</code>, your URL didn’t have any extension,
|
1868
|
+
<li>If your <code class="language-plaintext highlighter-rouge">permalink</code> ended with a <code class="language-plaintext highlighter-rouge">/</code>, your URL didn’t have any extension,
|
1826
1869
|
even if you wanted one</li>
|
1827
|
-
<li>We now strip the BOM by default per Ruby’s <code class="highlighter-rouge">IO.open</code>.</li>
|
1870
|
+
<li>We now strip the BOM by default per Ruby’s <code class="language-plaintext highlighter-rouge">IO.open</code>.</li>
|
1828
1871
|
<li>
|
1829
|
-
<code class="highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
1872
|
+
<code class="language-plaintext highlighter-rouge">page.dir</code> will not always end in a slash.</li>
|
1830
1873
|
</ul>
|
1831
1874
|
|
1832
1875
|
<p>We also updated our <a href="/docs/conduct/">Code of Conduct</a> to the latest version of
|
@@ -1842,7 +1885,7 @@ that</a>.</p>
|
|
1842
1885
|
<p>See links to the PR’s on <a href="/docs/history/#v3-1-1">the history page</a>.</p>
|
1843
1886
|
|
1844
1887
|
<p>Thanks to Jordon Bedwell, chrisfinazzo, Kroum Tzanev, David Celis, and
|
1845
|
-
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://
|
1888
|
+
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://github.githubassets.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
1846
1889
|
|
1847
1890
|
<p>Happy Jekylling!</p>
|
1848
1891
|
|
@@ -1884,13 +1927,13 @@ considerably!</p>
|
|
1884
1927
|
<p>Some other highlights:</p>
|
1885
1928
|
|
1886
1929
|
<ul>
|
1887
|
-
<li>Fix: <code class="highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
1888
|
-
<li>Fix: <code class="highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="highlighter-rouge">--source</code>.</li>
|
1889
|
-
<li>Enhancement: <code class="highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
1890
|
-
<li>Feature: adds new <code class="highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
1930
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">permalink</code>s with non-HTML extensions will not be honored</li>
|
1931
|
+
<li>Fix: <code class="language-plaintext highlighter-rouge">jekyll clean</code> now accepts build flags like <code class="language-plaintext highlighter-rouge">--source</code>.</li>
|
1932
|
+
<li>Enhancement: <code class="language-plaintext highlighter-rouge">include</code> tags can now accept multiple liquid variables</li>
|
1933
|
+
<li>Feature: adds new <code class="language-plaintext highlighter-rouge">sample</code> liquid tag which gets random element from an array</li>
|
1891
1934
|
<li>Fix: Jekyll will read in files with YAML front matter that has extraneous
|
1892
1935
|
spaces after the first line</li>
|
1893
|
-
<li>Enhancement: extract the <code class="highlighter-rouge">title</code> attribute from the filename for
|
1936
|
+
<li>Enhancement: extract the <code class="language-plaintext highlighter-rouge">title</code> attribute from the filename for
|
1894
1937
|
collection items without a date</li>
|
1895
1938
|
<li>Fix: gracefully handle empty configuration files</li>
|
1896
1939
|
</ul>
|
@@ -1945,8 +1988,8 @@ midnightSuyama, musoke, and rebornix</p>
|
|
1945
1988
|
<p>A crucial bug was found in v3.0.1 which caused invalid post dates to go
|
1946
1989
|
unnoticed in the build chain until the error that popped up was unhelpful.
|
1947
1990
|
v3.0.2 <a href="https://github.com/jekyll/jekyll/issues/4375">throws errors as you’d expect</a>
|
1948
|
-
when there is a post like <code class="highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
1949
|
-
invalid date like <code class="highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
1991
|
+
when there is a post like <code class="language-plaintext highlighter-rouge">_posts/2016-22-01-future.md</code> or a post has an
|
1992
|
+
invalid date like <code class="language-plaintext highlighter-rouge">date: "tuesday"</code> in their front matter.</p>
|
1950
1993
|
|
1951
1994
|
<p>This should make the experience of working with Jekyll just a little
|
1952
1995
|
better.</p>
|
@@ -1982,12 +2025,12 @@ better.</p>
|
|
1982
2025
|
<p>Hey, folks! Bunch of bug fixes here. Notables:</p>
|
1983
2026
|
|
1984
2027
|
<ul>
|
1985
|
-
<li>Only superdirectories of <code class="highlighter-rouge">_posts</code> will be categories.</li>
|
2028
|
+
<li>Only superdirectories of <code class="language-plaintext highlighter-rouge">_posts</code> will be categories.</li>
|
1986
2029
|
<li>
|
1987
|
-
<code class="highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
2030
|
+
<code class="language-plaintext highlighter-rouge">:title</code> in permalink templates are now properly cased as before</li>
|
1988
2031
|
<li>
|
1989
|
-
<code class="highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
1990
|
-
<li>Failure in liquid will now always fail the <code class="highlighter-rouge">jekyll</code> process.</li>
|
2032
|
+
<code class="language-plaintext highlighter-rouge">.jekyll-metadata</code> being erroneously written when not using incremental build.</li>
|
2033
|
+
<li>Failure in liquid will now always fail the <code class="language-plaintext highlighter-rouge">jekyll</code> process.</li>
|
1991
2034
|
<li>All hooks should now be properly registered & documented</li>
|
1992
2035
|
</ul>
|
1993
2036
|
|
@@ -2029,20 +2072,20 @@ Will Norris, XhmikosR, chrisfinazzo, and rebornix.</p>
|
|
2029
2072
|
<p>The much-anticipated Jekyll 3.0 has been released! Key changes:</p>
|
2030
2073
|
|
2031
2074
|
<ul>
|
2032
|
-
<li>Incremental regeneration (experimental, enable with <code class="highlighter-rouge">--incremental</code>)</li>
|
2033
|
-
<li>Liquid profiler (add <code class="highlighter-rouge">--profile</code> to a build or serve)</li>
|
2075
|
+
<li>Incremental regeneration (experimental, enable with <code class="language-plaintext highlighter-rouge">--incremental</code>)</li>
|
2076
|
+
<li>Liquid profiler (add <code class="language-plaintext highlighter-rouge">--profile</code> to a build or serve)</li>
|
2034
2077
|
<li>Hook plugin API (no more monkey-patching!)</li>
|
2035
2078
|
<li>Dependencies reduced from 14 to 8, none contain C extensions. We’re hoping to reduce this even more in the future.</li>
|
2036
2079
|
<li>Changed version support: no support for Ruby 1.9.3, added basic JRuby support. Better Windows support.</li>
|
2037
2080
|
<li>Extension-less URLs</li>
|
2038
2081
|
<li>
|
2039
|
-
<code class="highlighter-rouge">site.collections</code> is an array of collections, thus:
|
2082
|
+
<code class="language-plaintext highlighter-rouge">site.collections</code> is an array of collections, thus:
|
2040
2083
|
<ul>
|
2041
2084
|
<li>
|
2042
|
-
<code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
|
2085
|
+
<code class="language-plaintext highlighter-rouge">collection[0]</code> becomes <code class="language-plaintext highlighter-rouge">collection.label</code>
|
2043
2086
|
</li>
|
2044
2087
|
<li>
|
2045
|
-
<code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
|
2088
|
+
<code class="language-plaintext highlighter-rouge">collection[1]</code> becomes <code class="language-plaintext highlighter-rouge">collection</code>
|
2046
2089
|
</li>
|
2047
2090
|
</ul>
|
2048
2091
|
</li>
|
@@ -2187,8 +2230,8 @@ Feel free to chime in over on GitHub.</p>
|
|
2187
2230
|
</div>
|
2188
2231
|
<div class="post-content">
|
2189
2232
|
<p>A very minor release, 2.5.2 fixes a bug with path sanitation that 2.5.1
|
2190
|
-
introduced. It also improves the <code class="highlighter-rouge">post_url</code> tag such that it checks the
|
2191
|
-
posts’ name (e.g. <code class="highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
2233
|
+
introduced. It also improves the <code class="language-plaintext highlighter-rouge">post_url</code> tag such that it checks the
|
2234
|
+
posts’ name (e.g. <code class="language-plaintext highlighter-rouge">2014-03-03-my-cool-post</code>) instead of a compiled time and
|
2192
2235
|
name. This fixes issues where posts are created and the day changes based
|
2193
2236
|
on timezone discrepancies.</p>
|
2194
2237
|
|
@@ -2275,17 +2318,17 @@ milestone with a pretty big release. What’s changed in 2.5.0? Here are some
|
|
2275
2318
|
highlights:</p>
|
2276
2319
|
|
2277
2320
|
<ul>
|
2278
|
-
<li>Require plugins in the <code class="highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
2279
|
-
<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>
|
2280
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
2281
|
-
<li>Shorted <code class="highlighter-rouge">build</code> and <code class="highlighter-rouge">serve</code> commands with <code class="highlighter-rouge">b</code> and <code class="highlighter-rouge">s</code> aliases, respectively</li>
|
2321
|
+
<li>Require plugins in the <code class="language-plaintext highlighter-rouge">:jekyll_plugins</code> Gemfile group (turned off with an environment variable)</li>
|
2322
|
+
<li>YAML Front Matter permalinks can now contain placeholders like <code class="language-plaintext highlighter-rouge">:name</code>. Check out all the placeholders on the <a href="/docs/permalinks/">Permalinks docs page</a>.</li>
|
2323
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter now deep-converts arrays to liquid.</li>
|
2324
|
+
<li>Shorted <code class="language-plaintext highlighter-rouge">build</code> and <code class="language-plaintext highlighter-rouge">serve</code> commands with <code class="language-plaintext highlighter-rouge">b</code> and <code class="language-plaintext highlighter-rouge">s</code> aliases, respectively</li>
|
2282
2325
|
<li>WEBrick will now list your directory if it can’t find an index file.</li>
|
2283
|
-
<li>Any enumerable can be used with the <code class="highlighter-rouge">where</code> filter.</li>
|
2326
|
+
<li>Any enumerable can be used with the <code class="language-plaintext highlighter-rouge">where</code> filter.</li>
|
2284
2327
|
<li>Performance optimizations thanks to <a href="https://github.com/tmm1" class="user-mention">@tmm1</a>’s <a href="https://github.com/tmm1/stackprof">stackprof</a>
|
2285
2328
|
</li>
|
2286
2329
|
<li>Fix for Rouge’s Redcarpet interface</li>
|
2287
2330
|
<li>Security auditors will love this: path sanitation has now been centralized.</li>
|
2288
|
-
<li>Specify a log level with <code class="highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
2331
|
+
<li>Specify a log level with <code class="language-plaintext highlighter-rouge">JEKYLL_LOG_LEVEL</code>: debug, info, warn, or error.</li>
|
2289
2332
|
</ul>
|
2290
2333
|
|
2291
2334
|
<p>…and a whole bunch of other fixes and enhancements you can read more
|
@@ -2339,14 +2382,14 @@ Custódio, Igor Kapkov, and Kevin Ndung’u!</p>
|
|
2339
2382
|
<p>Well, lookie here! A new release of Jekyll! v2.4.0 contains lots of goodies, including some brilliant new additions:</p>
|
2340
2383
|
|
2341
2384
|
<ul>
|
2342
|
-
<li>A new <code class="highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
2385
|
+
<li>A new <code class="language-plaintext highlighter-rouge">relative_include</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/2870">#2870</a>)</li>
|
2343
2386
|
<li>Render Liquid in CoffeeScript files (<a href="https://github.com/jekyll/jekyll/issues/2830">#2830</a>)</li>
|
2344
|
-
<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>
|
2345
|
-
<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>
|
2346
|
-
<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>
|
2347
|
-
<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>
|
2348
|
-
<li>Add <code class="highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
2349
|
-
<li>Add a <code class="highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
2387
|
+
<li>Add 4 new array Liquid filters: <code class="language-plaintext highlighter-rouge">push</code>, <code class="language-plaintext highlighter-rouge">pop</code>, <code class="language-plaintext highlighter-rouge">shift</code>, and <code class="language-plaintext highlighter-rouge">unshift</code> (<a href="https://github.com/jekyll/jekyll/pull/2895">#2895</a>)</li>
|
2388
|
+
<li>Auto-enable watch on ‘serve’ (<a href="https://github.com/jekyll/jekyll/issues/2858">#2858</a>). No more <code class="language-plaintext highlighter-rouge">-w</code>!</li>
|
2389
|
+
<li>Add <code class="language-plaintext highlighter-rouge">:title</code> and <code class="language-plaintext highlighter-rouge">:name</code> to collection URL template fillers (<a href="https://github.com/jekyll/jekyll/issues/2864">#2864</a> & <a href="https://github.com/jekyll/jekyll/issues/2799">#2799</a>)</li>
|
2390
|
+
<li>Add support for CSV files in the <code class="language-plaintext highlighter-rouge">_data</code> directory (<a href="https://github.com/jekyll/jekyll/issues/2761">#2761</a>)</li>
|
2391
|
+
<li>Add <code class="language-plaintext highlighter-rouge">inspect</code> liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2867">#2867</a>)</li>
|
2392
|
+
<li>Add a <code class="language-plaintext highlighter-rouge">slugify</code> Liquid filter (<a href="https://github.com/jekyll/jekyll/issues/2880">#2880</a>)</li>
|
2350
2393
|
</ul>
|
2351
2394
|
|
2352
2395
|
<p>Some other wunderbar bug fixes in there as well. Check out the <a href="/docs/history/">full changelog</a> for the whole scoop.</p>
|
@@ -2390,22 +2433,22 @@ curious bug indeed.</a>
|
|
2390
2433
|
</li>
|
2391
2434
|
<li>Pages, Posts, and Drafts can now be converted by multiple converters.</li>
|
2392
2435
|
<li>Static files can now be safely included in collections. They’ll be placed
|
2393
|
-
in a <code class="highlighter-rouge">collection.files</code> array. <code class="highlighter-rouge">collection.docs</code> still holds exclusively
|
2436
|
+
in a <code class="language-plaintext highlighter-rouge">collection.files</code> array. <code class="language-plaintext highlighter-rouge">collection.docs</code> still holds exclusively
|
2394
2437
|
content with YAML front matter.</li>
|
2395
2438
|
<li>Sass files can once again be rendered by Liquid. However, neither Sass
|
2396
|
-
nor CoffeeScript can ever have a layout. Bonus: <code class="highlighter-rouge">scssify</code> and <code class="highlighter-rouge">sassify</code>
|
2439
|
+
nor CoffeeScript can ever have a layout. Bonus: <code class="language-plaintext highlighter-rouge">scssify</code> and <code class="language-plaintext highlighter-rouge">sassify</code>
|
2397
2440
|
Liquid filters.</li>
|
2398
|
-
<li>Partial variables allowed now in the path argument of <code class="highlighter-rouge">include</code> calls</li>
|
2399
|
-
<li>We added a <code class="highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
2400
|
-
about that subcommand. Or don’t, to see the help for <code class="highlighter-rouge">jekyll</code> itself.</li>
|
2401
|
-
<li>Lots of fixes to the site template we use for <code class="highlighter-rouge">jekyll new</code>, including
|
2441
|
+
<li>Partial variables allowed now in the path argument of <code class="language-plaintext highlighter-rouge">include</code> calls</li>
|
2442
|
+
<li>We added a <code class="language-plaintext highlighter-rouge">jekyll help</code> command. Pass it a subcommand to see more info
|
2443
|
+
about that subcommand. Or don’t, to see the help for <code class="language-plaintext highlighter-rouge">jekyll</code> itself.</li>
|
2444
|
+
<li>Lots of fixes to the site template we use for <code class="language-plaintext highlighter-rouge">jekyll new</code>, including
|
2402
2445
|
converting the CSS into SCSS.</li>
|
2403
|
-
<li>The <code class="highlighter-rouge">jsonify</code> filter will now call <code class="highlighter-rouge">#to_liquid</code> for you</li>
|
2446
|
+
<li>The <code class="language-plaintext highlighter-rouge">jsonify</code> filter will now call <code class="language-plaintext highlighter-rouge">#to_liquid</code> for you</li>
|
2404
2447
|
<li>Lots, lots more!</li>
|
2405
2448
|
</ul>
|
2406
2449
|
|
2407
2450
|
<p>One change deserves special note. In <a href="https://github.com/jekyll/jekyll/issues/2633">#2633</a>, subfolders <em>inside</em> a
|
2408
|
-
<code class="highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
2451
|
+
<code class="language-plaintext highlighter-rouge">_posts</code> folder were processed and added as categories to the posts. It
|
2409
2452
|
turns out, this behaviour was unwanted by a large number of individuals, as
|
2410
2453
|
it is a handy way to organize posts. Ultimately, we decided to revert this
|
2411
2454
|
change in <a href="https://github.com/jekyll/jekyll/issues/2705">#2705</a>, because it was a change in behaviour that was already
|
@@ -2446,7 +2489,7 @@ page</a>! Happy Jekylling!</p>
|
|
2446
2489
|
<li>A warning will now fire if you specify a layout in any of your pages or
|
2447
2490
|
posts that doesn’t exist.</li>
|
2448
2491
|
<li>Certain Pygments options are now whitelisted in safe mode</li>
|
2449
|
-
<li>Categories in a post’s path are now respected (i.e. folders in <code class="highlighter-rouge">_posts</code>
|
2492
|
+
<li>Categories in a post’s path are now respected (i.e. folders in <code class="language-plaintext highlighter-rouge">_posts</code>
|
2450
2493
|
will now work properly).</li>
|
2451
2494
|
</ol>
|
2452
2495
|
|
@@ -2486,7 +2529,7 @@ introduces fixes for a couple security-related issues.</p>
|
|
2486
2529
|
|
2487
2530
|
<ol>
|
2488
2531
|
<li>One in the reading of data</li>
|
2489
|
-
<li>One in the <code class="highlighter-rouge">layouts</code> setting</li>
|
2532
|
+
<li>One in the <code class="language-plaintext highlighter-rouge">layouts</code> setting</li>
|
2490
2533
|
</ol>
|
2491
2534
|
|
2492
2535
|
<p>They were identified in Jekyll 1.5.1 and has been confirmed as patched
|
@@ -2494,7 +2537,7 @@ in this version and the version used by GitHub Pages. If you are in the
|
|
2494
2537
|
business of building Jekyll sites, please ensure you upgrade to 2.1.1 as
|
2495
2538
|
soon as possible.</p>
|
2496
2539
|
|
2497
|
-
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
2540
|
+
<p>For more, check out <a href="https://github.com/jekyll/jekyll/pull/2563"><code class="language-plaintext highlighter-rouge">jekyll/jekyll#2563</code></a>.</p>
|
2498
2541
|
|
2499
2542
|
<p>Additionally, the dependency on Maruku has been loosened and a bug was
|
2500
2543
|
fixed with document URLs.</p>
|
@@ -2538,13 +2581,13 @@ things to look forward to:</p>
|
|
2538
2581
|
<li>Set front matter defaults for collections (#2419)</li>
|
2539
2582
|
<li>Set a collection-specific URL template (#2418)</li>
|
2540
2583
|
<li>
|
2541
|
-
<code class="highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
2584
|
+
<code class="language-plaintext highlighter-rouge">pygments.rb</code> 0.6.0! (#2504)</li>
|
2542
2585
|
<li>
|
2543
|
-
<code class="highlighter-rouge">.json</code> files in <code class="highlighter-rouge">_data</code> (#2369)</li>
|
2544
|
-
<li>Allow subdirectories in <code class="highlighter-rouge">_data</code> (#2395)</li>
|
2545
|
-
<li>Add support for <code class="highlighter-rouge">hl_lines</code> in <code class="highlighter-rouge">highlight</code> tag (#2532)</li>
|
2586
|
+
<code class="language-plaintext highlighter-rouge">.json</code> files in <code class="language-plaintext highlighter-rouge">_data</code> (#2369)</li>
|
2587
|
+
<li>Allow subdirectories in <code class="language-plaintext highlighter-rouge">_data</code> (#2395)</li>
|
2588
|
+
<li>Add support for <code class="language-plaintext highlighter-rouge">hl_lines</code> in <code class="language-plaintext highlighter-rouge">highlight</code> tag (#2532)</li>
|
2546
2589
|
<li>Post categories now merge with directory, front matter, and defaults (#2373)</li>
|
2547
|
-
<li>New <code class="highlighter-rouge">--skip_initial_build</code> flag for <code class="highlighter-rouge">jekyll serve</code> (#2477)</li>
|
2590
|
+
<li>New <code class="language-plaintext highlighter-rouge">--skip_initial_build</code> flag for <code class="language-plaintext highlighter-rouge">jekyll serve</code> (#2477)</li>
|
2548
2591
|
<li>A bajilion bug fixes and site updates!</li>
|
2549
2592
|
</ul>
|
2550
2593
|
|
@@ -2626,15 +2669,15 @@ things to look forward to:</p>
|
|
2626
2669
|
<li>
|
2627
2670
|
<a href="/docs/collections/">Collections</a> - Collections allow you to define an unlimited number of custom document types (beyond just posts and pages) for different types of content you may want to author in Jekyll such as API documentation or a cookbook!</li>
|
2628
2671
|
<li>
|
2629
|
-
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
2672
|
+
<a href="https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016">Brand new site template</a> (thanks <a href="https://github.com/jglovier">@jglovier</a>!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run <code class="language-plaintext highlighter-rouge">jekyll new <path></code> and you’re good to go.</li>
|
2630
2673
|
<li>
|
2631
2674
|
<a href="/docs/assets/">Native Sass & CoffeeScript support</a> - We love CSS and JavaScript as much as the next guy, but there will always be a special place in our hearts for Sass and CoffeeScript. We now offer native support for these file types — no more messing around with Rake or Grunt!</li>
|
2632
2675
|
<li>
|
2633
|
-
<a href="/docs/configuration/#front-matter-defaults">YAML Front Matter defaults</a> - If you’ve set <code class="highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
|
2676
|
+
<a href="/docs/configuration/#front-matter-defaults">YAML Front Matter defaults</a> - If you’ve set <code class="language-plaintext highlighter-rouge">layout: post</code> more than once in your life, you’ll love this new feature: set front matter defaults for a given directory or type.</li>
|
2634
2677
|
<li>
|
2635
|
-
<a href="/docs/configuration/#custom-markdown-processors">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
|
2678
|
+
<a href="/docs/configuration/#custom-markdown-processors">Custom markdown processors</a> - Always wanted to use your favourite home-grown Markdown converter, but couldn’t with Jekyll? Now you can. Simply specify <code class="language-plaintext highlighter-rouge">markdown: MyConverterClass</code> and you’re on your way.</li>
|
2636
2679
|
<li>
|
2637
|
-
<a href="/docs/templates/#filters">Addition of <code class="highlighter-rouge">where</code> and <code class="highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
|
2680
|
+
<a href="/docs/templates/#filters">Addition of <code class="language-plaintext highlighter-rouge">where</code> and <code class="language-plaintext highlighter-rouge">group_by</code> Liquid filters</a> - Simplifying your Liquid templates one filter at a time. The <code class="language-plaintext highlighter-rouge">where</code> filter selects from an array all items within which have a given value for a property. The <code class="language-plaintext highlighter-rouge">group_by</code> filter groups all items in an array which have the same value for a given property.</li>
|
2638
2681
|
<li>
|
2639
2682
|
<a href="https://github.com/jekyll/jekyll/pull/1988">Switch from Maruku to Kramdown as default markdown converter</a> - Maruku is dead. We’ve replaced it with the converter which has the closest feature parity: Kramdown!</li>
|
2640
2683
|
</ol>
|
@@ -2675,7 +2718,7 @@ things to look forward to:</p>
|
|
2675
2718
|
</div>
|
2676
2719
|
<div class="post-content">
|
2677
2720
|
<p>The hawk-eyed <a href="https://github.com/gregose">@gregose</a> spotted a bug in our
|
2678
|
-
<code class="highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
2721
|
+
<code class="language-plaintext highlighter-rouge">Jekyll.sanitized_path</code> code:</p>
|
2679
2722
|
|
2680
2723
|
<figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="o">></span> <span class="n">sanitized_path</span><span class="p">(</span><span class="s2">"/tmp/foobar/jail"</span><span class="p">,</span> <span class="s2">"..c:/..c:/..c:/etc/passwd"</span><span class="p">)</span>
|
2681
2724
|
<span class="o">=></span> <span class="s2">"/tmp/foobar/jail/../../../etc/passwd"</span></code></pre></figure>
|
@@ -2715,7 +2758,7 @@ the masses. Thanks, Greg!</p>
|
|
2715
2758
|
</div>
|
2716
2759
|
<div class="post-content">
|
2717
2760
|
<p>As work continues on Jekyll 2.0.0, we felt it was important to address two key
|
2718
|
-
issues of Jekyll 1.4.3, namely the <code class="highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
2761
|
+
issues of Jekyll 1.4.3, namely the <code class="language-plaintext highlighter-rouge">safe_yaml</code> dependency below 1.0 and the
|
2719
2762
|
inability to use Jekyll 1.4.3 on Windows due to a <a href="https://github.com/jekyll/jekyll/issues/1948">fun issue with path sanitizing</a>.</p>
|
2720
2763
|
|
2721
2764
|
<p>For a full changelog, check out our <a href="/docs/history/#v1-5-0">history</a> page.</p>
|
@@ -2760,7 +2803,7 @@ generated output via improper symlink sanitization, potentially resulting in an
|
|
2760
2803
|
inadvertent information disclosure.</p>
|
2761
2804
|
|
2762
2805
|
<p>Versions of Jekyll prior to 1.4.3 may also allow malicious users to write
|
2763
|
-
arbitrary <code class="highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
2806
|
+
arbitrary <code class="language-plaintext highlighter-rouge">.html</code> files outside of the destination folder via relative path
|
2764
2807
|
traversal, potentially overwriting otherwise-trusted content with arbitrary HTML
|
2765
2808
|
or Javascript depending on your server’s configuration.</p>
|
2766
2809
|
|
@@ -2795,8 +2838,8 @@ these vulnerabilities, and to <a href="https://github.com/BenBalter" class="user
|
|
2795
2838
|
<div class="post-content">
|
2796
2839
|
<p>This release fixes <a href="https://github.com/jekyll/jekyll/pull/1830">a regression</a> where Maruku fenced code blocks were turned
|
2797
2840
|
off, instead of the previous default to on. We’ve added a new default
|
2798
|
-
configuration to our <code class="highlighter-rouge">maruku</code> config key: <code class="highlighter-rouge">fenced_code_blocks</code> and set it to
|
2799
|
-
default to <code class="highlighter-rouge">true</code>.</p>
|
2841
|
+
configuration to our <code class="language-plaintext highlighter-rouge">maruku</code> config key: <code class="language-plaintext highlighter-rouge">fenced_code_blocks</code> and set it to
|
2842
|
+
default to <code class="language-plaintext highlighter-rouge">true</code>.</p>
|
2800
2843
|
|
2801
2844
|
<p>If you do not wish to use Maruku fenced code blocks, you may turn this option
|
2802
2845
|
off in your site’s configuration file.</p>
|
@@ -2879,7 +2922,7 @@ Jekyll v1.4.0. This release will be the last non-patch release to support Ruby
|
|
2879
2922
|
a ton of bugfixes over the previous 0.6.x releases.</p>
|
2880
2923
|
</li>
|
2881
2924
|
<li>
|
2882
|
-
<p>Non-<code class="highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
2925
|
+
<p>Non-<code class="language-plaintext highlighter-rouge">gem</code> Plugins are now sorted alphabetically by filename before they’re
|
2883
2926
|
processed, which can provide a rudimentary way to establish a load order for
|
2884
2927
|
plugins.</p>
|
2885
2928
|
</li>
|
@@ -2923,7 +2966,7 @@ Karékinian, Jordon Bedwell, Matthew Iversen, Persa Zula, and Yi Zeng.</p>
|
|
2923
2966
|
release of 1.3.0.</p>
|
2924
2967
|
|
2925
2968
|
<p>In addition to a couple of other smaller bug fixes, the biggest thing
|
2926
|
-
we’ve fixed is an issue with the <code class="highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
2969
|
+
we’ve fixed is an issue with the <code class="language-plaintext highlighter-rouge">--watch</code> option with Ruby 1.8.7. For a
|
2927
2970
|
full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
2928
2971
|
|
2929
2972
|
<p>Thanks to all the people who have contributed to this release! They are
|
@@ -2967,33 +3010,33 @@ love.</p>
|
|
2967
3010
|
<ul>
|
2968
3011
|
<li>
|
2969
3012
|
<p>You can add <a href="/docs/datafiles/">arbitrary data</a> to the site by adding YAML files under a
|
2970
|
-
site’s <code class="highlighter-rouge">_data</code> directory. This will allow you to avoid
|
3013
|
+
site’s <code class="language-plaintext highlighter-rouge">_data</code> directory. This will allow you to avoid
|
2971
3014
|
repetition in your templates and to set site specific options without
|
2972
|
-
changing <code class="highlighter-rouge">_config.yml</code>.</p>
|
3015
|
+
changing <code class="language-plaintext highlighter-rouge">_config.yml</code>.</p>
|
2973
3016
|
</li>
|
2974
3017
|
<li>
|
2975
|
-
<p>You can now run <code class="highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
2976
|
-
background. <strong>Note:</strong> you’ll need to run <code class="highlighter-rouge">kill [server_pid]</code> to shut
|
3018
|
+
<p>You can now run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the
|
3019
|
+
background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut
|
2977
3020
|
the server down. When ran, you’ll get a process id that you can use in
|
2978
|
-
place of <code class="highlighter-rouge">[server_pid]</code></p>
|
3021
|
+
place of <code class="language-plaintext highlighter-rouge">[server_pid]</code></p>
|
2979
3022
|
</li>
|
2980
3023
|
<li>
|
2981
3024
|
<p>You can now <strong>disable automatically-generated excerpts</strong> if you set
|
2982
|
-
<code class="highlighter-rouge">excerpt_separator</code> to <code class="highlighter-rouge">""</code>.</p>
|
3025
|
+
<code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</p>
|
2983
3026
|
</li>
|
2984
3027
|
<li>
|
2985
3028
|
<p>If you’re moving pages and posts, you can now check for <strong>URL
|
2986
|
-
conflicts</strong> by running <code class="highlighter-rouge">jekyll doctor</code>.</p>
|
3029
|
+
conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</p>
|
2987
3030
|
</li>
|
2988
3031
|
<li>
|
2989
3032
|
<p>If you’re a fan of the drafts feature, you’ll be happy to know we’ve
|
2990
|
-
added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</p>
|
3033
|
+
added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</p>
|
2991
3034
|
</li>
|
2992
3035
|
<li>
|
2993
3036
|
<p>Permalinks with special characters should now generate without errors.</p>
|
2994
3037
|
</li>
|
2995
3038
|
<li>
|
2996
|
-
<p>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid
|
3039
|
+
<p>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid
|
2997
3040
|
variable.</p>
|
2998
3041
|
</li>
|
2999
3042
|
</ul>
|
@@ -3064,11 +3107,11 @@ issues!</p>
|
|
3064
3107
|
<div class="post-content">
|
3065
3108
|
<p>Quick turnover, anyone? A <a href="https://github.com/jekyll/jekyll/pull/1525">recent incompatibility with Liquid
|
3066
3109
|
v2.5.2</a> produced a nasty bug in
|
3067
|
-
which <code class="highlighter-rouge">include</code> tags were not rendered properly within <code class="highlighter-rouge">if</code> blocks.</p>
|
3110
|
+
which <code class="language-plaintext highlighter-rouge">include</code> tags were not rendered properly within <code class="language-plaintext highlighter-rouge">if</code> blocks.</p>
|
3068
3111
|
|
3069
3112
|
<p>This release also includes a better handling of detached servers (prints pid and
|
3070
|
-
the command for killing the process). <strong>Note</strong>: the <code class="highlighter-rouge">--detach</code> flag and
|
3071
|
-
<code class="highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
3113
|
+
the command for killing the process). <strong>Note</strong>: the <code class="language-plaintext highlighter-rouge">--detach</code> flag and
|
3114
|
+
<code class="language-plaintext highlighter-rouge">--watch</code> flags are presently incompatible in 1.2.x. Fix for that coming soon!</p>
|
3072
3115
|
|
3073
3116
|
<p>For a full list of the fixes in this release, check out <a href="/docs/history/">the change
|
3074
3117
|
log</a>!</p>
|
@@ -3106,12 +3149,12 @@ enhancements that we think you’ll love.</p>
|
|
3106
3149
|
<p>Here are a few things we think you’ll want to know about this release:</p>
|
3107
3150
|
|
3108
3151
|
<ul>
|
3109
|
-
<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>
|
3110
|
-
<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>
|
3111
|
-
<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>
|
3112
|
-
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="highlighter-rouge">-D</code>, a shortened version of <code class="highlighter-rouge">--drafts</code>.</li>
|
3152
|
+
<li>Run <code class="language-plaintext highlighter-rouge">jekyll serve --detach</code> to boot up a WEBrick server in the background. <strong>Note:</strong> you’ll need to run <code class="language-plaintext highlighter-rouge">kill [server_pid]</code> to shut the server down.</li>
|
3153
|
+
<li>You can now <strong>disable automatically-generated excerpts</strong> if you set <code class="language-plaintext highlighter-rouge">excerpt_separator</code> to <code class="language-plaintext highlighter-rouge">""</code>.</li>
|
3154
|
+
<li>If you’re moving around pages and post, you can now check for <strong>URL conflicts</strong> by running <code class="language-plaintext highlighter-rouge">jekyll doctor</code>.</li>
|
3155
|
+
<li>If you’re a fan of the drafts feature, you’ll be happy to know we’ve added <code class="language-plaintext highlighter-rouge">-D</code>, a shortened version of <code class="language-plaintext highlighter-rouge">--drafts</code>.</li>
|
3113
3156
|
<li>Permalinks with special characters should now generate without errors.</li>
|
3114
|
-
<li>Expose the current Jekyll version as the <code class="highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
3157
|
+
<li>Expose the current Jekyll version as the <code class="language-plaintext highlighter-rouge">jekyll.version</code> Liquid variable.</li>
|
3115
3158
|
</ul>
|
3116
3159
|
|
3117
3160
|
<p>For a full run-down, visit our <a href="/docs/history/">change log</a>!</p>
|
@@ -3144,9 +3187,9 @@ enhancements that we think you’ll love.</p>
|
|
3144
3187
|
<div class="post-content">
|
3145
3188
|
<p>Version 1.1.2 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
|
3146
3189
|
|
3147
|
-
<p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
3190
|
+
<p>Community and custom plugins extending the <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
3148
3191
|
|
3149
|
-
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3192
|
+
<p>We recommend you upgrade to Jekyll v1.1.2 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3150
3193
|
|
3151
3194
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
3152
3195
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
@@ -3180,9 +3223,9 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
|
|
3180
3223
|
<div class="post-content">
|
3181
3224
|
<p>Version 1.0.4 fixes a minor, but nonetheless important security vulnerability affecting several third-party Jekyll plugins. If your Jekyll site does not use plugins, you may, but are not required to upgrade at this time.</p>
|
3182
3225
|
|
3183
|
-
<p>Community and custom plugins extending the <code class="highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
3226
|
+
<p>Community and custom plugins extending the <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> class may inadvertently disclose some system information such as directory structure or software configuration to users with access to the Liquid templating system.</p>
|
3184
3227
|
|
3185
|
-
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3228
|
+
<p>We recommend you upgrade to Jekyll v1.0.4 immediately if you use <code class="language-plaintext highlighter-rouge">Liquid::Drop</code> plugins on your Jekyll site.</p>
|
3186
3229
|
|
3187
3230
|
<p>Many thanks for <a href="https://github.com/benbalter">Ben Balter</a> for alerting us to the problem
|
3188
3231
|
and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a> so quickly.</p>
|
@@ -3258,12 +3301,12 @@ more a more detailed changelog for this release.</p>
|
|
3258
3301
|
Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new additions:</p>
|
3259
3302
|
|
3260
3303
|
<ul>
|
3261
|
-
<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>
|
3262
|
-
<li>Support passing parameters to templates in <code class="highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
|
3304
|
+
<li>Add <code class="language-plaintext highlighter-rouge">docs</code> subcommand to read Jekyll’s docs when offline. (<a href="https://github.com/jekyll/jekyll/issues/1046">#1046</a>)</li>
|
3305
|
+
<li>Support passing parameters to templates in <code class="language-plaintext highlighter-rouge">include</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1204">#1204</a>)</li>
|
3263
3306
|
<li>Add support for Liquid tags to post excerpts (<a href="https://github.com/jekyll/jekyll/issues/1302">#1302</a>)</li>
|
3264
3307
|
<li>Fix pagination for subdirectories (<a href="https://github.com/jekyll/jekyll/issues/1198">#1198</a>)</li>
|
3265
3308
|
<li>Provide better error reporting when generating sites (<a href="https://github.com/jekyll/jekyll/issues/1253">#1253</a>)</li>
|
3266
|
-
<li>Latest posts first in non-LSI <code class="highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
|
3309
|
+
<li>Latest posts first in non-LSI <code class="language-plaintext highlighter-rouge">related_posts</code> (<a href="https://github.com/jekyll/jekyll/issues/1271">#1271</a>)</li>
|
3267
3310
|
</ul>
|
3268
3311
|
|
3269
3312
|
<p>See the <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.0">GitHub Release</a> page for more a more detailed changelog for this release.</p>
|
@@ -3299,10 +3342,10 @@ Jekyll v1.1.0! This latest release of Jekyll brings some really exciting new add
|
|
3299
3342
|
|
3300
3343
|
<ul>
|
3301
3344
|
<li>Fail with non-zero exit code when MaRuKu errors (<a href="https://github.com/jekyll/jekyll/issues/1190">#1190</a>) or Liquid errors (<a href="https://github.com/jekyll/jekyll/issues/1121">#1121</a>)</li>
|
3302
|
-
<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>
|
3303
|
-
<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>
|
3304
|
-
<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>
|
3305
|
-
<li>Fix pagination issue regarding <code class="highlighter-rouge">File.basename</code> and <code class="highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
|
3345
|
+
<li>Add support for private gists to <code class="language-plaintext highlighter-rouge">gist</code> tag (<a href="https://github.com/jekyll/jekyll/issues/1189">#1189</a>)</li>
|
3346
|
+
<li>Add <code class="language-plaintext highlighter-rouge">--force</code> option to <code class="language-plaintext highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/1115">#1115</a>)</li>
|
3347
|
+
<li>Fix compatibility with <code class="language-plaintext highlighter-rouge">exclude</code> and <code class="language-plaintext highlighter-rouge">include</code> with pre-1.0 Jekyll (<a href="https://github.com/jekyll/jekyll/issues/1114">#1114</a>)</li>
|
3348
|
+
<li>Fix pagination issue regarding <code class="language-plaintext highlighter-rouge">File.basename</code> and <code class="language-plaintext highlighter-rouge">page:num</code> (<a href="https://github.com/jekyll/jekyll/issues/1063">#1063</a>)</li>
|
3306
3349
|
</ul>
|
3307
3350
|
|
3308
3351
|
<p>See the <a href="/docs/history/#v1-0-3">History</a> page for more information on this release.</p>
|
@@ -3339,11 +3382,11 @@ releases, and fix some other annoying bugs:</p>
|
|
3339
3382
|
|
3340
3383
|
<ul>
|
3341
3384
|
<li>Backwards-compatibilize relative permalinks (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
3342
|
-
<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>
|
3343
|
-
<li>Deprecate old config <code class="highlighter-rouge">server_port</code>, match to <code class="highlighter-rouge">port</code> if <code class="highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
|
3385
|
+
<li>Add <code class="language-plaintext highlighter-rouge">jekyll doctor</code> command to check site for any known compatibility problems (<a href="https://github.com/jekyll/jekyll/issues/1081">#1081</a>)</li>
|
3386
|
+
<li>Deprecate old config <code class="language-plaintext highlighter-rouge">server_port</code>, match to <code class="language-plaintext highlighter-rouge">port</code> if <code class="language-plaintext highlighter-rouge">port</code> isn’t set (<a href="https://github.com/jekyll/jekyll/issues/1084">#1084</a>)</li>
|
3344
3387
|
<li>Update pygments.rb and kramdon versions to 0.5.0 and 1.0.2, respectively (<a href="https://github.com/jekyll/jekyll/issues/1061">#1061</a>, <a href="https://github.com/jekyll/jekyll/issues/1067">#1067</a>)</li>
|
3345
3388
|
<li>Fix issue when post categories are numbers (<a href="https://github.com/jekyll/jekyll/issues/1078">#1078</a>)</li>
|
3346
|
-
<li>Add a <code class="highlighter-rouge">data-lang="<lang>"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
|
3389
|
+
<li>Add a <code class="language-plaintext highlighter-rouge">data-lang="<lang>"</code> attribute to Redcarpet code blocks (<a href="https://github.com/jekyll/jekyll/issues/1066">#1066</a>)</li>
|
3347
3390
|
<li>Catching that Redcarpet gem isn’t installed (<a href="https://github.com/jekyll/jekyll/issues/1059">#1059</a>)</li>
|
3348
3391
|
</ul>
|
3349
3392
|
|
@@ -3379,13 +3422,13 @@ releases, and fix some other annoying bugs:</p>
|
|
3379
3422
|
<p>Hot on the trails of v1.0, v1.0.1 is out! Here are the highlights:</p>
|
3380
3423
|
|
3381
3424
|
<ul>
|
3382
|
-
<li>Add newer <code class="highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
|
3425
|
+
<li>Add newer <code class="language-plaintext highlighter-rouge">language-</code> class name prefix to code blocks (<a href="https://github.com/jekyll/jekyll/issues/1037">#1037</a>)</li>
|
3383
3426
|
<li>Commander error message now preferred over process abort with incorrect args (<a href="https://github.com/jekyll/jekyll/issues/1040">#1040</a>)</li>
|
3384
3427
|
<li>Do not force use of toc_token when using generate_toc in RDiscount (<a href="https://github.com/jekyll/jekyll/issues/1048">#1048</a>)</li>
|
3385
3428
|
<li>Make Redcarpet respect the pygments configuration option (<a href="https://github.com/jekyll/jekyll/issues/1053">#1053</a>)</li>
|
3386
3429
|
<li>Fix the index build with LSI (<a href="https://github.com/jekyll/jekyll/issues/1045">#1045</a>)</li>
|
3387
3430
|
<li>Don’t print deprecation warning when no arguments are specified. (<a href="https://github.com/jekyll/jekyll/issues/1041">#1041</a>)</li>
|
3388
|
-
<li>Add missing <code class="highlighter-rouge"></div></code> to site template used by <code class="highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
|
3431
|
+
<li>Add missing <code class="language-plaintext highlighter-rouge"></div></code> to site template used by <code class="language-plaintext highlighter-rouge">new</code> subcommand, fixed typos in code (<a href="https://github.com/jekyll/jekyll/issues/1032">#1032</a>)</li>
|
3389
3432
|
</ul>
|
3390
3433
|
|
3391
3434
|
<p>See the <a href="/docs/history/#v1-0-1">History</a> page for more information on this release.</p>
|
@@ -3452,6 +3495,10 @@ examples and for compiling this list):</p>
|
|
3452
3495
|
<h4>Recent Releases</h4>
|
3453
3496
|
<ul>
|
3454
3497
|
|
3498
|
+
<li class="">
|
3499
|
+
<a href="/news/2019/07/02/jekyll-3-8-6-released/">Version 3.8.6</a>
|
3500
|
+
</li>
|
3501
|
+
|
3455
3502
|
<li class="">
|
3456
3503
|
<a href="/news/2018/06/05/jekyll-3-8-3-released/">Version 3.8.3</a>
|
3457
3504
|
</li>
|
@@ -3468,10 +3515,6 @@ examples and for compiling this list):</p>
|
|
3468
3515
|
<a href="/news/2018/02/24/jekyll-3-7-3-released/">Version 3.7.3</a>
|
3469
3516
|
</li>
|
3470
3517
|
|
3471
|
-
<li class="">
|
3472
|
-
<a href="/news/2018/01/25/jekyll-3-7-2-released/">Version 3.7.2</a>
|
3473
|
-
</li>
|
3474
|
-
|
3475
3518
|
<li>
|
3476
3519
|
<a href="/docs/history/">History »</a>
|
3477
3520
|
</li>
|
@@ -3488,6 +3531,8 @@ examples and for compiling this list):</p>
|
|
3488
3531
|
|
3489
3532
|
|
3490
3533
|
|
3534
|
+
|
3535
|
+
|
3491
3536
|
<li class="">
|
3492
3537
|
<a href="/news/2018/02/19/meet-jekyll-s-new-lead-developer/">Meet Jekyll's New Lead Developer</a>
|
3493
3538
|
</li>
|
@@ -3673,7 +3718,7 @@ examples and for compiling this list):</p>
|
|
3673
3718
|
<footer>
|
3674
3719
|
<div class="grid">
|
3675
3720
|
<div class="unit one-third center-on-mobiles">
|
3676
|
-
<p>The contents of this website are <br>©
|
3721
|
+
<p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
3677
3722
|
</div>
|
3678
3723
|
<div class="unit two-thirds align-right center-on-mobiles">
|
3679
3724
|
<p>
|