Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request 8243
- Loading branch information
Showing
1 changed file
with
38 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. |