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.
Files changed (102) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +2 -2
  3. data/site/community/index.html +4 -4
  4. data/site/css/screen.css +16 -8
  5. data/site/docs/assets/index.html +90 -79
  6. data/site/docs/collections/index.html +106 -84
  7. data/site/docs/conduct/index.html +70 -70
  8. data/site/docs/configuration/index.html +143 -93
  9. data/site/docs/continuous-integration/index.html +137 -95
  10. data/site/docs/contributing/index.html +70 -70
  11. data/site/docs/datafiles/index.html +116 -87
  12. data/site/docs/deployment-methods/index.html +108 -84
  13. data/site/docs/drafts/index.html +75 -72
  14. data/site/docs/extras/index.html +74 -71
  15. data/site/docs/frontmatter/index.html +82 -76
  16. data/site/docs/github-pages/index.html +88 -83
  17. data/site/docs/history/index.html +185 -74
  18. data/site/docs/home/index.html +70 -70
  19. data/site/docs/installation/index.html +94 -82
  20. data/site/docs/migrations/index.html +70 -70
  21. data/site/docs/pages/index.html +80 -74
  22. data/site/docs/pagination/index.html +91 -76
  23. data/site/docs/permalinks/index.html +70 -70
  24. data/site/docs/plugins/index.html +142 -96
  25. data/site/docs/posts/index.html +117 -87
  26. data/site/docs/quickstart/index.html +77 -73
  27. data/site/docs/resources/index.html +76 -71
  28. data/site/docs/sites/index.html +70 -70
  29. data/site/docs/static-files/index.html +88 -72
  30. data/site/docs/structure/index.html +79 -76
  31. data/site/docs/templates/index.html +210 -84
  32. data/site/docs/themes/index.html +106 -81
  33. data/site/docs/troubleshooting/index.html +155 -91
  34. data/site/docs/upgrading/0-to-2/index.html +74 -71
  35. data/site/docs/upgrading/2-to-3/index.html +99 -79
  36. data/site/docs/upgrading/index.html +70 -70
  37. data/site/docs/usage/index.html +95 -80
  38. data/site/docs/variables/index.html +71 -72
  39. data/site/docs/windows/index.html +89 -77
  40. data/site/feed.xml +111 -35
  41. data/site/help/index.html +2 -2
  42. data/site/index.html +3 -8
  43. data/site/latest_version.txt +1 -1
  44. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +18 -6
  45. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -6
  46. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +18 -6
  47. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +18 -6
  48. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +18 -6
  49. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +18 -6
  50. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -6
  51. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -6
  52. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +18 -6
  53. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +18 -6
  54. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +18 -6
  55. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +18 -6
  56. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +18 -6
  57. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +18 -6
  58. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +18 -6
  59. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -6
  60. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +18 -6
  61. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +18 -6
  62. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +18 -6
  63. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +18 -6
  64. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +18 -6
  65. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +18 -6
  66. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +18 -6
  67. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -6
  68. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +18 -6
  69. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +18 -6
  70. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +18 -6
  71. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +18 -6
  72. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +18 -6
  73. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -6
  74. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +18 -6
  75. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +18 -6
  76. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +18 -6
  77. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +18 -6
  78. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +18 -6
  79. data/site/news/2015/10/26/jekyll-3-0-released/index.html +18 -6
  80. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +18 -6
  81. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -6
  82. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +18 -6
  83. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +18 -6
  84. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +18 -6
  85. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -6
  86. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +18 -6
  87. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +18 -6
  88. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +18 -6
  89. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +18 -6
  90. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +18 -6
  91. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +18 -6
  92. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +18 -6
  93. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +18 -6
  94. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +19 -7
  95. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +18 -6
  96. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +536 -0
  97. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +615 -0
  98. data/site/news/index.html +172 -7
  99. data/site/news/releases/index.html +135 -7
  100. data/site/sitemap.xml +8 -0
  101. metadata +6 -5
  102. data/site/README.md +0 -16
@@ -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.2.1">
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.comimg/logo-2x.png",
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&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;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 &amp; 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> =&gt; /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> =&gt; /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> =&gt; 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&amp;s=24" alt="mertkahyaoglu" srcset="https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&amp;s=24 1x, https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&amp;s=48 2x, https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&amp;s=72 3x, https://avatars0.githubusercontent.com/mertkahyaoglu?v=3&amp;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, page, or document based on its path relative to the site source</li>
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.2.1">
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.comimg/logo-2x.png",
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&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;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 &amp; 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> =&gt; /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> =&gt; /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> =&gt; 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, page, or document based on its path relative to the site source</li>
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="">
@@ -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.2.1
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-08-03 00:00:00.000000000 Z
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.2.1
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.2.1
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