feat: Allow no layout when a default layout is defined

[wout]

Summary

When using a default layout, there should be a way to define "no layout".

Reference-level explanation

We're using a default global layout with the following configuration:

-
    scope:
      path: ""
    values:
      layout: "default"

That's great because it eliminates the need to define the same layout everywhere. But there are some edge cases where no layout is required at all. For example, an RSS feed or a sitemap. We now have two workarounds. One is a layout called feed.liquid with just the following contents:

{{ content }}

Another is to have layout: false in the front matter. Although, the latter adds the following warning to the logs:

[Bridgetown]      Build Warning: Layout 'false' requested in sitemap.xml does not exist.

So it's a hack, really.

Solution

Both options work, but allowing to configure layout: false in the front matter solves the issue.

[KonnorRogers]

@wout Out of curiosity, what warnings do you get with layout: null

Jekyll issues seems to say layout: null is the preferred syntax.

jekyll/jekyll#2730

[wout]

The result for sitemap.xml:

That's because it considers false as a layout (e.g. false.liquid) and null as "no layout defined", so it uses the default.

[jaredcwhite]

I'm thinking layout: none is supported but I should test this out a bit more.

[wout]

Just checked and it is. Thanks!

But maybe it's a good idea to include false as well as an option. Because none isn't an intuitive value, from my point of view at least.