配置文件缓存
配置文件缓存。
这是默认配置:
caches:
assets:
dir: :resourceDir/_gen
maxAge: -1
getcsv:
dir: :cacheDir/:project
maxAge: -1
getjson:
dir: :cacheDir/:project
maxAge: -1
getresource:
dir: :cacheDir/:project
maxAge: -1
images:
dir: :resourceDir/_gen
maxAge: -1
misc:
dir: :cacheDir/:project
maxAge: -1
modulequeries:
dir: :cacheDir/modules
maxAge: 24h
modules:
dir: :cacheDir/modules
maxAge: -1
[caches]
[caches.assets]
dir = ':resourceDir/_gen'
maxAge = -1
[caches.getcsv]
dir = ':cacheDir/:project'
maxAge = -1
[caches.getjson]
dir = ':cacheDir/:project'
maxAge = -1
[caches.getresource]
dir = ':cacheDir/:project'
maxAge = -1
[caches.images]
dir = ':resourceDir/_gen'
maxAge = -1
[caches.misc]
dir = ':cacheDir/:project'
maxAge = -1
[caches.modulequeries]
dir = ':cacheDir/modules'
maxAge = '24h'
[caches.modules]
dir = ':cacheDir/modules'
maxAge = -1
{
"caches": {
"assets": {
"dir": ":resourceDir/_gen",
"maxAge": -1
},
"getcsv": {
"dir": ":cacheDir/:project",
"maxAge": -1
},
"getjson": {
"dir": ":cacheDir/:project",
"maxAge": -1
},
"getresource": {
"dir": ":cacheDir/:project",
"maxAge": -1
},
"images": {
"dir": ":resourceDir/_gen",
"maxAge": -1
},
"misc": {
"dir": ":cacheDir/:project",
"maxAge": -1
},
"modulequeries": {
"dir": ":cacheDir/modules",
"maxAge": "24h"
},
"modules": {
"dir": ":cacheDir/modules",
"maxAge": -1
}
}
}
用途
Hugo 使用文件缓存在磁盘上存储数据,避免在同一构建中重复操作,并在构建之间持久化数据。
- assets
- 缓存处理后的 CSS 和 Sass 资源。
- getcsv
- 缓存
data.GetCSV函数的结果。请注意,data.GetCSV函数已在 v0.123.0 中弃用,改用resources.GetRemote函数。 - getjson
- 缓存
data.GetJSON函数的结果。请注意,data.GetJSON函数已在 v0.123.0 中弃用,改用resources.GetRemote函数。 - getresource
- 缓存通过
resources.GetRemote函数从远程 URL 获取的文件。 - images
- 缓存处理后的图片。
- misc
- 缓存杂项数据。
- modulequeries
- 缓存模块解析查询的结果。
- modules
- 缓存下载的模块。
键
- dir
- (
string) Hugo 存储缓存文件的绝对文件系统路径。您可以使用:cacheDir或:resourceDir标记 开始路径,将缓存锚定到特定的系统或项目位置。 - maxAge
- (
string) 缓存条目在被清除之前保持有效的持续时间,表示为 持续时间。值0禁用该键的缓存,值-1表示缓存条目永不过期。默认值是-1。
标记
:cacheDir- (
string) 指定的缓存目录。详见 详情。 :project- (
string) 当前 Hugo 项目的基本目录名。这确保每个项目的文件缓存隔离,防止hugo --gc命令影响同一机器上的其他项目。 :resourceDir- (
string) 指定的 资源管道 输出缓存目录。详见 详情。
垃圾回收
当您修改站点或更改配置时,以前构建的缓存文件可能会保留在磁盘上,占用不必要的空间。使用 hugo --gc 命令从文件缓存中删除这些过期或未使用的条目。