创建一个起始页面

您可以为组件版本创建一个名为index.adoc的起始页面,Antora将自动将其用作组件版本的默认起始页面。或者您可以创建一个文件名任意的页面,只要在组件版本描述符中将其指定为组件版本的起始页面即可。

访问者在单击组件版本选择器中的条目或在页面菜单顶部单击其名称时,将会进入组件版本的起始页面。

使用组件版本的默认起始页面

index.adoc的AsciiDoc源文件,并将其保存在 pages目录中的 ROOT模块目录中。像编写任何其他页面一样构建和添加 index.adoc的内容。Antora将在生成站点时自动将此页面设置为组件版本的起始页面。

为组件版本指定起始页面

源文件必须属于它将成为起始页面的组件版本,并且必须在 pages家族中。创建页面后,使用 antora.yml中的 start_page键将其指定为组件版本的起始页面。

组件版本的起始页面与站点的起始页面是分开的。站点的起始页面是访问者在访问站点的主URL时被引导的页面。要配置站点的起始页面,请参阅站点起始页面