From a7b8d27bda40628ceae0aadb8c35790171ef79ea Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 24 Jun 2020 22:23:29 +0530 Subject: [PATCH] Release post for v4.1.1 (#8243) Merge pull request 8243 --- .../2020-06-24-jekyll-4-1-1-released.markdown | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/_posts/2020-06-24-jekyll-4-1-1-released.markdown diff --git a/docs/_posts/2020-06-24-jekyll-4-1-1-released.markdown b/docs/_posts/2020-06-24-jekyll-4-1-1-released.markdown new file mode 100644 index 00000000000..599578ece02 --- /dev/null +++ b/docs/_posts/2020-06-24-jekyll-4-1-1-released.markdown @@ -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.