jekyll-docs 3.5.2 → 3.6.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (127) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +3 -3
  3. data/site/community/index.html +5 -5
  4. data/site/docs/assets/index.html +14 -22
  5. data/site/docs/code_of_conduct/index.html +730 -0
  6. data/site/docs/collections/index.html +65 -80
  7. data/site/docs/conduct/index.html +4 -4
  8. data/site/docs/configuration/index.html +130 -156
  9. data/site/docs/continuous-integration/buddyworks/index.html +14 -16
  10. data/site/docs/continuous-integration/circleci/index.html +13 -21
  11. data/site/docs/continuous-integration/index.html +5 -5
  12. data/site/docs/continuous-integration/travis-ci/index.html +45 -73
  13. data/site/docs/contributing/index.html +10 -10
  14. data/site/docs/datafiles/index.html +37 -53
  15. data/site/docs/deployment-methods/index.html +54 -64
  16. data/site/docs/drafts/index.html +6 -8
  17. data/site/docs/extras/index.html +8 -12
  18. data/site/docs/frontmatter/index.html +10 -14
  19. data/site/docs/github-pages/index.html +10 -14
  20. data/site/docs/history/index.html +539 -440
  21. data/site/docs/home/index.html +4 -4
  22. data/site/docs/includes/index.html +42 -70
  23. data/site/docs/installation/index.html +23 -37
  24. data/site/docs/maintaining/affinity-team-captain/index.html +4 -4
  25. data/site/docs/maintaining/avoiding-burnout/index.html +4 -4
  26. data/site/docs/maintaining/becoming-a-maintainer/index.html +4 -4
  27. data/site/docs/maintaining/index.html +4 -4
  28. data/site/docs/maintaining/merging-a-pull-request/index.html +6 -8
  29. data/site/docs/maintaining/reviewing-a-pull-request/index.html +4 -4
  30. data/site/docs/maintaining/special-labels/index.html +4 -4
  31. data/site/docs/maintaining/triaging-an-issue/index.html +4 -4
  32. data/site/docs/migrations/index.html +4 -4
  33. data/site/docs/pages/index.html +8 -12
  34. data/site/docs/pagination/index.html +13 -21
  35. data/site/docs/permalinks/index.html +43 -34
  36. data/site/docs/plugins/index.html +51 -79
  37. data/site/docs/posts/index.html +26 -48
  38. data/site/docs/quickstart/index.html +6 -8
  39. data/site/docs/resources/index.html +45 -21
  40. data/site/docs/sites/index.html +4 -4
  41. data/site/docs/static-files/index.html +12 -16
  42. data/site/docs/structure/index.html +6 -8
  43. data/site/docs/templates/index.html +36 -68
  44. data/site/docs/themes/index.html +32 -49
  45. data/site/docs/troubleshooting/index.html +44 -82
  46. data/site/docs/upgrading/0-to-2/index.html +7 -9
  47. data/site/docs/upgrading/2-to-3/index.html +19 -31
  48. data/site/docs/upgrading/index.html +4 -4
  49. data/site/docs/usage/index.html +20 -30
  50. data/site/docs/variables/index.html +26 -10
  51. data/site/docs/windows/index.html +36 -58
  52. data/site/feed.xml +47 -53
  53. data/site/help/index.html +3 -3
  54. data/site/index.html +3 -3
  55. data/site/latest_version.txt +1 -1
  56. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -8
  57. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +16 -8
  58. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +16 -8
  59. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +16 -8
  60. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +16 -8
  61. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -8
  62. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +16 -8
  63. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +16 -8
  64. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +16 -8
  65. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +16 -8
  66. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -8
  67. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +16 -8
  68. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +16 -8
  69. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +16 -8
  70. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -8
  71. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +16 -8
  72. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +16 -8
  73. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +16 -8
  74. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +16 -8
  75. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +16 -8
  76. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -8
  77. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -8
  78. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +16 -8
  79. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +16 -8
  80. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +16 -8
  81. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +16 -8
  82. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +16 -8
  83. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +16 -8
  84. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -8
  85. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +16 -8
  86. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -8
  87. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -8
  88. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -8
  89. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +17 -9
  90. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -8
  91. data/site/news/2015/10/26/jekyll-3-0-released/index.html +16 -8
  92. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +16 -8
  93. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +16 -8
  94. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +16 -8
  95. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +16 -8
  96. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +16 -8
  97. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +16 -8
  98. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -8
  99. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +20 -12
  100. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +16 -8
  101. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -8
  102. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +16 -8
  103. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +16 -8
  104. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +16 -8
  105. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -8
  106. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +16 -8
  107. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +16 -8
  108. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -8
  109. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +16 -8
  110. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +16 -8
  111. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +16 -8
  112. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -29
  113. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +23 -17
  114. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +20 -14
  115. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +21 -13
  116. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -10
  117. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +573 -0
  118. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +565 -0
  119. data/site/news/index.html +122 -48
  120. data/site/news/releases/index.html +122 -48
  121. data/site/sitemap.xml +64 -52
  122. data/site/tutorials/convert-site-to-jekyll/index.html +80 -138
  123. data/site/tutorials/custom-404-page/index.html +13 -21
  124. data/site/tutorials/home/index.html +4 -4
  125. data/site/tutorials/navigation/index.html +144 -180
  126. data/site/tutorials/orderofinterpretation/index.html +27 -45
  127. metadata +8 -5
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Extras | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Extras">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/extras/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Extras","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"There are a number of (optional) extra features that Jekyll supports that you may want to install, depending on how you plan to use Jekyll.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/extras/"},"url":"https://jekyllrb.com/docs/extras/"}</script>
28
+ {"name":null,"description":"There are a number of (optional) extra features that Jekyll supports that you may want to install, depending on how you plan to use Jekyll.","url":"https://jekyllrb.com/docs/extras/","headline":"Extras","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/extras/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -294,10 +294,8 @@ may want to install, depending on how you plan to use Jekyll.</p>
294
294
 
295
295
  <p>Register your site with <a href="https://txtpen.com">txtpen</a>. Then append</p>
296
296
 
297
- <div class="language-html highlighter-rouge">
298
- <pre class="highlight"><code><span class="nt">&lt;script </span><span class="na">src=</span><span class="s">"https://txtpen.com/embed.js?site=&lt;your site name&gt;"</span><span class="nt">&gt;&lt;/script&gt;</span>
299
- </code></pre>
300
- </div>
297
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;script </span><span class="na">src=</span><span class="s">"https://txtpen.com/embed.js?site=&lt;your site name&gt;"</span><span class="nt">&gt;&lt;/script&gt;</span>
298
+ </code></pre></div></div>
301
299
 
302
300
  <p>to your template files in <code class="highlighter-rouge">/_layout</code> folder.</p>
303
301
 
@@ -305,10 +303,8 @@ may want to install, depending on how you plan to use Jekyll.</p>
305
303
 
306
304
  <p>Kramdown comes with optional support for LaTeX to PNG rendering via <a href="https://www.mathjax.org">MathJax</a> within math blocks. See the Kramdown documentation on <a href="http://kramdown.gettalong.org/syntax.html#math-blocks">math blocks</a> and <a href="http://kramdown.gettalong.org/converter/html.html#math-support">math support</a> for more details. MathJax requires you to include JavaScript or CSS to render the LaTeX, e.g.</p>
307
305
 
308
- <div class="language-html highlighter-rouge">
309
- <pre class="highlight"><code><span class="nt">&lt;script </span><span class="na">src=</span><span class="s">"https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML"</span> <span class="na">type=</span><span class="s">"text/javascript"</span><span class="nt">&gt;&lt;/script&gt;</span>
310
- </code></pre>
311
- </div>
306
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;script </span><span class="na">src=</span><span class="s">"https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML"</span> <span class="na">type=</span><span class="s">"text/javascript"</span><span class="nt">&gt;&lt;/script&gt;</span>
307
+ </code></pre></div></div>
312
308
 
313
309
  <p>For more information about getting started, check out <a href="http://gastonsanchez.com/visually-enforced/opinion/2014/02/16/Mathjax-with-jekyll/">this excellent blog post</a>.</p>
314
310
 
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Front Matter | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Front Matter">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/frontmatter/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Front Matter","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"The front matter is where Jekyll starts to get really cool. Any file that contains a YAML front matter block will be processed by Jekyll as a special file. The front matter must be the first thing in the file and must take the form of valid YAML set between triple-dashed lines. Here is a basic example:","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/frontmatter/"},"url":"https://jekyllrb.com/docs/frontmatter/"}</script>
28
+ {"name":null,"description":"The front matter is where Jekyll starts to get really cool. Any file that contains a YAML front matter block will be processed by Jekyll as a special file. The front matter must be the first thing in the file and must take the form of valid YAML set between triple-dashed lines. Here is a basic example:","url":"https://jekyllrb.com/docs/frontmatter/","headline":"Front Matter","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/frontmatter/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -293,13 +293,11 @@ Jekyll as a special file. The front matter must be the first thing in the file
293
293
  and must take the form of valid YAML set between triple-dashed lines. Here is a
294
294
  basic example:</p>
295
295
 
296
- <div class="language-yaml highlighter-rouge">
297
- <pre class="highlight"><code><span class="nn">---</span>
298
- <span class="s">layout</span><span class="pi">:</span> <span class="s">post</span>
299
- <span class="s">title</span><span class="pi">:</span> <span class="s">Blogging Like a Hacker</span>
296
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
297
+ <span class="na">layout</span><span class="pi">:</span> <span class="s">post</span>
298
+ <span class="na">title</span><span class="pi">:</span> <span class="s">Blogging Like a Hacker</span>
300
299
  <span class="nn">---</span>
301
- </code></pre>
302
- </div>
300
+ </code></pre></div></div>
303
301
 
304
302
  <p>Between these triple-dashed lines, you can set predefined variables (see below
305
303
  for a reference) or even create custom ones of your own. These variables will
@@ -400,16 +398,14 @@ data that is sent to the Liquid templating engine during the conversion. For
400
398
  instance, if you set a title, you can use that in your layout to set the page
401
399
  title:</p>
402
400
 
403
- <div class="language-html highlighter-rouge">
404
- <pre class="highlight"><code><span class="cp">&lt;!DOCTYPE HTML&gt;</span>
401
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;!DOCTYPE HTML&gt;</span>
405
402
  <span class="nt">&lt;html&gt;</span>
406
403
  <span class="nt">&lt;head&gt;</span>
407
404
  <span class="nt">&lt;title&gt;</span>{{ page.title }}<span class="nt">&lt;/title&gt;</span>
408
405
  <span class="nt">&lt;/head&gt;</span>
409
406
  <span class="nt">&lt;body&gt;</span>
410
407
  ...
411
- </code></pre>
412
- </div>
408
+ </code></pre></div></div>
413
409
 
414
410
  <h2 id="predefined-variables-for-posts">Predefined Variables for Posts</h2>
415
411
 
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>GitHub Pages | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="GitHub Pages">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/github-pages/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"GitHub Pages","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"GitHub Pages are public web pages for users, organizations, and repositories, that are freely hosted on GitHub’s github.io domain or on a custom domain name of your choice. GitHub Pages are powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/github-pages/"},"url":"https://jekyllrb.com/docs/github-pages/"}</script>
28
+ {"name":null,"description":"GitHub Pages are public web pages for users, organizations, and repositories, that are freely hosted on GitHub’s github.io domain or on a custom domain name of your choice. GitHub Pages are powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free.","url":"https://jekyllrb.com/docs/github-pages/","headline":"GitHub Pages","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/github-pages/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -303,15 +303,13 @@ This guide will teach you what you need to know about Git, GitHub, and Jekyll to
303
303
  branch to GitHub. However, the subdirectory-like URL structure GitHub uses for
304
304
  Project Pages complicates the proper resolution of URLs. In order to assure your site builds properly, use <code class="highlighter-rouge">site.github.url</code> in your URLs.</p>
305
305
 
306
- <div class="language-html highlighter-rouge">
307
- <pre class="highlight"><code>
306
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
308
307
  <span class="c">&lt;!-- Useful for styles with static names... --&gt;</span>
309
308
  <span class="nt">&lt;link</span> <span class="na">href=</span><span class="s">"{{ site.github.url }}/path/to/css.css"</span> <span class="na">rel=</span><span class="s">"stylesheet"</span><span class="nt">&gt;</span>
310
309
  <span class="c">&lt;!-- and for documents/pages whose URLs can change... --&gt;</span>
311
310
  [{{ page.title }}]("{{ page.url | prepend: site.github.url }}")
312
311
 
313
- </code></pre>
314
- </div>
312
+ </code></pre></div></div>
315
313
 
316
314
  <p>This way you can preview your site locally from the site root on localhost,
317
315
  but when GitHub generates your pages from the gh-pages branch all the URLs
@@ -342,15 +340,14 @@ following to your <code class="highlighter-rouge">Gemfile</code>:</p>
342
340
  <div></div>
343
341
 
344
342
  <div class="language-ruby highlighter-rouge">
345
- <pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
343
+ <div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
346
344
 
347
345
  <span class="nb">require</span> <span class="s1">'json'</span>
348
346
  <span class="nb">require</span> <span class="s1">'open-uri'</span>
349
347
  <span class="n">versions</span> <span class="o">=</span> <span class="no">JSON</span><span class="p">.</span><span class="nf">parse</span><span class="p">(</span><span class="nb">open</span><span class="p">(</span><span class="s1">'https://pages.github.com/versions.json'</span><span class="p">).</span><span class="nf">read</span><span class="p">)</span>
350
348
 
351
349
  <span class="n">gem</span> <span class="s1">'github-pages'</span><span class="p">,</span> <span class="n">versions</span><span class="p">[</span><span class="s1">'github-pages'</span><span class="p">]</span>
352
- </code></pre>
353
- </div>
350
+ </code></pre></div> </div>
354
351
  </div>
355
352
 
356
353
  <p>This will ensure that when you run <code class="highlighter-rouge">bundle install</code>, you
@@ -362,11 +359,10 @@ have the correct version of the <code class="highlighter-rouge">github-pages</co
362
359
  <div></div>
363
360
 
364
361
  <div class="language-ruby highlighter-rouge">
365
- <pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
362
+ <div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
366
363
 
367
364
  <span class="n">gem</span> <span class="s1">'github-pages'</span>
368
- </code></pre>
369
- </div>
365
+ </code></pre></div> </div>
370
366
  </div>
371
367
 
372
368
  <p>And be sure to run <code class="highlighter-rouge">bundle update</code> often.</p>
@@ -4,28 +4,28 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>History | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="History">
16
16
  <meta property="og:locale" content="en_US">
17
- <meta name="description" content="3.5.1 / 2017-07-17">
18
- <meta property="og:description" content="3.5.1 / 2017-07-17">
17
+ <meta name="description" content="3.6.0 / 2017-09-21">
18
+ <meta property="og:description" content="3.6.0 / 2017-09-21">
19
19
  <link rel="canonical" href="https://jekyllrb.com/docs/history/">
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/history/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"History","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"3.5.1 / 2017-07-17","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/history/"},"url":"https://jekyllrb.com/docs/history/"}</script>
28
+ {"name":null,"description":"3.6.0 / 2017-09-21","url":"https://jekyllrb.com/docs/history/","headline":"History","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/history/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -287,7 +287,106 @@
287
287
  <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/history.md"><i class="fa fa-pencil"></i>  Improve this page</a>
288
288
  </div>
289
289
  <h1>History</h1>
290
- <h2 id="v3-5-1">3.5.1 / 2017-07-17</h2>
290
+ <h2 id="v3-6-0">3.6.0 / 2017-09-21</h2>
291
+
292
+ <h3 id="minor-enhancements-v3-6-0">Minor Enhancements</h3>
293
+
294
+ <ul>
295
+ <li>Ignore final newline in folded YAML string (<a href="https://github.com/jekyll/jekyll/issues/6054">#6054</a>)</li>
296
+ <li>Add URL checks to Doctor (<a href="https://github.com/jekyll/jekyll/issues/5760">#5760</a>)</li>
297
+ <li>Fix serving files that clash with directories (<a href="https://github.com/jekyll/jekyll/issues/6222">#6222</a>) (<a href="https://github.com/jekyll/jekyll/issues/6231">#6231</a>)</li>
298
+ <li>Bump supported Ruby version to <code class="highlighter-rouge">&gt;= 2.1.0</code> (<a href="https://github.com/jekyll/jekyll/issues/6220">#6220</a>)</li>
299
+ <li>set <code class="highlighter-rouge">LiquidError#template_name</code> for errors in included file (<a href="https://github.com/jekyll/jekyll/issues/6206">#6206</a>)</li>
300
+ <li>Access custom config array throughout session (<a href="https://github.com/jekyll/jekyll/issues/6200">#6200</a>)</li>
301
+ <li>Add support for Rouge 2, in addition to Rouge 1 (<a href="https://github.com/jekyll/jekyll/issues/5919">#5919</a>)</li>
302
+ <li>Allow <code class="highlighter-rouge">yield</code> to logger methods &amp; bail early on no-op messages (<a href="https://github.com/jekyll/jekyll/issues/6315">#6315</a>)</li>
303
+ <li>Update mime-types. (<a href="https://github.com/jekyll/jekyll/issues/6336">#6336</a>)</li>
304
+ <li>Use a Schwartzian transform with custom sorting (<a href="https://github.com/jekyll/jekyll/issues/6342">#6342</a>)</li>
305
+ <li>Alias <code class="highlighter-rouge">Drop#invoke_drop</code> to <code class="highlighter-rouge">Drop#[]</code> (<a href="https://github.com/jekyll/jekyll/issues/6338">#6338</a>)</li>
306
+ </ul>
307
+
308
+ <h3 id="bug-fixes-v3-6-0">Bug Fixes</h3>
309
+
310
+ <ul>
311
+ <li>
312
+ <code class="highlighter-rouge">Deprecator</code>: fix typo for <code class="highlighter-rouge">--serve</code> command (<a href="https://github.com/jekyll/jekyll/issues/6229">#6229</a>)</li>
313
+ <li>
314
+ <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (<a href="https://github.com/jekyll/jekyll/issues/6226">#6226</a>)</li>
315
+ <li>kramdown: symbolize keys in-place (<a href="https://github.com/jekyll/jekyll/issues/6247">#6247</a>)</li>
316
+ <li>Call <code class="highlighter-rouge">to_s</code> on site.url before attempting to concatenate strings (<a href="https://github.com/jekyll/jekyll/issues/6253">#6253</a>)</li>
317
+ <li>Enforce Style/FrozenStringLiteralComment (<a href="https://github.com/jekyll/jekyll/issues/6265">#6265</a>)</li>
318
+ <li>Update theme-template README to note &amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>;assets&amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>; directory (<a href="https://github.com/jekyll/jekyll/issues/6257">#6257</a>)</li>
319
+ <li>Memoize the return value of <code class="highlighter-rouge">Document#url</code> (<a href="https://github.com/jekyll/jekyll/issues/6266">#6266</a>)</li>
320
+ <li>delegate <code class="highlighter-rouge">StaticFile#to_json</code> to <code class="highlighter-rouge">StaticFile#to_liquid</code> (<a href="https://github.com/jekyll/jekyll/issues/6273">#6273</a>)</li>
321
+ <li>Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (<a href="https://github.com/jekyll/jekyll/issues/6281">#6281</a>)</li>
322
+ <li>Guard against type error in absolute url (<a href="https://github.com/jekyll/jekyll/issues/6280">#6280</a>)</li>
323
+ <li>Mutable drops should fallback to their own methods when a mutation isn&amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>;t present (<a href="https://github.com/jekyll/jekyll/issues/6350">#6350</a>)</li>
324
+ <li>Skip adding binary files as posts (<a href="https://github.com/jekyll/jekyll/issues/6344">#6344</a>)</li>
325
+ <li>Don&amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>;t break if bundler is not installed (<a href="https://github.com/jekyll/jekyll/issues/6377">#6377</a>)</li>
326
+ </ul>
327
+
328
+ <h3 id="documentation">Documentation</h3>
329
+
330
+ <ul>
331
+ <li>Fix a typo in <code class="highlighter-rouge">custom-404-page.md</code> (<a href="https://github.com/jekyll/jekyll/issues/6218">#6218</a>)</li>
332
+ <li>Docs: fix links to issues in History.markdown (<a href="https://github.com/jekyll/jekyll/issues/6255">#6255</a>)</li>
333
+ <li>Update deprecated gems key to plugins. (<a href="https://github.com/jekyll/jekyll/issues/6262">#6262</a>)</li>
334
+ <li>Fixes minor typo in post text (<a href="https://github.com/jekyll/jekyll/issues/6283">#6283</a>)</li>
335
+ <li>Execute build command using bundle. (<a href="https://github.com/jekyll/jekyll/issues/6274">#6274</a>)</li>
336
+ <li>name unification - buddy details (<a href="https://github.com/jekyll/jekyll/issues/6317">#6317</a>)</li>
337
+ <li>name unification - application index (<a href="https://github.com/jekyll/jekyll/issues/6318">#6318</a>)</li>
338
+ <li>trim and relocate plugin info across docs (<a href="https://github.com/jekyll/jekyll/issues/6311">#6311</a>)</li>
339
+ <li>update Jekyll&amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>;s README (<a href="https://github.com/jekyll/jekyll/issues/6321">#6321</a>)</li>
340
+ <li>add SUPPORT file for GitHub (<a href="https://github.com/jekyll/jekyll/issues/6324">#6324</a>)</li>
341
+ <li>Rename CODE_OF_CONDUCT to show in banner (<a href="https://github.com/jekyll/jekyll/issues/6325">#6325</a>)</li>
342
+ <li>Docs : illustrate page.id for a collection&amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>;s document (<a href="https://github.com/jekyll/jekyll/issues/6329">#6329</a>)</li>
343
+ <li>Docs: post&amp;<a href="https://github.com/jekyll/jekyll/issues/39">#39</a>;s date can be overriden in YAML front matter (<a href="https://github.com/jekyll/jekyll/issues/6334">#6334</a>)</li>
344
+ <li>Docs: <code class="highlighter-rouge">site.url</code> behavior on development and production environments (<a href="https://github.com/jekyll/jekyll/issues/6270">#6270</a>)</li>
345
+ <li>Fix typo in site.url section of variables.md :-[ (<a href="https://github.com/jekyll/jekyll/issues/6337">#6337</a>)</li>
346
+ <li>Docs: updates (<a href="https://github.com/jekyll/jekyll/issues/6343">#6343</a>)</li>
347
+ <li>Fix precedence docs (<a href="https://github.com/jekyll/jekyll/issues/6346">#6346</a>)</li>
348
+ <li>add note to contributing docs about <code class="highlighter-rouge">script/console</code> (<a href="https://github.com/jekyll/jekyll/issues/6349">#6349</a>)</li>
349
+ <li>Docs: Fix permalink example (<a href="https://github.com/jekyll/jekyll/issues/6375">#6375</a>)</li>
350
+ </ul>
351
+
352
+ <h3 id="site-enhancements-v3-6-0">Site Enhancements</h3>
353
+
354
+ <ul>
355
+ <li>Adding DevKit helpers (<a href="https://github.com/jekyll/jekyll/issues/6225">#6225</a>)</li>
356
+ <li>Customizing url in collection elements clarified (<a href="https://github.com/jekyll/jekyll/issues/6264">#6264</a>)</li>
357
+ <li>Plugins is the new gems (<a href="https://github.com/jekyll/jekyll/issues/6326">#6326</a>)</li>
358
+ </ul>
359
+
360
+ <h3 id="development-fixes-v3-6-0">Development Fixes</h3>
361
+
362
+ <ul>
363
+ <li>Strip unnecessary leading whitespace in template (<a href="https://github.com/jekyll/jekyll/issues/6228">#6228</a>)</li>
364
+ <li>Users should be installing patch versions. (<a href="https://github.com/jekyll/jekyll/issues/6198">#6198</a>)</li>
365
+ <li>Fix tests (<a href="https://github.com/jekyll/jekyll/issues/6240">#6240</a>)</li>
366
+ <li>Define path with <code class="highlighter-rouge">__dir__</code> (<a href="https://github.com/jekyll/jekyll/issues/6087">#6087</a>)</li>
367
+ <li>exit site.process sooner (<a href="https://github.com/jekyll/jekyll/issues/6239">#6239</a>)</li>
368
+ <li>make flakey test more robust (<a href="https://github.com/jekyll/jekyll/issues/6277">#6277</a>)</li>
369
+ <li>Add a quick test for DataReader (<a href="https://github.com/jekyll/jekyll/issues/6284">#6284</a>)</li>
370
+ <li>script/backport-pr: commit message no longer includes the <code class="highlighter-rouge">#</code> (<a href="https://github.com/jekyll/jekyll/issues/6289">#6289</a>)</li>
371
+ <li>Add Add CODEOWNERS file to help automate reviews. (<a href="https://github.com/jekyll/jekyll/issues/6320">#6320</a>)</li>
372
+ <li>Fix builds on codeclimate (<a href="https://github.com/jekyll/jekyll/issues/6333">#6333</a>)</li>
373
+ <li>Bump rubies on Travis (<a href="https://github.com/jekyll/jekyll/issues/6366">#6366</a>)</li>
374
+ </ul>
375
+
376
+ <h2 id="v3-5-2">3.5.2 / 2017-08-12</h2>
377
+
378
+ <h3 id="bug-fixes-v3-5-2">Bug Fixes</h3>
379
+
380
+ <ul>
381
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6281">#6281</a> for v3.5.x: Fix <code class="highlighter-rouge">Drop#key?</code> so it can handle a nil argument (<a href="https://github.com/jekyll/jekyll/issues/6288">#6288</a>)</li>
382
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6280">#6280</a> for v3.5.x: Guard against type error in <code class="highlighter-rouge">absolute_url</code> (<a href="https://github.com/jekyll/jekyll/issues/6287">#6287</a>)</li>
383
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6266">#6266</a> for v3.5.x: Memoize the return value of <code class="highlighter-rouge">Document#url</code> (<a href="https://github.com/jekyll/jekyll/issues/6301">#6301</a>)</li>
384
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6273">#6273</a> for v3.5.x: delegate <code class="highlighter-rouge">StaticFile#to_json</code> to <code class="highlighter-rouge">StaticFile#to_liquid</code> (<a href="https://github.com/jekyll/jekyll/issues/6302">#6302</a>)</li>
385
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6226">#6226</a> for v3.5.x: <code class="highlighter-rouge">Reader#read_directories</code>: guard against an entry not being a directory (<a href="https://github.com/jekyll/jekyll/issues/6304">#6304</a>)</li>
386
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6247">#6247</a> for v3.5.x: kramdown: symbolize keys in-place (<a href="https://github.com/jekyll/jekyll/issues/6303">#6303</a>)</li>
387
+ </ul>
388
+
389
+ <h2 id="v3-5-1">3.5.1 / 2017-07-17</h2>
291
390
 
292
391
  <h3 id="minor-enhancements-v3-5-1">Minor Enhancements</h3>
293
392
 
@@ -304,7 +403,7 @@
304
403
  <li>Always normalize the result of the <code class="highlighter-rouge">relative_url</code> filter (<a href="https://github.com/jekyll/jekyll/issues/6185">#6185</a>)</li>
305
404
  </ul>
306
405
 
307
- <h3 id="documentation">Documentation</h3>
406
+ <h3 id="documentation-1">Documentation</h3>
308
407
 
309
408
  <ul>
310
409
  <li>Update reference to trouble with OS X/macOS (<a href="https://github.com/jekyll/jekyll/issues/6139">#6139</a>)</li>
@@ -312,19 +411,19 @@
312
411
  <li>add plugins for multiple page pagination (<a href="https://github.com/jekyll/jekyll/issues/6055">#6055</a>)</li>
313
412
  <li>Update minimum Ruby version in installation.md (<a href="https://github.com/jekyll/jekyll/issues/6164">#6164</a>)</li>
314
413
  <li>[docs] Add information about finding a collection in <code class="highlighter-rouge">site.collections</code> (<a href="https://github.com/jekyll/jekyll/issues/6165">#6165</a>)</li>
315
- <li>Add to Liquid example on site (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6179">#6179</a>)</li>
316
- <li>Added improved Pug plugin - removed 404 Jade plugin (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6174">#6174</a>)</li>
317
- <li>Linking the link (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6210">#6210</a>)</li>
318
- <li>Small correction in documentation for includes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6193">#6193</a>)</li>
319
- <li>Fix docs site page margin (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6214">#6214</a>)</li>
414
+ <li>Add <code class="highlighter-rouge">{% raw %}</code> to Liquid example on site (<a href="https://github.com/jekyll/jekyll/issues/6179">#6179</a>)</li>
415
+ <li>Added improved Pug plugin - removed 404 Jade plugin (<a href="https://github.com/jekyll/jekyll/issues/6174">#6174</a>)</li>
416
+ <li>Linking the link (<a href="https://github.com/jekyll/jekyll/issues/6210">#6210</a>)</li>
417
+ <li>Small correction in documentation for includes (<a href="https://github.com/jekyll/jekyll/issues/6193">#6193</a>)</li>
418
+ <li>Fix docs site page margin (<a href="https://github.com/jekyll/jekyll/issues/6214">#6214</a>)</li>
320
419
  </ul>
321
420
 
322
421
  <h3 id="development-fixes-v3-5-1">Development Fixes</h3>
323
422
 
324
423
  <ul>
325
- <li>Add jekyll doctor to GitHub Issue Template (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6169">#6169</a>)</li>
326
- <li>Test with Ruby 2.4.1-1 on AppVeyor (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6176">#6176</a>)</li>
327
- <li>set minimum requirement for jekyll-feed (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6184">#6184</a>)</li>
424
+ <li>Add jekyll doctor to GitHub Issue Template (<a href="https://github.com/jekyll/jekyll/issues/6169">#6169</a>)</li>
425
+ <li>Test with Ruby 2.4.1-1 on AppVeyor (<a href="https://github.com/jekyll/jekyll/issues/6176">#6176</a>)</li>
426
+ <li>set minimum requirement for jekyll-feed (<a href="https://github.com/jekyll/jekyll/issues/6184">#6184</a>)</li>
328
427
  </ul>
329
428
 
330
429
  <h2 id="v3-5-0">3.5.0 / 2017-06-18</h2>
@@ -332,180 +431,180 @@
332
431
  <h3 id="minor-enhancements-v3-5-0">Minor Enhancements</h3>
333
432
 
334
433
  <ul>
335
- <li>Upgrade to Liquid v4 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4362">#4362</a>)</li>
336
- <li>Convert StaticFile liquid representation to a Drop &amp; add front matter defaults support to StaticFiles (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5871">#5871</a>)</li>
337
- <li>Add support for Tab-Separated Values data files (<code class="highlighter-rouge">*.tsv</code>) (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5985">#5985</a>)</li>
338
- <li>Specify version constraint in subcommand error message. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5974">#5974</a>)</li>
339
- <li>Add a template for custom 404 page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5945">#5945</a>)</li>
340
- <li>Require <code class="highlighter-rouge">runtime_dependencies</code> of a Gem-based theme from its <code class="highlighter-rouge">.gemspec</code> file (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5914">#5914</a>)</li>
341
- <li>Don’t raise an error if URL contains a colon (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5889">#5889</a>)</li>
342
- <li>Date filters should never raise an exception (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5722">#5722</a>)</li>
343
- <li>add <code class="highlighter-rouge">plugins</code> config key as replacement for <code class="highlighter-rouge">gems</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5130">#5130</a>)</li>
344
- <li>create configuration from options only once in the boot process (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5487">#5487</a>)</li>
345
- <li>Add option to fail a build with front matter syntax errors (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5832">#5832</a>)</li>
346
- <li>Disable default layouts for documents with a <code class="highlighter-rouge">layout: none</code> declaration (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5933">#5933</a>)</li>
347
- <li>In <code class="highlighter-rouge">jekyll new</code>, make copied site template user-writable (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6072">#6072</a>)</li>
348
- <li>Add top-level <code class="highlighter-rouge">layout</code> liquid variable to Documents (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6073">#6073</a>)</li>
349
- <li>Address reading non-binary static files in themes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5918">#5918</a>)</li>
350
- <li>Allow filters to sort &amp; select based on subvalues (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5622">#5622</a>)</li>
351
- <li>Add strip_index filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6075">#6075</a>)</li>
434
+ <li>Upgrade to Liquid v4 (<a href="https://github.com/jekyll/jekyll/issues/4362">#4362</a>)</li>
435
+ <li>Convert StaticFile liquid representation to a Drop &amp; add front matter defaults support to StaticFiles (<a href="https://github.com/jekyll/jekyll/issues/5871">#5871</a>)</li>
436
+ <li>Add support for Tab-Separated Values data files (<code class="highlighter-rouge">*.tsv</code>) (<a href="https://github.com/jekyll/jekyll/issues/5985">#5985</a>)</li>
437
+ <li>Specify version constraint in subcommand error message. (<a href="https://github.com/jekyll/jekyll/issues/5974">#5974</a>)</li>
438
+ <li>Add a template for custom 404 page (<a href="https://github.com/jekyll/jekyll/issues/5945">#5945</a>)</li>
439
+ <li>Require <code class="highlighter-rouge">runtime_dependencies</code> of a Gem-based theme from its <code class="highlighter-rouge">.gemspec</code> file (<a href="https://github.com/jekyll/jekyll/issues/5914">#5914</a>)</li>
440
+ <li>Don’t raise an error if URL contains a colon (<a href="https://github.com/jekyll/jekyll/issues/5889">#5889</a>)</li>
441
+ <li>Date filters should never raise an exception (<a href="https://github.com/jekyll/jekyll/issues/5722">#5722</a>)</li>
442
+ <li>add <code class="highlighter-rouge">plugins</code> config key as replacement for <code class="highlighter-rouge">gems</code> (<a href="https://github.com/jekyll/jekyll/issues/5130">#5130</a>)</li>
443
+ <li>create configuration from options only once in the boot process (<a href="https://github.com/jekyll/jekyll/issues/5487">#5487</a>)</li>
444
+ <li>Add option to fail a build with front matter syntax errors (<a href="https://github.com/jekyll/jekyll/issues/5832">#5832</a>)</li>
445
+ <li>Disable default layouts for documents with a <code class="highlighter-rouge">layout: none</code> declaration (<a href="https://github.com/jekyll/jekyll/issues/5933">#5933</a>)</li>
446
+ <li>In <code class="highlighter-rouge">jekyll new</code>, make copied site template user-writable (<a href="https://github.com/jekyll/jekyll/issues/6072">#6072</a>)</li>
447
+ <li>Add top-level <code class="highlighter-rouge">layout</code> liquid variable to Documents (<a href="https://github.com/jekyll/jekyll/issues/6073">#6073</a>)</li>
448
+ <li>Address reading non-binary static files in themes (<a href="https://github.com/jekyll/jekyll/issues/5918">#5918</a>)</li>
449
+ <li>Allow filters to sort &amp; select based on subvalues (<a href="https://github.com/jekyll/jekyll/issues/5622">#5622</a>)</li>
450
+ <li>Add strip_index filter (<a href="https://github.com/jekyll/jekyll/issues/6075">#6075</a>)</li>
352
451
  </ul>
353
452
 
354
- <h3 id="documentation-1">Documentation</h3>
453
+ <h3 id="documentation-2">Documentation</h3>
355
454
 
356
455
  <ul>
357
- <li>Install troubleshooting on Ubuntu (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5817">#5817</a>)</li>
358
- <li>Add Termux section on troubleshooting (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5837">#5837</a>)</li>
359
- <li>fix ial css classes in theme doc (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5876">#5876</a>)</li>
360
- <li>Update installation.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5880">#5880</a>)</li>
361
- <li>Update Aerobatic docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5883">#5883</a>)</li>
362
- <li>Add note to collections doc on hard-coded collections. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5882">#5882</a>)</li>
363
- <li>Makes uri_escape template docs more specific. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5887">#5887</a>)</li>
364
- <li>Remove duplicate footnote_nr from default config (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5891">#5891</a>)</li>
365
- <li>Fixed tutorial for publishing gem to include repo. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5900">#5900</a>)</li>
366
- <li>update broken links (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5905">#5905</a>)</li>
367
- <li>Fix typo in contribution information (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5910">#5910</a>)</li>
368
- <li>update plugin repo URL to reflect repo move (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5916">#5916</a>)</li>
369
- <li>Update exclude array in configuration.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5947">#5947</a>)</li>
370
- <li>Fixed path in “Improve this page” link in Tutorials section (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5951">#5951</a>)</li>
371
- <li>Corrected permalink (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5949">#5949</a>)</li>
372
- <li>Included more details about adding defaults to static files (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5971">#5971</a>)</li>
373
- <li>Create buddyworks (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5962">#5962</a>)</li>
374
- <li>added (buddyworks) to ci list (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5965">#5965</a>)</li>
375
- <li>Add a tutorial on serving custom Error 404 page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5946">#5946</a>)</li>
376
- <li>add custom 404 to tutorial navigation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5978">#5978</a>)</li>
377
- <li>Add link to order of interpretation tutorial in Tutorials nav (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5952">#5952</a>)</li>
378
- <li>Document Jekyll’s Philosophy (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5792">#5792</a>)</li>
379
- <li>Require Ruby &gt; 2.1.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5983">#5983</a>)</li>
380
- <li>Fix broken link (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5994">#5994</a>)</li>
381
- <li>Default options for script/proof (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5995">#5995</a>)</li>
382
- <li>Mention Bash on Ubuntu on Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5960">#5960</a>)</li>
383
- <li>Document <code class="highlighter-rouge">--unpublished</code> flag introduced in 91e9ecf (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5959">#5959</a>)</li>
384
- <li>Update upgrading.md to mention usage of <code class="highlighter-rouge">bundle update</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5604">#5604</a>)</li>
385
- <li>Fix missing quotation mark (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6002">#6002</a>)</li>
386
- <li>New tutorial: Convert an HTML site to Jekyll (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5881">#5881</a>)</li>
387
- <li>Revamp Permalink section (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5912">#5912</a>)</li>
388
- <li>Fixup tutorial on creating theme from existing HTML templates (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6006">#6006</a>)</li>
389
- <li>Standardise on “URLs” without apostrophe in docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6018">#6018</a>)</li>
390
- <li>Added txtpen in tutorial (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6021">#6021</a>)</li>
391
- <li>fix typo using past participle (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6026">#6026</a>)</li>
392
- <li>changed formatting to fit the style of the documentation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6027">#6027</a>)</li>
393
- <li>doc fix typo word usage (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6028">#6028</a>)</li>
394
- <li>corrected reference to layout in index.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6032">#6032</a>)</li>
395
- <li>(Minor) Update MathJax CDN (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6013">#6013</a>)</li>
396
- <li>Add MvvmCross to samples (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6035">#6035</a>)</li>
397
- <li>Update travis-ci.md to correct procedure (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6043">#6043</a>)</li>
398
- <li>fix sentence in documentation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6048">#6048</a>)</li>
399
- <li>rephrase a sentence in posts.md to be more direct (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6049">#6049</a>)</li>
400
- <li>Compress Website Sass output (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6009">#6009</a>)</li>
401
- <li>doc correct spelling error (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6050">#6050</a>)</li>
402
- <li>adjusted date-format in sitemap (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6053">#6053</a>)</li>
403
- <li>Typo fix (welcomed change -&gt; welcome change). (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6070">#6070</a>)</li>
404
- <li>Fixed documentation inconsistency (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6068">#6068</a>)</li>
405
- <li>Add own plugin -&gt; Jekyll Brand Social Wall (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6064">#6064</a>)</li>
406
- <li>Added plugin jekyll-analytics (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6042">#6042</a>)</li>
407
- <li>Use more precise language when explaining links (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6078">#6078</a>)</li>
408
- <li>Update plugins.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6088">#6088</a>)</li>
409
- <li>windows 10 tutorial (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6100">#6100</a>)</li>
410
- <li>Explain how to override theme styles (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6107">#6107</a>)</li>
411
- <li>updated Bash on Ubuntu on Windows link in tutorial (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6111">#6111</a>)</li>
412
- <li>Fix wording in <code class="highlighter-rouge">_docs/templates.md</code> links section (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6114">#6114</a>)</li>
413
- <li>Update windows.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6115">#6115</a>)</li>
414
- <li>Added windows to docs.yml (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6109">#6109</a>)</li>
415
- <li>Be more specific on what to upload (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6119">#6119</a>)</li>
416
- <li>Remove Blank Newlines from “Jekyll on Windows” Page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6126">#6126</a>)</li>
417
- <li>Link the troubleshooting page in the quickstart page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6134">#6134</a>)</li>
418
- <li>add documentation about the &amp;<a href="%7B%7B%20site.repository%20%7D%7D/issues/34">#34</a>;pinned&amp;<a href="%7B%7B%20site.repository%20%7D%7D/issues/34">#34</a>; label (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6147">#6147</a>)</li>
419
- <li>docs(JekyllOnWindows): Add a new Installation way (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6141">#6141</a>)</li>
420
- <li>corrected windows.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6149">#6149</a>)</li>
421
- <li>Refine documentation for Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6153">#6153</a>)</li>
456
+ <li>Install troubleshooting on Ubuntu (<a href="https://github.com/jekyll/jekyll/issues/5817">#5817</a>)</li>
457
+ <li>Add Termux section on troubleshooting (<a href="https://github.com/jekyll/jekyll/issues/5837">#5837</a>)</li>
458
+ <li>fix ial css classes in theme doc (<a href="https://github.com/jekyll/jekyll/issues/5876">#5876</a>)</li>
459
+ <li>Update installation.md (<a href="https://github.com/jekyll/jekyll/issues/5880">#5880</a>)</li>
460
+ <li>Update Aerobatic docs (<a href="https://github.com/jekyll/jekyll/issues/5883">#5883</a>)</li>
461
+ <li>Add note to collections doc on hard-coded collections. (<a href="https://github.com/jekyll/jekyll/issues/5882">#5882</a>)</li>
462
+ <li>Makes uri_escape template docs more specific. (<a href="https://github.com/jekyll/jekyll/issues/5887">#5887</a>)</li>
463
+ <li>Remove duplicate footnote_nr from default config (<a href="https://github.com/jekyll/jekyll/issues/5891">#5891</a>)</li>
464
+ <li>Fixed tutorial for publishing gem to include repo. (<a href="https://github.com/jekyll/jekyll/issues/5900">#5900</a>)</li>
465
+ <li>update broken links (<a href="https://github.com/jekyll/jekyll/issues/5905">#5905</a>)</li>
466
+ <li>Fix typo in contribution information (<a href="https://github.com/jekyll/jekyll/issues/5910">#5910</a>)</li>
467
+ <li>update plugin repo URL to reflect repo move (<a href="https://github.com/jekyll/jekyll/issues/5916">#5916</a>)</li>
468
+ <li>Update exclude array in configuration.md (<a href="https://github.com/jekyll/jekyll/issues/5947">#5947</a>)</li>
469
+ <li>Fixed path in “Improve this page” link in Tutorials section (<a href="https://github.com/jekyll/jekyll/issues/5951">#5951</a>)</li>
470
+ <li>Corrected permalink (<a href="https://github.com/jekyll/jekyll/issues/5949">#5949</a>)</li>
471
+ <li>Included more details about adding defaults to static files (<a href="https://github.com/jekyll/jekyll/issues/5971">#5971</a>)</li>
472
+ <li>Create buddyworks (<a href="https://github.com/jekyll/jekyll/issues/5962">#5962</a>)</li>
473
+ <li>added (buddyworks) to ci list (<a href="https://github.com/jekyll/jekyll/issues/5965">#5965</a>)</li>
474
+ <li>Add a tutorial on serving custom Error 404 page (<a href="https://github.com/jekyll/jekyll/issues/5946">#5946</a>)</li>
475
+ <li>add custom 404 to tutorial navigation (<a href="https://github.com/jekyll/jekyll/issues/5978">#5978</a>)</li>
476
+ <li>Add link to order of interpretation tutorial in Tutorials nav (<a href="https://github.com/jekyll/jekyll/issues/5952">#5952</a>)</li>
477
+ <li>Document Jekyll’s Philosophy (<a href="https://github.com/jekyll/jekyll/issues/5792">#5792</a>)</li>
478
+ <li>Require Ruby &gt; 2.1.0 (<a href="https://github.com/jekyll/jekyll/issues/5983">#5983</a>)</li>
479
+ <li>Fix broken link (<a href="https://github.com/jekyll/jekyll/issues/5994">#5994</a>)</li>
480
+ <li>Default options for script/proof (<a href="https://github.com/jekyll/jekyll/issues/5995">#5995</a>)</li>
481
+ <li>Mention Bash on Ubuntu on Windows (<a href="https://github.com/jekyll/jekyll/issues/5960">#5960</a>)</li>
482
+ <li>Document <code class="highlighter-rouge">--unpublished</code> flag introduced in 91e9ecf (<a href="https://github.com/jekyll/jekyll/issues/5959">#5959</a>)</li>
483
+ <li>Update upgrading.md to mention usage of <code class="highlighter-rouge">bundle update</code> (<a href="https://github.com/jekyll/jekyll/issues/5604">#5604</a>)</li>
484
+ <li>Fix missing quotation mark (<a href="https://github.com/jekyll/jekyll/issues/6002">#6002</a>)</li>
485
+ <li>New tutorial: Convert an HTML site to Jekyll (<a href="https://github.com/jekyll/jekyll/issues/5881">#5881</a>)</li>
486
+ <li>Revamp Permalink section (<a href="https://github.com/jekyll/jekyll/issues/5912">#5912</a>)</li>
487
+ <li>Fixup tutorial on creating theme from existing HTML templates (<a href="https://github.com/jekyll/jekyll/issues/6006">#6006</a>)</li>
488
+ <li>Standardise on “URLs” without apostrophe in docs (<a href="https://github.com/jekyll/jekyll/issues/6018">#6018</a>)</li>
489
+ <li>Added txtpen in tutorial (<a href="https://github.com/jekyll/jekyll/issues/6021">#6021</a>)</li>
490
+ <li>fix typo using past participle (<a href="https://github.com/jekyll/jekyll/issues/6026">#6026</a>)</li>
491
+ <li>changed formatting to fit the style of the documentation (<a href="https://github.com/jekyll/jekyll/issues/6027">#6027</a>)</li>
492
+ <li>doc fix typo word usage (<a href="https://github.com/jekyll/jekyll/issues/6028">#6028</a>)</li>
493
+ <li>corrected reference to layout in index.md (<a href="https://github.com/jekyll/jekyll/issues/6032">#6032</a>)</li>
494
+ <li>(Minor) Update MathJax CDN (<a href="https://github.com/jekyll/jekyll/issues/6013">#6013</a>)</li>
495
+ <li>Add MvvmCross to samples (<a href="https://github.com/jekyll/jekyll/issues/6035">#6035</a>)</li>
496
+ <li>Update travis-ci.md to correct procedure (<a href="https://github.com/jekyll/jekyll/issues/6043">#6043</a>)</li>
497
+ <li>fix sentence in documentation (<a href="https://github.com/jekyll/jekyll/issues/6048">#6048</a>)</li>
498
+ <li>rephrase a sentence in posts.md to be more direct (<a href="https://github.com/jekyll/jekyll/issues/6049">#6049</a>)</li>
499
+ <li>Compress Website Sass output (<a href="https://github.com/jekyll/jekyll/issues/6009">#6009</a>)</li>
500
+ <li>doc correct spelling error (<a href="https://github.com/jekyll/jekyll/issues/6050">#6050</a>)</li>
501
+ <li>adjusted date-format in sitemap (<a href="https://github.com/jekyll/jekyll/issues/6053">#6053</a>)</li>
502
+ <li>Typo fix (welcomed change -&gt; welcome change). (<a href="https://github.com/jekyll/jekyll/issues/6070">#6070</a>)</li>
503
+ <li>Fixed documentation inconsistency (<a href="https://github.com/jekyll/jekyll/issues/6068">#6068</a>)</li>
504
+ <li>Add own plugin -&gt; Jekyll Brand Social Wall (<a href="https://github.com/jekyll/jekyll/issues/6064">#6064</a>)</li>
505
+ <li>Added plugin jekyll-analytics (<a href="https://github.com/jekyll/jekyll/issues/6042">#6042</a>)</li>
506
+ <li>Use more precise language when explaining links (<a href="https://github.com/jekyll/jekyll/issues/6078">#6078</a>)</li>
507
+ <li>Update plugins.md (<a href="https://github.com/jekyll/jekyll/issues/6088">#6088</a>)</li>
508
+ <li>windows 10 tutorial (<a href="https://github.com/jekyll/jekyll/issues/6100">#6100</a>)</li>
509
+ <li>Explain how to override theme styles (<a href="https://github.com/jekyll/jekyll/issues/6107">#6107</a>)</li>
510
+ <li>updated Bash on Ubuntu on Windows link in tutorial (<a href="https://github.com/jekyll/jekyll/issues/6111">#6111</a>)</li>
511
+ <li>Fix wording in <code class="highlighter-rouge">_docs/templates.md</code> links section (<a href="https://github.com/jekyll/jekyll/issues/6114">#6114</a>)</li>
512
+ <li>Update windows.md (<a href="https://github.com/jekyll/jekyll/issues/6115">#6115</a>)</li>
513
+ <li>Added windows to docs.yml (<a href="https://github.com/jekyll/jekyll/issues/6109">#6109</a>)</li>
514
+ <li>Be more specific on what to upload (<a href="https://github.com/jekyll/jekyll/issues/6119">#6119</a>)</li>
515
+ <li>Remove Blank Newlines from “Jekyll on Windows” Page (<a href="https://github.com/jekyll/jekyll/issues/6126">#6126</a>)</li>
516
+ <li>Link the troubleshooting page in the quickstart page (<a href="https://github.com/jekyll/jekyll/issues/6134">#6134</a>)</li>
517
+ <li>add documentation about the &amp;<a href="https://github.com/jekyll/jekyll/issues/34">#34</a>;pinned&amp;<a href="https://github.com/jekyll/jekyll/issues/34">#34</a>; label (<a href="https://github.com/jekyll/jekyll/issues/6147">#6147</a>)</li>
518
+ <li>docs(JekyllOnWindows): Add a new Installation way (<a href="https://github.com/jekyll/jekyll/issues/6141">#6141</a>)</li>
519
+ <li>corrected windows.md (<a href="https://github.com/jekyll/jekyll/issues/6149">#6149</a>)</li>
520
+ <li>Refine documentation for Windows (<a href="https://github.com/jekyll/jekyll/issues/6153">#6153</a>)</li>
422
521
  </ul>
423
522
 
424
523
  <h3 id="development-fixes-v3-5-0">Development Fixes</h3>
425
524
 
426
525
  <ul>
427
- <li>[Rubocop] add missing comma (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5835">#5835</a>)</li>
428
- <li>Appease classifier-reborn (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5934">#5934</a>)</li>
429
- <li>Allow releases &amp; development on <code class="highlighter-rouge">*-stable</code> branches (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5926">#5926</a>)</li>
430
- <li>Add script/backport-pr (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5925">#5925</a>)</li>
431
- <li>Prefer .yaml over .toml (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5966">#5966</a>)</li>
432
- <li>Fix Appveyor with DST-aware cucumber steps (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5961">#5961</a>)</li>
433
- <li>Use Rubocop v0.47.1 till we’re ready for v0.48 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5989">#5989</a>)</li>
434
- <li>Test against Ruby 2.4.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5687">#5687</a>)</li>
435
- <li>rubocop: lib/jekyll/renderer.rb complexity fixes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5052">#5052</a>)</li>
436
- <li>Use yajl-ruby 1.2.2 (now with 2.4 support) (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6007">#6007</a>)</li>
437
- <li>Bump Rubocop to v0.48 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5997">#5997</a>)</li>
438
- <li>doc use example.com (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6031">#6031</a>)</li>
439
- <li>fix typo (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6040">#6040</a>)</li>
440
- <li>Fix CI (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6044">#6044</a>)</li>
441
- <li>Remove <code class="highlighter-rouge">ruby RUBY_VERSION</code> from generated Gemfile (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5803">#5803</a>)</li>
442
- <li>Test if hidden collections output a document with a future date (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6103">#6103</a>)</li>
443
- <li>Add test for uri_escape on reserved characters (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6086">#6086</a>)</li>
444
- <li>Allow you to specify the rouge version via an environment variable for testing (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6138">#6138</a>)</li>
445
- <li>Bump Rubocop to 0.49.1 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6093">#6093</a>)</li>
446
- <li>Lock nokogiri to 1.7.x for Ruby 2.1 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6140">#6140</a>)</li>
526
+ <li>[Rubocop] add missing comma (<a href="https://github.com/jekyll/jekyll/issues/5835">#5835</a>)</li>
527
+ <li>Appease classifier-reborn (<a href="https://github.com/jekyll/jekyll/issues/5934">#5934</a>)</li>
528
+ <li>Allow releases &amp; development on <code class="highlighter-rouge">*-stable</code> branches (<a href="https://github.com/jekyll/jekyll/issues/5926">#5926</a>)</li>
529
+ <li>Add script/backport-pr (<a href="https://github.com/jekyll/jekyll/issues/5925">#5925</a>)</li>
530
+ <li>Prefer .yaml over .toml (<a href="https://github.com/jekyll/jekyll/issues/5966">#5966</a>)</li>
531
+ <li>Fix Appveyor with DST-aware cucumber steps (<a href="https://github.com/jekyll/jekyll/issues/5961">#5961</a>)</li>
532
+ <li>Use Rubocop v0.47.1 till we’re ready for v0.48 (<a href="https://github.com/jekyll/jekyll/issues/5989">#5989</a>)</li>
533
+ <li>Test against Ruby 2.4.0 (<a href="https://github.com/jekyll/jekyll/issues/5687">#5687</a>)</li>
534
+ <li>rubocop: lib/jekyll/renderer.rb complexity fixes (<a href="https://github.com/jekyll/jekyll/issues/5052">#5052</a>)</li>
535
+ <li>Use yajl-ruby 1.2.2 (now with 2.4 support) (<a href="https://github.com/jekyll/jekyll/issues/6007">#6007</a>)</li>
536
+ <li>Bump Rubocop to v0.48 (<a href="https://github.com/jekyll/jekyll/issues/5997">#5997</a>)</li>
537
+ <li>doc use example.com (<a href="https://github.com/jekyll/jekyll/issues/6031">#6031</a>)</li>
538
+ <li>fix typo (<a href="https://github.com/jekyll/jekyll/issues/6040">#6040</a>)</li>
539
+ <li>Fix CI (<a href="https://github.com/jekyll/jekyll/issues/6044">#6044</a>)</li>
540
+ <li>Remove <code class="highlighter-rouge">ruby RUBY_VERSION</code> from generated Gemfile (<a href="https://github.com/jekyll/jekyll/issues/5803">#5803</a>)</li>
541
+ <li>Test if hidden collections output a document with a future date (<a href="https://github.com/jekyll/jekyll/issues/6103">#6103</a>)</li>
542
+ <li>Add test for uri_escape on reserved characters (<a href="https://github.com/jekyll/jekyll/issues/6086">#6086</a>)</li>
543
+ <li>Allow you to specify the rouge version via an environment variable for testing (<a href="https://github.com/jekyll/jekyll/issues/6138">#6138</a>)</li>
544
+ <li>Bump Rubocop to 0.49.1 (<a href="https://github.com/jekyll/jekyll/issues/6093">#6093</a>)</li>
545
+ <li>Lock nokogiri to 1.7.x for Ruby 2.1 (<a href="https://github.com/jekyll/jekyll/issues/6140">#6140</a>)</li>
447
546
  </ul>
448
547
 
449
548
  <h3 id="site-enhancements-v3-5-0">Site Enhancements</h3>
450
549
 
451
550
  <ul>
452
- <li>Corrected date for version 3.4.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5842">#5842</a>)</li>
453
- <li>Add the correct year to the 3.4.0 release date (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5858">#5858</a>)</li>
454
- <li>Add documentation about order of interpretation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5834">#5834</a>)</li>
455
- <li>Documentation on how to build navigation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5698">#5698</a>)</li>
456
- <li>Navigation has been moved out from docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5927">#5927</a>)</li>
457
- <li>Make links in sidebar for current page more prominent (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5820">#5820</a>)</li>
458
- <li>Update normalize.css to v6.0.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6008">#6008</a>)</li>
459
- <li>Docs: rename <code class="highlighter-rouge">gems</code> to <code class="highlighter-rouge">plugins</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6082">#6082</a>)</li>
460
- <li>plugins -&gt; gems (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6110">#6110</a>)</li>
461
- <li>Document difference between cgi_escape and uri_escape <a href="%7B%7B%20site.repository%20%7D%7D/issues/5970">#5970</a> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6081">#6081</a>)</li>
551
+ <li>Corrected date for version 3.4.0 (<a href="https://github.com/jekyll/jekyll/issues/5842">#5842</a>)</li>
552
+ <li>Add the correct year to the 3.4.0 release date (<a href="https://github.com/jekyll/jekyll/issues/5858">#5858</a>)</li>
553
+ <li>Add documentation about order of interpretation (<a href="https://github.com/jekyll/jekyll/issues/5834">#5834</a>)</li>
554
+ <li>Documentation on how to build navigation (<a href="https://github.com/jekyll/jekyll/issues/5698">#5698</a>)</li>
555
+ <li>Navigation has been moved out from docs (<a href="https://github.com/jekyll/jekyll/issues/5927">#5927</a>)</li>
556
+ <li>Make links in sidebar for current page more prominent (<a href="https://github.com/jekyll/jekyll/issues/5820">#5820</a>)</li>
557
+ <li>Update normalize.css to v6.0.0 (<a href="https://github.com/jekyll/jekyll/issues/6008">#6008</a>)</li>
558
+ <li>Docs: rename <code class="highlighter-rouge">gems</code> to <code class="highlighter-rouge">plugins</code> (<a href="https://github.com/jekyll/jekyll/issues/6082">#6082</a>)</li>
559
+ <li>plugins -&gt; gems (<a href="https://github.com/jekyll/jekyll/issues/6110">#6110</a>)</li>
560
+ <li>Document difference between cgi_escape and uri_escape <a href="https://github.com/jekyll/jekyll/issues/5970">#5970</a> (<a href="https://github.com/jekyll/jekyll/issues/6081">#6081</a>)</li>
462
561
  </ul>
463
562
 
464
563
  <h3 id="bug-fixes-v3-5-0">Bug Fixes</h3>
465
564
 
466
565
  <ul>
467
- <li>Exclude Gemfile by default (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5860">#5860</a>)</li>
468
- <li>Convertible#validate_permalink!: ensure the return value of data[“permalink”] is a string before asking if it is empty (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5878">#5878</a>)</li>
469
- <li>Allow abbreviated post dates (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5920">#5920</a>)</li>
470
- <li>Remove dependency on include from default about.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5903">#5903</a>)</li>
471
- <li>Allow colons in <code class="highlighter-rouge">uri_escape</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5957">#5957</a>)</li>
472
- <li>Re-surface missing public methods in <code class="highlighter-rouge">Jekyll::Document</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5975">#5975</a>)</li>
473
- <li>absolute_url should not mangle URL if called more than once (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5789">#5789</a>)</li>
474
- <li>patch URLFilters to prevent <code class="highlighter-rouge">//</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6058">#6058</a>)</li>
475
- <li>add test to ensure variables work in <code class="highlighter-rouge">where_exp</code> condition (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5315">#5315</a>)</li>
476
- <li>Read explicitly included dot-files in collections. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6092">#6092</a>)</li>
477
- <li>Default <code class="highlighter-rouge">baseurl</code> to <code class="highlighter-rouge">nil</code> instead of empty string (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6137">#6137</a>)</li>
478
- <li>Filters#time helper: Duplicate time before calling #localtime. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5996">#5996</a>)</li>
566
+ <li>Exclude Gemfile by default (<a href="https://github.com/jekyll/jekyll/issues/5860">#5860</a>)</li>
567
+ <li>Convertible#validate_permalink!: ensure the return value of data[“permalink”] is a string before asking if it is empty (<a href="https://github.com/jekyll/jekyll/issues/5878">#5878</a>)</li>
568
+ <li>Allow abbreviated post dates (<a href="https://github.com/jekyll/jekyll/issues/5920">#5920</a>)</li>
569
+ <li>Remove dependency on include from default about.md (<a href="https://github.com/jekyll/jekyll/issues/5903">#5903</a>)</li>
570
+ <li>Allow colons in <code class="highlighter-rouge">uri_escape</code> filter (<a href="https://github.com/jekyll/jekyll/issues/5957">#5957</a>)</li>
571
+ <li>Re-surface missing public methods in <code class="highlighter-rouge">Jekyll::Document</code> (<a href="https://github.com/jekyll/jekyll/issues/5975">#5975</a>)</li>
572
+ <li>absolute_url should not mangle URL if called more than once (<a href="https://github.com/jekyll/jekyll/issues/5789">#5789</a>)</li>
573
+ <li>patch URLFilters to prevent <code class="highlighter-rouge">//</code> (<a href="https://github.com/jekyll/jekyll/issues/6058">#6058</a>)</li>
574
+ <li>add test to ensure variables work in <code class="highlighter-rouge">where_exp</code> condition (<a href="https://github.com/jekyll/jekyll/issues/5315">#5315</a>)</li>
575
+ <li>Read explicitly included dot-files in collections. (<a href="https://github.com/jekyll/jekyll/issues/6092">#6092</a>)</li>
576
+ <li>Default <code class="highlighter-rouge">baseurl</code> to <code class="highlighter-rouge">nil</code> instead of empty string (<a href="https://github.com/jekyll/jekyll/issues/6137">#6137</a>)</li>
577
+ <li>Filters#time helper: Duplicate time before calling #localtime. (<a href="https://github.com/jekyll/jekyll/issues/5996">#5996</a>)</li>
479
578
  </ul>
480
579
 
481
580
  <h2 id="v3-4-5">3.4.5 / 2017-06-30</h2>
482
581
 
483
582
  <ul>
484
- <li>Backport <a href="%7B%7B%20site.repository%20%7D%7D/issues/6185">#6185</a> for v3.4.x: Always normalize the result of the <code class="highlighter-rouge">relative_url</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6186">#6186</a>)</li>
583
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6185">#6185</a> for v3.4.x: Always normalize the result of the <code class="highlighter-rouge">relative_url</code> filter (<a href="https://github.com/jekyll/jekyll/issues/6186">#6186</a>)</li>
485
584
  </ul>
486
585
 
487
586
  <h2 id="v3-4-4">3.4.4 / 2017-06-17</h2>
488
587
 
489
588
  <ul>
490
- <li>Backport <a href="%7B%7B%20site.repository%20%7D%7D/issues/6137">#6137</a> for v3.4.x: Default <code class="highlighter-rouge">baseurl</code> to <code class="highlighter-rouge">nil</code> instead of empty string (<a href="%7B%7B%20site.repository%20%7D%7D/issues/6146">#6146</a>)</li>
589
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/6137">#6137</a> for v3.4.x: Default <code class="highlighter-rouge">baseurl</code> to <code class="highlighter-rouge">nil</code> instead of empty string (<a href="https://github.com/jekyll/jekyll/issues/6146">#6146</a>)</li>
491
590
  </ul>
492
591
 
493
592
  <h2 id="v3-4-3">3.4.3 / 2017-03-21</h2>
494
593
 
495
594
  <ul>
496
- <li>Backport <a href="%7B%7B%20site.repository%20%7D%7D/issues/5957">#5957</a> for v3.4.x: Allow colons in <code class="highlighter-rouge">uri_escape</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5968">#5968</a>)</li>
595
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/5957">#5957</a> for v3.4.x: Allow colons in <code class="highlighter-rouge">uri_escape</code> filter (<a href="https://github.com/jekyll/jekyll/issues/5968">#5968</a>)</li>
497
596
  </ul>
498
597
 
499
598
  <h2 id="v3-4-2">3.4.2 / 2017-03-09</h2>
500
599
 
501
600
  <ul>
502
- <li>Backport <a href="%7B%7B%20site.repository%20%7D%7D/issues/5871">#5871</a> for v3.4.x: Convert StaticFile liquid representation to a Drop &amp; add front matter defaults support to StaticFiles (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5940">#5940</a>)</li>
601
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/5871">#5871</a> for v3.4.x: Convert StaticFile liquid representation to a Drop &amp; add front matter defaults support to StaticFiles (<a href="https://github.com/jekyll/jekyll/issues/5940">#5940</a>)</li>
503
602
  </ul>
504
603
 
505
604
  <h2 id="v3-4-1">3.4.1 / 2017-03-02</h2>
506
605
 
507
606
  <ul>
508
- <li>Backport <a href="%7B%7B%20site.repository%20%7D%7D/issues/5920">#5920</a> for v3.4.x: Allow abbreviated post dates (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5924">#5924</a>)</li>
607
+ <li>Backport <a href="https://github.com/jekyll/jekyll/issues/5920">#5920</a> for v3.4.x: Allow abbreviated post dates (<a href="https://github.com/jekyll/jekyll/issues/5924">#5924</a>)</li>
509
608
  </ul>
510
609
 
511
610
  <h2 id="v3-4-0">3.4.0 / 2017-01-27</h2>
@@ -513,111 +612,111 @@
513
612
  <h3 id="minor-enhancements-v3-4-0">Minor Enhancements</h3>
514
613
 
515
614
  <ul>
516
- <li>Add connector param to <code class="highlighter-rouge">array_to_sentence_string</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5597">#5597</a>)</li>
517
- <li>Adds <code class="highlighter-rouge">group_by_exp</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5513">#5513</a>)</li>
518
- <li>Use Addressable instead of URI to decode (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5726">#5726</a>)</li>
519
- <li>throw IncludeTagError if error occurs in included file (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5767">#5767</a>)</li>
520
- <li>Write Jekyll::Utils::Exec.run for running shell commands. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5640">#5640</a>)</li>
521
- <li>Use the current year for the LICENSE of theme (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5712">#5712</a>)</li>
522
- <li>Update License (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5713">#5713</a>)</li>
615
+ <li>Add connector param to <code class="highlighter-rouge">array_to_sentence_string</code> filter (<a href="https://github.com/jekyll/jekyll/issues/5597">#5597</a>)</li>
616
+ <li>Adds <code class="highlighter-rouge">group_by_exp</code> filter (<a href="https://github.com/jekyll/jekyll/issues/5513">#5513</a>)</li>
617
+ <li>Use Addressable instead of URI to decode (<a href="https://github.com/jekyll/jekyll/issues/5726">#5726</a>)</li>
618
+ <li>throw IncludeTagError if error occurs in included file (<a href="https://github.com/jekyll/jekyll/issues/5767">#5767</a>)</li>
619
+ <li>Write Jekyll::Utils::Exec.run for running shell commands. (<a href="https://github.com/jekyll/jekyll/issues/5640">#5640</a>)</li>
620
+ <li>Use the current year for the LICENSE of theme (<a href="https://github.com/jekyll/jekyll/issues/5712">#5712</a>)</li>
621
+ <li>Update License (<a href="https://github.com/jekyll/jekyll/issues/5713">#5713</a>)</li>
523
622
  </ul>
524
623
 
525
624
  <h3 id="bug-fixes-v3-4-0">Bug Fixes</h3>
526
625
 
527
626
  <ul>
528
- <li>Escaped regular expressions when using <code class="highlighter-rouge">post_url</code>. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5605">#5605</a>)</li>
529
- <li>fix date parsing in file names to be stricter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5609">#5609</a>)</li>
530
- <li>Add a module to re-define <code class="highlighter-rouge">ENV["TZ"]</code> in Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5612">#5612</a>)</li>
531
- <li>Use each instead of map to actually return nothing (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5668">#5668</a>)</li>
532
- <li>include: fix ‘no implicit conversion of nil to String’ (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5750">#5750</a>)</li>
533
- <li>Don’t include the theme’s includes_path if it is nil. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5780">#5780</a>)</li>
534
- <li>test double slash when input = ‘/’ (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5542">#5542</a>)</li>
535
- <li>use logger.info for related posts (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5822">#5822</a>)</li>
627
+ <li>Escaped regular expressions when using <code class="highlighter-rouge">post_url</code>. (<a href="https://github.com/jekyll/jekyll/issues/5605">#5605</a>)</li>
628
+ <li>fix date parsing in file names to be stricter (<a href="https://github.com/jekyll/jekyll/issues/5609">#5609</a>)</li>
629
+ <li>Add a module to re-define <code class="highlighter-rouge">ENV["TZ"]</code> in Windows (<a href="https://github.com/jekyll/jekyll/issues/5612">#5612</a>)</li>
630
+ <li>Use each instead of map to actually return nothing (<a href="https://github.com/jekyll/jekyll/issues/5668">#5668</a>)</li>
631
+ <li>include: fix ‘no implicit conversion of nil to String’ (<a href="https://github.com/jekyll/jekyll/issues/5750">#5750</a>)</li>
632
+ <li>Don’t include the theme’s includes_path if it is nil. (<a href="https://github.com/jekyll/jekyll/issues/5780">#5780</a>)</li>
633
+ <li>test double slash when input = ‘/’ (<a href="https://github.com/jekyll/jekyll/issues/5542">#5542</a>)</li>
634
+ <li>use logger.info for related posts (<a href="https://github.com/jekyll/jekyll/issues/5822">#5822</a>)</li>
536
635
  </ul>
537
636
 
538
637
  <h3 id="site-enhancements-v3-4-0">Site Enhancements</h3>
539
638
 
540
639
  <ul>
541
- <li>Use only the used Font Awesome icons. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5530">#5530</a>)</li>
542
- <li>Switch to <code class="highlighter-rouge">https</code> when possible. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5611">#5611</a>)</li>
543
- <li>Update <code class="highlighter-rouge">_font-awesome.scss</code> to move .woff file before .ttf (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5614">#5614</a>)</li>
544
- <li>Update documentation on updating FontAwesome Iconset (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5655">#5655</a>)</li>
545
- <li>[site] Use defaults for docs and news-items (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5744">#5744</a>)</li>
546
- <li>Sort gems in <code class="highlighter-rouge">docs/_config.yml</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5746">#5746</a>)</li>
547
- <li>Add missing class (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5791">#5791</a>)</li>
548
- <li>Improve template docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5694">#5694</a>)</li>
640
+ <li>Use only the used Font Awesome icons. (<a href="https://github.com/jekyll/jekyll/issues/5530">#5530</a>)</li>
641
+ <li>Switch to <code class="highlighter-rouge">https</code> when possible. (<a href="https://github.com/jekyll/jekyll/issues/5611">#5611</a>)</li>
642
+ <li>Update <code class="highlighter-rouge">_font-awesome.scss</code> to move .woff file before .ttf (<a href="https://github.com/jekyll/jekyll/issues/5614">#5614</a>)</li>
643
+ <li>Update documentation on updating FontAwesome Iconset (<a href="https://github.com/jekyll/jekyll/issues/5655">#5655</a>)</li>
644
+ <li>[site] Use defaults for docs and news-items (<a href="https://github.com/jekyll/jekyll/issues/5744">#5744</a>)</li>
645
+ <li>Sort gems in <code class="highlighter-rouge">docs/_config.yml</code> (<a href="https://github.com/jekyll/jekyll/issues/5746">#5746</a>)</li>
646
+ <li>Add missing class (<a href="https://github.com/jekyll/jekyll/issues/5791">#5791</a>)</li>
647
+ <li>Improve template docs (<a href="https://github.com/jekyll/jekyll/issues/5694">#5694</a>)</li>
549
648
  </ul>
550
649
 
551
650
  <h3 id="development-fixes-v3-4-0">Development Fixes</h3>
552
651
 
553
652
  <ul>
554
- <li>clean unit-test names in <code class="highlighter-rouge">test/test_tags.rb</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5608">#5608</a>)</li>
555
- <li>Add cucumber feature to test for bonafide theme gems (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5384">#5384</a>)</li>
556
- <li>Use <code class="highlighter-rouge">assert_nil</code> instead of <code class="highlighter-rouge">assert_equal nil</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5652">#5652</a>)</li>
557
- <li>Rubocop -a on lib/jekyll (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5666">#5666</a>)</li>
558
- <li>Bump to rake 12.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5670">#5670</a>)</li>
559
- <li>Rubocop Gemfile (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5671">#5671</a>)</li>
560
- <li>update Classifier-Reborn to 2.1.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5711">#5711</a>)</li>
561
- <li>Rubocop: fix Rakefile and gemspec (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5745">#5745</a>)</li>
562
- <li>Use <code class="highlighter-rouge">assert_nil</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5725">#5725</a>)</li>
563
- <li>Sort gems in <code class="highlighter-rouge">jekyll.gemspec</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5746">#5746</a>)</li>
564
- <li>Rubocop: Require consistent comma in multiline literals (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5761">#5761</a>)</li>
565
- <li>Bump rubocop (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5765">#5765</a>)</li>
566
- <li>New rubocop security checks (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5768">#5768</a>)</li>
567
- <li>test/helper: fix flaky plugin path test by removing calls to Dir.chdir without a block (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5779">#5779</a>)</li>
568
- <li>Use latest jemoji gem (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5782">#5782</a>)</li>
569
- <li>Bump htmlproofer (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5781">#5781</a>)</li>
570
- <li>Bump rubies we test against (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5784">#5784</a>)</li>
571
- <li>Bump rdoc to v5.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5797">#5797</a>)</li>
572
- <li>Bump codeclimate-test-reporter to v1.0.5 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5798">#5798</a>)</li>
573
- </ul>
574
-
575
- <h3 id="documentation-2">Documentation</h3>
576
-
577
- <ul>
578
- <li>Improve quickstart docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5689">#5689</a>)</li>
579
- <li>Add Jekyll-Post to list of plugins (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5705">#5705</a>)</li>
580
- <li>Add jekyll-numbered-headings (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5688">#5688</a>)</li>
581
- <li>Docs: move permalinks from documents into config (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5544">#5544</a>)</li>
582
- <li>Improve collections docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5691">#5691</a>)</li>
583
- <li>Fix <a href="%7B%7B%20site.repository%20%7D%7D/issues/5730">#5730</a>: add gcc and make to the list of requirements (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5731">#5731</a>)</li>
584
- <li>Remove instructions to install Jekyll 2 on Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5582">#5582</a>)</li>
585
- <li>Fix example URL inconsistency (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5592">#5592</a>)</li>
586
- <li>Replace backticks within HTML blocks with HTML tags (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5435">#5435</a>)</li>
587
- <li>Add jekyll-migrate-permalink (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5600">#5600</a>)</li>
588
- <li>Fix bad config YAML in collections example (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5587">#5587</a>)</li>
589
- <li>Bring documentation on ‘Directory Structure’ up-to-date (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5573">#5573</a>)</li>
590
- <li>Fixed typo (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5632">#5632</a>)</li>
591
- <li>use backticks for Gemfile for consistency since in the next sentence … (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5641">#5641</a>)</li>
592
- <li>Update Core team list in the README file (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5643">#5643</a>)</li>
593
- <li>Improve Permalinks documentation. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5653">#5653</a>)</li>
594
- <li>Fix typo in Variables doc page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5657">#5657</a>)</li>
595
- <li>Fix a couple of typos in the docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5658">#5658</a>)</li>
596
- <li>Update windows.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5683">#5683</a>)</li>
597
- <li>Improve permalinks docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5693">#5693</a>)</li>
598
- <li>Document –unpublished build option (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5720">#5720</a>)</li>
599
- <li>Improve pages docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5692">#5692</a>)</li>
600
- <li>Added new includes.md topic to docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5696">#5696</a>)</li>
601
- <li>Replace a dead link with a web-archived one (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5738">#5738</a>)</li>
602
- <li>Remove duplicate paragraph. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5740">#5740</a>)</li>
603
- <li>Addition of a sample “typical post” (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5473">#5473</a>)</li>
604
- <li>Fix a minor grammatical mistake on themes’ document ### -dev (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5748">#5748</a>)</li>
605
- <li>Correct comments in data_reader.rb (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5621">#5621</a>)</li>
606
- <li>Add jekyll-pre-commit to plugins list (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5752">#5752</a>)</li>
607
- <li>Update quickstart.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5758">#5758</a>)</li>
608
- <li>Correct minor typo (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5764">#5764</a>)</li>
609
- <li>Fix a markdown link to look properly on the web (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5769">#5769</a>)</li>
610
- <li>[docs] Info about the help command usage (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5312">#5312</a>)</li>
611
- <li>Add missing merge labels for jekyllbot (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5753">#5753</a>)</li>
612
- <li>Fix broken links in documentation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5736">#5736</a>)</li>
613
- <li>Docs: add <code class="highlighter-rouge">match_regex</code> and <code class="highlighter-rouge">replace_regex</code> filters (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5799">#5799</a>)</li>
614
- <li>Got that diaper money? (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5810">#5810</a>)</li>
615
- <li>Sort content by popularity using Google Analytics (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5812">#5812</a>)</li>
616
- <li>Rework CI doc to include multiple providers. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5815">#5815</a>)</li>
617
- <li>Improve theme docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5690">#5690</a>)</li>
618
- <li>Add mention of classifier-reborn for LSI (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5811">#5811</a>)</li>
619
- <li>Added note about –blank flag (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5802">#5802</a>)</li>
620
- <li>Fixed inaccuracy in “Built-in permalink styles” docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5819">#5819</a>)</li>
653
+ <li>clean unit-test names in <code class="highlighter-rouge">test/test_tags.rb</code> (<a href="https://github.com/jekyll/jekyll/issues/5608">#5608</a>)</li>
654
+ <li>Add cucumber feature to test for bonafide theme gems (<a href="https://github.com/jekyll/jekyll/issues/5384">#5384</a>)</li>
655
+ <li>Use <code class="highlighter-rouge">assert_nil</code> instead of <code class="highlighter-rouge">assert_equal nil</code> (<a href="https://github.com/jekyll/jekyll/issues/5652">#5652</a>)</li>
656
+ <li>Rubocop -a on lib/jekyll (<a href="https://github.com/jekyll/jekyll/issues/5666">#5666</a>)</li>
657
+ <li>Bump to rake 12.0 (<a href="https://github.com/jekyll/jekyll/issues/5670">#5670</a>)</li>
658
+ <li>Rubocop Gemfile (<a href="https://github.com/jekyll/jekyll/issues/5671">#5671</a>)</li>
659
+ <li>update Classifier-Reborn to 2.1.0 (<a href="https://github.com/jekyll/jekyll/issues/5711">#5711</a>)</li>
660
+ <li>Rubocop: fix Rakefile and gemspec (<a href="https://github.com/jekyll/jekyll/issues/5745">#5745</a>)</li>
661
+ <li>Use <code class="highlighter-rouge">assert_nil</code> (<a href="https://github.com/jekyll/jekyll/issues/5725">#5725</a>)</li>
662
+ <li>Sort gems in <code class="highlighter-rouge">jekyll.gemspec</code> (<a href="https://github.com/jekyll/jekyll/issues/5746">#5746</a>)</li>
663
+ <li>Rubocop: Require consistent comma in multiline literals (<a href="https://github.com/jekyll/jekyll/issues/5761">#5761</a>)</li>
664
+ <li>Bump rubocop (<a href="https://github.com/jekyll/jekyll/issues/5765">#5765</a>)</li>
665
+ <li>New rubocop security checks (<a href="https://github.com/jekyll/jekyll/issues/5768">#5768</a>)</li>
666
+ <li>test/helper: fix flaky plugin path test by removing calls to Dir.chdir without a block (<a href="https://github.com/jekyll/jekyll/issues/5779">#5779</a>)</li>
667
+ <li>Use latest jemoji gem (<a href="https://github.com/jekyll/jekyll/issues/5782">#5782</a>)</li>
668
+ <li>Bump htmlproofer (<a href="https://github.com/jekyll/jekyll/issues/5781">#5781</a>)</li>
669
+ <li>Bump rubies we test against (<a href="https://github.com/jekyll/jekyll/issues/5784">#5784</a>)</li>
670
+ <li>Bump rdoc to v5.0 (<a href="https://github.com/jekyll/jekyll/issues/5797">#5797</a>)</li>
671
+ <li>Bump codeclimate-test-reporter to v1.0.5 (<a href="https://github.com/jekyll/jekyll/issues/5798">#5798</a>)</li>
672
+ </ul>
673
+
674
+ <h3 id="documentation-3">Documentation</h3>
675
+
676
+ <ul>
677
+ <li>Improve quickstart docs (<a href="https://github.com/jekyll/jekyll/issues/5689">#5689</a>)</li>
678
+ <li>Add Jekyll-Post to list of plugins (<a href="https://github.com/jekyll/jekyll/issues/5705">#5705</a>)</li>
679
+ <li>Add jekyll-numbered-headings (<a href="https://github.com/jekyll/jekyll/issues/5688">#5688</a>)</li>
680
+ <li>Docs: move permalinks from documents into config (<a href="https://github.com/jekyll/jekyll/issues/5544">#5544</a>)</li>
681
+ <li>Improve collections docs (<a href="https://github.com/jekyll/jekyll/issues/5691">#5691</a>)</li>
682
+ <li>Fix <a href="https://github.com/jekyll/jekyll/issues/5730">#5730</a>: add gcc and make to the list of requirements (<a href="https://github.com/jekyll/jekyll/issues/5731">#5731</a>)</li>
683
+ <li>Remove instructions to install Jekyll 2 on Windows (<a href="https://github.com/jekyll/jekyll/issues/5582">#5582</a>)</li>
684
+ <li>Fix example URL inconsistency (<a href="https://github.com/jekyll/jekyll/issues/5592">#5592</a>)</li>
685
+ <li>Replace backticks within HTML blocks with HTML tags (<a href="https://github.com/jekyll/jekyll/issues/5435">#5435</a>)</li>
686
+ <li>Add jekyll-migrate-permalink (<a href="https://github.com/jekyll/jekyll/issues/5600">#5600</a>)</li>
687
+ <li>Fix bad config YAML in collections example (<a href="https://github.com/jekyll/jekyll/issues/5587">#5587</a>)</li>
688
+ <li>Bring documentation on ‘Directory Structure’ up-to-date (<a href="https://github.com/jekyll/jekyll/issues/5573">#5573</a>)</li>
689
+ <li>Fixed typo (<a href="https://github.com/jekyll/jekyll/issues/5632">#5632</a>)</li>
690
+ <li>use backticks for Gemfile for consistency since in the next sentence … (<a href="https://github.com/jekyll/jekyll/issues/5641">#5641</a>)</li>
691
+ <li>Update Core team list in the README file (<a href="https://github.com/jekyll/jekyll/issues/5643">#5643</a>)</li>
692
+ <li>Improve Permalinks documentation. (<a href="https://github.com/jekyll/jekyll/issues/5653">#5653</a>)</li>
693
+ <li>Fix typo in Variables doc page (<a href="https://github.com/jekyll/jekyll/issues/5657">#5657</a>)</li>
694
+ <li>Fix a couple of typos in the docs (<a href="https://github.com/jekyll/jekyll/issues/5658">#5658</a>)</li>
695
+ <li>Update windows.md (<a href="https://github.com/jekyll/jekyll/issues/5683">#5683</a>)</li>
696
+ <li>Improve permalinks docs (<a href="https://github.com/jekyll/jekyll/issues/5693">#5693</a>)</li>
697
+ <li>Document –unpublished build option (<a href="https://github.com/jekyll/jekyll/issues/5720">#5720</a>)</li>
698
+ <li>Improve pages docs (<a href="https://github.com/jekyll/jekyll/issues/5692">#5692</a>)</li>
699
+ <li>Added new includes.md topic to docs (<a href="https://github.com/jekyll/jekyll/issues/5696">#5696</a>)</li>
700
+ <li>Replace a dead link with a web-archived one (<a href="https://github.com/jekyll/jekyll/issues/5738">#5738</a>)</li>
701
+ <li>Remove duplicate paragraph. (<a href="https://github.com/jekyll/jekyll/issues/5740">#5740</a>)</li>
702
+ <li>Addition of a sample “typical post” (<a href="https://github.com/jekyll/jekyll/issues/5473">#5473</a>)</li>
703
+ <li>Fix a minor grammatical mistake on themes’ document ### -dev (<a href="https://github.com/jekyll/jekyll/issues/5748">#5748</a>)</li>
704
+ <li>Correct comments in data_reader.rb (<a href="https://github.com/jekyll/jekyll/issues/5621">#5621</a>)</li>
705
+ <li>Add jekyll-pre-commit to plugins list (<a href="https://github.com/jekyll/jekyll/issues/5752">#5752</a>)</li>
706
+ <li>Update quickstart.md (<a href="https://github.com/jekyll/jekyll/issues/5758">#5758</a>)</li>
707
+ <li>Correct minor typo (<a href="https://github.com/jekyll/jekyll/issues/5764">#5764</a>)</li>
708
+ <li>Fix a markdown link to look properly on the web (<a href="https://github.com/jekyll/jekyll/issues/5769">#5769</a>)</li>
709
+ <li>[docs] Info about the help command usage (<a href="https://github.com/jekyll/jekyll/issues/5312">#5312</a>)</li>
710
+ <li>Add missing merge labels for jekyllbot (<a href="https://github.com/jekyll/jekyll/issues/5753">#5753</a>)</li>
711
+ <li>Fix broken links in documentation (<a href="https://github.com/jekyll/jekyll/issues/5736">#5736</a>)</li>
712
+ <li>Docs: add <code class="highlighter-rouge">match_regex</code> and <code class="highlighter-rouge">replace_regex</code> filters (<a href="https://github.com/jekyll/jekyll/issues/5799">#5799</a>)</li>
713
+ <li>Got that diaper money? (<a href="https://github.com/jekyll/jekyll/issues/5810">#5810</a>)</li>
714
+ <li>Sort content by popularity using Google Analytics (<a href="https://github.com/jekyll/jekyll/issues/5812">#5812</a>)</li>
715
+ <li>Rework CI doc to include multiple providers. (<a href="https://github.com/jekyll/jekyll/issues/5815">#5815</a>)</li>
716
+ <li>Improve theme docs (<a href="https://github.com/jekyll/jekyll/issues/5690">#5690</a>)</li>
717
+ <li>Add mention of classifier-reborn for LSI (<a href="https://github.com/jekyll/jekyll/issues/5811">#5811</a>)</li>
718
+ <li>Added note about –blank flag (<a href="https://github.com/jekyll/jekyll/issues/5802">#5802</a>)</li>
719
+ <li>Fixed inaccuracy in “Built-in permalink styles” docs (<a href="https://github.com/jekyll/jekyll/issues/5819">#5819</a>)</li>
621
720
  </ul>
622
721
 
623
722
  <h2 id="v3-3-1">3.3.1 / 2016-11-14</h2>
@@ -625,62 +724,62 @@
625
724
  <h3 id="minor-enhancements-v3-3-1">Minor Enhancements</h3>
626
725
 
627
726
  <ul>
628
- <li>Collapse <code class="highlighter-rouge">gsub</code> for performance (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5494">#5494</a>)</li>
629
- <li>URL: warn if key doesn’t exist in url drop (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5524">#5524</a>)</li>
727
+ <li>Collapse <code class="highlighter-rouge">gsub</code> for performance (<a href="https://github.com/jekyll/jekyll/issues/5494">#5494</a>)</li>
728
+ <li>URL: warn if key doesn’t exist in url drop (<a href="https://github.com/jekyll/jekyll/issues/5524">#5524</a>)</li>
630
729
  </ul>
631
730
 
632
731
  <h3 id="bug-fixes-v3-3-1">Bug Fixes</h3>
633
732
 
634
733
  <ul>
635
- <li>Fix typo in <code class="highlighter-rouge">theme_template</code> README (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5472">#5472</a>)</li>
636
- <li>Do not swallow all exceptions on render (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5495">#5495</a>)</li>
637
- <li>Site template: fixed <code class="highlighter-rouge">_config.yml</code> comment typo (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5511">#5511</a>)</li>
734
+ <li>Fix typo in <code class="highlighter-rouge">theme_template</code> README (<a href="https://github.com/jekyll/jekyll/issues/5472">#5472</a>)</li>
735
+ <li>Do not swallow all exceptions on render (<a href="https://github.com/jekyll/jekyll/issues/5495">#5495</a>)</li>
736
+ <li>Site template: fixed <code class="highlighter-rouge">_config.yml</code> comment typo (<a href="https://github.com/jekyll/jekyll/issues/5511">#5511</a>)</li>
638
737
  <li>
639
- <code class="highlighter-rouge">jekyll new-theme</code> should specify Jekyll as a runtime dependency for the theme (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5457">#5457</a>)</li>
640
- <li>Be much more specific about ignoring specific vendored directories. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5564">#5564</a>)</li>
641
- <li>Only warn about auto-regeneration bug on Bash On Windows. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5464">#5464</a>)</li>
642
- <li>Allow permalink template to have underscores (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5572">#5572</a>)</li>
738
+ <code class="highlighter-rouge">jekyll new-theme</code> should specify Jekyll as a runtime dependency for the theme (<a href="https://github.com/jekyll/jekyll/issues/5457">#5457</a>)</li>
739
+ <li>Be much more specific about ignoring specific vendored directories. (<a href="https://github.com/jekyll/jekyll/issues/5564">#5564</a>)</li>
740
+ <li>Only warn about auto-regeneration bug on Bash On Windows. (<a href="https://github.com/jekyll/jekyll/issues/5464">#5464</a>)</li>
741
+ <li>Allow permalink template to have underscores (<a href="https://github.com/jekyll/jekyll/issues/5572">#5572</a>)</li>
643
742
  </ul>
644
743
 
645
744
  <h3 id="site-enhancements-v3-3-1">Site Enhancements</h3>
646
745
 
647
746
  <ul>
648
- <li>Documentation: <code class="highlighter-rouge">link</code> Liquid tag (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5449">#5449</a>)</li>
649
- <li>Updating install instruction link for Jekyll 3 on Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5475">#5475</a>)</li>
650
- <li>Update normalize.css to v5.0.0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5471">#5471</a>)</li>
651
- <li>Add jekyll-data to the list of plugins (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5491">#5491</a>)</li>
652
- <li>Add info about checking version + updating (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5497">#5497</a>)</li>
653
- <li>Add jekyll-include-absolute-plugin to list of third-party plugins (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5492">#5492</a>)</li>
654
- <li>Remove jekyll-hook from deployment methods (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5502">#5502</a>)</li>
655
- <li>Update deployment-methods.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5504">#5504</a>)</li>
656
- <li>Ubuntu users should install ruby2.3-dev (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5512">#5512</a>)</li>
657
- <li>Remove Glynn as deployment option (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5519">#5519</a>)</li>
658
- <li>Fix broken forum link (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5466">#5466</a>)</li>
659
- <li>Move documentation to docs folder (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5459">#5459</a>)</li>
660
- <li>Fix broken links in CONTRIBUTING (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5533">#5533</a>)</li>
661
- <li>Update documentation on jekyllrb.com (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5540">#5540</a>)</li>
662
- <li>Fix HTML rendering (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5536">#5536</a>)</li>
663
- <li>Remove outdated deployment information (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5557">#5557</a>)</li>
664
- <li>no more invalid US-ASCII on lines 30 and 97 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5520">#5520</a>)</li>
665
- <li>Add permalinks to docs in ‘/maintaining/’ (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5532">#5532</a>)</li>
666
- <li>Add jekyll-pinboard to list of third-party plugins (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5514">#5514</a>)</li>
667
- <li>Fix formatting in 2-to-3.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5507">#5507</a>)</li>
668
- <li>Add two plugins to the plugins page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5493">#5493</a>)</li>
669
- <li>Use site.baseurl before link and post_url tags (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5559">#5559</a>)</li>
670
- <li>Fix link to jekyll-pinboard plugin (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5570">#5570</a>)</li>
671
- <li>mention <code class="highlighter-rouge">docs</code> folder as a way to deploy on GitHub Pages (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5571">#5571</a>)</li>
747
+ <li>Documentation: <code class="highlighter-rouge">link</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/5449">#5449</a>)</li>
748
+ <li>Updating install instruction link for Jekyll 3 on Windows (<a href="https://github.com/jekyll/jekyll/issues/5475">#5475</a>)</li>
749
+ <li>Update normalize.css to v5.0.0 (<a href="https://github.com/jekyll/jekyll/issues/5471">#5471</a>)</li>
750
+ <li>Add jekyll-data to the list of plugins (<a href="https://github.com/jekyll/jekyll/issues/5491">#5491</a>)</li>
751
+ <li>Add info about checking version + updating (<a href="https://github.com/jekyll/jekyll/issues/5497">#5497</a>)</li>
752
+ <li>Add jekyll-include-absolute-plugin to list of third-party plugins (<a href="https://github.com/jekyll/jekyll/issues/5492">#5492</a>)</li>
753
+ <li>Remove jekyll-hook from deployment methods (<a href="https://github.com/jekyll/jekyll/issues/5502">#5502</a>)</li>
754
+ <li>Update deployment-methods.md (<a href="https://github.com/jekyll/jekyll/issues/5504">#5504</a>)</li>
755
+ <li>Ubuntu users should install ruby2.3-dev (<a href="https://github.com/jekyll/jekyll/issues/5512">#5512</a>)</li>
756
+ <li>Remove Glynn as deployment option (<a href="https://github.com/jekyll/jekyll/issues/5519">#5519</a>)</li>
757
+ <li>Fix broken forum link (<a href="https://github.com/jekyll/jekyll/issues/5466">#5466</a>)</li>
758
+ <li>Move documentation to docs folder (<a href="https://github.com/jekyll/jekyll/issues/5459">#5459</a>)</li>
759
+ <li>Fix broken links in CONTRIBUTING (<a href="https://github.com/jekyll/jekyll/issues/5533">#5533</a>)</li>
760
+ <li>Update documentation on jekyllrb.com (<a href="https://github.com/jekyll/jekyll/issues/5540">#5540</a>)</li>
761
+ <li>Fix HTML rendering (<a href="https://github.com/jekyll/jekyll/issues/5536">#5536</a>)</li>
762
+ <li>Remove outdated deployment information (<a href="https://github.com/jekyll/jekyll/issues/5557">#5557</a>)</li>
763
+ <li>no more invalid US-ASCII on lines 30 and 97 (<a href="https://github.com/jekyll/jekyll/issues/5520">#5520</a>)</li>
764
+ <li>Add permalinks to docs in ‘/maintaining/’ (<a href="https://github.com/jekyll/jekyll/issues/5532">#5532</a>)</li>
765
+ <li>Add jekyll-pinboard to list of third-party plugins (<a href="https://github.com/jekyll/jekyll/issues/5514">#5514</a>)</li>
766
+ <li>Fix formatting in 2-to-3.md (<a href="https://github.com/jekyll/jekyll/issues/5507">#5507</a>)</li>
767
+ <li>Add two plugins to the plugins page (<a href="https://github.com/jekyll/jekyll/issues/5493">#5493</a>)</li>
768
+ <li>Use site.baseurl before link and post_url tags (<a href="https://github.com/jekyll/jekyll/issues/5559">#5559</a>)</li>
769
+ <li>Fix link to jekyll-pinboard plugin (<a href="https://github.com/jekyll/jekyll/issues/5570">#5570</a>)</li>
770
+ <li>mention <code class="highlighter-rouge">docs</code> folder as a way to deploy on GitHub Pages (<a href="https://github.com/jekyll/jekyll/issues/5571">#5571</a>)</li>
672
771
  </ul>
673
772
 
674
773
  <h3 id="development-fixes-v3-3-1">Development Fixes</h3>
675
774
 
676
775
  <ul>
677
- <li>fix rubocop errors on testing with Rubocop 0.44 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5489">#5489</a>)</li>
678
- <li>script/test: add missing whitespace (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5479">#5479</a>)</li>
679
- <li>Restrict Rubocop version (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5496">#5496</a>)</li>
680
- <li>include a hashbang for all benchmark scripts &amp; make them executable (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5505">#5505</a>)</li>
681
- <li>Update source in script/proof (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5538">#5538</a>)</li>
682
- <li>Collections.feature: conditional steps to have it pass on Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5546">#5546</a>)</li>
683
- <li>Fix tests to get script/test to pass on Windows (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5526">#5526</a>)</li>
776
+ <li>fix rubocop errors on testing with Rubocop 0.44 (<a href="https://github.com/jekyll/jekyll/issues/5489">#5489</a>)</li>
777
+ <li>script/test: add missing whitespace (<a href="https://github.com/jekyll/jekyll/issues/5479">#5479</a>)</li>
778
+ <li>Restrict Rubocop version (<a href="https://github.com/jekyll/jekyll/issues/5496">#5496</a>)</li>
779
+ <li>include a hashbang for all benchmark scripts &amp; make them executable (<a href="https://github.com/jekyll/jekyll/issues/5505">#5505</a>)</li>
780
+ <li>Update source in script/proof (<a href="https://github.com/jekyll/jekyll/issues/5538">#5538</a>)</li>
781
+ <li>Collections.feature: conditional steps to have it pass on Windows (<a href="https://github.com/jekyll/jekyll/issues/5546">#5546</a>)</li>
782
+ <li>Fix tests to get script/test to pass on Windows (<a href="https://github.com/jekyll/jekyll/issues/5526">#5526</a>)</li>
684
783
  </ul>
685
784
 
686
785
  <h2 id="v3-3-0">3.3.0 / 2016-10-06</h2>
@@ -688,110 +787,110 @@
688
787
  <h3 id="minor-enhancements-v3-3-0">Minor Enhancements</h3>
689
788
 
690
789
  <ul>
691
- <li>Colorize interpolated output in logger.info (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5239">#5239</a>)</li>
692
- <li>Site template: exclude Gemfile and Gemfile.lock in site config (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5293">#5293</a>)</li>
693
- <li>Fix <a href="%7B%7B%20site.repository%20%7D%7D/issues/5233">#5233</a>: Increase our ability to detect Windows. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5235">#5235</a>)</li>
694
- <li>update gitignore template to ignore theme gems built by user (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5326">#5326</a>)</li>
695
- <li>Adds ability to link to all files (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5199">#5199</a>)</li>
696
- <li>Exclude vendor by default (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5361">#5361</a>)</li>
697
- <li>Add ThemeAssetsReader which reads assets from a theme (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5364">#5364</a>)</li>
698
- <li>Add bundle install to jekyll new command (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5237">#5237</a>)</li>
699
- <li>Add absolute_url and relative_url filters. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5399">#5399</a>)</li>
700
- <li>Site template: remove <code class="highlighter-rouge">css/</code> from new site scaffolding (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5402">#5402</a>)</li>
701
- <li>Site template: Move contents of the index.html page to the ‘home’ layout (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5420">#5420</a>)</li>
702
- <li>Exclude node_modules by default (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5210">#5210</a>)</li>
703
- <li>Run hooks in priority order. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5157">#5157</a>)</li>
704
- <li>Add <code class="highlighter-rouge">static_file.name</code> and <code class="highlighter-rouge">.basename</code> Liquid attributes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5264">#5264</a>)</li>
705
- <li>set site.url in dev environment to <code class="highlighter-rouge">http://localhost:4000</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5431">#5431</a>)</li>
706
- <li>Add support for indented link references on excerpt (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5212">#5212</a>)</li>
790
+ <li>Colorize interpolated output in logger.info (<a href="https://github.com/jekyll/jekyll/issues/5239">#5239</a>)</li>
791
+ <li>Site template: exclude Gemfile and Gemfile.lock in site config (<a href="https://github.com/jekyll/jekyll/issues/5293">#5293</a>)</li>
792
+ <li>Fix <a href="https://github.com/jekyll/jekyll/issues/5233">#5233</a>: Increase our ability to detect Windows. (<a href="https://github.com/jekyll/jekyll/issues/5235">#5235</a>)</li>
793
+ <li>update gitignore template to ignore theme gems built by user (<a href="https://github.com/jekyll/jekyll/issues/5326">#5326</a>)</li>
794
+ <li>Adds ability to link to all files (<a href="https://github.com/jekyll/jekyll/issues/5199">#5199</a>)</li>
795
+ <li>Exclude vendor by default (<a href="https://github.com/jekyll/jekyll/issues/5361">#5361</a>)</li>
796
+ <li>Add ThemeAssetsReader which reads assets from a theme (<a href="https://github.com/jekyll/jekyll/issues/5364">#5364</a>)</li>
797
+ <li>Add bundle install to jekyll new command (<a href="https://github.com/jekyll/jekyll/issues/5237">#5237</a>)</li>
798
+ <li>Add absolute_url and relative_url filters. (<a href="https://github.com/jekyll/jekyll/issues/5399">#5399</a>)</li>
799
+ <li>Site template: remove <code class="highlighter-rouge">css/</code> from new site scaffolding (<a href="https://github.com/jekyll/jekyll/issues/5402">#5402</a>)</li>
800
+ <li>Site template: Move contents of the index.html page to the ‘home’ layout (<a href="https://github.com/jekyll/jekyll/issues/5420">#5420</a>)</li>
801
+ <li>Exclude node_modules by default (<a href="https://github.com/jekyll/jekyll/issues/5210">#5210</a>)</li>
802
+ <li>Run hooks in priority order. (<a href="https://github.com/jekyll/jekyll/issues/5157">#5157</a>)</li>
803
+ <li>Add <code class="highlighter-rouge">static_file.name</code> and <code class="highlighter-rouge">.basename</code> Liquid attributes (<a href="https://github.com/jekyll/jekyll/issues/5264">#5264</a>)</li>
804
+ <li>set site.url in dev environment to <code class="highlighter-rouge">http://localhost:4000</code> (<a href="https://github.com/jekyll/jekyll/issues/5431">#5431</a>)</li>
805
+ <li>Add support for indented link references on excerpt (<a href="https://github.com/jekyll/jekyll/issues/5212">#5212</a>)</li>
707
806
  </ul>
708
807
 
709
808
  <h3 id="bug-fixes-v3-3-0">Bug Fixes</h3>
710
809
 
711
810
  <ul>
712
- <li>Use jekyll-feed to generate the default site’s RSS feed (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5196">#5196</a>)</li>
713
- <li>Site#configure_theme: do not set theme unless it’s a string (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5189">#5189</a>)</li>
714
- <li>Convertible: set self.output in #render_all_layouts and #do_layout (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5337">#5337</a>)</li>
715
- <li>Only complain about <code class="highlighter-rouge">kramdown.coderay</code> if it is actually in the config (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5380">#5380</a>)</li>
716
- <li>Clarify documentation in theme gem’s README template (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5376">#5376</a>)</li>
717
- <li>Allow underscore in highlighter language (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5375">#5375</a>)</li>
718
- <li>Site template: set empty url in config file by default (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5338">#5338</a>)</li>
719
- <li>Site template config: prepend ‘jekyll serve’ with ‘bundle exec’ (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5430">#5430</a>)</li>
720
- <li>Don’t call <code class="highlighter-rouge">File.utime</code> for StaticFiles if it’s a symlink (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5427">#5427</a>)</li>
721
- <li>Fix handling of non-ASCII characters in new <code class="highlighter-rouge">*_url</code> filters (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5410">#5410</a>)</li>
722
- <li>Remove autoload of Draft which no longer exists. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5441">#5441</a>)</li>
723
- <li>Fix issue where Windows drive name is stripped from Jekyll.sanitized_path incorrectly (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5256">#5256</a>)</li>
724
- <li>Fix bug where <code class="highlighter-rouge">post_url</code> tag matched incorrect post with subdirectory (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4873">#4873</a>)</li>
725
- <li>Fix loading data from subdir with a period in name (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5433">#5433</a>)</li>
726
- <li>Revert Commands::Serve#server_address signature change. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5456">#5456</a>)</li>
811
+ <li>Use jekyll-feed to generate the default site’s RSS feed (<a href="https://github.com/jekyll/jekyll/issues/5196">#5196</a>)</li>
812
+ <li>Site#configure_theme: do not set theme unless it’s a string (<a href="https://github.com/jekyll/jekyll/issues/5189">#5189</a>)</li>
813
+ <li>Convertible: set self.output in #render_all_layouts and #do_layout (<a href="https://github.com/jekyll/jekyll/issues/5337">#5337</a>)</li>
814
+ <li>Only complain about <code class="highlighter-rouge">kramdown.coderay</code> if it is actually in the config (<a href="https://github.com/jekyll/jekyll/issues/5380">#5380</a>)</li>
815
+ <li>Clarify documentation in theme gem’s README template (<a href="https://github.com/jekyll/jekyll/issues/5376">#5376</a>)</li>
816
+ <li>Allow underscore in highlighter language (<a href="https://github.com/jekyll/jekyll/issues/5375">#5375</a>)</li>
817
+ <li>Site template: set empty url in config file by default (<a href="https://github.com/jekyll/jekyll/issues/5338">#5338</a>)</li>
818
+ <li>Site template config: prepend ‘jekyll serve’ with ‘bundle exec’ (<a href="https://github.com/jekyll/jekyll/issues/5430">#5430</a>)</li>
819
+ <li>Don’t call <code class="highlighter-rouge">File.utime</code> for StaticFiles if it’s a symlink (<a href="https://github.com/jekyll/jekyll/issues/5427">#5427</a>)</li>
820
+ <li>Fix handling of non-ASCII characters in new <code class="highlighter-rouge">*_url</code> filters (<a href="https://github.com/jekyll/jekyll/issues/5410">#5410</a>)</li>
821
+ <li>Remove autoload of Draft which no longer exists. (<a href="https://github.com/jekyll/jekyll/issues/5441">#5441</a>)</li>
822
+ <li>Fix issue where Windows drive name is stripped from Jekyll.sanitized_path incorrectly (<a href="https://github.com/jekyll/jekyll/issues/5256">#5256</a>)</li>
823
+ <li>Fix bug where <code class="highlighter-rouge">post_url</code> tag matched incorrect post with subdirectory (<a href="https://github.com/jekyll/jekyll/issues/4873">#4873</a>)</li>
824
+ <li>Fix loading data from subdir with a period in name (<a href="https://github.com/jekyll/jekyll/issues/5433">#5433</a>)</li>
825
+ <li>Revert Commands::Serve#server_address signature change. (<a href="https://github.com/jekyll/jekyll/issues/5456">#5456</a>)</li>
727
826
  </ul>
728
827
 
729
828
  <h3 id="site-enhancements-v3-3-0">Site Enhancements</h3>
730
829
 
731
830
  <ul>
732
- <li>Document <code class="highlighter-rouge">to_integer</code> and <code class="highlighter-rouge">inspect</code> filters (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5185">#5185</a>)</li>
733
- <li>Fix path in the prompt (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5194">#5194</a>)</li>
734
- <li>need subcommand build (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5190">#5190</a>)</li>
735
- <li>Add the Jekyll Cloudinary plugin (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5183">#5183</a>)</li>
736
- <li>Documentation : <code class="highlighter-rouge">new-theme</code> command (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5205">#5205</a>)</li>
737
- <li>Document <code class="highlighter-rouge">link</code> Liquid tag (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5182">#5182</a>)</li>
738
- <li>Remove mention of page for link tag in release post (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5214">#5214</a>)</li>
739
- <li>fixed typo (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5226">#5226</a>)</li>
740
- <li>Add missing comma (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5222">#5222</a>)</li>
741
- <li>Maintain aspect ratio with <code class="highlighter-rouge">height: auto;</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5254">#5254</a>)</li>
742
- <li>Fix a link in deployment-methods.md (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5244">#5244</a>)</li>
743
- <li>Documentation: improve highlight in <code class="highlighter-rouge">Creating a theme</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5249">#5249</a>)</li>
744
- <li>Bundler isn’t installed by default (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5258">#5258</a>)</li>
745
- <li>Update troubleshooting documentation to include fix for issue with vendored gems (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5271">#5271</a>)</li>
746
- <li>Link <code class="highlighter-rouge">--lsi</code> option’s description to Wikipedia docs on LSI (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5274">#5274</a>)</li>
747
- <li>Document <code class="highlighter-rouge">--profile</code> option on the configuration page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5279">#5279</a>)</li>
748
- <li>Update homepage to sync with merge of <a href="%7B%7B%20site.repository%20%7D%7D/issues/5258">#5258</a> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5287">#5287</a>)</li>
749
- <li>Add post about Jekyll Admin initial release (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5291">#5291</a>)</li>
750
- <li>Replace liquid highlight tag with backticks (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5262">#5262</a>)</li>
751
- <li>Word update (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5294">#5294</a>)</li>
752
- <li>Site documentation section links always point to https://jekyllrb.com (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5281">#5281</a>)</li>
753
- <li>Missing <code class="highlighter-rouge">:site, :post_render</code> payload documentation on site (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5280">#5280</a>)</li>
754
- <li>Site: exclude README.md and .gitignore (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5304">#5304</a>)</li>
755
- <li>Add link to Staticman (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5224">#5224</a>)</li>
756
- <li>Update url for OpenShift (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5320">#5320</a>)</li>
757
- <li>[docs] add help for missing static_file e.g. on heroku (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5334">#5334</a>)</li>
758
- <li>Add a line about updating theme-gems in the docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5318">#5318</a>)</li>
759
- <li>Explain how to copy a theme’s files (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5335">#5335</a>)</li>
760
- <li>[docs] .md as default extension in examples (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5316">#5316</a>)</li>
761
- <li>Fix small typo in docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5347">#5347</a>)</li>
762
- <li>Add missing period to sentence in first paragraph. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5372">#5372</a>)</li>
763
- <li>added jekyll-spotify plugin (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5369">#5369</a>)</li>
764
- <li>Add jekyll-menus to the list of plugins. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5397">#5397</a>)</li>
765
- <li>macOS and one grammar fix (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5403">#5403</a>)</li>
766
- <li>Add documentation for <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5405">#5405</a>)</li>
767
- <li>Bugfix on logo in JSON-LD (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5421">#5421</a>)</li>
768
- <li>Fix Travis.ci documentation (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5413">#5413</a>)</li>
769
- <li>[docs] Update documentation regarding <code class="highlighter-rouge">bundle install</code> after <code class="highlighter-rouge">jekyll new</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5428">#5428</a>)</li>
770
- <li>Replace classic box-sizing reset with inheritance reset (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5411">#5411</a>)</li>
771
- <li>Update Wikipedia YAML list link (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5452">#5452</a>)</li>
772
- <li>Add Jekyll 3.3 release post (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5442">#5442</a>)</li>
831
+ <li>Document <code class="highlighter-rouge">to_integer</code> and <code class="highlighter-rouge">inspect</code> filters (<a href="https://github.com/jekyll/jekyll/issues/5185">#5185</a>)</li>
832
+ <li>Fix path in the prompt (<a href="https://github.com/jekyll/jekyll/issues/5194">#5194</a>)</li>
833
+ <li>need subcommand build (<a href="https://github.com/jekyll/jekyll/issues/5190">#5190</a>)</li>
834
+ <li>Add the Jekyll Cloudinary plugin (<a href="https://github.com/jekyll/jekyll/issues/5183">#5183</a>)</li>
835
+ <li>Documentation : <code class="highlighter-rouge">new-theme</code> command (<a href="https://github.com/jekyll/jekyll/issues/5205">#5205</a>)</li>
836
+ <li>Document <code class="highlighter-rouge">link</code> Liquid tag (<a href="https://github.com/jekyll/jekyll/issues/5182">#5182</a>)</li>
837
+ <li>Remove mention of page for link tag in release post (<a href="https://github.com/jekyll/jekyll/issues/5214">#5214</a>)</li>
838
+ <li>fixed typo (<a href="https://github.com/jekyll/jekyll/issues/5226">#5226</a>)</li>
839
+ <li>Add missing comma (<a href="https://github.com/jekyll/jekyll/issues/5222">#5222</a>)</li>
840
+ <li>Maintain aspect ratio with <code class="highlighter-rouge">height: auto;</code> (<a href="https://github.com/jekyll/jekyll/issues/5254">#5254</a>)</li>
841
+ <li>Fix a link in deployment-methods.md (<a href="https://github.com/jekyll/jekyll/issues/5244">#5244</a>)</li>
842
+ <li>Documentation: improve highlight in <code class="highlighter-rouge">Creating a theme</code> (<a href="https://github.com/jekyll/jekyll/issues/5249">#5249</a>)</li>
843
+ <li>Bundler isn’t installed by default (<a href="https://github.com/jekyll/jekyll/issues/5258">#5258</a>)</li>
844
+ <li>Update troubleshooting documentation to include fix for issue with vendored gems (<a href="https://github.com/jekyll/jekyll/issues/5271">#5271</a>)</li>
845
+ <li>Link <code class="highlighter-rouge">--lsi</code> option’s description to Wikipedia docs on LSI (<a href="https://github.com/jekyll/jekyll/issues/5274">#5274</a>)</li>
846
+ <li>Document <code class="highlighter-rouge">--profile</code> option on the configuration page (<a href="https://github.com/jekyll/jekyll/issues/5279">#5279</a>)</li>
847
+ <li>Update homepage to sync with merge of <a href="https://github.com/jekyll/jekyll/issues/5258">#5258</a> (<a href="https://github.com/jekyll/jekyll/issues/5287">#5287</a>)</li>
848
+ <li>Add post about Jekyll Admin initial release (<a href="https://github.com/jekyll/jekyll/issues/5291">#5291</a>)</li>
849
+ <li>Replace liquid highlight tag with backticks (<a href="https://github.com/jekyll/jekyll/issues/5262">#5262</a>)</li>
850
+ <li>Word update (<a href="https://github.com/jekyll/jekyll/issues/5294">#5294</a>)</li>
851
+ <li>Site documentation section links always point to https://jekyllrb.com (<a href="https://github.com/jekyll/jekyll/issues/5281">#5281</a>)</li>
852
+ <li>Missing <code class="highlighter-rouge">:site, :post_render</code> payload documentation on site (<a href="https://github.com/jekyll/jekyll/issues/5280">#5280</a>)</li>
853
+ <li>Site: exclude README.md and .gitignore (<a href="https://github.com/jekyll/jekyll/issues/5304">#5304</a>)</li>
854
+ <li>Add link to Staticman (<a href="https://github.com/jekyll/jekyll/issues/5224">#5224</a>)</li>
855
+ <li>Update url for OpenShift (<a href="https://github.com/jekyll/jekyll/issues/5320">#5320</a>)</li>
856
+ <li>[docs] add help for missing static_file e.g. on heroku (<a href="https://github.com/jekyll/jekyll/issues/5334">#5334</a>)</li>
857
+ <li>Add a line about updating theme-gems in the docs (<a href="https://github.com/jekyll/jekyll/issues/5318">#5318</a>)</li>
858
+ <li>Explain how to copy a theme’s files (<a href="https://github.com/jekyll/jekyll/issues/5335">#5335</a>)</li>
859
+ <li>[docs] .md as default extension in examples (<a href="https://github.com/jekyll/jekyll/issues/5316">#5316</a>)</li>
860
+ <li>Fix small typo in docs (<a href="https://github.com/jekyll/jekyll/issues/5347">#5347</a>)</li>
861
+ <li>Add missing period to sentence in first paragraph. (<a href="https://github.com/jekyll/jekyll/issues/5372">#5372</a>)</li>
862
+ <li>added jekyll-spotify plugin (<a href="https://github.com/jekyll/jekyll/issues/5369">#5369</a>)</li>
863
+ <li>Add jekyll-menus to the list of plugins. (<a href="https://github.com/jekyll/jekyll/issues/5397">#5397</a>)</li>
864
+ <li>macOS and one grammar fix (<a href="https://github.com/jekyll/jekyll/issues/5403">#5403</a>)</li>
865
+ <li>Add documentation for <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> (<a href="https://github.com/jekyll/jekyll/issues/5405">#5405</a>)</li>
866
+ <li>Bugfix on logo in JSON-LD (<a href="https://github.com/jekyll/jekyll/issues/5421">#5421</a>)</li>
867
+ <li>Fix Travis.ci documentation (<a href="https://github.com/jekyll/jekyll/issues/5413">#5413</a>)</li>
868
+ <li>[docs] Update documentation regarding <code class="highlighter-rouge">bundle install</code> after <code class="highlighter-rouge">jekyll new</code> (<a href="https://github.com/jekyll/jekyll/issues/5428">#5428</a>)</li>
869
+ <li>Replace classic box-sizing reset with inheritance reset (<a href="https://github.com/jekyll/jekyll/issues/5411">#5411</a>)</li>
870
+ <li>Update Wikipedia YAML list link (<a href="https://github.com/jekyll/jekyll/issues/5452">#5452</a>)</li>
871
+ <li>Add Jekyll 3.3 release post (<a href="https://github.com/jekyll/jekyll/issues/5442">#5442</a>)</li>
773
872
  </ul>
774
873
 
775
874
  <h3 id="development-fixes-v3-3-0">Development Fixes</h3>
776
875
 
777
876
  <ul>
778
- <li>Update appveyor.yml and fix optional deps for Ruby x64 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5180">#5180</a>)</li>
779
- <li>Improve tests for Jekyll::PluginManager (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5167">#5167</a>)</li>
780
- <li>Update Ruby versions in travis.yml (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5221">#5221</a>)</li>
781
- <li>Avoid installing unecessary gems for site testing (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5272">#5272</a>)</li>
782
- <li>Proposal: Affinity teams and their captains (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5273">#5273</a>)</li>
783
- <li>Replace duplicate with postive local test in issue template (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5286">#5286</a>)</li>
784
- <li>Update AppVeyor config. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5240">#5240</a>)</li>
785
- <li>Execute jekyll from clone instead of defined binary when running ‘script/default-site’ (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5295">#5295</a>)</li>
786
- <li>rubocop: lib/jekyll/document.rb complexity fixes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5045">#5045</a>)</li>
787
- <li>Proxy a number of Convertible methods to Renderer (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5308">#5308</a>)</li>
788
- <li>Run executable for Cucumber via Ruby instead of Shell (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5383">#5383</a>)</li>
789
- <li>Appease Rubocop (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5381">#5381</a>)</li>
790
- <li>remove features’ directories on windows with proper access (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5389">#5389</a>)</li>
877
+ <li>Update appveyor.yml and fix optional deps for Ruby x64 (<a href="https://github.com/jekyll/jekyll/issues/5180">#5180</a>)</li>
878
+ <li>Improve tests for Jekyll::PluginManager (<a href="https://github.com/jekyll/jekyll/issues/5167">#5167</a>)</li>
879
+ <li>Update Ruby versions in travis.yml (<a href="https://github.com/jekyll/jekyll/issues/5221">#5221</a>)</li>
880
+ <li>Avoid installing unecessary gems for site testing (<a href="https://github.com/jekyll/jekyll/issues/5272">#5272</a>)</li>
881
+ <li>Proposal: Affinity teams and their captains (<a href="https://github.com/jekyll/jekyll/issues/5273">#5273</a>)</li>
882
+ <li>Replace duplicate with postive local test in issue template (<a href="https://github.com/jekyll/jekyll/issues/5286">#5286</a>)</li>
883
+ <li>Update AppVeyor config. (<a href="https://github.com/jekyll/jekyll/issues/5240">#5240</a>)</li>
884
+ <li>Execute jekyll from clone instead of defined binary when running ‘script/default-site’ (<a href="https://github.com/jekyll/jekyll/issues/5295">#5295</a>)</li>
885
+ <li>rubocop: lib/jekyll/document.rb complexity fixes (<a href="https://github.com/jekyll/jekyll/issues/5045">#5045</a>)</li>
886
+ <li>Proxy a number of Convertible methods to Renderer (<a href="https://github.com/jekyll/jekyll/issues/5308">#5308</a>)</li>
887
+ <li>Run executable for Cucumber via Ruby instead of Shell (<a href="https://github.com/jekyll/jekyll/issues/5383">#5383</a>)</li>
888
+ <li>Appease Rubocop (<a href="https://github.com/jekyll/jekyll/issues/5381">#5381</a>)</li>
889
+ <li>remove features’ directories on windows with proper access (<a href="https://github.com/jekyll/jekyll/issues/5389">#5389</a>)</li>
791
890
  <li>
792
- <code class="highlighter-rouge">site_configuration.feature</code>: use UTC format in timezone (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5416">#5416</a>)</li>
793
- <li>swallow bundle output from <code class="highlighter-rouge">jekyll new</code> while in CI (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5408">#5408</a>)</li>
794
- <li>Add .editorconfig (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5412">#5412</a>)</li>
891
+ <code class="highlighter-rouge">site_configuration.feature</code>: use UTC format in timezone (<a href="https://github.com/jekyll/jekyll/issues/5416">#5416</a>)</li>
892
+ <li>swallow bundle output from <code class="highlighter-rouge">jekyll new</code> while in CI (<a href="https://github.com/jekyll/jekyll/issues/5408">#5408</a>)</li>
893
+ <li>Add .editorconfig (<a href="https://github.com/jekyll/jekyll/issues/5412">#5412</a>)</li>
795
894
  </ul>
796
895
 
797
896
  <h2 id="v3-2-1">3.2.1 / 2016-08-02</h2>
@@ -799,29 +898,29 @@
799
898
  <h3 id="bug-fixes-v3-2-1">Bug Fixes</h3>
800
899
 
801
900
  <ul>
802
- <li>Include theme directories in default gemspec (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5152">#5152</a>)</li>
803
- <li>Fix for symlinked themes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5156">#5156</a>)</li>
804
- <li>Layout: set <code class="highlighter-rouge">relative_path</code> without using Pathname (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5164">#5164</a>)</li>
901
+ <li>Include theme directories in default gemspec (<a href="https://github.com/jekyll/jekyll/issues/5152">#5152</a>)</li>
902
+ <li>Fix for symlinked themes (<a href="https://github.com/jekyll/jekyll/issues/5156">#5156</a>)</li>
903
+ <li>Layout: set <code class="highlighter-rouge">relative_path</code> without using Pathname (<a href="https://github.com/jekyll/jekyll/issues/5164">#5164</a>)</li>
805
904
  </ul>
806
905
 
807
906
  <h3 id="development-fixes-v3-2-1">Development Fixes</h3>
808
907
 
809
908
  <ul>
810
- <li>Add test to build the default site (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5154">#5154</a>)</li>
811
- <li>script/default-site: specify <code class="highlighter-rouge">BUNDLE_GEMFILE</code> for new site (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5178">#5178</a>)</li>
812
- <li>script/default-site: read Jekyll source from local clone (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5188">#5188</a>)</li>
909
+ <li>Add test to build the default site (<a href="https://github.com/jekyll/jekyll/issues/5154">#5154</a>)</li>
910
+ <li>script/default-site: specify <code class="highlighter-rouge">BUNDLE_GEMFILE</code> for new site (<a href="https://github.com/jekyll/jekyll/issues/5178">#5178</a>)</li>
911
+ <li>script/default-site: read Jekyll source from local clone (<a href="https://github.com/jekyll/jekyll/issues/5188">#5188</a>)</li>
813
912
  </ul>
814
913
 
815
914
  <h3 id="site-enhancements-v3-2-1">Site Enhancements</h3>
816
915
 
817
916
  <ul>
818
- <li>Enable site excerpts (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5150">#5150</a>)</li>
819
- <li>Initial 404 page (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5143">#5143</a>)</li>
820
- <li>Remove the “this feature is unreleased” warning from the theme docs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5158">#5158</a>)</li>
821
- <li>Future True on GitHub Pages note (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5173">#5173</a>)</li>
822
- <li>Minor updates and corrections (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5177">#5177</a>)</li>
823
- <li>index.html: update instructions to require bundler (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5169">#5169</a>)</li>
824
- <li>docs/quickstart: update instructions to require bundler (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5168">#5168</a>)</li>
917
+ <li>Enable site excerpts (<a href="https://github.com/jekyll/jekyll/issues/5150">#5150</a>)</li>
918
+ <li>Initial 404 page (<a href="https://github.com/jekyll/jekyll/issues/5143">#5143</a>)</li>
919
+ <li>Remove the “this feature is unreleased” warning from the theme docs (<a href="https://github.com/jekyll/jekyll/issues/5158">#5158</a>)</li>
920
+ <li>Future True on GitHub Pages note (<a href="https://github.com/jekyll/jekyll/issues/5173">#5173</a>)</li>
921
+ <li>Minor updates and corrections (<a href="https://github.com/jekyll/jekyll/issues/5177">#5177</a>)</li>
922
+ <li>index.html: update instructions to require bundler (<a href="https://github.com/jekyll/jekyll/issues/5169">#5169</a>)</li>
923
+ <li>docs/quickstart: update instructions to require bundler (<a href="https://github.com/jekyll/jekyll/issues/5168">#5168</a>)</li>
825
924
  </ul>
826
925
 
827
926
  <h2 id="v3-2-0">3.2.0 / 2016-07-26</h2>
@@ -829,82 +928,82 @@
829
928
  <h3 id="minor-enhancements-v3-2-0">Minor Enhancements</h3>
830
929
 
831
930
  <ul>
832
- <li>Stop testing with Ruby 2.0.x, which is EOL’d. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4381">#4381</a>)</li>
833
- <li>Allow collections to have documents that have no file extension (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4545">#4545</a>)</li>
834
- <li>Add size property to <code class="highlighter-rouge">group_by</code> result (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4557">#4557</a>)</li>
835
- <li>Site Template: Removed unnecessary nesting from <code class="highlighter-rouge">_base.scss</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4637">#4637</a>)</li>
836
- <li>Adding a debug log statment for skipped future documents. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4558">#4558</a>)</li>
837
- <li>Site Template: Changed main <code class="highlighter-rouge">&lt;div&gt;</code> to <code class="highlighter-rouge">&lt;main&gt;</code> and added accessibility info (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4636">#4636</a>)</li>
838
- <li>Add array support to <code class="highlighter-rouge">where</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4555">#4555</a>)</li>
839
- <li>‘jekyll clean’: also remove .sass-cache (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4652">#4652</a>)</li>
840
- <li>Clean up <code class="highlighter-rouge">Tags::PostUrl</code> a bit, including better errors and date parsing (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4670">#4670</a>)</li>
841
- <li>Use <code class="highlighter-rouge">String#encode</code> for <code class="highlighter-rouge">xml_escape</code> filter instead of <code class="highlighter-rouge">CGI.escapeHTML</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4694">#4694</a>)</li>
842
- <li>Add <code class="highlighter-rouge">show_dir_listing</code> option for serve command and fix index file names (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4533">#4533</a>)</li>
843
- <li>Site Template: write a Gemfile which is educational to the new site (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4542">#4542</a>)</li>
844
- <li>Site template: add explanation of site variables in the example <code class="highlighter-rouge">_config.yml</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4704">#4704</a>)</li>
845
- <li>Adds <code class="highlighter-rouge">link</code> Liquid tag to make generation of URLs easier (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4624">#4624</a>)</li>
846
- <li>Allow static files to be symlinked in unsafe mode or non-prod environments (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4640">#4640</a>)</li>
847
- <li>Add <code class="highlighter-rouge">:after_init</code> hook &amp; add <code class="highlighter-rouge">Site#config=</code> to make resetting config easy (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4703">#4703</a>)</li>
848
- <li>DocumentDrop: add <code class="highlighter-rouge">#&lt;=&gt;</code> which sorts by date (falling back to path) (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4741">#4741</a>)</li>
849
- <li>Add a <code class="highlighter-rouge">where_exp</code> filter for filtering by expression (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4478">#4478</a>)</li>
850
- <li>Globalize Jekyll’s Filters. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4792">#4792</a>)</li>
851
- <li>Gem-based themes (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4595">#4595</a>)</li>
852
- <li>Allow symlinks if they point to stuff inside <code class="highlighter-rouge">site.source</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4710">#4710</a>)</li>
853
- <li>Update colorator dependency to v1.x (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4855">#4855</a>)</li>
854
- <li>Move EntryFilter to use Pathutil &amp; fix <code class="highlighter-rouge">glob_include?</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4859">#4859</a>)</li>
855
- <li>Add ‘jekyll new-theme’ command to help users get up and running creating a theme (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4848">#4848</a>)</li>
931
+ <li>Stop testing with Ruby 2.0.x, which is EOL’d. (<a href="https://github.com/jekyll/jekyll/issues/4381">#4381</a>)</li>
932
+ <li>Allow collections to have documents that have no file extension (<a href="https://github.com/jekyll/jekyll/issues/4545">#4545</a>)</li>
933
+ <li>Add size property to <code class="highlighter-rouge">group_by</code> result (<a href="https://github.com/jekyll/jekyll/issues/4557">#4557</a>)</li>
934
+ <li>Site Template: Removed unnecessary nesting from <code class="highlighter-rouge">_base.scss</code> (<a href="https://github.com/jekyll/jekyll/issues/4637">#4637</a>)</li>
935
+ <li>Adding a debug log statment for skipped future documents. (<a href="https://github.com/jekyll/jekyll/issues/4558">#4558</a>)</li>
936
+ <li>Site Template: Changed main <code class="highlighter-rouge">&lt;div&gt;</code> to <code class="highlighter-rouge">&lt;main&gt;</code> and added accessibility info (<a href="https://github.com/jekyll/jekyll/issues/4636">#4636</a>)</li>
937
+ <li>Add array support to <code class="highlighter-rouge">where</code> filter (<a href="https://github.com/jekyll/jekyll/issues/4555">#4555</a>)</li>
938
+ <li>‘jekyll clean’: also remove .sass-cache (<a href="https://github.com/jekyll/jekyll/issues/4652">#4652</a>)</li>
939
+ <li>Clean up <code class="highlighter-rouge">Tags::PostUrl</code> a bit, including better errors and date parsing (<a href="https://github.com/jekyll/jekyll/issues/4670">#4670</a>)</li>
940
+ <li>Use <code class="highlighter-rouge">String#encode</code> for <code class="highlighter-rouge">xml_escape</code> filter instead of <code class="highlighter-rouge">CGI.escapeHTML</code> (<a href="https://github.com/jekyll/jekyll/issues/4694">#4694</a>)</li>
941
+ <li>Add <code class="highlighter-rouge">show_dir_listing</code> option for serve command and fix index file names (<a href="https://github.com/jekyll/jekyll/issues/4533">#4533</a>)</li>
942
+ <li>Site Template: write a Gemfile which is educational to the new site (<a href="https://github.com/jekyll/jekyll/issues/4542">#4542</a>)</li>
943
+ <li>Site template: add explanation of site variables in the example <code class="highlighter-rouge">_config.yml</code> (<a href="https://github.com/jekyll/jekyll/issues/4704">#4704</a>)</li>
944
+ <li>Adds <code class="highlighter-rouge">link</code> Liquid tag to make generation of URLs easier (<a href="https://github.com/jekyll/jekyll/issues/4624">#4624</a>)</li>
945
+ <li>Allow static files to be symlinked in unsafe mode or non-prod environments (<a href="https://github.com/jekyll/jekyll/issues/4640">#4640</a>)</li>
946
+ <li>Add <code class="highlighter-rouge">:after_init</code> hook &amp; add <code class="highlighter-rouge">Site#config=</code> to make resetting config easy (<a href="https://github.com/jekyll/jekyll/issues/4703">#4703</a>)</li>
947
+ <li>DocumentDrop: add <code class="highlighter-rouge">#&lt;=&gt;</code> which sorts by date (falling back to path) (<a href="https://github.com/jekyll/jekyll/issues/4741">#4741</a>)</li>
948
+ <li>Add a <code class="highlighter-rouge">where_exp</code> filter for filtering by expression (<a href="https://github.com/jekyll/jekyll/issues/4478">#4478</a>)</li>
949
+ <li>Globalize Jekyll’s Filters. (<a href="https://github.com/jekyll/jekyll/issues/4792">#4792</a>)</li>
950
+ <li>Gem-based themes (<a href="https://github.com/jekyll/jekyll/issues/4595">#4595</a>)</li>
951
+ <li>Allow symlinks if they point to stuff inside <code class="highlighter-rouge">site.source</code> (<a href="https://github.com/jekyll/jekyll/issues/4710">#4710</a>)</li>
952
+ <li>Update colorator dependency to v1.x (<a href="https://github.com/jekyll/jekyll/issues/4855">#4855</a>)</li>
953
+ <li>Move EntryFilter to use Pathutil &amp; fix <code class="highlighter-rouge">glob_include?</code> (<a href="https://github.com/jekyll/jekyll/issues/4859">#4859</a>)</li>
954
+ <li>Add ‘jekyll new-theme’ command to help users get up and running creating a theme (<a href="https://github.com/jekyll/jekyll/issues/4848">#4848</a>)</li>
856
955
  <li>
857
- <code class="highlighter-rouge">markdownify</code> and <code class="highlighter-rouge">smartify</code> should convert input to string before conversion (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4958">#4958</a>)</li>
858
- <li>Run <code class="highlighter-rouge">Site#generate</code> for ‘jekyll doctor’ to catch plugin issues (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5005">#5005</a>)</li>
859
- <li>Add <code class="highlighter-rouge">normalize_whitepace</code> filter (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4917">#4917</a>)</li>
860
- <li>Move bin/jekyll to exe/jekyll to prevent collision with binstubs (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5014">#5014</a>)</li>
861
- <li>Cleaning up site template &amp; theme updates. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4922">#4922</a>)</li>
862
- <li>Add fetch method to Drops (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5056">#5056</a>)</li>
863
- <li>Extract tag name to class method (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5063">#5063</a>)</li>
864
- <li>check if relative URL contains a colon (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5069">#5069</a>)</li>
865
- <li>Enable strict (or lax) liquid parsing via a config variable. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5053">#5053</a>)</li>
866
- <li>Add filter: <code class="highlighter-rouge">to_integer</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5101">#5101</a>)</li>
867
- <li>watcher: pass site instance to watch plugin (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5109">#5109</a>)</li>
868
- <li>Show liquid warnings. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5129">#5129</a>)</li>
869
- <li>Add <code class="highlighter-rouge">--baseurl</code> to <code class="highlighter-rouge">build</code> subcommand (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5135">#5135</a>)</li>
956
+ <code class="highlighter-rouge">markdownify</code> and <code class="highlighter-rouge">smartify</code> should convert input to string before conversion (<a href="https://github.com/jekyll/jekyll/issues/4958">#4958</a>)</li>
957
+ <li>Run <code class="highlighter-rouge">Site#generate</code> for ‘jekyll doctor’ to catch plugin issues (<a href="https://github.com/jekyll/jekyll/issues/5005">#5005</a>)</li>
958
+ <li>Add <code class="highlighter-rouge">normalize_whitepace</code> filter (<a href="https://github.com/jekyll/jekyll/issues/4917">#4917</a>)</li>
959
+ <li>Move bin/jekyll to exe/jekyll to prevent collision with binstubs (<a href="https://github.com/jekyll/jekyll/issues/5014">#5014</a>)</li>
960
+ <li>Cleaning up site template &amp; theme updates. (<a href="https://github.com/jekyll/jekyll/issues/4922">#4922</a>)</li>
961
+ <li>Add fetch method to Drops (<a href="https://github.com/jekyll/jekyll/issues/5056">#5056</a>)</li>
962
+ <li>Extract tag name to class method (<a href="https://github.com/jekyll/jekyll/issues/5063">#5063</a>)</li>
963
+ <li>check if relative URL contains a colon (<a href="https://github.com/jekyll/jekyll/issues/5069">#5069</a>)</li>
964
+ <li>Enable strict (or lax) liquid parsing via a config variable. (<a href="https://github.com/jekyll/jekyll/issues/5053">#5053</a>)</li>
965
+ <li>Add filter: <code class="highlighter-rouge">to_integer</code> (<a href="https://github.com/jekyll/jekyll/issues/5101">#5101</a>)</li>
966
+ <li>watcher: pass site instance to watch plugin (<a href="https://github.com/jekyll/jekyll/issues/5109">#5109</a>)</li>
967
+ <li>Show liquid warnings. (<a href="https://github.com/jekyll/jekyll/issues/5129">#5129</a>)</li>
968
+ <li>Add <code class="highlighter-rouge">--baseurl</code> to <code class="highlighter-rouge">build</code> subcommand (<a href="https://github.com/jekyll/jekyll/issues/5135">#5135</a>)</li>
870
969
  </ul>
871
970
 
872
971
  <h3 id="bug-fixes-v3-2-0">Bug Fixes</h3>
873
972
 
874
973
  <ul>
875
- <li>Site Template: Added a default lang attribute (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4633">#4633</a>)</li>
876
- <li>Site template: Escape title and description where it is used in HTML (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4606">#4606</a>)</li>
974
+ <li>Site Template: Added a default lang attribute (<a href="https://github.com/jekyll/jekyll/issues/4633">#4633</a>)</li>
975
+ <li>Site template: Escape title and description where it is used in HTML (<a href="https://github.com/jekyll/jekyll/issues/4606">#4606</a>)</li>
877
976
  <li>
878
- <code class="highlighter-rouge">Document#date</code>: drafts which have no date should use source file mtime (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4611">#4611</a>)</li>
977
+ <code class="highlighter-rouge">Document#date</code>: drafts which have no date should use source file mtime (<a href="https://github.com/jekyll/jekyll/issues/4611">#4611</a>)</li>
879
978
  <li>
880
- <code class="highlighter-rouge">Filters#time</code>: clone an input Time so as to be non-destructive (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4590">#4590</a>)</li>
881
- <li>Doctor: fix issue where <code class="highlighter-rouge">--config</code> wasn’t a recognized flag (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4598">#4598</a>)</li>
882
- <li>Ensures <code class="highlighter-rouge">related_posts</code> are only set for a post (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4620">#4620</a>)</li>
979
+ <code class="highlighter-rouge">Filters#time</code>: clone an input Time so as to be non-destructive (<a href="https://github.com/jekyll/jekyll/issues/4590">#4590</a>)</li>
980
+ <li>Doctor: fix issue where <code class="highlighter-rouge">--config</code> wasn’t a recognized flag (<a href="https://github.com/jekyll/jekyll/issues/4598">#4598</a>)</li>
981
+ <li>Ensures <code class="highlighter-rouge">related_posts</code> are only set for a post (<a href="https://github.com/jekyll/jekyll/issues/4620">#4620</a>)</li>
883
982
  <li>
884
- <code class="highlighter-rouge">EntryFilter#special?</code>: ignore filenames which begin with <code class="highlighter-rouge">~</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4491">#4491</a>)</li>
885
- <li>Cleaner: <code class="highlighter-rouge">keep_files</code> should only apply to the beginning of paths, not substrings with index &gt; 0 (<a href="%7B%7B%20site.repository%20%7D%7D/issues/3849">#3849</a>)</li>
886
- <li>Use SSLEnable instead of EnableSSL and make URL HTTPS. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4693">#4693</a>)</li>
887
- <li>convertible: use <code class="highlighter-rouge">Document::YAML_FRONT_MATTER_REGEXP</code> to parse transformable files (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4786">#4786</a>)</li>
888
- <li>Example in the site template should be IANA-approved example.com (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4793">#4793</a>)</li>
889
- <li>3.2.x/master: Fix defaults for Documents (posts/collection docs) (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4808">#4808</a>)</li>
890
- <li>Don’t rescue LoadError or bundler load errors for Bundler. (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4857">#4857</a>)</li>
983
+ <code class="highlighter-rouge">EntryFilter#special?</code>: ignore filenames which begin with <code class="highlighter-rouge">~</code> (<a href="https://github.com/jekyll/jekyll/issues/4491">#4491</a>)</li>
984
+ <li>Cleaner: <code class="highlighter-rouge">keep_files</code> should only apply to the beginning of paths, not substrings with index &gt; 0 (<a href="https://github.com/jekyll/jekyll/issues/3849">#3849</a>)</li>
985
+ <li>Use SSLEnable instead of EnableSSL and make URL HTTPS. (<a href="https://github.com/jekyll/jekyll/issues/4693">#4693</a>)</li>
986
+ <li>convertible: use <code class="highlighter-rouge">Document::YAML_FRONT_MATTER_REGEXP</code> to parse transformable files (<a href="https://github.com/jekyll/jekyll/issues/4786">#4786</a>)</li>
987
+ <li>Example in the site template should be IANA-approved example.com (<a href="https://github.com/jekyll/jekyll/issues/4793">#4793</a>)</li>
988
+ <li>3.2.x/master: Fix defaults for Documents (posts/collection docs) (<a href="https://github.com/jekyll/jekyll/issues/4808">#4808</a>)</li>
989
+ <li>Don’t rescue LoadError or bundler load errors for Bundler. (<a href="https://github.com/jekyll/jekyll/issues/4857">#4857</a>)</li>
891
990
  <li>
892
- <code class="highlighter-rouge">Serve.process</code> should receive same config as <code class="highlighter-rouge">Build.process</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4953">#4953</a>)</li>
893
- <li>Prevent reset of page in Liquid payload right before rendering layouts (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5009">#5009</a>)</li>
894
- <li>Add missing fields to ExcerptDrop (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5067">#5067</a>)</li>
895
- <li>Stringify configuration overrides before first use (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5060">#5060</a>)</li>
896
- <li>hooks: move <code class="highlighter-rouge">after_init</code> hook call at the end of <code class="highlighter-rouge">Site#initialize</code> (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5106">#5106</a>)</li>
897
- <li>filters: raise error if no input given to date filters (<a href="%7B%7B%20site.repository%20%7D%7D/issues/5127">#5127</a>)</li>
991
+ <code class="highlighter-rouge">Serve.process</code> should receive same config as <code class="highlighter-rouge">Build.process</code> (<a href="https://github.com/jekyll/jekyll/issues/4953">#4953</a>)</li>
992
+ <li>Prevent reset of page in Liquid payload right before rendering layouts (<a href="https://github.com/jekyll/jekyll/issues/5009">#5009</a>)</li>
993
+ <li>Add missing fields to ExcerptDrop (<a href="https://github.com/jekyll/jekyll/issues/5067">#5067</a>)</li>
994
+ <li>Stringify configuration overrides before first use (<a href="https://github.com/jekyll/jekyll/issues/5060">#5060</a>)</li>
995
+ <li>hooks: move <code class="highlighter-rouge">after_init</code> hook call at the end of <code class="highlighter-rouge">Site#initialize</code> (<a href="https://github.com/jekyll/jekyll/issues/5106">#5106</a>)</li>
996
+ <li>filters: raise error if no input given to date filters (<a href="https://github.com/jekyll/jekyll/issues/5127">#5127</a>)</li>
898
997
  <li>
899
- <code class="highlighter-rouge">where_exp</code> filter should filter posts (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4860">#4860</a>)</li>
998
+ <code class="highlighter-rouge">where_exp</code> filter should filter posts (<a href="https://github.com/jekyll/jekyll/issues/4860">#4860</a>)</li>
900
999
  </ul>
901
1000
 
902
1001
  <h3 id="forward-ports-v3-2-0">Forward Ports</h3>
903
1002
 
904
1003
  <ul>
905
- <li>From v3.1.4: Add ExcerptDrop and remove excerpt’s ability to refer to itself in Liquid (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4941">#4941</a>)</li>
906
- <li>From v3.1.4: Configuration permalink fix and addition of Configuration.from and sorting <code class="highlighter-rouge">site.collections</code> by label (<a href="%7B%7B%20site.repository%20%7D%7D/issues/4942">#4942</a>)</li>
907
- <li>From v3.1.4: Fix {% raw %}<code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">layout</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code> oddities (proper inheritance &amp; fixing overflow of old data) (<a href="https://github.com/jekyll/jekyll/issues/4943">#4943</a>)</li>
1004
+ <li>From v3.1.4: Add ExcerptDrop and remove excerpt’s ability to refer to itself in Liquid (<a href="https://github.com/jekyll/jekyll/issues/4941">#4941</a>)</li>
1005
+ <li>From v3.1.4: Configuration permalink fix and addition of Configuration.from and sorting <code class="highlighter-rouge">site.collections</code> by label (<a href="https://github.com/jekyll/jekyll/issues/4942">#4942</a>)</li>
1006
+ <li>From v3.1.4: Fix <code class="highlighter-rouge">{{ layout }}</code> oddities (proper inheritance &amp; fixing overflow of old data) (<a href="https://github.com/jekyll/jekyll/issues/4943">#4943</a>)</li>
908
1007
  <li>From v3.1.5: Sort the results of the <code class="highlighter-rouge">require_all</code> glob (<a href="https://github.com/jekyll/jekyll/issues/4944">#4944</a>)</li>
909
1008
  <li>From v3.1.6: Add ability to render drops as JSON (<a href="https://github.com/jekyll/jekyll/issues/4945">#4945</a>)</li>
910
1009
  </ul>
@@ -2196,7 +2295,7 @@
2196
2295
  <li>Only strip the drive name if it begins the string (<a href="https://github.com/jekyll/jekyll/issues/2175">#2175</a>)</li>
2197
2296
  <li>Remove default post with invalid date from site template (<a href="https://github.com/jekyll/jekyll/issues/2200">#2200</a>)</li>
2198
2297
  <li>Fix <code class="highlighter-rouge">Post#url</code> and <code class="highlighter-rouge">Page#url</code> escape (<a href="https://github.com/jekyll/jekyll/issues/1568">#1568</a>)</li>
2199
- <li>Strip newlines from the <code class="highlighter-rouge"><span class="p">{</span><span class="err">%</span><span class="w"> </span><span class="err">highlight</span><span class="w"> </span><span class="err">%</span><span class="p">}</span></code> block content (<a href="https://github.com/jekyll/jekyll/issues/1823">#1823</a>)</li>
2298
+ <li>Strip newlines from the <code class="highlighter-rouge">{% highlight %}</code> block content (<a href="https://github.com/jekyll/jekyll/issues/1823">#1823</a>)</li>
2200
2299
  <li>Load in <code class="highlighter-rouge">rouge</code> only when it’s been requested as the highlighter (<a href="https://github.com/jekyll/jekyll/issues/2189">#2189</a>)</li>
2201
2300
  <li>Convert input to string before XML escaping (<code class="highlighter-rouge">xml_escape</code> liquid filter) (<a href="https://github.com/jekyll/jekyll/issues/2244">#2244</a>)</li>
2202
2301
  <li>Modify configuration key for Collections and reset properly. (<a href="https://github.com/jekyll/jekyll/issues/2238">#2238</a>)</li>
@@ -3371,7 +3470,7 @@
3371
3470
 
3372
3471
  <ul>
3373
3472
  <li>Major Features</li>
3374
- <li>Include files in <code class="highlighter-rouge">_includes</code> with <code class="highlighter-rouge"><span class="p">{</span><span class="err">%</span><span class="w"> </span><span class="err">include</span><span class="w"> </span><span class="err">x.textile</span><span class="w"> </span><span class="err">%</span><span class="p">}</span></code>
3473
+ <li>Include files in <code class="highlighter-rouge">_includes</code> with <code class="highlighter-rouge">{% include x.textile %}</code>
3375
3474
  </li>
3376
3475
  </ul>
3377
3476
 
@@ -3426,7 +3525,7 @@
3426
3525
 
3427
3526
  <ul>
3428
3527
  <li>Minor Additions</li>
3429
- <li>Posts now support introspectional data e.g. <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">page.url</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>
3528
+ <li>Posts now support introspectional data e.g. <code class="highlighter-rouge">{{ page.url }}</code>
3430
3529
  </li>
3431
3530
  </ul>
3432
3531