本文是博客配置示例。配置前请先确认项目已使用正确的 Notion 数据库。
配置方式与优先级
NotionNext 的配置通常来自以下位置:
- 项目中的
blog.config.js
- 所用主题的
config.js
- Vercel 环境变量
- Notion 内的「配置中心」
配置中心的优先级最高:其中已启用的配置会覆盖 Vercel 环境变量和
blog.config.js 中的同名配置。使用配置中心
配置中心仅在 NotionNext V4.1.0 及以后版本支持。
- 打开博客数据库中的「配置中心」页面。
- 在
CONFIG-TABLE新建或编辑一行配置。
- 勾选「启用」;未启用的行不会生效。
- 填写配置名与配置值。
- 部署后检查博客页面是否按预期更新。
配置表字段
字段 | 用途 |
启用 | 控制该配置是否生效 |
配置名 | 配置变量名,例如 AUTHOR |
配置值 | 实际取值,例如作者名、 true 或 false |
配置备注 | 用于记录该配置的目的或修改原因 |
配置附件 | 当配置值为图片时,在此上传图片文件 |
注意事项
- 可用的配置名和值,请以
blog.config.js与当前主题的config.js为准。
- 并非所有配置都支持写入配置中心;例如
NOTION_PAGE_ID不支持在此设置。
- 不要修改配置表的表头,除非你同时清楚项目中对应字段的实现。
- 重要配置修改后,建议保留备注,方便之后排查。
发布前检查
配置项已勾选「启用」
配置名与项目配置文件完全一致
配置值符合预期格式
已确认没有用配置中心意外覆盖环境变量
已重新部署并在网页端验证
参考:配置中心
项目仓库:NotionNext
- 作者:NotionNext
- 链接:https://hexo.oldmatch.work/article/notionnext-config-guide
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
