配置构建
build 配置部分包含全局构建相关的配置选项。
build:
buildStats:
disableClasses: false
disableIDs: false
disableTags: false
enable: false
cacheBusters:
- source: (postcss|tailwind)\.config\.js
target: (css|styles|scss|sass)
noJSConfigInAssets: false
useResourceCacheWhen: fallback
[build]
noJSConfigInAssets = false
useResourceCacheWhen = 'fallback'
[build.buildStats]
disableClasses = false
disableIDs = false
disableTags = false
enable = false
[[build.cacheBusters]]
source = '(postcss|tailwind)\.config\.js'
target = '(css|styles|scss|sass)'
{
"build": {
"buildStats": {
"disableClasses": false,
"disableIDs": false,
"disableTags": false,
"enable": false
},
"cacheBusters": [
{
"source": "(postcss|tailwind)\\.config\\.js",
"target": "(css|styles|scss|sass)"
}
],
"noJSConfigInAssets": false,
"useResourceCacheWhen": "fallback"
}
}
buildStats
请参阅配置 buildStats。
cachebusters
请参阅配置缓存清除。
noJSConfigInAssets
（bool）如果为 true，则禁用将 jsconfig.json 写入到您的 assets 目录，该文件会映射运行 js.Build 的导入。此文件旨在帮助在 VS Code 等代码编辑器中进行智能感知/导航。请注意，如果您不使用 js.Build，则不会写入任何文件。
useResourceCacheWhen
（string）何时在 /resources/_gen 中为 PostCSS 和 ToCSS 使用缓存的资源。有效值是 never、always 和 fallback。最后一个值表示如果 PostCSS/扩展版本不可用，则会尝试缓存。
配置缓存清除
v0.112.0 中的新增功能添加了 build.cachebusters 配置选项，以支持使用 Tailwind 3.x 的 JIT 编译器进行开发，其中 build 配置可能如下所示
build:
buildStats:
enable: true
cachebusters:
- source: assets/watching/hugo_stats\.json
target: styles\.css
- source: (postcss|tailwind)\.config\.js
target: css
- source: assets/.*\.(js|ts|jsx|tsx)
target: js
- source: assets/.*\.(.*)$
target: $1
[build]
[build.buildStats]
enable = true
[[build.cachebusters]]
source = 'assets/watching/hugo_stats\.json'
target = 'styles\.css'
[[build.cachebusters]]
source = '(postcss|tailwind)\.config\.js'
target = 'css'
[[build.cachebusters]]
source = 'assets/.*\.(js|ts|jsx|tsx)'
target = 'js'
[[build.cachebusters]]
source = 'assets/.*\.(.*)$'
target = '$1'
{
"build": {
"buildStats": {
"enable": true
},
"cachebusters": [
{
"source": "assets/watching/hugo_stats\\.json",
"target": "styles\\.css"
},
{
"source": "(postcss|tailwind)\\.config\\.js",
"target": "css"
},
{
"source": "assets/.*\\.(js|ts|jsx|tsx)",
"target": "js"
},
{
"source": "assets/.*\\.(.*)$",
"target": "$1"
}
]
}
}
当启用 buildStats v0.115.1 中的新增功能时，Hugo 会在每次构建时写入一个 hugo_stats.json 文件，其中包含在渲染输出中使用的 HTML 类等。对此文件的更改将触发 styles.css 文件的重建。您还需要将 hugo_stats.json 添加到 Hugo 的服务器监视器中。有关运行示例，请参阅Hugo Starter Tailwind Basic。
- source
- 一个正则表达式，匹配相对于 Hugo 中的一个虚拟组件目录的文件，通常是
assets/...。 - target
- 一个正则表达式，匹配在
source更改时应过期的资源缓存中的键。您可以在表达式中使用来自source的匹配正则表达式组，例如$1。
配置构建统计信息
build:
buildStats:
disableClasses: false
disableIDs: false
disableTags: false
enable: false
[build]
[build.buildStats]
disableClasses = false
disableIDs = false
disableTags = false
enable = false
{
"build": {
"buildStats": {
"disableClasses": false,
"disableIDs": false,
"disableTags": false,
"enable": false
}
}
}
如果 enable 设置为 true，则在项目的根目录中创建一个 hugo_stats.json 文件。此文件包含您发布的站点中每个 HTML 元素的 class 属性、id 属性和标签的数组。当从您的站点删除未使用的 CSS时，请使用此文件作为数据源。此过程也称为修剪、清除或树摇。
使用 disableClasses、disableIDs 和 disableTags 键从 hugo_stats.json 中排除 class 属性、id 属性或标签。
由于部分服务器构建的性质，新的 HTML 实体在服务器运行时添加，但旧值在您重新启动服务器或运行常规 hugo 构建之前不会被删除。