使用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_layoutdefault页面布局将default.hbs布局文件应用于未明确设置page-layout的任何页面。