jekyll-docs 3.4.3 → 3.5.1

Sign up to get free protection for your applications and to get access to all the features.
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>