Release post for v4.1.1 (#8243)

Merge pull request 8243
This commit is contained in:
Ashwin Maroli 2020-06-24 22:23:29 +05:30 committed by GitHub
parent 3ebbb7994f
commit a7b8d27bda
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 38 additions and 0 deletions

View File

@ -0,0 +1,38 @@
---
title: 'Jekyll 4.1.1 Released'
date: 2020-06-24 16:45:35 +0530
author: ashmaroli
version: 4.1.1
category: release
---
Jekyll 4.1.0 brought two notable changes: *Page-excerpts* and *Liquid Drop for Page objects*.
However these seemingly benign changes had unexpected adverse side-effects which did not figure in our tests.
The Core team decided that the best way forward is to revert introduction of the Liquid drop for Pages but push back
generating excerpts for pages behind a flag until `v5.0`.
Page-excerpts are henceforth an opt-in experimental feature which can be enabled by setting `page_excerpts: true` in
your configuration file. Due to its experimental nature, we have narrowed the scope for page-excerpts to limit their
negative effect on builds. Excerpts will not be generated for pages that *do not* output into an HTML file even if
`page_excerpts: true` has been set in the configuration file.
Another known issue with page-excerpts is that an infinite loop is created in certain use-cases such as any construct
that involves iterating through `site.pages` directly within a `Jekyll::Page` instance. A couple of examples would be
having a variant of either of the following code blocks inside a page source, say `index.markdown` or `about.markdown`:
{% raw %}
```liquid
{% for entry in site.pages %}
{{ entry.name }}
{% endfor %}
```
```liquid
{{ site.pages | sort: 'title' }}
```
{% endraw %}
Therefore, we advise caution when opting to use the page-excerpt feature.