jekyll-docs 3.7.3 → 3.8.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/lib/jekyll-docs.rb +1 -1
- data/site/404.html +6 -22
- data/site/docs/assets/index.html +9 -25
- data/site/docs/code_of_conduct/index.html +8 -24
- data/site/docs/collections/index.html +22 -24
- data/site/docs/conduct/index.html +8 -24
- data/site/docs/configuration/index.html +33 -39
- data/site/docs/continuous-integration/buddyworks/index.html +8 -24
- data/site/docs/continuous-integration/circleci/index.html +8 -24
- data/site/docs/continuous-integration/index.html +8 -24
- data/site/docs/continuous-integration/travis-ci/index.html +8 -24
- data/site/docs/contributing/index.html +8 -24
- data/site/docs/datafiles/index.html +8 -24
- data/site/docs/deployment-methods/index.html +8 -24
- data/site/docs/drafts/index.html +8 -24
- data/site/docs/extras/index.html +8 -24
- data/site/docs/frontmatter/index.html +8 -24
- data/site/docs/github-pages/index.html +8 -24
- data/site/docs/history/index.html +137 -40
- data/site/docs/home/index.html +32 -63
- data/site/docs/includes/index.html +8 -24
- data/site/docs/installation/index.html +120 -109
- data/site/docs/maintaining/affinity-team-captain/index.html +8 -24
- data/site/docs/maintaining/avoiding-burnout/index.html +10 -26
- data/site/docs/maintaining/becoming-a-maintainer/index.html +8 -24
- data/site/docs/maintaining/index.html +14 -29
- data/site/docs/maintaining/merging-a-pull-request/index.html +12 -28
- data/site/docs/maintaining/releasing-a-new-version/index.html +761 -0
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +8 -24
- data/site/docs/maintaining/special-labels/index.html +8 -24
- data/site/docs/maintaining/triaging-an-issue/index.html +8 -24
- data/site/docs/migrations/index.html +8 -24
- data/site/docs/pages/index.html +8 -24
- data/site/docs/pagination/index.html +8 -24
- data/site/docs/permalinks/index.html +16 -32
- data/site/docs/plugins/index.html +27 -104
- data/site/docs/posts/index.html +34 -27
- data/site/docs/quickstart/index.html +8 -24
- data/site/docs/resources/index.html +14 -26
- data/site/docs/sites/index.html +8 -24
- data/site/docs/static-files/index.html +8 -24
- data/site/docs/structure/index.html +8 -24
- data/site/docs/support/index.html +8 -24
- data/site/docs/templates/index.html +36 -24
- data/site/docs/themes/index.html +50 -29
- data/site/docs/troubleshooting/index.html +68 -34
- data/site/docs/upgrading/0-to-2/index.html +8 -24
- data/site/docs/upgrading/2-to-3/index.html +8 -24
- data/site/docs/upgrading/index.html +8 -24
- data/site/docs/usage/index.html +8 -24
- data/site/docs/variables/index.html +9 -25
- data/site/docs/windows/index.html +14 -25
- data/site/feed.xml +49 -82
- data/site/help/index.html +7 -23
- data/site/index.html +7 -23
- data/site/jekyllconf/index.html +7 -23
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +27 -30
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +27 -30
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +27 -30
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +27 -30
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +27 -30
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +27 -30
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +27 -30
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +27 -30
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +27 -30
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +27 -30
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +27 -30
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +27 -30
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +27 -30
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +27 -30
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +27 -30
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +27 -30
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +27 -30
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +27 -30
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +27 -30
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +27 -30
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +27 -30
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +27 -30
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +27 -30
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +27 -30
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +27 -30
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +27 -30
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +27 -30
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +27 -30
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +27 -30
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +27 -30
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +27 -30
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +27 -30
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +27 -30
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +27 -30
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +27 -30
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +27 -30
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +27 -30
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +27 -30
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +27 -30
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +27 -30
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +27 -30
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +27 -30
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +27 -30
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +27 -30
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +27 -30
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +27 -30
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +27 -30
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +27 -30
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +27 -30
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +27 -30
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +27 -30
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +27 -30
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +27 -30
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +27 -30
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +27 -30
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +27 -30
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -30
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +27 -30
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +27 -30
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +27 -30
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +27 -30
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +27 -30
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +27 -30
- data/site/news/2017/10/19/diversity-open-source/index.html +31 -34
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +27 -30
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +27 -30
- data/site/news/2018/01/25/{jekyll-3-7-1-released → jekyll-3-7-2-released}/index.html +35 -37
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +628 -0
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +604 -0
- data/site/news/index.html +265 -168
- data/site/news/releases/index.html +185 -150
- data/site/sitemap.xml +78 -59
- data/site/team/index.html +258 -0
- data/site/tutorials/convert-site-to-jekyll/index.html +19 -25
- data/site/tutorials/custom-404-page/index.html +16 -24
- data/site/tutorials/home/index.html +16 -24
- data/site/tutorials/navigation/index.html +23 -28
- data/site/tutorials/orderofinterpretation/index.html +16 -24
- data/site/tutorials/using-jekyll-with-bundler/index.html +424 -0
- data/site/tutorials/video-walkthroughs/index.html +16 -24
- metadata +11 -6
|
@@ -3,16 +3,17 @@
|
|
|
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.8.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
|
-
<link rel="
|
|
9
|
+
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
10
|
+
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
|
10
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
11
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
14
|
<!-- Begin Jekyll SEO tag v2.4.0 -->
|
|
14
15
|
<title>Upgrading | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.8.0" />
|
|
16
17
|
<meta property="og:title" content="Upgrading" />
|
|
17
18
|
<meta property="og:locale" content="en_US" />
|
|
18
19
|
<meta name="description" content="Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:" />
|
|
@@ -21,12 +22,12 @@
|
|
|
21
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/upgrading/" />
|
|
22
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
23
24
|
<meta property="og:type" content="article" />
|
|
24
|
-
<meta property="article:published_time" content="2018-
|
|
25
|
+
<meta property="article:published_time" content="2018-05-01T13:26:35-07:00" />
|
|
25
26
|
<meta name="twitter:card" content="summary" />
|
|
26
27
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
27
28
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
28
29
|
<script type="application/ld+json">
|
|
29
|
-
{"
|
|
30
|
+
{"description":"Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:","@type":"BlogPosting","url":"https://jekyllrb.com/docs/upgrading/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Upgrading","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/"},"@context":"http://schema.org"}</script>
|
|
30
31
|
<!-- End Jekyll SEO tag -->
|
|
31
32
|
|
|
32
33
|
<!--[if lt IE 9]>
|
|
@@ -71,7 +72,7 @@
|
|
|
71
72
|
<div class="meta hide-on-mobiles">
|
|
72
73
|
<ul>
|
|
73
74
|
<li>
|
|
74
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
75
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
|
|
75
76
|
</li>
|
|
76
77
|
<li>
|
|
77
78
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -680,28 +681,11 @@ gem</a>.</p>
|
|
|
680
681
|
</script>
|
|
681
682
|
|
|
682
683
|
|
|
683
|
-
<!-- Gauges (http://get.gaug.es/) -->
|
|
684
|
-
<script>
|
|
685
|
-
var _gauges = _gauges || [];
|
|
686
|
-
(function() {
|
|
687
|
-
var t = document.createElement('script');
|
|
688
|
-
t.type = 'text/javascript';
|
|
689
|
-
t.async = true;
|
|
690
|
-
t.id = 'gauges-tracker';
|
|
691
|
-
t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
|
|
692
|
-
t.src = '//secure.gaug.es/track.js';
|
|
693
|
-
var s = document.getElementsByTagName('script')[0];
|
|
694
|
-
s.parentNode.insertBefore(t, s);
|
|
695
|
-
})();
|
|
696
|
-
</script>
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
684
|
<!-- Google Analytics (https://www.google.com/analytics) -->
|
|
701
685
|
<script>
|
|
702
686
|
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
|
703
687
|
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
|
704
|
-
L=e.getElementsByTagName(k)[0],l.src='
|
|
688
|
+
L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
|
|
705
689
|
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
|
706
690
|
|
|
707
691
|
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
data/site/docs/usage/index.html
CHANGED
|
@@ -3,16 +3,17 @@
|
|
|
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.8.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
|
-
<link rel="
|
|
9
|
+
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
10
|
+
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
|
10
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
11
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
14
|
<!-- Begin Jekyll SEO tag v2.4.0 -->
|
|
14
15
|
<title>Basic Usage | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.8.0" />
|
|
16
17
|
<meta property="og:title" content="Basic Usage" />
|
|
17
18
|
<meta property="og:locale" content="en_US" />
|
|
18
19
|
<meta name="description" content="The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:" />
|
|
@@ -21,12 +22,12 @@
|
|
|
21
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/usage/" />
|
|
22
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
23
24
|
<meta property="og:type" content="article" />
|
|
24
|
-
<meta property="article:published_time" content="2018-
|
|
25
|
+
<meta property="article:published_time" content="2018-05-01T13:26:35-07:00" />
|
|
25
26
|
<meta name="twitter:card" content="summary" />
|
|
26
27
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
27
28
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
28
29
|
<script type="application/ld+json">
|
|
29
|
-
{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Basic Usage","dateModified":"2018-
|
|
30
|
+
{"description":"The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:","@type":"BlogPosting","url":"https://jekyllrb.com/docs/usage/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Basic Usage","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/usage/"},"@context":"http://schema.org"}</script>
|
|
30
31
|
<!-- End Jekyll SEO tag -->
|
|
31
32
|
|
|
32
33
|
<!--[if lt IE 9]>
|
|
@@ -71,7 +72,7 @@
|
|
|
71
72
|
<div class="meta hide-on-mobiles">
|
|
72
73
|
<ul>
|
|
73
74
|
<li>
|
|
74
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
75
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
|
|
75
76
|
</li>
|
|
76
77
|
<li>
|
|
77
78
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -686,28 +687,11 @@ jekyll build <span class="nt">--source</span> _source <span class="nt">--destina
|
|
|
686
687
|
</script>
|
|
687
688
|
|
|
688
689
|
|
|
689
|
-
<!-- Gauges (http://get.gaug.es/) -->
|
|
690
|
-
<script>
|
|
691
|
-
var _gauges = _gauges || [];
|
|
692
|
-
(function() {
|
|
693
|
-
var t = document.createElement('script');
|
|
694
|
-
t.type = 'text/javascript';
|
|
695
|
-
t.async = true;
|
|
696
|
-
t.id = 'gauges-tracker';
|
|
697
|
-
t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
|
|
698
|
-
t.src = '//secure.gaug.es/track.js';
|
|
699
|
-
var s = document.getElementsByTagName('script')[0];
|
|
700
|
-
s.parentNode.insertBefore(t, s);
|
|
701
|
-
})();
|
|
702
|
-
</script>
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
690
|
<!-- Google Analytics (https://www.google.com/analytics) -->
|
|
707
691
|
<script>
|
|
708
692
|
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
|
709
693
|
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
|
710
|
-
L=e.getElementsByTagName(k)[0],l.src='
|
|
694
|
+
L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
|
|
711
695
|
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
|
712
696
|
|
|
713
697
|
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
|
@@ -3,16 +3,17 @@
|
|
|
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.8.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
|
-
<link rel="
|
|
9
|
+
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
10
|
+
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
|
10
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
11
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
14
|
<!-- Begin Jekyll SEO tag v2.4.0 -->
|
|
14
15
|
<title>Variables | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.8.0" />
|
|
16
17
|
<meta property="og:title" content="Variables" />
|
|
17
18
|
<meta property="og:locale" content="en_US" />
|
|
18
19
|
<meta name="description" content="Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data." />
|
|
@@ -21,12 +22,12 @@
|
|
|
21
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/variables/" />
|
|
22
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
23
24
|
<meta property="og:type" content="article" />
|
|
24
|
-
<meta property="article:published_time" content="2018-
|
|
25
|
+
<meta property="article:published_time" content="2018-05-01T13:26:35-07:00" />
|
|
25
26
|
<meta name="twitter:card" content="summary" />
|
|
26
27
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
27
28
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
28
29
|
<script type="application/ld+json">
|
|
29
|
-
{"
|
|
30
|
+
{"description":"Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/variables/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Variables","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/variables/"},"@context":"http://schema.org"}</script>
|
|
30
31
|
<!-- End Jekyll SEO tag -->
|
|
31
32
|
|
|
32
33
|
<!--[if lt IE 9]>
|
|
@@ -71,7 +72,7 @@
|
|
|
71
72
|
<div class="meta hide-on-mobiles">
|
|
72
73
|
<ul>
|
|
73
74
|
<li>
|
|
74
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
75
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
|
|
75
76
|
</li>
|
|
76
77
|
<li>
|
|
77
78
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -539,7 +540,7 @@ following is a reference of the available data.</p>
|
|
|
539
540
|
<td><p><code>page.excerpt</code></p></td>
|
|
540
541
|
<td><p>
|
|
541
542
|
|
|
542
|
-
The un-rendered excerpt of
|
|
543
|
+
The un-rendered excerpt of a document.
|
|
543
544
|
|
|
544
545
|
</p></td>
|
|
545
546
|
</tr>
|
|
@@ -1019,28 +1020,11 @@ following is a reference of the available data.</p>
|
|
|
1019
1020
|
</script>
|
|
1020
1021
|
|
|
1021
1022
|
|
|
1022
|
-
<!-- Gauges (http://get.gaug.es/) -->
|
|
1023
|
-
<script>
|
|
1024
|
-
var _gauges = _gauges || [];
|
|
1025
|
-
(function() {
|
|
1026
|
-
var t = document.createElement('script');
|
|
1027
|
-
t.type = 'text/javascript';
|
|
1028
|
-
t.async = true;
|
|
1029
|
-
t.id = 'gauges-tracker';
|
|
1030
|
-
t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
|
|
1031
|
-
t.src = '//secure.gaug.es/track.js';
|
|
1032
|
-
var s = document.getElementsByTagName('script')[0];
|
|
1033
|
-
s.parentNode.insertBefore(t, s);
|
|
1034
|
-
})();
|
|
1035
|
-
</script>
|
|
1036
|
-
|
|
1037
|
-
|
|
1038
|
-
|
|
1039
1023
|
<!-- Google Analytics (https://www.google.com/analytics) -->
|
|
1040
1024
|
<script>
|
|
1041
1025
|
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
|
1042
1026
|
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
|
1043
|
-
L=e.getElementsByTagName(k)[0],l.src='
|
|
1027
|
+
L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
|
|
1044
1028
|
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
|
1045
1029
|
|
|
1046
1030
|
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
|
@@ -3,16 +3,17 @@
|
|
|
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.8.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
|
-
<link rel="
|
|
9
|
+
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
10
|
+
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
|
10
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
11
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
14
|
<!-- Begin Jekyll SEO tag v2.4.0 -->
|
|
14
15
|
<title>Jekyll on Windows | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.8.0" />
|
|
16
17
|
<meta property="og:title" content="Jekyll on Windows" />
|
|
17
18
|
<meta property="og:locale" content="en_US" />
|
|
18
19
|
<meta name="description" content="While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users." />
|
|
@@ -21,12 +22,12 @@
|
|
|
21
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/windows/" />
|
|
22
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
23
24
|
<meta property="og:type" content="article" />
|
|
24
|
-
<meta property="article:published_time" content="2018-
|
|
25
|
+
<meta property="article:published_time" content="2018-05-01T13:26:35-07:00" />
|
|
25
26
|
<meta name="twitter:card" content="summary" />
|
|
26
27
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
27
28
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
28
29
|
<script type="application/ld+json">
|
|
29
|
-
{"
|
|
30
|
+
{"description":"While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/windows/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Jekyll on Windows","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/windows/"},"@context":"http://schema.org"}</script>
|
|
30
31
|
<!-- End Jekyll SEO tag -->
|
|
31
32
|
|
|
32
33
|
<!--[if lt IE 9]>
|
|
@@ -71,7 +72,7 @@
|
|
|
71
72
|
<div class="meta hide-on-mobiles">
|
|
72
73
|
<ul>
|
|
73
74
|
<li>
|
|
74
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
75
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
|
|
75
76
|
</li>
|
|
76
77
|
<li>
|
|
77
78
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -315,7 +316,7 @@
|
|
|
315
316
|
|
|
316
317
|
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-add-repository ppa:brightbox/ruby-ng
|
|
317
318
|
<span class="nb">sudo </span>apt-get update
|
|
318
|
-
<span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby2.3 ruby2.3-dev build-essential
|
|
319
|
+
<span class="nb">sudo </span>apt-get <span class="nb">install </span>ruby2.3 ruby2.3-dev build-essential dh-autoreconf
|
|
319
320
|
</code></pre></div></div>
|
|
320
321
|
|
|
321
322
|
<p>Next let’s update our Ruby gems:</p>
|
|
@@ -342,6 +343,11 @@
|
|
|
342
343
|
|
|
343
344
|
<p>You can make sure time management is working properly by inspecting your <code class="highlighter-rouge">_posts</code> folder. You should see a markdown file with the current date in the filename.</p>
|
|
344
345
|
|
|
346
|
+
<div class="note info">
|
|
347
|
+
<h5>Non-superuser account issues</h5>
|
|
348
|
+
<p>If the `jekyll new` command prints the error "Your user account isn't allowed to install to the system RubyGems", see the "Running Jekyll as Non-Superuser" instructions in <a href="/docs/troubleshooting/#no-sudo">Troubleshooting</a>.</p>
|
|
349
|
+
</div>
|
|
350
|
+
|
|
345
351
|
<p><strong>Note:</strong> Bash on Ubuntu on Windows is still under development, so you may run into issues.</p>
|
|
346
352
|
|
|
347
353
|
<h3 id="installation-via-rubyinstaller">Installation via RubyInstaller</h3>
|
|
@@ -752,28 +758,11 @@ While ‘new’ blogs created with Jekyll v3.4 and greater, will have the follow
|
|
|
752
758
|
</script>
|
|
753
759
|
|
|
754
760
|
|
|
755
|
-
<!-- Gauges (http://get.gaug.es/) -->
|
|
756
|
-
<script>
|
|
757
|
-
var _gauges = _gauges || [];
|
|
758
|
-
(function() {
|
|
759
|
-
var t = document.createElement('script');
|
|
760
|
-
t.type = 'text/javascript';
|
|
761
|
-
t.async = true;
|
|
762
|
-
t.id = 'gauges-tracker';
|
|
763
|
-
t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
|
|
764
|
-
t.src = '//secure.gaug.es/track.js';
|
|
765
|
-
var s = document.getElementsByTagName('script')[0];
|
|
766
|
-
s.parentNode.insertBefore(t, s);
|
|
767
|
-
})();
|
|
768
|
-
</script>
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
761
|
<!-- Google Analytics (https://www.google.com/analytics) -->
|
|
773
762
|
<script>
|
|
774
763
|
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
|
775
764
|
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
|
776
|
-
L=e.getElementsByTagName(k)[0],l.src='
|
|
765
|
+
L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
|
|
777
766
|
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
|
778
767
|
|
|
779
768
|
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
data/site/feed.xml
CHANGED
|
@@ -1,8 +1,53 @@
|
|
|
1
|
-
<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.
|
|
1
|
+
<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.8.0">Jekyll</generator><link href="https://jekyllrb.com/feed.xml" rel="self" type="application/atom+xml" /><link href="https://jekyllrb.com/" rel="alternate" type="text/html" /><updated>2018-05-01T13:26:35-07:00</updated><id>https://jekyllrb.com/</id><title type="html">Jekyll • Simple, blog-aware, static sites</title><subtitle>Transform your plain text into static websites and blogs</subtitle><entry><title type="html">Jekyll 3.7.3 Released</title><link href="https://jekyllrb.com/news/2018/02/24/jekyll-3-7-3-released/" rel="alternate" type="text/html" title="Jekyll 3.7.3 Released" /><published>2018-02-24T23:32:08-08:00</published><updated>2018-02-24T23:32:08-08:00</updated><id>https://jekyllrb.com/news/2018/02/24/jekyll-3-7-3-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/02/24/jekyll-3-7-3-released/"><p>Hello Jekyllers!! :wave:</p>
|
|
2
|
+
|
|
3
|
+
<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
|
|
4
|
+
Jekyll plugin that in turn uses the <code class="highlighter-rouge">I18n</code> library.</p>
|
|
5
|
+
|
|
6
|
+
<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
|
|
7
|
+
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
|
|
8
|
+
any locale. This led to issues with third-party i18n plugins for Jekyll, especially since the default locale got assigned before
|
|
9
|
+
the plugin was loaded, irrespective of whether the <code class="highlighter-rouge">slugify</code> filter was used.</p>
|
|
10
|
+
|
|
11
|
+
<p>Jekyll will henceforth set the default locale if and only if necessary.</p></content><author><name>ashmaroli</name></author><summary type="html">Hello Jekyllers!! :wave:</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry><entry><title type="html">Meet Jekyll’s New Lead Developer</title><link href="https://jekyllrb.com/news/2018/02/19/meet-jekyll-s-new-lead-developer/" rel="alternate" type="text/html" title="Meet Jekyll's New Lead Developer" /><published>2018-02-19T17:48:09-08:00</published><updated>2018-02-19T17:48:09-08:00</updated><id>https://jekyllrb.com/news/2018/02/19/meet-jekyll-s-new-lead-developer</id><content type="html" xml:base="https://jekyllrb.com/news/2018/02/19/meet-jekyll-s-new-lead-developer/"><p>Jekyll has a new Lead Developer: <a href="https://liv.cat/">Olivia</a>!</p>
|
|
12
|
+
|
|
13
|
+
<p>After over 5 years of leading Jekyll, many releases from 0.12.1 to 3.6.0, and
|
|
14
|
+
countless conversations in GitHub Issues, Pull Requests, Jekyll Talk, and
|
|
15
|
+
more, I am passing on the torch as Lead Developer of Jekyll.</p>
|
|
16
|
+
|
|
17
|
+
<p>Olivia has been working with the Jekyll community for some time now. You
|
|
18
|
+
may have seen her around in issues and pull requests on the various Jekyll
|
|
19
|
+
repositories. She started as a contributor, then joined the Core team as our
|
|
20
|
+
community lead. Olivia joined the Jekyll Core Team with experience in the
|
|
21
|
+
Node.js community, both online and as a volunteer organizer with JSConf EU.</p>
|
|
22
|
+
|
|
23
|
+
<p>In my conversations with Olivia, it is clear that Jekyll’s vision of
|
|
24
|
+
simplicity for the user (<a href="/philosophy#1-no-magic">no magic!</a>) and letting
|
|
25
|
+
users’ <a href="/philosophy#3-content-is-king">content be king</a> will remain a top
|
|
26
|
+
priority. In just the last few weeks as the transition has been occurring,
|
|
27
|
+
we have seen some incredible work on performance that will make future
|
|
28
|
+
versions of Jekyll work better at scale. She will be prioritizing work on
|
|
29
|
+
innovative improvements to make Jekyll that much better for all of us.
|
|
30
|
+
Olivia balances an eye for quality with the need for shipping well.</p>
|
|
31
|
+
|
|
32
|
+
<p>When Tom Preston-Werner met me at GitHub HQ 2.0 in January 2013 to pass on
|
|
33
|
+
the torch, I could never have dreamed of all the amazing experiences this
|
|
34
|
+
community would share with me over the next 5 years. From visiting @qrush
|
|
35
|
+
in Buffalo, NY for a hack night on Jekyll to attending a Jekyll planning
|
|
36
|
+
session hosted by @benbalter at GitHub to Google Summer of Code which gave
|
|
37
|
+
us jekyll-admin, I am eternally grateful to all of you for the opportunity
|
|
38
|
+
to lead this excellent community. I’m confident Olivia will continue to
|
|
39
|
+
lead Jekyll to even greater heights.</p>
|
|
40
|
+
|
|
41
|
+
<p>As always, Happy Jekylling!</p>
|
|
42
|
+
|
|
43
|
+
<p>Parker</p>
|
|
44
|
+
|
|
45
|
+
<p><em>Curious about who else runs this show? <a href="/team/">Check out our excellent team.</a></em></p></content><author><name>parkr</name></author><summary type="html">Jekyll has a new Lead Developer: Olivia!</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry><entry><title type="html">Jekyll 3.7.2 Released</title><link href="https://jekyllrb.com/news/2018/01/25/jekyll-3-7-2-released/" rel="alternate" type="text/html" title="Jekyll 3.7.2 Released" /><published>2018-01-25T08:52:22-08:00</published><updated>2018-01-25T08:52:22-08:00</updated><id>https://jekyllrb.com/news/2018/01/25/jekyll-3-7-2-released</id><content type="html" xml:base="https://jekyllrb.com/news/2018/01/25/jekyll-3-7-2-released/"><p>Close on the heels of shipping 3.7.0, we were informed of a couple of
|
|
2
46
|
regressions due to the changes made in that release. In due time, Team Jekyll
|
|
3
47
|
set out to address those issues as early as possible.</p>
|
|
4
48
|
|
|
5
|
-
<p>Days later here we’re, announcing 3.7.
|
|
49
|
+
<p>Days later here we’re, announcing 3.7.2 (sorry for skipping 3.7.1,
|
|
50
|
+
RubyGems didn’t want to play nice) that fixes numerous issues! :tada:
|
|
6
51
|
The highlights being:</p>
|
|
7
52
|
|
|
8
53
|
<ul>
|
|
@@ -164,7 +209,7 @@ today.</p>
|
|
|
164
209
|
|
|
165
210
|
<p>I know this is a cliche and a overused phrase, but really, it works if you pull through with it. Come to terms with the fact that some people aren’t as fast or reliable as you might want to think. Don’t get angry when a contributor takes a day longer than you might like them to. Treat new contributors to your project with respect, but also with hospitality. Think twice before you send that comment with slurs in it.</p>
|
|
166
211
|
|
|
167
|
-
<p>I’ve been contributing to open source for about 4 years now, and I’ve had my fair share of horrible, horrible experiences. But Jekyll has historically been a project that has always valued the people contributing to it over the code itself, and I hope we can keep it that way. I also hope that other project maintainers read this and take inspiration from this post. Every project should be more diverse.</p></content><author><name>
|
|
212
|
+
<p>I’ve been contributing to open source for about 4 years now, and I’ve had my fair share of horrible, horrible experiences. But Jekyll has historically been a project that has always valued the people contributing to it over the code itself, and I hope we can keep it that way. I also hope that other project maintainers read this and take inspiration from this post. Every project should be more diverse.</p></content><author><name>oe</name></author><summary type="html">Open Source has a problem with diversity. GitHub recently conducted a survey which revealed that 95% of the respondents were identifying as male. This is even worse than in the tech industry overall, where the percentage is only about 76%. Every other week, there seems to be another case of a maintainer engaging in targeted harassment against minorities. People somehow deem it completely okay to let these things slide, though.</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry><entry><title type="html">Jekyll turns 3.6!</title><link href="https://jekyllrb.com/news/2017/09/21/jekyll-3-6-0-released/" rel="alternate" type="text/html" title="Jekyll turns 3.6!" /><published>2017-09-21T13:38:20-07:00</published><updated>2017-09-21T13:38:20-07:00</updated><id>https://jekyllrb.com/news/2017/09/21/jekyll-3-6-0-released</id><content type="html" xml:base="https://jekyllrb.com/news/2017/09/21/jekyll-3-6-0-released/"><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>
|
|
168
213
|
|
|
169
214
|
<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>
|
|
170
215
|
|
|
@@ -231,82 +276,4 @@ Thank you, all!</p>
|
|
|
231
276
|
bugs. Better yet, submit a patch if you find the bug in the code and know
|
|
232
277
|
how to fix it! :heart:</p>
|
|
233
278
|
|
|
234
|
-
<p>Happy Jekylling! :tada:</p></content><author><name>parkr</name></author><summary type="html">Good news! Nearly 400 commits later, Jekyll 3.5.0 has been released into the wild. Some new shiny things you might want to test out:</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry
|
|
235
|
-
fairly technical debriefing follows, but the TLDR is that we have updated the
|
|
236
|
-
<code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
|
|
237
|
-
|
|
238
|
-
<p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
|
|
239
|
-
moved away from using the deprecated
|
|
240
|
-
<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>
|
|
241
|
-
in favor of
|
|
242
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
|
|
243
|
-
This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
|
|
244
|
-
filter</a>.</p>
|
|
245
|
-
|
|
246
|
-
<p>While this transition was mostly a smooth one, the two methods are not
|
|
247
|
-
identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
|
|
248
|
-
<code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
|
|
249
|
-
object, and will then escape each component of that object. In most cases, this
|
|
250
|
-
difference was insignificant, but there were a few cases where this caused some
|
|
251
|
-
unintended regressions when encoding colons.</p>
|
|
252
|
-
|
|
253
|
-
<p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
|
|
254
|
-
relative URI, without the slash it cannot figure out how to turn
|
|
255
|
-
<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
|
|
256
|
-
objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
|
|
257
|
-
but breaking in 3.4.0:</p>
|
|
258
|
-
|
|
259
|
-
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"example :page"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">uri_escape</span><span class="w"> </span><span class="p">}}</span>
|
|
260
|
-
</code></pre></div></div>
|
|
261
|
-
|
|
262
|
-
<p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
|
|
263
|
-
|
|
264
|
-
<p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
|
|
265
|
-
<a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
|
|
266
|
-
which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
|
|
267
|
-
|
|
268
|
-
<p>Thanks to @cameronmcefee and @FriesFlorian for reporting
|
|
269
|
-
<a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
|
|
270
|
-
|
|
271
|
-
<p>Happy Jekylling!</p></content><author><name>pathawks</name></author><summary type="html">Another one-PR patch update as we continue our quest to destroy all bugs. A fairly technical debriefing follows, but the TLDR is that we have updated the uri_escape filter to more closely follow the pre-v3.4.0 behavior.</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry><entry><title type="html">Jekyll 3.4.2 Released</title><link href="https://jekyllrb.com/news/2017/03/09/jekyll-3-4-2-released/" rel="alternate" type="text/html" title="Jekyll 3.4.2 Released" /><published>2017-03-09T12:41:57-08:00</published><updated>2017-03-09T12:41:57-08:00</updated><id>https://jekyllrb.com/news/2017/03/09/jekyll-3-4-2-released</id><content type="html" xml:base="https://jekyllrb.com/news/2017/03/09/jekyll-3-4-2-released/"><p>Another one-PR patch update, though without the same <a href="/news/2017/03/02/jekyll-3-4-1-released/">lessons as for the
|
|
272
|
-
previous release</a>.</p>
|
|
273
|
-
|
|
274
|
-
<p>This release includes a beneficial change for a number of plugins:
|
|
275
|
-
<strong>static files now respect front matter defaults</strong>.</p>
|
|
276
|
-
|
|
277
|
-
<p>You might be asking yourself: “why would static files, files that are
|
|
278
|
-
static files explicitly because they <em>don’t</em> have YAML front matter, want
|
|
279
|
-
to respect YAML front matter?” That’s a great question. Let me illustrate
|
|
280
|
-
with an example.</p>
|
|
281
|
-
|
|
282
|
-
<p>Let’s look at <code class="highlighter-rouge">jekyll-sitemap</code>. This plugin generates a list of documents,
|
|
283
|
-
pages, and static files, and some metadata for them in an XML file for a
|
|
284
|
-
Google/Yahoo/Bing/DuckDuckGo crawler to consume. If you don’t want a given
|
|
285
|
-
file in this list, you set <code class="highlighter-rouge">sitemap: false</code> in the YAML front matter. But
|
|
286
|
-
what about static files, which don’t have YAML front matter? Before this
|
|
287
|
-
release, they could not be excluded because they had no properties in YAML
|
|
288
|
-
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>.
|
|
289
|
-
So if you had a PDF you didn’t want to be in your sitemap, you couldn’t use
|
|
290
|
-
<code class="highlighter-rouge">jekyll-sitemap</code>.</p>
|
|
291
|
-
|
|
292
|
-
<p>With this release, you can now set <a href="/docs/configuration/#front-matter-defaults">front matter
|
|
293
|
-
defaults</a> for static files:</p>
|
|
294
|
-
|
|
295
|
-
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
|
|
296
|
-
<span class="pi">-</span>
|
|
297
|
-
<span class="na">scope</span><span class="pi">:</span>
|
|
298
|
-
<span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">pdfs/"</span>
|
|
299
|
-
<span class="na">values</span><span class="pi">:</span>
|
|
300
|
-
<span class="na">sitemap</span><span class="pi">:</span> <span class="no">false</span>
|
|
301
|
-
</code></pre></div></div>
|
|
302
|
-
|
|
303
|
-
<p>Now, for every file in the Liquid <code class="highlighter-rouge">site.static_files</code> loop which is in the
|
|
304
|
-
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>
|
|
305
|
-
|
|
306
|
-
<p>Many thanks to @benbalter for coming up with the solution and ensuring
|
|
307
|
-
sitemaps everywhere are filled with just the right content.</p>
|
|
308
|
-
|
|
309
|
-
<p>As always, if you notice any bugs, please search the issues and file one if
|
|
310
|
-
you can’t find another related to your issue.</p>
|
|
311
|
-
|
|
312
|
-
<p>Happy Jekylling!</p></content><author><name>parkr</name></author><summary type="html">Another one-PR patch update, though without the same lessons as for the previous release.</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry></feed>
|
|
279
|
+
<p>Happy Jekylling! :tada:</p></content><author><name>parkr</name></author><summary type="html">Good news! Nearly 400 commits later, Jekyll 3.5.0 has been released into the wild. Some new shiny things you might want to test out:</summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://jekyllrb.com/img/twitter-card.png" /></entry></feed>
|