Using :page-layout: does not appear to work when using other levels

[bgallantgit3]

The Creating Pages section shows a sample which works correctly; however, if you modify it slightly by changing the level, the info layout does not appear in the generated HTML. For example, change from level 0 to level 1:

== Sample Page
:page-layout: info

However, if I move page-layout to the top, then the info layout works. For example:

:page-layout: info
== Sample Page

I don't usually start my pages off with an attribute, so I am not sure if this is a bug or my lack of understand. I did not see a related issue. Thanks.

[mojavelinux]

You are describing the behavior perfectly. The page-layout must be defined in the document header. That either means putting it below the document title (the single equals sign) or at the top of the document (an implicit document header).

For details, see http://asciidoctor.org/docs/user-manual/#doc-header

Think of the document header as a replacement for the front matter. Perhaps this could be better explained in the README. I'm open to suggestions for improved wording.

[bgallantgit3]

Thank you, that it explains it nicely. I never saw that reference in the User Manual. I would recommend a simple update added to the end of https://github.com/asciidoctor/jekyll-asciidoc#creating-pages as you mentioned. For example:

Page variables must be defined in the document header. That means putting them below the document title (the single equals sign as shown in the sample) or at the top of the document for an implicit document header (such as two equal signs). For more details on the document header, see http://asciidoctor.org/docs/user-manual/#doc-header in the User Manual for details.

[mojavelinux]

Documentation added.