自定义背景
控制整个站点的背景图片来源及模糊程度。
支持三种来源:直接使用图片链接、本地上传(仅保存在用户浏览器本地)、以及 Pixaroa 随机图服务。
配置位置
在站点根目录的 hugo.toml 中设置:
toml
[params.theme]
# 说明:设置首次访问时默认使用的背景来源。
# 可选值:
# - 'url' (默认):使用用户填写的图片链接(如有)。
# - 'upload':使用用户上传的本地图片(仅限该用户浏览器可见)。
# - 'pixaroa':使用 Pixaroa 随机图服务。
defaultBackgroundProvider = 'url'
# 说明:如果你想使用 Pixaroa 服务,需要在这里设置服务地址(base URL)。
# 注意:留空将无法使用 Pixaroa。
# 你可以填写:
# - https://pixaroa.example.com/ (推荐:以 / 结尾)
# - /pixaroa/ (同域反向代理路径;同样建议以 / 结尾)
pixaroaHost = 'https://your-pixaroa-api.com/'功能说明
- 背景模糊:设置面板提供了一个专门的滑动条,用于调节背景图本身的模糊度。这与“玻璃质感”的模糊是相互叠加的。
- 上传功能:这里的“上传”并不会把图片发到你的服务器,而是利用浏览器的本地数据库(IndexedDB)保存在用户自己的电脑上,保护隐私且不占服务器流量。
优先级规则
- 用户本地配置:用户在面板里填写的 URL、上传的图或选择的 Pixaroa 设置优先级最高。
- 站点配置:默认来源由
defaultBackgroundProvider决定。