使用page-layout分配UI模板
Antora提供了一个名为page-layout的页面属性。该属性将一个替代的UI布局应用于页面的内容。
page-layout属性
page-layout属性是可选的。它在页面的头部使用AsciiDoc属性条目进行定义。
= 页面标题
:page-layout: tiles
page-layout属性接受UI布局文件的文件名,不包括文件扩展名。例如,如果您希望页面使用布局文件tiles.hbs,则将值tiles分配给page-layout。相关的布局文件(例如tiles.hbs)应该位于UI包的layouts目录中。当在页面的头部明确设置page-layout属性时,它会覆盖默认布局。
默认page-layout
如果页面的头部未定义page-layout,则在生成站点时将应用由default_layout playbook key定义的页面布局。当既未设置page-layout也未设置default_layout时,Antora会自动将内置的default值分配给default_layout。default页面布局将default.hbs布局文件应用于未明确设置page-layout的任何页面。