使用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
的任何页面。