创建一个开始页面

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

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

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

要使用 Antora 的默认起始页选项,请创建一个名为 index.adoc 的 AsciiDoc 源文件。并将其保存在 ROOT 模块目录的 pages 目录中。构建和添加内容到 index.adoc 。像你写的任何其他页面一样。当站点生成时,Antora 会自动将此页面设置为组件版本的起始页面。

为组件版本指定起始页

您可以指定一个特定的页面,而不管它的文件名是什么,作为组件版本的起始页。源文件必须属于作为起始页的组件版本,并且必须在 pages 族中。创建页面后,使用 antora.yml 中的起始页键将其指定为组件版本的起始页。

NOTE

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