用page-layout分配UI模板

Antora 提供了一个名为 page-layout 的页面属性。此属性将另一种 UI 布局应用于页面内容。

page-layout属性

page-layout 属性是可选的。它是在使用 AsciiDoc 属性条目的页头中定义的。

= Page Title
:page-layout: tiles

page-layout 属性接受 UI 布局文件的文件名，但不包括文件扩展名。例如，如果您希望页面使用布局文件 tiles.hbs ，请将值 tiles 分配给 page-layout 值。关联的布局文件（例如，tiles.hbs ）应该位于 UI 捆绑包的 layouts 目录中。当在页面的页眉中明确设置 page-layout 属性时，它会覆盖默认布局。

默认page-layout

如果页面的页眉中未定义 page-layout ，则在生成站点时会应用由 playbook 中 default_layout 键定义的页面布局。当既没有设置 page-layout 又没有设置 default_layout 时，Antora 会自动将内置 default 分配给 default_layout 。default 页面布局将默认 .hbs 布局文件应用于任何未明确设置 page-layout 的页面。