middleman/middleman-asciidoc

Generate standalone document when page-layout is unset

mojavelinux opened this issue · 1 comments

When the page-layout attribute is unset, Asciidoctor should generate a standalone HTML document for Middleman to serve.

= Page Title
:page-layout!:

As part of this change, middleman-asciidoc should recognize when the page-layout attribute is explicitly unset. That is done by passing page-layout=@ to Asciidoctor so the attribute entry effectively unassigns the default value.

A blank value for page-layout should activate the auto layout feature in Middleman.

Here are the valid values for the AsciiDoc attribute in the page.

  • :page-layout: default - use the page layout named "default"
  • :page-layout!: - generate a standalone document (don't use a layout, use the Asciidoctor default exterior)
  • :page-layout: - use the auto-detected layout
  • (not specified) - use the auto-detected layout

The global layout can be explicitly defined in the Middleman configuration (config.rb):

set :layout, :default

The page-layout cascades as follows:

site config -> front matter -> AsciiDoc header attribute