URLs 键

urls下配置的playbook键管理站点的发布URL和重定向。

urls 键

在playbook文件中,您站点的发布URL和重定向功能的全局属性在urls键下定义。

urls: (1)
  html_extension_style: drop (2)
  redirect_facility: nginx (3)
  latest_version_segment_strategy: redirect:to (4)
  latest_version_segment: stable (5)
  latest_prerelease_version_segment: unstable (6)
1 可选的urls
2 可选的html_extension_style
3 可选的redirect_facility
4 可选的latest_version_segment_strategy
5 可选的latest_version_segment
6 可选的latest_prerelease_version_segment

如果未指定,Antora将使用html_extension_styleredirect_facility键的默认值。 html_extension_styleredirect_facility键也可以从Antora CLI进行配置。

可用的urls键

URLs 键 描述 必需

html_extension_style

指定用于HTML页面的用户可见URL扩展名。接受值defaultdropindexify

latest_prerelease_version_segment

Antora用于替换页面和资源URL的版本段中的实际版本的符号预发布版本。仅适用于最新的预发布组件版本。

latest_version_segment

Antora用于替换页面和资源URL的版本段中的实际版本的符号版本。仅适用于最新的组件版本。

latest_version_segment_strategy

控制包含实际版本和包含符号版本的URL之间的替换和重定向方向。仅适用于最新的组件版本或最新的预发布组件版本。接受值replaceredirect:toredirect:from

redirect_facility

指定Antora生成重定向为静态HTML刷新页面或重定向配置文件。接受值disabledhttpdnetlifynginxstatic