HUGO
Menu
GitHub 87548 stars Mastodon

配置文件缓存

配置文件缓存。

这是默认配置:

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 命令从文件缓存中删除这些过期或未使用的条目。


Last updated: January 1, 0001
Improve this page