站点配置

根配置

在站点根 hugo.toml 中设置 baseURL、title 和语言。 Hugo 的 [outputs]、[taxonomies] 和 [permalinks] 也须由站点声明。 Banyan 提供 [outputFormats] 定义,站点仍须通过 [outputs] 启用对应输出。

保留以下设置。它防止 HTML 压缩改变用于 CSP 哈希的内联 JS:

[minify]
disableJS = true

新站点使用 Skill 的起始配置。 现有站点按需合并配置,保留自己的内容和 URL 规则。

站点说明与语言

[params]
description = "Your site description."

[languages.en.params]
locale = "en_US"
icon = { text = "EN" }

[languages.zh.params]
description = "站点中文说明。"
locale = "zh_CN"

params.description 提供全站说明。各语言可用 languages.<lang>.params.description 覆盖。页面 front matter 的 description 优先于站点说明,用于 SEO 和社交卡片;llms.txt 的介绍和首页条目也使用站点说明。

locale 用于 Open Graph。可选 icon 为语言选择列表提供短标记; 未设置时使用语言图标。为每种启用的语言声明根配置,并创建对应的首页和分类 bundle。

覆盖主题文件

站点中的同路径内容、资源和数据覆盖 Module 默认文件。 品牌、账号和法律文本放在站点中;可复用主题行为放在 Module 中。 发布的主题只包含 module/,不包含本仓库的文档内容和工具。

本仓库根 hugo.toml 配置文档站点,根 go.mod 将主题依赖替换为 ./module。 使用已发布 Module 的站点不应复制这个本地替换。

params.theme_changelog 设置 Powered by 中的主题发布说明链接。 默认指向上游仓库的变更记录;本仓库设置为 /changelog/,中文为 /zh/changelog/。

按需继续配置页面区域、 分类法、交付与缓存 和站点发现。