jekyll-docs 3.2.1 → 3.3.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/site/404.html +2 -2
- data/site/community/index.html +4 -4
- data/site/css/screen.css +16 -8
- data/site/docs/assets/index.html +90 -79
- data/site/docs/collections/index.html +106 -84
- data/site/docs/conduct/index.html +70 -70
- data/site/docs/configuration/index.html +143 -93
- data/site/docs/continuous-integration/index.html +137 -95
- data/site/docs/contributing/index.html +70 -70
- data/site/docs/datafiles/index.html +116 -87
- data/site/docs/deployment-methods/index.html +108 -84
- data/site/docs/drafts/index.html +75 -72
- data/site/docs/extras/index.html +74 -71
- data/site/docs/frontmatter/index.html +82 -76
- data/site/docs/github-pages/index.html +88 -83
- data/site/docs/history/index.html +185 -74
- data/site/docs/home/index.html +70 -70
- data/site/docs/installation/index.html +94 -82
- data/site/docs/migrations/index.html +70 -70
- data/site/docs/pages/index.html +80 -74
- data/site/docs/pagination/index.html +91 -76
- data/site/docs/permalinks/index.html +70 -70
- data/site/docs/plugins/index.html +142 -96
- data/site/docs/posts/index.html +117 -87
- data/site/docs/quickstart/index.html +77 -73
- data/site/docs/resources/index.html +76 -71
- data/site/docs/sites/index.html +70 -70
- data/site/docs/static-files/index.html +88 -72
- data/site/docs/structure/index.html +79 -76
- data/site/docs/templates/index.html +210 -84
- data/site/docs/themes/index.html +106 -81
- data/site/docs/troubleshooting/index.html +155 -91
- data/site/docs/upgrading/0-to-2/index.html +74 -71
- data/site/docs/upgrading/2-to-3/index.html +99 -79
- data/site/docs/upgrading/index.html +70 -70
- data/site/docs/usage/index.html +95 -80
- data/site/docs/variables/index.html +71 -72
- data/site/docs/windows/index.html +89 -77
- data/site/feed.xml +111 -35
- data/site/help/index.html +2 -2
- data/site/index.html +3 -8
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +18 -6
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -6
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +18 -6
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +18 -6
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +18 -6
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +18 -6
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -6
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -6
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +18 -6
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +18 -6
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +18 -6
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +18 -6
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +18 -6
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +18 -6
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +18 -6
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -6
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +18 -6
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +18 -6
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +18 -6
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +18 -6
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +18 -6
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +18 -6
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +18 -6
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -6
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +18 -6
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +18 -6
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +18 -6
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +18 -6
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +18 -6
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -6
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +18 -6
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +18 -6
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +18 -6
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +18 -6
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +18 -6
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +18 -6
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +18 -6
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -6
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +18 -6
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +18 -6
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +18 -6
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -6
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +18 -6
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +18 -6
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +18 -6
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +18 -6
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +18 -6
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +18 -6
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +18 -6
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +18 -6
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +19 -7
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +18 -6
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +536 -0
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +615 -0
- data/site/news/index.html +172 -7
- data/site/news/releases/index.html +135 -7
- data/site/sitemap.xml +8 -0
- metadata +6 -5
- data/site/README.md +0 -16
data/site/news/index.html
CHANGED
@@ -4,7 +4,7 @@
|
|
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.
|
7
|
+
<meta name="generator" content="Jekyll v3.3.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">
|
@@ -28,7 +28,7 @@
|
|
28
28
|
"@type": "WebPage",
|
29
29
|
"headline": "News",
|
30
30
|
"description": "Transform your plain text into static websites and blogs",
|
31
|
-
"logo": "https://jekyllrb.
|
31
|
+
"logo": "https://jekyllrb.com/img/logo-2x.png",
|
32
32
|
"url": "https://jekyllrb.com/news/"
|
33
33
|
}
|
34
34
|
</script>
|
@@ -110,6 +110,10 @@
|
|
110
110
|
<option value="/news/">Home</option>
|
111
111
|
<optgroup label="v1.x">
|
112
112
|
|
113
|
+
<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>
|
114
|
+
|
115
|
+
<option value="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</option>
|
116
|
+
|
113
117
|
<option value="/news/2016/08/02/jekyll-3-2-1-released/">Jekyll 3.2.1 Released with Fix for Windows</option>
|
114
118
|
|
115
119
|
<option value="/news/2016/07/26/jekyll-3-2-0-released/">Jekyll turns 3.2</option>
|
@@ -221,6 +225,159 @@
|
|
221
225
|
|
222
226
|
<div class="unit four-fifths">
|
223
227
|
|
228
|
+
<article>
|
229
|
+
<h2>
|
230
|
+
<a href="/news/2016/10/06/jekyll-3-3-is-here/">
|
231
|
+
Jekyll 3.3 is here with better theme support, new URL filters, and tons more
|
232
|
+
</a>
|
233
|
+
</h2>
|
234
|
+
<span class="post-category">
|
235
|
+
<span class="label">
|
236
|
+
release
|
237
|
+
</span>
|
238
|
+
</span>
|
239
|
+
<div class="post-meta">
|
240
|
+
<span class="post-date">
|
241
|
+
06 Oct 2016
|
242
|
+
</span>
|
243
|
+
<a href="https://github.com/parkr" class="post-author">
|
244
|
+
|
245
|
+
<img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&s=96 4x" width="24" height="24" data-proofer-ignore="true">
|
246
|
+
parkr
|
247
|
+
</a>
|
248
|
+
</div>
|
249
|
+
<div class="post-content">
|
250
|
+
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
251
|
+
Three key things you might want to try:</p>
|
252
|
+
|
253
|
+
<h3 id="themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
|
254
|
+
|
255
|
+
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
256
|
+
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
257
|
+
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
258
|
+
|
259
|
+
<p>In an effort to make theme management a bit easier, any files you put into
|
260
|
+
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
261
|
+
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
262
|
+
webfonts, and so on – anything you’d consider a part of the
|
263
|
+
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
264
|
+
front matter, it will be converted and rendered. No YAML front matter, and
|
265
|
+
it will simply be copied over like a static asset.</p>
|
266
|
+
|
267
|
+
<p>Note that if a user has a file of the same path, the theme content will not
|
268
|
+
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
269
|
+
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
270
|
+
|
271
|
+
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
272
|
+
for more info.</p>
|
273
|
+
|
274
|
+
<h3 id="relativeurl-and-absoluteurl-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
|
275
|
+
|
276
|
+
<p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
|
277
|
+
new filters have you covered. When working locally, if you set your
|
278
|
+
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
279
|
+
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
280
|
+
you pass it:</p>
|
281
|
+
|
282
|
+
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /myproject/docs/assets</code></pre></figure>
|
283
|
+
|
284
|
+
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
285
|
+
<code class="highlighter-rouge">"/"</code>):</p>
|
286
|
+
|
287
|
+
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /docs/assets</code></pre></figure>
|
288
|
+
|
289
|
+
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
290
|
+
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
291
|
+
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URL’s all the
|
292
|
+
easier to make:</p>
|
293
|
+
|
294
|
+
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> => http://jekyllrb.com/myproject/docs/assets</code></pre></figure>
|
295
|
+
|
296
|
+
<h3 id="siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
|
297
|
+
|
298
|
+
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
299
|
+
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
300
|
+
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
301
|
+
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
302
|
+
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
303
|
+
|
304
|
+
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
305
|
+
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
306
|
+
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
307
|
+
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
308
|
+
|
309
|
+
<p>This happens by default when running Jekyll locally. It will not be set if
|
310
|
+
you set <code class="highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="highlighter-rouge">jekyll serve</code>. If <code class="highlighter-rouge">JEKYLL_ENV</code> is
|
311
|
+
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
312
|
+
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
313
|
+
to serving, not to building.</p>
|
314
|
+
|
315
|
+
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
316
|
+
|
317
|
+
<p>There are dozens of bug fixes and minor improvements to make your Jekyll
|
318
|
+
experience better than ever. With every Jekyll release, we strive to bring
|
319
|
+
greater stability and reliability to your everyday development workflow.</p>
|
320
|
+
|
321
|
+
<p>As always, thanks to our many contributors who contributed countless hours
|
322
|
+
of their free time to making this release happen:</p>
|
323
|
+
|
324
|
+
<p>Anatoliy Yastreb, Anthony Gaudino, Antonio, Ashwin Maroli, Ben Balter,
|
325
|
+
Charles Horn, Chris Finazzo, Daniel Chapman, David Zhang, Eduardo
|
326
|
+
Bouças, Edward Thomson, Eloy Espinaco, Florian Thomas, Frank Taillandier,
|
327
|
+
Gerardo, Heng Kwokfu, Heng, K. (Stephen), Jeff Kolesky, Jonathan Thornton,
|
328
|
+
Jordon Bedwell, Jussi Kinnula, Júnior Messias, Kyle O’Brien, Manmeet Gill,
|
329
|
+
Mark H. Wilkinson, Marko Locher, Mertcan GÖKGÖZ, Michal Švácha, Mike
|
330
|
+
Kasberg, Nadjib Amar, Nicolas Hoizey, Nicolas Porcel, Parker Moore, Pat
|
331
|
+
Hawks, Patrick Marsceill, Stephen Checkoway, Stuart Kent, XhmikosR, Zlatan
|
332
|
+
Vasović, mertkahyaoglu, shingo-nakanishi, and vohedge.</p>
|
333
|
+
|
334
|
+
<p><a href="/docs/history/#v3-3-0">Full release notes</a> are available
|
335
|
+
for your perusal. If you notice any issues, please don’t hesitate to file a
|
336
|
+
bug report.</p>
|
337
|
+
|
338
|
+
<p>Happy Jekylling!</p>
|
339
|
+
|
340
|
+
</div>
|
341
|
+
</article>
|
342
|
+
|
343
|
+
|
344
|
+
<article>
|
345
|
+
<h2>
|
346
|
+
<a href="/news/2016/08/24/jekyll-admin-initial-release/">
|
347
|
+
Jekyll Admin Initial Release
|
348
|
+
</a>
|
349
|
+
</h2>
|
350
|
+
<span class="post-category">
|
351
|
+
<span class="label">
|
352
|
+
community
|
353
|
+
</span>
|
354
|
+
</span>
|
355
|
+
<div class="post-meta">
|
356
|
+
<span class="post-date">
|
357
|
+
24 Aug 2016
|
358
|
+
</span>
|
359
|
+
<a href="https://github.com/mertkahyaoglu" class="post-author">
|
360
|
+
|
361
|
+
<img class="avatar avatar-small" src="https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&s=24" alt="mertkahyaoglu" srcset="https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&s=24 1x, https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&s=48 2x, https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&s=72 3x, https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&s=96 4x" width="24" height="24" data-proofer-ignore="true">
|
362
|
+
mertkahyaoglu
|
363
|
+
</a>
|
364
|
+
</div>
|
365
|
+
<div class="post-content">
|
366
|
+
<p><a href="http://jekyllrb.com/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll’s Google Summer of Code Project</a> has concluded. After three months of hard (but fun) work with my mentors <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>, <a href="https://github.com/jldec" class="user-mention">@jldec</a>, and <a href="https://github.com/parkr" class="user-mention">@parkr</a>, I’m proud to announce <a href="https://github.com/jekyll/jekyll-admin">Jekyll Admin</a>’s <a href="https://github.com/jekyll/jekyll-admin/releases/tag/v0.1.0">initial release</a>. Jekyll admin is a Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites. You can start to use it right away by following <a href="https://github.com/jekyll/jekyll-admin#installation">these instructions</a>.</p>
|
367
|
+
|
368
|
+
<p>As a Google Summer of Code student, I feel very lucky to be part of a project that the community has been wanting for such a long time. The three-month Google Summer of Code period was a great journey. It was a lot of fun developing the project and seeing how it could help the community, and going forward, we are really excited to see where the project goes with the help of the amazing Jekyll community.</p>
|
369
|
+
|
370
|
+
<p>I would like to thank my mentors who embraced me as their teammate and guided me throughout the process. They have put a lot of work and time to mentor me and helped me with everything. It was a great pleasure to work with them. I also would like to thank the wonderful Jekyll community for making Jekyll what it is today. It was amazing to see the community contribute to the project and give their feedback
|
371
|
+
prior to its release. I’m sure that they will support Jekyll Admin as much as they can and move Jekyll even further.</p>
|
372
|
+
|
373
|
+
<p>Please let us know what you think about <a href="https://github.com/jekyll/jekyll-admin">Jekyll Admin</a> and feel free to <a href="https://github.com/jekyll/jekyll-admin/blob/master/.github/CONTRIBUTING.md">contribute</a>. Your feedback and contributions are greatly appreciated.</p>
|
374
|
+
|
375
|
+
<p>Happy (graphical) Jekylling!</p>
|
376
|
+
|
377
|
+
</div>
|
378
|
+
</article>
|
379
|
+
|
380
|
+
|
224
381
|
<article>
|
225
382
|
<h2>
|
226
383
|
<a href="/news/2016/08/02/jekyll-3-2-1-released/">
|
@@ -303,7 +460,7 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
303
460
|
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
304
461
|
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
305
462
|
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URL’s for any
|
306
|
-
post
|
463
|
+
post or document based on its path relative to the site source</li>
|
307
464
|
<li>… and lots more!</li>
|
308
465
|
</ul>
|
309
466
|
|
@@ -2625,6 +2782,10 @@ examples and for compiling this list):</p>
|
|
2625
2782
|
<h4>Recent Releases</h4>
|
2626
2783
|
<ul>
|
2627
2784
|
|
2785
|
+
<li class="">
|
2786
|
+
<a href="/news/2016/10/06/jekyll-3-3-is-here/">Version 3.3.0</a>
|
2787
|
+
</li>
|
2788
|
+
|
2628
2789
|
<li class="">
|
2629
2790
|
<a href="/news/2016/08/02/jekyll-3-2-1-released/">Version 3.2.1</a>
|
2630
2791
|
</li>
|
@@ -2641,10 +2802,6 @@ examples and for compiling this list):</p>
|
|
2641
2802
|
<a href="/news/2016/05/18/jekyll-3-1-5-released/">Version 3.1.5</a>
|
2642
2803
|
</li>
|
2643
2804
|
|
2644
|
-
<li class="">
|
2645
|
-
<a href="/news/2016/05/18/jekyll-3-1-4-released/">Version 3.1.4</a>
|
2646
|
-
</li>
|
2647
|
-
|
2648
2805
|
<li>
|
2649
2806
|
<a href="/docs/history/">History »</a>
|
2650
2807
|
</li>
|
@@ -2655,6 +2812,14 @@ examples and for compiling this list):</p>
|
|
2655
2812
|
|
2656
2813
|
|
2657
2814
|
|
2815
|
+
<li class="">
|
2816
|
+
<a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
|
2817
|
+
</li>
|
2818
|
+
|
2819
|
+
|
2820
|
+
|
2821
|
+
|
2822
|
+
|
2658
2823
|
|
2659
2824
|
|
2660
2825
|
<li class="">
|
@@ -4,7 +4,7 @@
|
|
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.
|
7
|
+
<meta name="generator" content="Jekyll v3.3.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">
|
@@ -28,7 +28,7 @@
|
|
28
28
|
"@type": "WebPage",
|
29
29
|
"headline": "Releases",
|
30
30
|
"description": "Transform your plain text into static websites and blogs",
|
31
|
-
"logo": "https://jekyllrb.
|
31
|
+
"logo": "https://jekyllrb.com/img/logo-2x.png",
|
32
32
|
"url": "https://jekyllrb.com/news/releases/"
|
33
33
|
}
|
34
34
|
</script>
|
@@ -110,6 +110,10 @@
|
|
110
110
|
<option value="/news/">Home</option>
|
111
111
|
<optgroup label="v1.x">
|
112
112
|
|
113
|
+
<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>
|
114
|
+
|
115
|
+
<option value="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</option>
|
116
|
+
|
113
117
|
<option value="/news/2016/08/02/jekyll-3-2-1-released/">Jekyll 3.2.1 Released with Fix for Windows</option>
|
114
118
|
|
115
119
|
<option value="/news/2016/07/26/jekyll-3-2-0-released/">Jekyll turns 3.2</option>
|
@@ -221,6 +225,122 @@
|
|
221
225
|
|
222
226
|
<div class="unit four-fifths">
|
223
227
|
|
228
|
+
<article>
|
229
|
+
<h2>
|
230
|
+
<a href="/news/2016/10/06/jekyll-3-3-is-here/">
|
231
|
+
Jekyll 3.3 is here with better theme support, new URL filters, and tons more
|
232
|
+
</a>
|
233
|
+
</h2>
|
234
|
+
<span class="post-category">
|
235
|
+
<span class="label">
|
236
|
+
release
|
237
|
+
</span>
|
238
|
+
</span>
|
239
|
+
<div class="post-meta">
|
240
|
+
<span class="post-date">
|
241
|
+
06 Oct 2016
|
242
|
+
</span>
|
243
|
+
<a href="https://github.com/parkr" class="post-author">
|
244
|
+
|
245
|
+
<img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&s=96 4x" width="24" height="24" data-proofer-ignore="true">
|
246
|
+
parkr
|
247
|
+
</a>
|
248
|
+
</div>
|
249
|
+
<div class="post-content">
|
250
|
+
<p>There are tons of great new quality-of-life features you can use in 3.3.
|
251
|
+
Three key things you might want to try:</p>
|
252
|
+
|
253
|
+
<h3 id="themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static & dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
|
254
|
+
|
255
|
+
<p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
|
256
|
+
<a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
|
257
|
+
layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
|
258
|
+
|
259
|
+
<p>In an effort to make theme management a bit easier, any files you put into
|
260
|
+
<code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
|
261
|
+
user’s site. This means you can ship SCSS and CoffeeScript, images and
|
262
|
+
webfonts, and so on – anything you’d consider a part of the
|
263
|
+
<em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
|
264
|
+
front matter, it will be converted and rendered. No YAML front matter, and
|
265
|
+
it will simply be copied over like a static asset.</p>
|
266
|
+
|
267
|
+
<p>Note that if a user has a file of the same path, the theme content will not
|
268
|
+
be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
|
269
|
+
processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
|
270
|
+
|
271
|
+
<p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
|
272
|
+
for more info.</p>
|
273
|
+
|
274
|
+
<h3 id="relativeurl-and-absoluteurl-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
|
275
|
+
|
276
|
+
<p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
|
277
|
+
new filters have you covered. When working locally, if you set your
|
278
|
+
<code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
|
279
|
+
then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
|
280
|
+
you pass it:</p>
|
281
|
+
|
282
|
+
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /myproject/docs/assets</code></pre></figure>
|
283
|
+
|
284
|
+
<p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
|
285
|
+
<code class="highlighter-rouge">"/"</code>):</p>
|
286
|
+
|
287
|
+
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> => /docs/assets</code></pre></figure>
|
288
|
+
|
289
|
+
<p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
|
290
|
+
relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
|
291
|
+
It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URL’s all the
|
292
|
+
easier to make:</p>
|
293
|
+
|
294
|
+
<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> => http://jekyllrb.com/myproject/docs/assets</code></pre></figure>
|
295
|
+
|
296
|
+
<h3 id="siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
|
297
|
+
|
298
|
+
<p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
|
299
|
+
<code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
|
300
|
+
development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
|
301
|
+
<code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
|
302
|
+
which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
303
|
+
|
304
|
+
<p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
|
305
|
+
the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
|
306
|
+
<code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
|
307
|
+
will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
|
308
|
+
|
309
|
+
<p>This happens by default when running Jekyll locally. It will not be set if
|
310
|
+
you set <code class="highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="highlighter-rouge">jekyll serve</code>. If <code class="highlighter-rouge">JEKYLL_ENV</code> is
|
311
|
+
any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
|
312
|
+
overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
|
313
|
+
to serving, not to building.</p>
|
314
|
+
|
315
|
+
<h2 id="a-lot-more">A <em>lot</em> more!</h2>
|
316
|
+
|
317
|
+
<p>There are dozens of bug fixes and minor improvements to make your Jekyll
|
318
|
+
experience better than ever. With every Jekyll release, we strive to bring
|
319
|
+
greater stability and reliability to your everyday development workflow.</p>
|
320
|
+
|
321
|
+
<p>As always, thanks to our many contributors who contributed countless hours
|
322
|
+
of their free time to making this release happen:</p>
|
323
|
+
|
324
|
+
<p>Anatoliy Yastreb, Anthony Gaudino, Antonio, Ashwin Maroli, Ben Balter,
|
325
|
+
Charles Horn, Chris Finazzo, Daniel Chapman, David Zhang, Eduardo
|
326
|
+
Bouças, Edward Thomson, Eloy Espinaco, Florian Thomas, Frank Taillandier,
|
327
|
+
Gerardo, Heng Kwokfu, Heng, K. (Stephen), Jeff Kolesky, Jonathan Thornton,
|
328
|
+
Jordon Bedwell, Jussi Kinnula, Júnior Messias, Kyle O’Brien, Manmeet Gill,
|
329
|
+
Mark H. Wilkinson, Marko Locher, Mertcan GÖKGÖZ, Michal Švácha, Mike
|
330
|
+
Kasberg, Nadjib Amar, Nicolas Hoizey, Nicolas Porcel, Parker Moore, Pat
|
331
|
+
Hawks, Patrick Marsceill, Stephen Checkoway, Stuart Kent, XhmikosR, Zlatan
|
332
|
+
Vasović, mertkahyaoglu, shingo-nakanishi, and vohedge.</p>
|
333
|
+
|
334
|
+
<p><a href="/docs/history/#v3-3-0">Full release notes</a> are available
|
335
|
+
for your perusal. If you notice any issues, please don’t hesitate to file a
|
336
|
+
bug report.</p>
|
337
|
+
|
338
|
+
<p>Happy Jekylling!</p>
|
339
|
+
|
340
|
+
</div>
|
341
|
+
</article>
|
342
|
+
|
343
|
+
|
224
344
|
<article>
|
225
345
|
<h2>
|
226
346
|
<a href="/news/2016/08/02/jekyll-3-2-1-released/">
|
@@ -303,7 +423,7 @@ now dogfoods this feature, using the <a href="https://github.com/jekyll/minima">
|
|
303
423
|
<li>Added an <code class="highlighter-rouge">:after_init</code> Hook</li>
|
304
424
|
<li>Added a <code class="highlighter-rouge">where_exp</code> filter to provide more powerful filtering</li>
|
305
425
|
<li>Added a <code class="highlighter-rouge">link</code> liquid tag which can be used to generate URL’s for any
|
306
|
-
post
|
426
|
+
post or document based on its path relative to the site source</li>
|
307
427
|
<li>… and lots more!</li>
|
308
428
|
</ul>
|
309
429
|
|
@@ -2397,6 +2517,10 @@ examples and for compiling this list):</p>
|
|
2397
2517
|
<h4>Recent Releases</h4>
|
2398
2518
|
<ul>
|
2399
2519
|
|
2520
|
+
<li class="">
|
2521
|
+
<a href="/news/2016/10/06/jekyll-3-3-is-here/">Version 3.3.0</a>
|
2522
|
+
</li>
|
2523
|
+
|
2400
2524
|
<li class="">
|
2401
2525
|
<a href="/news/2016/08/02/jekyll-3-2-1-released/">Version 3.2.1</a>
|
2402
2526
|
</li>
|
@@ -2413,10 +2537,6 @@ examples and for compiling this list):</p>
|
|
2413
2537
|
<a href="/news/2016/05/18/jekyll-3-1-5-released/">Version 3.1.5</a>
|
2414
2538
|
</li>
|
2415
2539
|
|
2416
|
-
<li class="">
|
2417
|
-
<a href="/news/2016/05/18/jekyll-3-1-4-released/">Version 3.1.4</a>
|
2418
|
-
</li>
|
2419
|
-
|
2420
2540
|
<li>
|
2421
2541
|
<a href="/docs/history/">History »</a>
|
2422
2542
|
</li>
|
@@ -2427,6 +2547,14 @@ examples and for compiling this list):</p>
|
|
2427
2547
|
|
2428
2548
|
|
2429
2549
|
|
2550
|
+
<li class="">
|
2551
|
+
<a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
|
2552
|
+
</li>
|
2553
|
+
|
2554
|
+
|
2555
|
+
|
2556
|
+
|
2557
|
+
|
2430
2558
|
|
2431
2559
|
|
2432
2560
|
<li class="">
|
data/site/sitemap.xml
CHANGED
@@ -1,6 +1,14 @@
|
|
1
1
|
<?xml version="1.0" encoding="UTF-8"?>
|
2
2
|
<urlset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
3
3
|
<url>
|
4
|
+
<loc>https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/</loc>
|
5
|
+
<lastmod>2016-10-06T11:10:38-07:00</lastmod>
|
6
|
+
</url>
|
7
|
+
<url>
|
8
|
+
<loc>https://jekyllrb.com/news/2016/08/24/jekyll-admin-initial-release/</loc>
|
9
|
+
<lastmod>2016-08-24T23:50:00-07:00</lastmod>
|
10
|
+
</url>
|
11
|
+
<url>
|
4
12
|
<loc>https://jekyllrb.com/news/2016/08/02/jekyll-3-2-1-released/</loc>
|
5
13
|
<lastmod>2016-08-02T13:20:11-07:00</lastmod>
|
6
14
|
</url>
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: jekyll-docs
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.
|
4
|
+
version: 3.3.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Parker Moore
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2016-
|
11
|
+
date: 2016-10-06 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: jekyll
|
@@ -16,14 +16,14 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - '='
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: 3.
|
19
|
+
version: 3.3.0
|
20
20
|
type: :runtime
|
21
21
|
prerelease: false
|
22
22
|
version_requirements: !ruby/object:Gem::Requirement
|
23
23
|
requirements:
|
24
24
|
- - '='
|
25
25
|
- !ruby/object:Gem::Version
|
26
|
-
version: 3.
|
26
|
+
version: 3.3.0
|
27
27
|
- !ruby/object:Gem::Dependency
|
28
28
|
name: bundler
|
29
29
|
requirement: !ruby/object:Gem::Requirement
|
@@ -62,7 +62,6 @@ files:
|
|
62
62
|
- lib/jekyll-docs.rb
|
63
63
|
- site/404.html
|
64
64
|
- site/CNAME
|
65
|
-
- site/README.md
|
66
65
|
- site/community/index.html
|
67
66
|
- site/conduct/index.html
|
68
67
|
- site/css/screen.css
|
@@ -177,6 +176,8 @@ files:
|
|
177
176
|
- site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html
|
178
177
|
- site/news/2016/07/26/jekyll-3-2-0-released/index.html
|
179
178
|
- site/news/2016/08/02/jekyll-3-2-1-released/index.html
|
179
|
+
- site/news/2016/08/24/jekyll-admin-initial-release/index.html
|
180
|
+
- site/news/2016/10/06/jekyll-3-3-is-here/index.html
|
180
181
|
- site/news/index.html
|
181
182
|
- site/news/releases/index.html
|
182
183
|
- site/sitemap.xml
|