eleventy 🕚⚡️ v0.10.0 Release Notes
Release Date: 2020-01-07 // over 4 years ago-
A special note of remembrance
👀 Before we get going here I just want to take a brief moment to remember the very special @jameswillweb who passed away earlier this month. James was diagnosed with ALS in 2013 and was known for his widespread teaching contributions to the web community. Probably the least of which, but one that I will always remember, was his creation of the floating possum mascot for our little Eleventy project. This mascot (nay, mastcot, because it lives in the masthead ok fine but James would have liked that one) lives at the top of the Eleventy docs and links to the Twitter thread he started in 2018. Though we never met in real life, James was clearly a one-of-a-kind. We will miss you ❤️
Donations may be made in James’ name to The ALS Therapy Development Institute or to Quest Youth Ministries at St. John's United Methodist Church.
Permalink: https://www.11ty.dev/news/james-williamson/
📚 v0.10.0 Documentation
Installation
- Install to your Local project (preferred):
npm install @11ty/eleventy - ⚡️ Already installed in your local project? Upgrade your version:
npm update @11ty/eleventy - Want to install globally?
npm install -g @11ty/eleventy - ⚡️ Already installed globally? Upgrade your Global version:
npm update -g @11ty/eleventy - 📄 Read more about local versus global installation
📄 How can you support Eleventy?
- 🍱 ⭐️ Starring us on GitHub! This will increase our project’s visibility on staticgen.com, a big giant list of static site generators.
- 🐦 Follow us on Twitter @eleven_ty!
- 🍱 🎁 Join 62 other lovely people and become an Eleventy Supporter!
🚀 Thank you to the code contributors that helped with this release: @gloryofrobots @edbrannin @MadeByMike @Ryuno-Ki @cschuller @micahmills @fredrikekelund @ahl @Munter @saenglert (and @zachleat, I guess)
🔋 Features
🔌 Official Plugins
- ➕ Adds new official Navigation Plugin for hierarchical site navigation and breadcrumbs #419 #210 https://github.com/11ty/eleventy-navigation
- Documentation: https://www.11ty.dev/docs/plugins/navigation/
- 🆕 New major version of
eleventy-plugin-syntaxhighlight, only opt-in to line wrapping markup if line highlighting features are used. Read more: https://github.com/11ty/eleventy-plugin-syntaxhighlight/releases/tag/v3.0.0- Documentation: https://www.11ty.dev/docs/plugins/syntaxhighlight/
🔧 Configuration API
- 👌 Support for arbitrary data file formats in the Data Cascade. e.g.
eleventyConfig.addDataExtension("yaml", contents => yaml.safeLoad(contents));Thank you @gloryofrobots! #736 #798 #635 #630 #624 #265- ⚠️ Documentation pending
- ➕ Adds
setQuietModemethod to Configuration API so that we don’t have to type--quietall the time. #808 - ➕ Adds
addWatchTargetmethod to Configuration API for programmatic watching of arbitrary files. Thanks @MadeByMike! #803 #641 - 0️⃣ Show
pathPrefixbeing used in standard console output (if non-default). #807 - ➕ Adds
getFilteredByTagsto Collection API #708 #711 #830
Pagination
- ➕ Adds a
beforecallback option to pagination to allow you to modify the data prior to it being paginated. Very powerful! #699- Documentation: https://www.11ty.dev/docs/pagination/#the-before-callback
- ➕ Adds
pagination.aliasandpagination.pagesoptions to pagination variable. These will help when creating navigation for your pagination. #280 #345 #334 #211- Documentation: https://www.11ty.dev/docs/pagination/nav/
🐎 Performance
- 🐎
dependency-treenpm package used to find JavaScript dependencies was slow. https://www.11ty.dev/docs/config/#watch-javascript-dependencies Wrote https://github.com/11ty/eleventy-dependency-tree to solve this. One major difference here is that dependencies now will berequire’dto resolve—so be aware of this if your node files aren’t idempotent! This pays off in a huge performance boost when using--watchor--serve. #700
Shortcodes
- 👍 Better support for asynchronous shortcodes (shortcode functions can return promises). Supported in
11ty.js, Liquid, and Nunjucks templates. #672 #429- Documentation updated:
- https://www.11ty.dev/docs/shortcodes/
- https://www.11ty.dev/docs/languages/javascript/
- https://www.11ty.dev/docs/languages/liquid/
- https://www.11ty.dev/docs/languages/nunjucks/
- https://www.11ty.dev/docs/languages/handlebars/#asynchronous-helpers (not supported in Handlebars but the docs were updated to reflect this)
Miscellanous
📚 Documentation Web Site
- 📚 We launched Contributor Accounts on 11ty.dev, including access to on-site documentation search.
- 📚 Documentation moved from 11ty.io to 11ty.dev
- 📚 Official Eleventy plugin documentation moved to 11ty.dev
- 📚 @Munter added his
hyperlinkchecker to the 11ty documentation for link rot checking! Source tweet
🐛 Bug fixes
- 👌 Improved error reporting in shortcode code. #681
- Issue with
Cannot read property 'trim' of undefinederror on unhandledRejection events. #689 - 🛠 Fix for
requirenode cache busting on Windows (some JavaScript files may not have picked up changes when watching) #341 #596 #683 Thanks @cschuller! - Fix bug with negated entries (
!) in .gitignore or .eleventyignore files. The bug caused Eleventy to not process any files. Support was not added for negated entries—they are ignored for now. Thanks @micahmills! #677 #709 - 🛠 Fix to Sortable implementation, improved tests—thanks @edbrannin! #747
- 🛠 Fix small variable scoping issue in TemplateWriter—thanks @fredrikekelund! #724 #722
- 🛠 Fix data bleed issue in the Data Cascade with front matter and
setDataDeepMerge. Thanks @ahl! #676 #735 - 👌 Improved test coverage for
EleventyErrorUtil—thank you @edbrannin! #753
Administration
- 🛠 Issues fixed in v0.10.0 Milestone
- All code changes from v0.9.0 to v0.10.0
- 📄 Code coverage stats for v0.10.0
- ✅ npm audit passed
🚀 Dependency Major Release Bumps
- 🚀 chalk from v2.4 to v3.0.0
- 👍 semver v6.3 to v7.1: Drops support for old versions of Node
- 🚀 handlebars from v4.1.2 to v4.5.3 (while this isn’t technically a major release bump, it’s a fair number of minor releases and probably worth noting)
- Install to your Local project (preferred):