Skip to content

Commit

Permalink
add release post for v3.7.1
Browse files Browse the repository at this point in the history
  • Loading branch information
ashmaroli committed Jan 15, 2018
1 parent 7895168 commit 697a330
Showing 1 changed file with 49 additions and 0 deletions.
49 changes: 49 additions & 0 deletions docs/_posts/2018-01-15-jekyll-3-7-1-released.md
@@ -0,0 +1,49 @@
---
title: "Jekyll 3.7.1 Released"
date: 2018-01-15 11:21:00 +0530
author: ashmaroli
version: 3.7.1
categories: [release]
---

Close on the heels of shipping 3.7.0, we were informed of a couple of
regressions due to the changes made in that release. In due time, Team Jekyll
set out to address those issues as early as possible.

Days later, here we're announcing 3.7.1 that aims to set things in order. The
highlights being:

* A major regression in 3.7.0 was that when a Front matter default was
configured with a `scope["path"]` set to a directory, Jekyll would scan
that directory for any subfolders and files, for each document in that
`path`.
Though this is intended, it increases build times in proportion to the size
of the said directory. <br />
We addressed this by having Jekyll scan the directory path only if the user
explicitly configures the `scope["path"]` using wildcards. Read our
documentation for more details. <br />
A huge shout-out to @mmistakes for bringing this to our notice and
additionally providing with a test repository to aid in resolving the
issue.
* Another regression reported was related to our "Custom collections
directory" feature introduced in 3.7.0. <br />
Users setting `collection_dir` to a certain directory would have *altered*
paths to their posts still at the root of their site's source. This
roughly translated to 404 errors on urls to their posts. <br />
Props to @localheinz for asserting this regression to our notice. <br />
We decided to resolve this by having Jekyll ignore posts and drafts at the
root of the site's source directory if the user customizes the
`collection_dir` setting. <br />
Ergo, if you set a custom location for your collections, please ensure you
move all of your collections into that directory. *This includes posts and
drafts as well*. Your links generated by `{% post_url %}` or `{% link %}`
will adapt automatically.

In addition to the above, numerous other minor fixes and documentation updates
have been made that should improve your Jekyll experience. All of which would
not have been possible without our wonderful contributors: Andreas Möller,
Ashwin Maroli, Florian Thomas, Frank Taillandier, Olivia and Parker Moore.

As always, you can see our full changelog on [the History page](/docs/history/).

Happy Jekylling!

0 comments on commit 697a330

Please sign in to comment.