jekyll-docs 3.4.3 → 3.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. checksums.yaml +4 -4
  2. data/lib/jekyll-docs.rb +1 -1
  3. data/site/404.html +5 -11
  4. data/site/community/index.html +9 -15
  5. data/site/css/screen.css +1 -1468
  6. data/site/docs/assets/index.html +20 -16
  7. data/site/docs/collections/index.html +115 -109
  8. data/site/docs/conduct/index.html +19 -15
  9. data/site/docs/configuration/index.html +39 -23
  10. data/site/docs/continuous-integration/buddyworks/index.html +728 -0
  11. data/site/docs/continuous-integration/circleci/index.html +19 -15
  12. data/site/docs/continuous-integration/index.html +20 -15
  13. data/site/docs/continuous-integration/travis-ci/index.html +21 -18
  14. data/site/docs/contributing/index.html +20 -16
  15. data/site/docs/datafiles/index.html +23 -15
  16. data/site/docs/deployment-methods/index.html +24 -20
  17. data/site/docs/drafts/index.html +19 -15
  18. data/site/docs/extras/index.html +31 -16
  19. data/site/docs/frontmatter/index.html +28 -15
  20. data/site/docs/github-pages/index.html +21 -17
  21. data/site/docs/history/index.html +521 -315
  22. data/site/docs/home/index.html +16 -15
  23. data/site/docs/includes/index.html +21 -17
  24. data/site/docs/installation/index.html +41 -31
  25. data/site/docs/maintaining/affinity-team-captain/index.html +19 -15
  26. data/site/docs/maintaining/avoiding-burnout/index.html +19 -15
  27. data/site/docs/maintaining/becoming-a-maintainer/index.html +19 -15
  28. data/site/docs/maintaining/index.html +19 -15
  29. data/site/docs/maintaining/merging-a-pull-request/index.html +19 -15
  30. data/site/docs/maintaining/reviewing-a-pull-request/index.html +19 -15
  31. data/site/docs/maintaining/special-labels/index.html +23 -15
  32. data/site/docs/maintaining/triaging-an-issue/index.html +20 -16
  33. data/site/docs/migrations/index.html +19 -15
  34. data/site/docs/pages/index.html +19 -15
  35. data/site/docs/pagination/index.html +19 -15
  36. data/site/docs/permalinks/index.html +19 -15
  37. data/site/docs/plugins/index.html +36 -23
  38. data/site/docs/posts/index.html +23 -19
  39. data/site/docs/quickstart/index.html +18 -17
  40. data/site/docs/resources/index.html +19 -15
  41. data/site/docs/sites/index.html +22 -15
  42. data/site/docs/static-files/index.html +52 -15
  43. data/site/docs/structure/index.html +19 -15
  44. data/site/docs/templates/index.html +29 -25
  45. data/site/docs/themes/index.html +65 -39
  46. data/site/docs/troubleshooting/index.html +41 -19
  47. data/site/docs/upgrading/0-to-2/index.html +19 -15
  48. data/site/docs/upgrading/2-to-3/index.html +20 -16
  49. data/site/docs/upgrading/index.html +22 -15
  50. data/site/docs/usage/index.html +20 -16
  51. data/site/docs/variables/index.html +19 -15
  52. data/site/docs/windows/index.html +135 -136
  53. data/site/feed.xml +228 -180
  54. data/site/help/index.html +11 -13
  55. data/site/img/jekylllayoutconcept.png +0 -0
  56. data/site/index.html +7 -14
  57. data/site/latest_version.txt +1 -1
  58. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +33 -19
  59. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +33 -19
  60. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +33 -19
  61. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +33 -19
  62. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +33 -19
  63. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +33 -19
  64. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +33 -19
  65. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +33 -19
  66. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +33 -19
  67. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +33 -19
  68. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +33 -19
  69. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +33 -19
  70. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +33 -19
  71. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +33 -19
  72. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +33 -19
  73. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +33 -19
  74. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +33 -19
  75. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +33 -19
  76. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +33 -19
  77. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +33 -19
  78. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +33 -19
  79. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +35 -21
  80. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +33 -19
  81. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +33 -19
  82. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +33 -19
  83. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +33 -19
  84. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +33 -19
  85. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +33 -19
  86. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +33 -19
  87. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +33 -19
  88. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +33 -19
  89. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +33 -19
  90. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +33 -19
  91. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +33 -19
  92. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +33 -19
  93. data/site/news/2015/10/26/jekyll-3-0-released/index.html +33 -19
  94. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +33 -19
  95. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +33 -19
  96. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +33 -19
  97. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +33 -19
  98. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +33 -19
  99. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +33 -19
  100. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +33 -19
  101. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +33 -19
  102. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +33 -19
  103. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +33 -19
  104. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +33 -19
  105. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +33 -19
  106. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +33 -19
  107. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +33 -19
  108. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +35 -21
  109. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +34 -20
  110. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +33 -19
  111. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +35 -21
  112. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +34 -20
  113. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +36 -22
  114. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +651 -0
  115. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +592 -0
  116. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +588 -0
  117. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +581 -0
  118. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +561 -0
  119. data/site/news/index.html +405 -22
  120. data/site/news/releases/index.html +405 -22
  121. data/site/philosophy.html +46 -0
  122. data/site/sitemap.xml +95 -48
  123. data/site/tutorials/convert-site-to-jekyll/index.html +851 -0
  124. data/site/tutorials/custom-404-page/index.html +366 -0
  125. data/site/tutorials/home/index.html +323 -0
  126. data/site/tutorials/index.html +10 -0
  127. data/site/tutorials/navigation/index.html +908 -0
  128. data/site/tutorials/orderofinterpretation/index.html +459 -0
  129. metadata +20 -7
  130. data/site/feed.xslt.xml +0 -4
@@ -0,0 +1,588 @@
1
+ <!DOCTYPE HTML>
2
+ <html lang="en-US">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <meta charset="UTF-8">
6
+ <meta name="viewport" content="width=device-width,initial-scale=1">
7
+ <meta name="generator" content="Jekyll v3.5.1">
8
+ <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
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
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
+ <link rel="stylesheet" href="/css/screen.css">
12
+ <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
+ <!-- Begin Jekyll SEO tag v2.2.3 -->
14
+ <title>Jekyll 3.4.3 Released | Jekyll • Simple, blog-aware, static sites</title>
15
+ <meta property="og:title" content="Jekyll 3.4.3 Released">
16
+ <meta name="author" content="pathawks">
17
+ <meta property="og:locale" content="en_US">
18
+ <meta name="description" content="Another one-PR patch update as we continue our quest to destroy all bugs. A fairly technical debriefing follows, but the TLDR is that we have updated the uri_escape filter to more closely follow the pre-v3.4.0 behavior.">
19
+ <meta property="og:description" content="Another one-PR patch update as we continue our quest to destroy all bugs. A fairly technical debriefing follows, but the TLDR is that we have updated the uri_escape filter to more closely follow the pre-v3.4.0 behavior.">
20
+ <link rel="canonical" href="https://jekyllrb.com/news/2017/03/21/jekyll-3-4-3-released/">
21
+ <meta property="og:url" content="https://jekyllrb.com/news/2017/03/21/jekyll-3-4-3-released/">
22
+ <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
23
+ <meta property="og:type" content="article">
24
+ <meta property="article:published_time" content="2017-03-21T06:52:53-07:00">
25
+ <meta name="twitter:card" content="summary">
26
+ <meta name="twitter:site" content="@jekyllrb">
27
+ <meta name="twitter:creator" content="@pathawks">
28
+ <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
29
+ <script type="application/ld+json">
30
+ {"@context":"http://schema.org","@type":"BlogPosting","headline":"Jekyll 3.4.3 Released","author":{"@type":"Person","name":"pathawks"},"datePublished":"2017-03-21T06:52:53-07:00","dateModified":"2017-03-21T06:52:53-07:00","description":"Another one-PR patch update as we continue our quest to destroy all bugs. A fairly technical debriefing follows, but the TLDR is that we have updated the uri_escape filter to more closely follow the pre-v3.4.0 behavior.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"pathawks"},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/news/2017/03/21/jekyll-3-4-3-released/"},"url":"https://jekyllrb.com/news/2017/03/21/jekyll-3-4-3-released/"}</script>
31
+ <!-- End Jekyll SEO tag -->
32
+
33
+ <!--[if lt IE 9]>
34
+ <script src="/js/html5shiv.min.js"></script>
35
+ <script src="/js/respond.min.js"></script>
36
+ <![endif]-->
37
+ </head>
38
+
39
+
40
+ <body class="wrap">
41
+ <header>
42
+ <nav class="mobile-nav show-on-mobiles">
43
+ <ul>
44
+ <li class="">
45
+ <a href="/">Home</a>
46
+ </li>
47
+ <li class="">
48
+ <a href="/docs/home/">Docs</a>
49
+ </li>
50
+ <li class="current">
51
+ <a href="/news/">News</a>
52
+ </li>
53
+ <li class="">
54
+ <a href="/community/">Community</a>
55
+ </li>
56
+ <li class="">
57
+ <a href="/help/">Help</a>
58
+ </li>
59
+ <li>
60
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
61
+ </li>
62
+ </ul>
63
+
64
+ </nav>
65
+ <div class="grid">
66
+ <div class="unit one-third center-on-mobiles">
67
+ <h1>
68
+ <a href="/">
69
+ <span class="sr-only">Jekyll</span>
70
+ <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
71
+ </a>
72
+ </h1>
73
+ </div>
74
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
75
+ <ul>
76
+ <li class="">
77
+ <a href="/">Home</a>
78
+ </li>
79
+ <li class="">
80
+ <a href="/docs/home/">Docs</a>
81
+ </li>
82
+ <li class="current">
83
+ <a href="/news/">News</a>
84
+ </li>
85
+ <li class="">
86
+ <a href="/community/">Community</a>
87
+ </li>
88
+ <li class="">
89
+ <a href="/help/">Help</a>
90
+ </li>
91
+ <li>
92
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
93
+ </li>
94
+ </ul>
95
+
96
+ </nav>
97
+ </div>
98
+ </header>
99
+
100
+
101
+ <section class="news">
102
+ <div class="grid">
103
+
104
+ <div class="docs-nav-mobile unit whole show-on-mobiles">
105
+ <select onchange="if (this.value) window.location.href=this.value">
106
+ <option value="">Navigate the blog…</option>
107
+ <option value="/news/">Home</option>
108
+ <optgroup label="v1.x">
109
+
110
+ <option value="/news/2017/07/17/jekyll-3-5-1-released/">Jekyll 3.5.1 Released</option>
111
+
112
+ <option value="/news/2017/06/15/jekyll-3-5-0-released/">Jekyll turns 3.5, oh my!</option>
113
+
114
+ <option value="/news/2017/03/21/jekyll-3-4-3-released/">Jekyll 3.4.3 Released</option>
115
+
116
+ <option value="/news/2017/03/09/jekyll-3-4-2-released/">Jekyll 3.4.2 Released</option>
117
+
118
+ <option value="/news/2017/03/02/jekyll-3-4-1-released/">Jekyll 3.4.1, or "Unintended Consequences"</option>
119
+
120
+ <option value="/news/2017/01/18/jekyll-3-4-0-released/">Jekyll turns 3.4.0</option>
121
+
122
+ <option value="/news/2016/11/14/jekyll-3-3-1-released/">Jekyll 3.3.1 Released</option>
123
+
124
+ <option value="/news/2016/10/06/jekyll-3-3-is-here/">Jekyll 3.3 is here with better theme support, new URL filters, and tons more</option>
125
+
126
+ <option value="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</option>
127
+
128
+ <option value="/news/2016/08/02/jekyll-3-2-1-released/">Jekyll 3.2.1 Released with Fix for Windows</option>
129
+
130
+ <option value="/news/2016/07/26/jekyll-3-2-0-released/">Jekyll turns 3.2</option>
131
+
132
+ <option value="/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll's Google Summer of Code Project: The CMS You Always Wanted</option>
133
+
134
+ <option value="/news/2016/05/19/jekyll-3-1-6-released/">Jekyll 3.1.6 Released</option>
135
+
136
+ <option value="/news/2016/05/18/jekyll-3-1-5-released/">Jekyll 3.1.5 Released</option>
137
+
138
+ <option value="/news/2016/05/18/jekyll-3-1-4-released/">Jekyll 3.1.4 "Stability Sam" Released</option>
139
+
140
+ <option value="/news/2016/04/26/jekyll-3-0-5-released/">Jekyll 3.0.5 Released</option>
141
+
142
+ <option value="/news/2016/04/19/jekyll-3-1-3-released/">Jekyll 3.1.3 Released</option>
143
+
144
+ <option value="/news/2016/04/19/jekyll-3-0-4-released/">Jekyll 3.0.4 Released</option>
145
+
146
+ <option value="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</option>
147
+
148
+ <option value="/news/2016/02/19/jekyll-3-1-2-released/">Jekyll 3.1.2 Released!</option>
149
+
150
+ <option value="/news/2016/02/08/jekyll-3-0-3-released/">Jekyll 3.0.3 Released</option>
151
+
152
+ <option value="/news/2016/01/28/jekyll-3-1-1-released/">Jekyll 3.1.1 Released</option>
153
+
154
+ <option value="/news/2016/01/24/jekyll-3-1-0-released/">Jekyll 3.1.0 Released</option>
155
+
156
+ <option value="/news/2016/01/20/jekyll-3-0-2-released/">Jekyll 3.0.2 Released</option>
157
+
158
+ <option value="/news/2015/11/17/jekyll-3-0-1-released/">Jekyll 3.0.1 Released</option>
159
+
160
+ <option value="/news/2015/10/26/jekyll-3-0-released/">Jekyll 3.0 Released</option>
161
+
162
+ <option value="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</option>
163
+
164
+ <option value="/news/2015/01/24/jekyll-3-0-0-beta1-released/">Jekyll 3.0.0.beta1 Released</option>
165
+
166
+ <option value="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet &amp; Greet at GitHub HQ</option>
167
+
168
+ <option value="/news/2014/12/22/jekyll-2-5-3-released/">Jekyll Release for the Holidays! v2.5.3 Out</option>
169
+
170
+ <option value="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</option>
171
+
172
+ <option value="/news/2014/11/12/jekyll-2-5-2-released/">Jekyll 2.5.2 Released</option>
173
+
174
+ <option value="/news/2014/11/09/jekyll-2-5-1-released/">Jekyll 2.5.1 Released</option>
175
+
176
+ <option value="/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/">Jekyll's Mid-Life Crisis (Or, Jekyll turns 2.5.0)</option>
177
+
178
+ <option value="/news/2014/09/09/jekyll-2-4-0-released/">A Wild Jekyll 2.4.0 Appeared!</option>
179
+
180
+ <option value="/news/2014/08/10/jekyll-2-3-0-released/">Jekyll 2.3.0 Released</option>
181
+
182
+ <option value="/news/2014/07/29/jekyll-2-2-0-released/">Jekyll 2.2.0 Released</option>
183
+
184
+ <option value="/news/2014/07/01/jekyll-2-1-1-released/">Jekyll 2.1.1 Released</option>
185
+
186
+ <option value="/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/">Jekyll Turns 21! Err... I mean 2.1.0.</option>
187
+
188
+ <option value="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</option>
189
+
190
+ <option value="/news/2014/05/08/jekyll-2-0-3-released/">Jekyll 2.0.3 Released</option>
191
+
192
+ <option value="/news/2014/05/06/jekyll-turns-2-0-0/">Jekyll turns 2.0.0</option>
193
+
194
+ <option value="/news/2014/03/27/jekyll-1-5-1-released/">Jekyll 1.5.1 Released</option>
195
+
196
+ <option value="/news/2014/03/24/jekyll-1-5-0-released/">Jekyll 1.5.0 Released</option>
197
+
198
+ <option value="/news/2014/01/13/jekyll-1-4-3-released/">Jekyll 1.4.3 Released</option>
199
+
200
+ <option value="/news/2013/12/16/jekyll-1-4-2-released/">Jekyll 1.4.2 Released</option>
201
+
202
+ <option value="/news/2013/12/09/jekyll-1-4-1-released/">Jekyll 1.4.1 Released</option>
203
+
204
+ <option value="/news/2013/12/07/jekyll-1-4-0-released/">Jekyll 1.4.0 Released</option>
205
+
206
+ <option value="/news/2013/11/26/jekyll-1-3-1-released/">Jekyll 1.3.1 Released</option>
207
+
208
+ <option value="/news/2013/11/04/jekyll-1-3-0-released/">Jekyll 1.3.0 Released</option>
209
+
210
+ <option value="/news/2013/10/28/jekyll-1-3-0-rc1-released/">Jekyll 1.3.0.rc1 Released</option>
211
+
212
+ <option value="/news/2013/09/14/jekyll-1-2-1-released/">Jekyll 1.2.1 Released</option>
213
+
214
+ <option value="/news/2013/09/06/jekyll-1-2-0-released/">Jekyll 1.2.0 Released</option>
215
+
216
+ <option value="/news/2013/07/25/jekyll-1-1-2-released/">Jekyll 1.1.2 Released</option>
217
+
218
+ <option value="/news/2013/07/25/jekyll-1-0-4-released/">Jekyll 1.0.4 Released</option>
219
+
220
+ <option value="/news/2013/07/24/jekyll-1-1-1-released/">Jekyll 1.1.1 Released</option>
221
+
222
+ <option value="/news/2013/07/14/jekyll-1-1-0-released/">Jekyll 1.1.0 Released</option>
223
+
224
+ <option value="/news/2013/06/07/jekyll-1-0-3-released/">Jekyll 1.0.3 Released</option>
225
+
226
+ <option value="/news/2013/05/12/jekyll-1-0-2-released/">Jekyll 1.0.2 Released</option>
227
+
228
+ <option value="/news/2013/05/08/jekyll-1-0-1-released/">Jekyll 1.0.1 Released</option>
229
+
230
+ <option value="/news/2013/05/05/jekyll-1-0-0-released/">Jekyll 1.0.0 Released</option>
231
+
232
+ </optgroup>
233
+ </select>
234
+ </div>
235
+
236
+
237
+ <div class="unit four-fifths">
238
+ <article>
239
+ <h2>
240
+ Jekyll 3.4.3 Released
241
+ <a href="/news/2017/03/21/jekyll-3-4-3-released/" class="permalink" title="Permalink">∞</a>
242
+ </h2>
243
+ <span class="post-category">
244
+ <span class="label">
245
+ release
246
+ </span>
247
+ </span>
248
+ <div class="post-meta">
249
+ <span class="post-date">
250
+ 21 Mar 2017
251
+ </span>
252
+ <a href="https://github.com/pathawks" class="post-author">
253
+ <img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/pathawks?v=3&amp;s=24" alt="pathawks" srcset="https://avatars3.githubusercontent.com/pathawks?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/pathawks?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/pathawks?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/pathawks?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
254
+ pathawks
255
+ </a>
256
+ </div>
257
+ <div class="post-content">
258
+ <p>Another one-PR patch update as we continue our quest to destroy all bugs. A
259
+ fairly technical debriefing follows, but the TLDR is that we have updated the
260
+ <code class="highlighter-rouge">uri_escape</code> filter to more closely follow the pre-v3.4.0 behavior.</p>
261
+
262
+ <p>In <a href="/news/2017/01/18/jekyll-3-4-0-released/">v3.4.0</a>, we
263
+ moved away from using the deprecated
264
+ <a href="https://ruby-doc.org/stdlib-2.3.0/libdoc/uri/rdoc/URI/Escape.html#method-i-encode"><code class="highlighter-rouge">URI.escape</code></a>
265
+ in favor of
266
+ <a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#encode-class_method"><code class="highlighter-rouge">Addressable::URI.encode</code></a>.
267
+ This is what powers our <a href="https://jekyllrb.com/docs/templates/"><code class="highlighter-rouge">uri_escape</code>
268
+ filter</a>.</p>
269
+
270
+ <p>While this transition was mostly a smooth one, the two methods are not
271
+ identical. While <code class="highlighter-rouge">URI.escape</code> was happy to escape any string,
272
+ <code class="highlighter-rouge">Addressable::URI.encode</code> first turns the string into an <code class="highlighter-rouge">Addressable::URI</code>
273
+ object, and will then escape each component of that object. In most cases, this
274
+ difference was insignificant, but there were a few cases where this caused some
275
+ unintended regressions when encoding colons.</p>
276
+
277
+ <p>While <strong>Addressable</strong> can understand that something like <code class="highlighter-rouge">"/example :page"</code> is a
278
+ relative URI, without the slash it cannot figure out how to turn
279
+ <code class="highlighter-rouge">"example :page"</code> into an <code class="highlighter-rouge">Addressable::URI</code> object. <code class="highlighter-rouge">URI.escape</code> had no such
280
+ objection. This lead to the following Liquid code working fine in Jekyll 3.3.x
281
+ but breaking in 3.4.0:</p>
282
+
283
+ <div class="language-liquid highlighter-rouge">
284
+ <pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"example :page"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">uri_escape</span><span class="w"> </span><span class="p">}}</span>
285
+ </code></pre>
286
+ </div>
287
+
288
+ <p>This was not an intended consequence of switching to <strong>Addressable</strong>.</p>
289
+
290
+ <p>Fortunately, the solution was not complicated. <strong>Addressable</strong> has a method
291
+ <a href="http://www.rubydoc.info/gems/addressable/Addressable/URI#normalize_component-class_method"><code class="highlighter-rouge">Addressable::URI.normalize_component</code></a>
292
+ which will simply escape the characters in a string, much like <code class="highlighter-rouge">URI.escape</code>.</p>
293
+
294
+ <p>Thanks to <a href="https://github.com/cameronmcefee" class="user-mention">@cameronmcefee</a> and <a href="https://github.com/FriesFlorian" class="user-mention">@FriesFlorian</a> for reporting
295
+ <a href="https://github.com/jekyll/jekyll/issues/5954">this issue</a>.</p>
296
+
297
+ <p>Happy Jekylling!</p>
298
+
299
+ </div>
300
+ </article>
301
+
302
+ </div>
303
+
304
+ <div class="unit one-fifth hide-on-mobiles">
305
+ <aside>
306
+ <ul>
307
+ <li class="">
308
+ <a href="/news/">All News</a>
309
+ </li>
310
+ <li class="">
311
+ <a href="/news/releases/">Jekyll Releases</a>
312
+ </li>
313
+ </ul>
314
+ <h4>Recent Releases</h4>
315
+ <ul>
316
+
317
+ <li class="">
318
+ <a href="/news/2017/07/17/jekyll-3-5-1-released/">Version 3.5.1</a>
319
+ </li>
320
+
321
+ <li class="">
322
+ <a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
323
+ </li>
324
+
325
+ <li class="current">
326
+ <a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
327
+ </li>
328
+
329
+ <li class="">
330
+ <a href="/news/2017/03/09/jekyll-3-4-2-released/">Version 3.4.2</a>
331
+ </li>
332
+
333
+ <li class="">
334
+ <a href="/news/2017/03/02/jekyll-3-4-1-released/">Version 3.4.1</a>
335
+ </li>
336
+
337
+ <li>
338
+ <a href="/docs/history/">History »</a>
339
+ </li>
340
+ </ul>
341
+ <h4>Other News</h4>
342
+ <ul>
343
+
344
+
345
+
346
+
347
+
348
+
349
+
350
+
351
+
352
+
353
+
354
+
355
+
356
+
357
+
358
+
359
+
360
+
361
+ <li class="">
362
+ <a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
363
+ </li>
364
+
365
+
366
+
367
+
368
+
369
+
370
+
371
+ <li class="">
372
+ <a href="/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll's Google Summer of Code Project: The CMS You Always Wanted</a>
373
+ </li>
374
+
375
+
376
+
377
+
378
+
379
+
380
+
381
+
382
+
383
+
384
+
385
+
386
+
387
+
388
+
389
+ <li class="">
390
+ <a href="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</a>
391
+ </li>
392
+
393
+
394
+
395
+
396
+
397
+
398
+
399
+
400
+
401
+
402
+
403
+
404
+
405
+
406
+
407
+
408
+
409
+ <li class="">
410
+ <a href="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</a>
411
+ </li>
412
+
413
+
414
+
415
+
416
+
417
+ <li class="">
418
+ <a href="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet &amp; Greet at GitHub HQ</a>
419
+ </li>
420
+
421
+
422
+
423
+
424
+
425
+ <li class="">
426
+ <a href="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</a>
427
+ </li>
428
+
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+
437
+
438
+
439
+
440
+
441
+
442
+
443
+
444
+
445
+
446
+
447
+ <li class="">
448
+ <a href="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</a>
449
+ </li>
450
+
451
+
452
+
453
+
454
+
455
+
456
+
457
+
458
+
459
+
460
+
461
+
462
+
463
+
464
+
465
+
466
+
467
+
468
+
469
+
470
+
471
+
472
+
473
+
474
+
475
+
476
+
477
+
478
+
479
+
480
+
481
+
482
+
483
+
484
+
485
+
486
+
487
+
488
+
489
+
490
+
491
+
492
+
493
+
494
+ </ul>
495
+ </aside>
496
+ </div>
497
+
498
+
499
+ <div class="clear"></div>
500
+
501
+ </div>
502
+ </section>
503
+
504
+
505
+ <footer>
506
+ <div class="grid">
507
+ <div class="unit one-third center-on-mobiles">
508
+ <p>The contents of this website are <br>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
509
+ </div>
510
+ <div class="unit two-thirds align-right center-on-mobiles">
511
+ <p>
512
+ Proudly hosted by
513
+ <a href="https://github.com">
514
+ <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
515
+ </a>
516
+ </p>
517
+ </div>
518
+ </div>
519
+ </footer>
520
+
521
+ <script>
522
+ var anchorForId = function (id) {
523
+ var anchor = document.createElement("a");
524
+ anchor.className = "header-link";
525
+ anchor.href = "#" + id;
526
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
527
+ anchor.title = "Permalink";
528
+ return anchor;
529
+ };
530
+
531
+ var linkifyAnchors = function (level, containingElement) {
532
+ var headers = containingElement.getElementsByTagName("h" + level);
533
+ for (var h = 0; h < headers.length; h++) {
534
+ var header = headers[h];
535
+
536
+ if (typeof header.id !== "undefined" && header.id !== "") {
537
+ header.appendChild(anchorForId(header.id));
538
+ }
539
+ }
540
+ };
541
+
542
+ document.onreadystatechange = function () {
543
+ if (this.readyState === "complete") {
544
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
545
+ if (!contentBlock) {
546
+ return;
547
+ }
548
+ for (var level = 1; level <= 6; level++) {
549
+ linkifyAnchors(level, contentBlock);
550
+ }
551
+ }
552
+ };
553
+ </script>
554
+
555
+
556
+ <!-- Gauges (http://get.gaug.es/) -->
557
+ <script>
558
+ var _gauges = _gauges || [];
559
+ (function() {
560
+ var t = document.createElement('script');
561
+ t.type = 'text/javascript';
562
+ t.async = true;
563
+ t.id = 'gauges-tracker';
564
+ t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
565
+ t.src = '//secure.gaug.es/track.js';
566
+ var s = document.getElementsByTagName('script')[0];
567
+ s.parentNode.insertBefore(t, s);
568
+ })();
569
+ </script>
570
+
571
+
572
+
573
+ <!-- Google Analytics (https://www.google.com/analytics) -->
574
+ <script>
575
+ !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
576
+ (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
577
+ L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
578
+ L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
579
+
580
+ ga('create', 'UA-50755011-1', 'jekyllrb.com');
581
+ ga('send', 'pageview');
582
+
583
+ </script>
584
+
585
+
586
+
587
+ </body>
588
+ </html>