Git仓库URL后缀

ensure_git_suffix键告诉Antora是否应将.git扩展名（如果不存在）附加到远程内容源的URL。如果您使用GitHub或GitLab，则无需在playbook中定义此键，因为默认值就足够了。但是，如果您使用Team Foundation Server（TFS）或Azure DevOps，请继续阅读。

默认的git仓库URL后缀

默认情况下，ensure_git_suffix键被赋予值true。当ensure_git_suffix为true时，Antora指示git客户端自动将.git附加到任何缺少后缀的远程内容源仓库URL。

一些git服务如果URL包含.git扩展名，则无法识别该URL。因此，有必要对此行为进行配置。

ensure_git_suffix键

可选的ensure_git_suffix键设置在playbook中的git键下。它接受布尔值。

false

Antora不会将.git附加到任何缺少.git后缀的远程内容源的URL。

true

默认值。Antora将.git附加到任何缺少.git后缀的远程内容源仓库URL。

如果您使用Team Foundation Server（TFS）或Azure DevOps，如果您的内容源仓库无法克隆，您可能需要将ensure_git_suffix设置为false。

示例1. antora-playbook.yml 
git:
  ensure_git_suffix: false