Fqzlrのblog

两层配置：默认值与覆盖层#

主题源码的 src/config/*.ts 是全部配置的默认值，每个文件都有中文注释说明每个字段的含义。而采用双仓模式（内容分离）时，内容仓的 config/*.yaml 是覆盖层——同名文件里的字段会覆盖主题默认值，没写的字段自动继承默认。

1
shirone-content-fq/config/site.yaml    ← 你只写要改的字段
2
shirone-fq/src/config/siteConfig.ts    ← 其余字段继承这里的默认

最先改的三个文件#

1
title: Fqzlr的博客        # 浏览器标签页与页脚显示的名字
2
siteUrl: https://blog.fqzlr.top/
3
locale: zh_CN             # 界面语言，支持 10 种
4
primaryHue: 165           # 主题色相（HCT 色彩空间的色相值）

1
name: Fqzlr
2
avatar: https://q1.qlogo.cn/g?b=qq&nk=QQ号&s=640
3
slogan: 躬身入局，挺膺负责
4
socialLinks:              # 社交链接，图标需要主题已安装的图标集
5
  - name: GitHub
6
    url: https://github.com/你的ID

按需开关功能#

Shirone 遵循”零额外负担”原则：关闭的功能零请求、零 DOM、零代码体积。所以放心把用不到的功能关掉：

其他常用项速览#

• font.yaml：正文字体、代码字体、字体来源（本地 / CDN）
• post-list.yaml：文章列表分页数量、列表/网格布局切换
• article.yaml：文章页的更新提示、延伸阅读、分享开关
• license.yaml：文章底部的版权协议（CC BY-NC-SA 之类）
• footer.yaml：页脚开关；自定义 HTML（比如备案号）放内容仓 config/footer.html
• permalink.yaml：文章 URL 结构，上线前定好，之后别再改（会断旧链接）

改完之后#

配置文件是构建时读取的，dev 模式下多数改动会热更新；如果发现没生效，重启 pnpm dev，仍不行就清一下缓存：

1
pnpm content:sync    # 先确保覆盖层编译进主题

然后清 node_modules/.vite 与 .astro 目录再重启，这一招能解决九成”改了没反应”的问题。