配置 Antora 的缓存
关于 Antora 的缓存
当 Antora 第一次运行时,它会将从网络获取的资源保存在本地缓存中。Antora 缓存两种类型的资源:
-
克隆的 git 仓库
-
下载的 UI bundles
Antora 将这些资源存储在缓存目录中,分别进一步组织在 content 和 ui 文件夹下。操作系统的 默认缓存目录 会有所不同。
覆盖默认缓存位置
您可以按照以下优先顺序覆盖默认缓存位置:
-
使用 CLI 中的 --cache-dir 选项,
-
在 playbook 中设置 cache_dir 键。
更新缓存
如果您希望 Antora 在后续运行中更新缓存,请在 Antora CLI 中传递 --fetch 选项,或在 playbook 中将 fetch 键 设置为 true
。此开关将强制 Antora 对先前克隆的每个仓库运行获取操作。如果 URL 是远程的且 snapshot 键 为 true
,它还将强制 Antora 下载 UI bundle 的新副本。