🚧🚧 Eleventy 🕚⚡️ v0.10.0 Beta 1 🚧🚧

Eleventy is a Simpler Static Site Generator.

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/

Installation

Install this 🚧🚧 prerelease 🚧🚧 to help test the upcoming Eleventy 0.10.0 release:

npm install @11ty/eleventy@beta --save-dev

Thank you to the code contributors that helped with this release!

@gloryofrobots @edbrannin @MadeByMike @Ryuno-Ki @cschuller @micahmills @fredrikekelund @ahl @Munter (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/

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 setQuietMode method to Configuration API so that we don’t have to type --quiet all the time. #808
• Adds addWatchTarget method to Configuration API for programmatic watching of arbitrary files. Thanks @MadeByMike! #803 #641
• Show pathPrefix being used in standard console output (if non-default). #807

Pagination

• Adds a before callback 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.alias and pagination.pages options 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-tree npm 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 be require’d to resolve—so be aware of this if your node files aren’t idempotent! This pays off in a huge performance boost when using --watch or --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

• JSDoc annotations added to Eleventy.js. Thanks @Ryuno-Ki! #582

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 hyperlink checker 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 undefined error on unhandledRejection events. #689
• Fix for require node 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-beta.1
• Code coverage stats for v0.10.0-beta.1
• ✅ npm audit passed

Dependency Major Release Bumps

• chalk from v2.4 to v3.0.0
• 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)