Release v0.075


It's been a while, but we have a bunch of changes, and the start of some new documentation.

Some deprecations this time, in the continuing run-up to v1.0:

  • Document data attributes now must be hashes. This makes all the data attributes (document, page, site, application) consistent and easier to manage.
  • The default layout is now layout/default.html.ep, not site/layout.html.ep. Now that layouts are bundling multiple themes, having a specific directory is better.

The new features include:

  • Content sections. Templates and documents can now define content that can be used later in the layout. This allows applications with tags or feeds, for example, to add content to the layout header, sidebar, or footer.
  • The bundle theme command now allows you to specify which files you want to bundle. This makes it easy to copy only certain things from the default theme. This is helpful for the templates that don't change much, like the feed templates, robots.txt, and sitemap.xml templates.
  • The site object now has a templates attribute which allows you to override the site's default layout, sitemap.xml, and robots.txt.
  • The document page sections method now allows for indexes as arguments. This makes it easier to use document sections in template.

And some bugfixes:

  • The LinkCheck plugin now correctly handles relative links to parent directories (..).
  • The LinkCheck plugin now warns about links with empty href attributes. This is technically legal, but is more likely a problem of not filling in the URL.
  • The index page now properly handles relative links. Previously, relative links on an index page would be broken when the index gets moved to /index.html.

Finally, some new documentation is in development, starting with a new theme guide. Please try it out and let us know if anything isn't clear by submitting a Github ticket or telling us on IRC

Full changelog below.