parent
							
								
									3ebbb7994f
								
							
						
					
					
						commit
						a7b8d27bda
					
				| 
						 | 
				
			
			@ -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.
 | 
			
		||||
		Loading…
	
		Reference in New Issue