02 设置自己的站点

根配置

本页在完整参考站点上修改配置。安装和预览命令见开始使用。示例只展示相关字段:在已有表中修改对应项,不要把整段追加到文件末尾。

在 hugo.toml 开头修改正式网址:

baseURL = "https://example.com/"

把示例域名换成自己的完整网址;如果部署在子目录中,连同子目录一起填写,例如 https://example.com/blog/。它影响站点地图、订阅和规范地址。本地预览仍使用终端显示的本机网址。

初次配置时保留其余构建设置,尤其是:

设置保留它的原因
minify.disableJS = true避免压缩改变脚本后,浏览器因 CSP 拒绝执行
module.mounts 中的界面字典挂载让界面使用站点的 assets/i18n/ 字典
cascade 中的 build.publishResources = false避免自动发布未使用的页面包文件,包括 _map.toml
printPathWarnings、panicOnWarning在页面发布网址冲突时停止构建

文章网址与栏目目录见目录与引用,索引开关见站点发现,部署步骤见首次部署。

站点说明与语言

先编辑首页。参考站的 content/_index.md 是英文首页,content/_index.zh.md 是中文首页,content/_index.ar.md 是阿拉伯文首页。例如,在中文首页修改已有字段:

title: 我的站点
description: 介绍本站提供的内容。

title 用作站名;linkTitle 可单独设置导航文字。参考首页还设有 params.browser_title,它会覆盖浏览器标签标题,应一并修改或删除。各篇文章的 description 可覆盖首页提供的默认说明。

首页可见的风场文字来自它引用的艺术包,不是首页的 title。修改步骤见首页定制;想先用简单文字首页,可切换到最小首页艺术包。

语言在 hugo.toml 的 [languages] 中设置:

[languages]
en.label = "English"
en.locale = "en-US"
en.weight = 1
zh.label = "中文"
zh.locale = "zh-Hans"
zh.weight = 2

label 是语言名称,weight 控制排列顺序;根配置的 defaultContentLanguage 决定默认语言。它不会随排列顺序改变。defaultContentLanguageInSubdir 决定默认语言是否也放在语言子目录中,调整后检查原有网址。

暂时不提供某种语言时,可在文件顶部、任何 TOML 表之前设置:

disableLanguages = ["ar"]

此例停用阿拉伯语,保留内容文件以便以后恢复;不要停用当前默认语言。改变默认语言前,要核对无语言后缀文件的归属,并检查各语言首页和文章是否仍发布到预期地址。

新增语言时,完成三处配置:在 [languages] 中声明语言,补齐 assets/i18n/<语言代码>.toml 界面字典,再添加同名页面的译文,如 index.fr.md、_index.fr.md。界面字典只翻译按钮等界面文字,不替代正文翻译。启用 SW 的站点还需要该语言的离线页。

参考站的界面字典挂载已配置,无需重复添加。语言选项图标与设置页见选择列表。

站点状态页

编辑已有的各语言 content/powered-by/index*.md,在正文中维护说明、源码和变更记录链接。该页通过短代码显示版本和诊断信息:

短代码显示内容
theme-version、hugo-version主题与 Hugo 版本
site-status "version"当前页面的站点构建版本
site-status "interval" "每 %d 分钟检查"内容检查间隔
site-status "policy"、site-status "offline"缓存策略与当前语言离线页链接
site-status "status"SW 程序状态与检查按钮
site-status "content"本页与服务器的站点构建版本比对

params.site_status.labels 提供各语言文案。检查按钮只检查,不激活等待中的 SW,也不自动刷新页面。预取诊断见预取配置。

替换示例内容

发布前替换示例文章和品牌内容,并检查以下位置:

内容编辑位置
首页文字和链接当前首页引用的艺术包,见首页定制
图标与应用名称assets/site/,见应用名称与图标
关于、GitHub 等页面content/about/、content/github/ 等页面的正文
文章来源链接hugo.toml 中的 params.content_source;改为自己的仓库或删除该配置

Banyan 文档与版本说明可以保留,也可以删除。删除前,把首页艺术包中的文档链接、Powered by 中的版本说明链接改为 Banyan 官网对应地址。删除示例正文时,同时处理引用它的 _map.toml。

检查设置

重新预览站点,检查站名、浏览器标签和语言切换。打开每种启用语言的首页和一篇文章,确认文字与网址正确。

下一步

继续阅读03 首次部署,把检查后的站点发布到目标平台。配色和首页样式可以在站点运行后按外观定制调整。

横向滚动 · 单击或按 Esc 退出