页面的默认布局

默认页面布局

除非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属性