配置字典:我想改的东西在哪里?
按页面、功能或完整配置路径,找到 site.config 中的设置。
文章目录
版本说明: 本字典以当前源码为准。实时减弱动画、blogPageSize 严格校验和关闭 Fragments 后的图片隔离从 0.36.1 起提供,0.36.0 不包含。默认安装和 CLI 用法不变。
如果你已经知道想完成什么,先看操作教程;如果你在找一个字段的含义、默认值或限制,从这里查配置字典。两者都以当前主题代码为准,不要求先阅读仓库说明文件。
第一次使用请从八篇教程总入口按顺序阅读:安装 → 写文章 → 添加图片 → 发布碎片 → 调整页面与功能 → 评论 → 多语言 → 部署。可选功能不必全部启用;本字典用于随时查字段,不要求从头读完整份路径表。
目前已完成首页配置、Blog List 与标签列表配置、文章详情页配置、Fragments 配置、About 配置、Decoder 配置、音乐播放器配置、Giscus 评论配置、语言与回退配置、搜索与内容发现配置、GA4 与 AI 阅读补充配置、站点与公共界面配置和终端配置。
按页面或功能查找
| 我想修改 | 字典状态 | 现有操作教程 |
|---|---|---|
| 首页标题、介绍、最新文章、启动提示、终端文字与穿越 | 首页配置字典 | 页面与功能定制 |
| 站点名称、域名、公共导航、社交和页脚 | 站点与公共界面字典 | 安装与站点信息、页面定制 |
| Blog List、标签列表和分页 | 列表配置字典 | 列表与分页设置 |
| 文章详情、目录、数学和阅读效果 | 文章配置字典 | 写第一篇文章 |
| Fragments 列表与预览 | Fragments 字典 | 发布一条碎片 |
| About 正文、联系、侧栏和工具 | About 字典 | 页面与功能定制 |
| About 终端、命令提示与只读阅读器 | 终端字典 | 页面与功能定制 |
| Decoder 页面与阅读卡片 | Decoder 字典 | 页面与功能定制 |
| 音乐播放器 | 音乐播放器字典 | 音乐设置 |
| Giscus 评论和多语言讨论共享 | Giscus 评论字典 | 让读者留下评论 |
| 语言启停、地址、界面翻译和回退 | 语言配置字典 | 多语言教程 |
| 搜索与内容发现 | 搜索配置字典 | 写文章、部署 |
| GA4 访问统计、AI 阅读补充说明 | GA4 与 AI 补充字典 | 发布到自己的域名 |
同一个字段会有一个主要说明位置;其他模块引用它时提供链接。例如首页使用碎片开关,但这个开关还影响完整碎片列表,不能当成首页专用字段。
按完整配置路径查找
下面按当前公开配置类型提供路径索引,包括当前未使用的字段。点击进入主要说明位置;跨页面的用法差异在对应模块交叉引用。<语言> 是占位,换成 zh、en 等实际代码。文章 frontmatter 另列,不混入 site.config 路径。
| 完整路径 | 查阅位置 |
|---|---|
i18n.locales.<语言>.site.homeTitle |
首页大标题 |
i18n.locales.<语言>.site.hero |
首页可见介绍 |
i18n.locales.<语言>.messages.siteDescription |
首页元描述 |
theme.homeLatestCount |
最新文章数量 |
theme.home.showInitialize |
启动提示开关 |
theme.home.showFollow |
启动提示开关 |
theme.home.showTrace |
启动提示开关 |
theme.effects.enableHomePassage |
点击穿越 |
i18n.locales.<语言>.messages.home.latest |
首页界面文案 |
i18n.locales.<语言>.messages.home.viewAll |
首页界面文案 |
i18n.locales.<语言>.messages.home.noPosts |
首页界面文案 |
i18n.locales.<语言>.messages.home.openDoor |
首页界面文案 |
i18n.locales.<语言>.messages.home.transmission |
宽屏终端文字 |
i18n.locales.<语言>.messages.home.hero |
介绍的备用文案 |
theme.fragments.enabled |
碎片总开关 |
i18n.locales.<语言>.messages.blog.allPosts |
文章与标签共享入口 |
i18n.locales.<语言>.messages.fragments.title |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.close |
碎片界面文案 |
i18n.locales.<语言>.messages.siteTitle |
当前未使用的标题字段 |
theme.blogPageSize |
每页文章数 |
theme.tags.enabled |
标签开关 |
theme.pagination.windowSize |
页码窗口 |
theme.pagination.showJumpThreshold |
跳页阈值 |
theme.pagination.jump.enabled |
跳页开关 |
theme.pagination.jump.enterToGo |
回车跳页 |
theme.pagination.style.enabled |
分页样式开关 |
theme.pagination.style.mode |
变体策略 |
theme.pagination.style.variants |
变体数量 |
theme.pagination.style.fixedVariant |
固定变体 |
i18n.locales.<语言>.messages.blog.title |
列表标题与描述 |
i18n.locales.<语言>.messages.blog.pageTitle |
列表标题与描述 |
i18n.locales.<语言>.messages.blog.archiveDescription |
列表标题与描述 |
i18n.locales.<语言>.messages.blog.pageDescription |
列表标题与描述 |
i18n.locales.<语言>.messages.blog.previous |
分页文案 |
i18n.locales.<语言>.messages.blog.next |
分页文案 |
i18n.locales.<语言>.messages.blog.paginationAria |
分页文案 |
i18n.locales.<语言>.messages.blog.jumpTo |
分页文案 |
i18n.locales.<语言>.messages.blog.jumpInputLabel |
分页文案 |
i18n.locales.<语言>.messages.blog.jumpGo |
分页文案 |
i18n.locales.<语言>.messages.blog.tags |
标签文案 |
i18n.locales.<语言>.messages.blog.noTags |
标签文案 |
i18n.locales.<语言>.messages.blog.taggedPosts |
标签文案 |
theme.toc.enabled |
文章功能开关 |
theme.math.enabled |
文章功能开关 |
theme.effects.enableRedQueen |
文章功能开关 |
theme.search.enabled |
站内搜索开关 |
theme.socialImage.enabled |
文章功能开关 |
site.author |
站点与公共界面配置 |
site.ogImage |
站点与公共界面配置 |
theme.enableAboutPage |
About 页面开关 |
theme.footer.showCredits |
站点与公共界面配置 |
theme.comments.enabled |
Giscus 评论配置 |
i18n.locales.<语言>.messages.blog.rqBadge |
文章界面文案 |
i18n.locales.<语言>.messages.blog.rqReplayAria |
文章界面文案 |
i18n.locales.<语言>.messages.blog.backToTop |
文章界面文案 |
i18n.locales.<语言>.messages.blog.toastP10 |
文章界面文案 |
i18n.locales.<语言>.messages.blog.toastP30 |
文章界面文案 |
i18n.locales.<语言>.messages.blog.toastP60 |
文章界面文案 |
i18n.locales.<语言>.messages.blog.toastDone |
文章界面文案 |
i18n.locales.<语言>.messages.blog.metaPublished |
文章界面文案 |
i18n.locales.<语言>.messages.blog.metaAuthor |
文章界面文案 |
i18n.locales.<语言>.messages.blog.metaUpdated |
文章界面文案 |
i18n.locales.<语言>.messages.blog.systemStatusAria |
文章界面文案 |
i18n.locales.<语言>.messages.blog.systemModelLabel |
文章界面文案 |
i18n.locales.<语言>.messages.blog.systemModeLabel |
文章界面文案 |
i18n.locales.<语言>.messages.blog.systemStateLabel |
文章界面文案 |
i18n.locales.<语言>.messages.blog.promptContextLabel |
文章界面文案 |
i18n.locales.<语言>.messages.blog.heroMonitor |
文章界面文案 |
i18n.locales.<语言>.messages.blog.heroSignalSync |
文章界面文案 |
i18n.locales.<语言>.messages.blog.heroModelOnline |
文章界面文案 |
i18n.locales.<语言>.messages.blog.toc |
文章界面文案 |
i18n.locales.<语言>.messages.blog.responseOutput |
文章界面文案 |
i18n.locales.<语言>.messages.blog.statsWords |
文章界面文案 |
i18n.locales.<语言>.messages.blog.statsTokens |
文章界面文案 |
i18n.locales.<语言>.messages.blog.copySectionLink |
文章界面文案 |
i18n.locales.<语言>.messages.blog.regenerate |
文章界面文案 |
i18n.locales.<语言>.messages.blog.relatedAria |
文章界面文案 |
i18n.locales.<语言>.messages.blog.related |
文章界面文案 |
i18n.locales.<语言>.messages.blog.backToBlogAria |
文章界面文案 |
i18n.locales.<语言>.messages.blog.backToBlog |
文章界面文案 |
i18n.locales.<语言>.messages.blog.comments |
文章界面文案 |
i18n.locales.<语言>.messages.blog.metaReadMinutes |
文章界面文案(当前未使用) |
i18n.locales.<语言>.messages.blog.latencyLabel |
文章界面文案(当前未使用) |
i18n.locales.<语言>.messages.blog.confidenceLabel |
文章界面文案(当前未使用) |
i18n.locales.<语言>.messages.codeCopy.copy |
阅读交互文案 |
i18n.locales.<语言>.messages.codeCopy.copied |
阅读交互文案 |
i18n.locales.<语言>.messages.codeCopy.failed |
阅读交互文案 |
i18n.locales.<语言>.messages.imagePreview.open |
阅读交互文案 |
i18n.locales.<语言>.messages.imagePreview.close |
阅读交互文案 |
theme.fragments.pageSize |
碎片每页条数 |
theme.fragments.comments.enabled |
碎片评论 |
i18n.locales.<语言>.messages.fragments.description |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.empty |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.comments |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.previous |
碎片文案(当前未使用) |
i18n.locales.<语言>.messages.fragments.next |
碎片文案(当前未使用) |
i18n.locales.<语言>.messages.fragments.loading |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.error |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.retry |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.copyLink |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.linkCopied |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.copyLinkFailed |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.notFound |
碎片界面文案 |
i18n.locales.<语言>.messages.fragments.indexError |
碎片界面文案 |
theme.comments.repo |
Giscus 评论配置 |
theme.comments.repoId |
Giscus 评论配置 |
theme.comments.category |
Giscus 评论配置 |
theme.comments.categoryId |
Giscus 评论配置 |
i18n.locales.<语言>.about.metaLine |
About 正文 |
i18n.locales.<语言>.about.sections.who |
About 正文 |
i18n.locales.<语言>.about.sections.what |
About 正文 |
i18n.locales.<语言>.about.sections.ethos |
About 正文 |
i18n.locales.<语言>.about.sections.now |
About 正文 |
i18n.locales.<语言>.about.sections.contactLead |
About 正文 |
i18n.locales.<语言>.about.sections.signature |
About 正文 |
i18n.locales.<语言>.about.contact.email |
About 联系 |
i18n.locales.<语言>.about.contact.githubUrl |
About 联系 |
i18n.locales.<语言>.about.contact.githubLabel |
About 联系 |
i18n.locales.<语言>.about.sidebar.dlData |
About 工具入口 |
i18n.locales.<语言>.about.sidebar.ai |
About 工具入口 |
i18n.locales.<语言>.about.sidebar.decryptor |
About 工具入口 |
i18n.locales.<语言>.about.sidebar.help |
About 工具入口 |
i18n.locales.<语言>.about.sidebar.allScripts |
About 工具入口 |
i18n.locales.<语言>.about.scriptsPath |
About 工具入口 |
i18n.locales.<语言>.about.labels.modalOutput |
About 通用文案(注意生效状态) |
i18n.locales.<语言>.about.labels.modalClose |
About 通用文案 |
i18n.locales.<语言>.about.labels.responseOutput |
About 通用文案 |
i18n.locales.<语言>.about.labels.contactEmailLead |
About 通用文案 |
i18n.locales.<语言>.about.labels.contactConnectLead |
About 通用文案 |
i18n.locales.<语言>.about.labels.backToTop |
About 通用文案 |
i18n.locales.<语言>.about.labels.quickAccess |
About 通用文案 |
i18n.locales.<语言>.about.labels.contactEmailLabel |
About 通用文案 |
i18n.locales.<语言>.about.modals.dlData.title |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.dlData.subtitle |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.ai.title |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.ai.lines |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.decryptor.title |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.decryptor.header |
About 工具弹窗(注意生效状态) |
i18n.locales.<语言>.about.modals.decryptor.keysLabel |
About 工具弹窗(注意生效状态) |
i18n.locales.<语言>.about.modals.decryptor.currentPassphraseLabel |
About 工具弹窗(注意生效状态) |
i18n.locales.<语言>.about.modals.decryptor.masterKeyLabel |
About 工具弹窗(注意生效状态) |
i18n.locales.<语言>.about.modals.decryptor.transientKeyLabel |
About 工具弹窗(注意生效状态) |
i18n.locales.<语言>.about.modals.help.title |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.help.statsLabel |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.help.typedPrefix |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.help.typedSuffix |
About 工具弹窗 |
i18n.locales.<语言>.about.modals.allScripts.title |
About 工具弹窗 |
i18n.locales.<语言>.about.effects.backgroundLines |
About 效果(注意生效状态) |
i18n.locales.<语言>.about.effects.scrollToasts.p30 |
About 效果 |
i18n.locales.<语言>.about.effects.scrollToasts.p60 |
About 效果 |
i18n.locales.<语言>.about.effects.scrollToasts.p90 |
About 效果 |
i18n.locales.<语言>.messages.about.title |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.description |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.who |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.what |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.ethos |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.now |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.contact |
About 及共用控件文案 |
i18n.locales.<语言>.messages.about.regenerate |
About 及共用控件文案 |
i18n.locales.<语言>.messages.windowControls.collapse |
About 及共用控件文案 |
i18n.locales.<语言>.messages.windowControls.expand |
About 及共用控件文案 |
i18n.locales.<语言>.messages.windowControls.restore |
About 及共用控件文案 |
i18n.locales.<语言>.messages.windowControls.fullscreen |
About 及共用控件文案 |
i18n.locales.<语言>.messages.scriptFolders.copyTitle |
About 及共用控件文案 |
i18n.locales.<语言>.messages.scriptFolders.copied |
About 及共用控件文案 |
i18n.locales.<语言>.messages.scriptFolders.failed |
About 及共用控件文案 |
theme.enableDecoderPage |
Decoder 页面开关 |
i18n.locales.<语言>.messages.nav.about |
站点与公共界面配置 |
i18n.locales.<语言>.messages.decoder.input |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.placeholder |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.format |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.auto |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.decode |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.clear |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.copy |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.reuse |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.supported |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.html |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.unicode |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.jwtWarning |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.copied |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.copyFailed |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.output |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.local |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.ready |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.running |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.done |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.empty |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.tooLong |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.invalid |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.binary |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.unknown |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.ambiguous |
Decoder 文案 |
i18n.locales.<语言>.messages.decoder.example |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.description |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.fullTool |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.task |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.textTask |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.callTask |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.addressTask |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.addressHint |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.chain |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.decimals |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.precisionHint |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.network |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.history |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.back |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.export |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.limits |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.callNotice |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.addressNotice |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.unsupported |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.checksum |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.length |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.wrongNetwork |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.stepLimit |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.budget |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.addressParse |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.addressCheck |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.addressResult |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.callParse |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.rawOnly |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.amountResult |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.inputHint |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.loadFailed |
Decoder 文案 |
i18n.locales.<语言>.messages.decoderPage.readings.tribute |
Decoder 阅读区 |
i18n.locales.<语言>.messages.decoderPage.readings.links |
Decoder 阅读区 |
i18n.locales.<语言>.messages.decoderPage.readings.links[].title |
Decoder 阅读区 |
i18n.locales.<语言>.messages.decoderPage.readings.links[].href |
Decoder 阅读区 |
i18n.locales.<语言>.messages.decoderPage.readings.links[].author |
Decoder 阅读区 |
i18n.locales.<语言>.messages.decoderPage.readings.links[].year |
Decoder 阅读区 |
i18n.locales.<语言>.messages.decoderPage.readings.links[].cover |
Decoder 阅读区 |
theme.music.enabled |
音乐播放器配置 |
theme.music.tracks |
音乐播放器配置 |
theme.music.tracks[].title |
音乐播放器配置 |
theme.music.tracks[].artist |
音乐播放器配置 |
theme.music.tracks[].src |
音乐播放器配置 |
i18n.locales.<语言>.messages.music.label |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.play |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.pause |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.prev |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.next |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.open |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.close |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.progress |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.volume |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.queue |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.mute |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.unmute |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.idle |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.loading |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.playing |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.paused |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.blocked |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.error |
音乐播放器文案 |
i18n.locales.<语言>.messages.music.noScript |
音乐播放器文案 |
theme.comments.shareAcrossLocales |
Giscus 评论配置 |
theme.comments.mapping |
Giscus 评论配置 |
theme.comments.term |
Giscus 评论配置 |
theme.comments.number |
Giscus 评论配置 |
theme.comments.strict |
Giscus 评论配置 |
theme.comments.reactionsEnabled |
Giscus 评论配置 |
theme.comments.emitMetadata |
Giscus 评论配置 |
theme.comments.inputPosition |
Giscus 评论配置 |
theme.comments.theme |
Giscus 评论配置 |
theme.comments.lang |
Giscus 评论配置 |
theme.comments.loading |
Giscus 评论配置 |
theme.comments.crossorigin |
Giscus 评论配置 |
i18n.defaultLocale |
语言与回退配置 |
i18n.locales |
语言与回退配置 |
i18n.locales.<语言> |
语言与回退配置 |
i18n.routing.defaultLocalePrefix |
语言与回退配置 |
i18n.locales.<语言>.meta |
语言与回退配置 |
i18n.locales.<语言>.meta.label |
语言与回退配置 |
i18n.locales.<语言>.meta.hreflang |
语言与回退配置 |
i18n.locales.<语言>.meta.ogLocale |
语言与回退配置 |
i18n.locales.<语言>.meta.enabled |
语言与回退配置 |
i18n.locales.<语言>.meta.fallback |
语言与回退配置 |
i18n.locales.<语言>.site |
语言与回退配置 |
i18n.locales.<语言>.messages |
语言与回退配置 |
i18n.locales.<语言>.about |
语言与回退配置 |
i18n.locales.<语言>.messages.langLabel |
语言与回退配置 |
i18n.locales.<语言>.aiReadableContent |
GA4 与 AI 阅读补充 |
i18n.locales.<语言>.aiReadableContent.notes |
GA4 与 AI 阅读补充 |
i18n.locales.<语言>.aiReadableContent.links |
GA4 与 AI 阅读补充 |
i18n.locales.<语言>.aiReadableContent.links[].label |
GA4 与 AI 阅读补充 |
i18n.locales.<语言>.aiReadableContent.links[].href |
GA4 与 AI 阅读补充 |
i18n.locales.<语言>.messages.search.label |
搜索文案 |
i18n.locales.<语言>.messages.search.close |
搜索文案 |
i18n.locales.<语言>.messages.search.placeholder |
搜索文案 |
i18n.locales.<语言>.messages.search.hint |
搜索文案 |
i18n.locales.<语言>.messages.search.loading |
搜索文案 |
i18n.locales.<语言>.messages.search.empty |
搜索文案 |
i18n.locales.<语言>.messages.search.error |
搜索文案 |
i18n.locales.<语言>.messages.search.retry |
搜索文案 |
i18n.locales.<语言>.messages.search.more |
搜索文案 |
i18n.locales.<语言>.messages.search.results |
搜索文案 |
i18n.locales.<语言>.messages.search.dev |
搜索文案 |
analytics |
GA4 与 AI 阅读补充 |
analytics.googleAnalyticsId |
GA4 与 AI 阅读补充 |
aiReadableContent |
GA4 与 AI 阅读补充 |
aiReadableContent.notes |
GA4 与 AI 阅读补充 |
aiReadableContent.links |
GA4 与 AI 阅读补充 |
aiReadableContent.links[].label |
GA4 与 AI 阅读补充 |
aiReadableContent.links[].href |
GA4 与 AI 阅读补充 |
site.title |
站点与公共界面配置 |
site.description |
站点与公共界面配置 |
site.url |
站点与公共界面配置 |
site.tagline |
站点与公共界面配置 |
social.links |
站点与公共界面配置 |
social.links[].href |
站点与公共界面配置 |
social.links[].label |
站点与公共界面配置 |
social.links[].rel |
站点与公共界面配置 |
social.links[].icon |
站点与公共界面配置 |
social.links[].iconSrc |
站点与公共界面配置 |
theme.footer.links |
站点与公共界面配置 |
theme.footer.links[].label |
站点与公共界面配置 |
theme.footer.links[].href |
站点与公共界面配置 |
i18n.locales.<语言>.messages.nav.home |
站点与公共界面配置 |
i18n.locales.<语言>.messages.nav.blog |
站点与公共界面配置 |
i18n.locales.<语言>.messages.nav.status |
站点与公共界面配置 |
i18n.locales.<语言>.messages.nav.statusAria |
站点与公共界面配置 |
i18n.locales.<语言>.messages.footer.theme |
站点与公共界面配置 |
i18n.locales.<语言>.messages.footer.builtWith |
站点与公共界面配置 |
i18n.locales.<语言>.messages.terminal.commandInput |
终端文案 |
i18n.locales.<语言>.messages.terminal.hint |
终端文案 |
i18n.locales.<语言>.messages.terminal.help |
终端文案 |
i18n.locales.<语言>.messages.terminal.syntax |
终端文案 |
i18n.locales.<语言>.messages.terminal.usage |
终端文案 |
i18n.locales.<语言>.messages.terminal.unknown |
终端文案 |
i18n.locales.<语言>.messages.terminal.notFound |
终端文案 |
i18n.locales.<语言>.messages.terminal.notDirectory |
终端文案 |
i18n.locales.<语言>.messages.terminal.isDirectory |
终端文案 |
i18n.locales.<语言>.messages.terminal.failed |
终端文案 |
i18n.locales.<语言>.messages.terminal.tooLarge |
终端文案 |
i18n.locales.<语言>.messages.terminal.empty |
终端文案 |
i18n.locales.<语言>.messages.terminal.loading |
终端文案 |
i18n.locales.<语言>.messages.terminal.readerTitle |
终端文案(当前未使用) |
i18n.locales.<语言>.messages.terminal.readerHint |
终端文案 |
i18n.locales.<语言>.messages.terminal.readerCommand |
终端文案 |
文章字段与站点配置分开查
文章 frontmatter 不放入上面的 site.config 路径表:内容、日期和图片字段、OUTPUT 统计与状态、兼容及当前未使用字段。
碎片的三个 frontmatter 字段单独见碎片内容字段,不与文章字段混用。
单篇文章是否进入站内搜索见search 字段,它不是 site.config 字段,也不是隐私开关。
怎么阅读字段说明
每篇字典使用相同约定:给出完整路径、类型、主题默认值、实际作用、限制、生效条件和示例。没有消费代码的字段不能因为类型仍接受就写成有效功能。
| 状态 | 含义 |
|---|---|
| 生效 | 当前实现有对应作用 |
| 条件生效 | 需要开启功能、满足页面条件,或不被更高优先级配置覆盖 |
| 当前未使用 | 类型接受,但当前没有对应消费效果;不建议为了改变页面填写它 |
| 兼容保留 | 有明确兼容用途,具体说明保留什么、当前是否显示 |
主题默认值来自包内默认配置或内置文案;starter 可以覆盖它,demo 又有自己的个人配置。不要把演示站的作者、标题和歌单当作所有新博客的默认值。
语言字段的默认值随语言和回退链变化。字典会注明“未设置”“内置当前语言文案”或具体值;只给中文/英文例子时会标明范围,不冒充所有语言的固定默认值。
配置写在哪里,怎么合并?
示例中的配置片段合并到 src/site.config.ts 现有的 defineThemeConfig({...}) 中;保留 import、export 和其他个人配置,不要在同一对象重复创建 theme 或 i18n。
对象递归合并,省略字段继续使用默认配置;数组整体替换;undefined 覆盖会被跳过。空字符串、空数组和 false 的含义由字段决定,不能统一理解成“恢复默认”。例如首页 hero 的空字符串是主动清空,homeTitle 的空白则继续回退。
修改后先在 dev 中查看对应页面;环境覆盖变化需要重启开发服务。正式网站要重新构建和部署,单独保存本地配置不会修改线上页面。
文章 frontmatter、Astro 配置和环境变量有不同的位置。字典遇到这些关联会说明,但不会把它们冒充成 site.config 字段。安装与升级见第一篇教程,本地检查和部署见发布教程。