站点配置指南

Sonder 把站点级信息集中在根目录的 site.config.toml，而不是散落在组件里。配置结构由 src/config/schema.ts 中的 Zod schema 校验；字段缺失或类型不对时，bun run build 会直接报错。

站点与作者

1
[config.site]
2
title = "Sonder"
3
description = "Sonder 的个人博客。"
4
pageTitle = "Sonder"
5
url = "https://sonder.liang.one"
6
repository = "https://github.com/lmb666666/Sonder"
7
timeEstablished = "2026-10-04"
8

9
[config.profile]
10
name = "Sonder"
11
role = "写博客的人"
12
avatar = "/images/logo.svg"

页脚与桌面首页署名读取 profile.name；站点程序名读取 siteInfo.program。

站点信息卡

1
[config.siteInfo]
2
title = "站点信息"
3
program = "Sonder"
4
uptime = true
5
totalWords = true
6
lastContentUpdate = true
7
lastUpdated = true
8
buildPlatform = true

program 会显示为「站点程序」一行，也用于页脚的 Powered by；留空时两处一起隐藏。uptime、totalWords、lastContentUpdate、lastUpdated 和 buildPlatform 控制其余信息行。lastUpdated 是构建时间，lastContentUpdate 取文章发布时间与修改时间的最大值。

导航与外观

1
[config.theme]
2
palette = "orange-soft"
3
lang = "zh-CN"
4
navStyle = "pill"

palette：默认色盘，可选 green-soft、green-vivid、rose-soft、pink-soft、purple-soft、blue-soft、orange-soft、brown-soft
lang：zh-CN、zh-TW 或 en
navStyle：pill 胶囊导航或 bar 通栏工具条

顶部导航由 [[config.topNav.links]] 控制，每项填写 label 与 href。

字体与代码块

1
[config.fonts]
2
en = "Maple Mono"
3
code = "Monaco"
4
zh = "ChillRoundF"
5
file = "assets/fonts/ChillRoundFRegular.woff2"
6

7
[config.code]
8
lineNumbers = true
9
wrap = false
10
preserveIndent = true
11
collapseStyle = "collapsible-auto"
12
languageBadge = true
13
collapseLines = 15
14
previewLines = 8

fonts.file：构建期源字体，仅用于生成 public/fonts 下的 UI / 内容子集，本身不会部署。
code.wrap：桌面端是否自动换行；false 时横向滚动，窄屏仍由样式强制换行。
code.languageBadge：是否在代码块右上角显示语言徽章。
code.collapseLines / previewLines：超过指定行数自动折叠，以及折叠时预览的行数。
代码块主题固定为纸面主题，token 颜色跟随色盘与深浅色，无需配置主题名。

页面文案

页面标题、kicker 和说明都在 [config.pages] 下：

1
[config.pages.blog]
2
title = "文章"
3
kicker = "归档"
4
subtitle = "长文与随想的归档。"
5
listLayout = "media"
6

7
[config.pages.links]
8
title = "朋友"
9
kicker = "Friends"
10
subtitle = "那些人，那些事。"

文章页的 listLayout = "media" 会使用带封面的磨砂卡片；改成 rows 则回到行式列表。postsPerPage 控制每页文章数。

文章页组件

1
[config.article]
2
share = true
3
navigation = true
4
morePosts = true

share：文章底部分享卡片
navigation：上一篇 / 下一篇
morePosts：更多文章列表

首页

1
[config.home.latest]
2
count = 2
3
heatmapWeeks = 20
4
showHeatmapLatest = true

count 控制首页「最新」展示的文章数量。首页引语、介绍和联系方式分别在 [config.home.quote]、[config.home.intro] 与 [[config.home.links]] 中维护。

搜索、评论与朋友圈

1
[config.search]
2
enabled = true
3
placeholder = "搜索文章…"
4
maxResults = 6
5

6
[config.comments]
7
enabled = false
8

9
[config.friendCircle]
10
feed_src = ""
11
pageSize = 20

评论支持 giscus、utterances、Waline、Twikoo 或关闭；具体凭据在对应的 [config.comments.*] 区块中填写。朋友页的 feed_src 可以指向 Friend-Circle-Lite 订阅源，也可以留空使用 public/friend-circle.json 或构建期 RSS 聚合。

友邻（Youlin）

可选接入友邻：友链和朋友圈改由 Youlin 接口提供，本地数据与 friendCircle 配置保留为回退。

1
[config.youlin]
2
baseUrl = "https://youlin.example.com"
3
timeoutMs = 8000
4
mode = "build" # build | client
5

6
[config.youlin.links]
7
sources = ["youlin", "local"]
8

9
[config.youlin.circle]
10
sources = ["youlin", "friendcircle", "public", "rss", "demo"]
11

12
[config.youlin.apply]
13
provider = "auto" # auto | youlin | github | none
14
# Youlin 开启 Turnstile 时填写它的公开 site key
15
turnstileSiteKey = ""
16

17
[config.youlin.directives]
18
friendCircle = "auto"
19
friendLinkCard = "auto"

baseUrl 为空时完全沿用原有本地链路，不会发出任何 Youlin 请求。
sources 按顺序尝试：只有网络/HTTP/解析失败才继续下一个源；Youlin 返回 200 且 JSON 合法即采用（空结果也有效）。
mode = "build" 在构建期 SSR，SEO 与 Pagefind 覆盖最好；mode = "client" 先渲染构建期回退，浏览器再请求 Youlin 替换 DOM。可在 links / circle 下单独覆盖。client 刷新只在 youlin 位于对应 sources 第一位时生效；把 local 放前面会退回构建期行为。
apply.provider = "auto" 时，配了 baseUrl 就用 Youlin 的 /apply 接口：表单在当前页面直接 POST，不跳转；开启 Turnstile 时把公开 site key 填到 turnstileSiteKey。也可强制 github / none。
浏览器内提交与 client 刷新都要求 Youlin 的 api.corsOrigin 允许博客域名；启用 Turnstile 时 site key 也要允许该域名。
文章里的 ::friend-circle{src="youlin"} 与 ::friend-link-card{src="youlin"} 同样可用；不写 src 时取 directives.* 的默认值。
环境变量是覆盖层：SONDER_YOULIN_BASE_URL 覆盖地址，SONDER_YOULIN_MODE 覆盖全局以及 links / circle 的 mode；无效值会被忽略并回退 TOML。适合 CI 或预览环境。复用本地 Astro 内容缓存时，如果发现文章内指令没有跟随新配置，用 bunx astro build --force 重建。
build 模式下数据变化需要重新构建：可以在 Youlin 设置 rebuild.* webhook / GitHub dispatch 触发本站构建，或手动重建。

统计与分析（Umami / 51la）

访问统计是可选的，所有 ID 留空就不会加载任何第三方脚本。

1
[config.analytics]
2
sendInDev = false
3

4
[config.analytics.umami]
5
websiteId = ""
6
scriptUrl = ""
7
hostUrl = ""
8

9
[config.analytics.la51]
10
id = ""
11
lingqueMonitorId = ""

Umami：websiteId 和 scriptUrl 都填写才启用。scriptUrl 填 Umami 实例的 script.js 地址；如果脚本走 CDN 或镜像，hostUrl 必须填 Umami 实例地址，否则数据会发到脚本所在域。站点域名填在 Umami 后台即可。
最新版 Umami 会自动跟随 ClientRouter 的站内换页，不需要手动上报 pageview。
51la：填 id 启用；再填 lingqueMonitorId 会额外加载灵雀 perf SDK，启用 sendSpaPv 与 sendSuspicious。灵雀 SDK 失败不影响 51la。灵雀会采集应用异常与可疑行为数据，开启前请确认其隐私说明。
Umami 和 51la 同时开启会各自统计一份，数字不会一致，通常二选一即可。
sendInDev = false 时开发环境不加载统计脚本。Vercel Preview 请在环境变量里设置 SONDER_ANALYTICS_DISABLED=1，并且只勾选 Preview，不要影响 Production。
统计脚本异步加载，被广告拦截器拦截时只影响统计，不影响页面。

Markdown 开关

[config.markdown] 控制数学公式与 Mermaid 图表：

1
[config.markdown]
2
math = true
3
mathRenderer = "katex" # "katex" | "mathjax"
4
mermaid = true

提醒块、外挂指令与响应式表格始终开启——文章内容依赖它们，因此不提供开关。

页面与集合

书影音、动态、朋友页都是普通页面加内容集合，不需要注册：删除 src/pages/media/ 与 src/content/media/ 即移除书影音，导航项同步从 site.config.toml 删除。项目卡片直接读取 src/content/projects/，由关于页展示；没有独立项目页。短记录统一使用 /moments。