页面的默认布局
默认页面布局
除非playbook中指定了default_layout
键,否则Antora会将default
布局应用于未设置page-layout
属性的任何页面。 default
布局对应于Antora期望在UI包的layouts目录中找到的default.hbs文件。
您可以使用default_layout
键指示Antora将自定义布局应用于站点中的所有页面。
default_layout键
default_layout
键映射到ui
键。它接受一个值,该值是布局文件的主干(即,文件名不包括文件扩展名)。指定的布局文件应位于UI包的layouts目录中。
例如,如果您希望将布局文件article.hbs用作默认页面布局,则应将default_layout
设置为article
。
示例1. 默认布局值
ui:
bundle:
url: ./../docs-ui/build/ui-bundle.zip
default_layout: article
布局article
将应用于站点中的每个页面,除非页面的头部中定义了page-layout属性。