Configuration Reference: Where Is the Setting I Need?
Find site.config settings by page, feature or full configuration path.
On this page
Version note: This reference follows current source. Live reduced-motion updates, strict blogPageSize validation and image isolation when Fragments is disabled require 0.36.1 or later; 0.36.0 does not include them. Default installation and CLI usage are unchanged.
If you know the task, start with its practical tutorial. To find a field’s meaning, default or limits, use this reference. Both follow the current code and do not require reading repository setup documents first.
First-time users can follow all eight tutorials: install → write → images → fragments → customize → comments → languages → deploy. Optional features need not all be enabled. This is a lookup reference, not a requirement to read every field from beginning to end.
Available modules: homepage, Blog List and tags, article detail, Fragments, About, Decoder, music, Giscus, languages and fallback, search and discovery, GA4 and AI-readable context, site and shared interface, and terminal.
Find settings by page or feature
| What I want to change | Reference | Practical tutorial |
|---|---|---|
| Homepage title, introduction, latest posts, startup prompts, terminal and passage | Homepage reference | Page and feature customization |
| Site name, domain, navigation, social links and footer | Site and shared-interface reference | Installation and site identity, Page customization |
| Blog List, tags and pagination | List reference | Lists and pagination |
| Article details, contents, mathematics and reading effects | Article reference | Write your first post |
| Fragments list and preview | Fragments reference | Publish a fragment |
| About body, contact, sidebar and tools | About reference | Page and feature customization |
| About terminal, prompts and read-only reader | Terminal reference | Page and feature customization |
| Decoder page and reading cards | Decoder reference | Page and feature customization |
| Music player | Music reference | Music setup |
| Giscus comments and translated discussions | Giscus reference | Let readers leave comments |
| Language switches, addresses, translation and fallback | Language reference | Language tutorial |
| Search and content discovery | Search reference | Writing posts, Deployment |
| GA4 analytics and AI-readable context | GA4 and AI context reference | Publish on your own domain |
Every field has one main reference location; other modules link to it. For example, the homepage uses the Fragments switch, but that switch also controls the full list and is not homepage-only.
Find settings by full path
This index follows the current public configuration type, including unused fields. Links open their main explanation; module references describe cross-page differences. <locale> is a placeholder for a code such as zh or en. Article frontmatter is listed separately from site.config paths.
| Full path | Reference |
|---|---|
i18n.locales.<locale>.site.homeTitle |
Homepage title |
i18n.locales.<locale>.site.hero |
Visible introduction |
i18n.locales.<locale>.messages.siteDescription |
Homepage metadata description |
theme.homeLatestCount |
Latest-post count |
theme.home.showInitialize |
Startup switches |
theme.home.showFollow |
Startup switches |
theme.home.showTrace |
Startup switches |
theme.effects.enableHomePassage |
Passage navigation |
i18n.locales.<locale>.messages.home.latest |
Homepage messages |
i18n.locales.<locale>.messages.home.viewAll |
Homepage messages |
i18n.locales.<locale>.messages.home.noPosts |
Homepage messages |
i18n.locales.<locale>.messages.home.openDoor |
Homepage messages |
i18n.locales.<locale>.messages.home.transmission |
Widescreen terminal text |
i18n.locales.<locale>.messages.home.hero |
Fallback introduction |
theme.fragments.enabled |
Fragments switch |
i18n.locales.<locale>.messages.blog.allPosts |
Shared article/tag entry |
i18n.locales.<locale>.messages.fragments.title |
Fragment messages |
i18n.locales.<locale>.messages.fragments.close |
Fragment messages |
i18n.locales.<locale>.messages.siteTitle |
Currently unused title field |
theme.blogPageSize |
Posts per page |
theme.tags.enabled |
Tags switch |
theme.pagination.windowSize |
Page-number window |
theme.pagination.showJumpThreshold |
Jump threshold |
theme.pagination.jump.enabled |
Jump switch |
theme.pagination.jump.enterToGo |
Enter to jump |
theme.pagination.style.enabled |
Pagination style switch |
theme.pagination.style.mode |
Variant strategy |
theme.pagination.style.variants |
Variant count |
theme.pagination.style.fixedVariant |
Fixed variant |
i18n.locales.<locale>.messages.blog.title |
List titles and descriptions |
i18n.locales.<locale>.messages.blog.pageTitle |
List titles and descriptions |
i18n.locales.<locale>.messages.blog.archiveDescription |
List titles and descriptions |
i18n.locales.<locale>.messages.blog.pageDescription |
List titles and descriptions |
i18n.locales.<locale>.messages.blog.previous |
Pagination text |
i18n.locales.<locale>.messages.blog.next |
Pagination text |
i18n.locales.<locale>.messages.blog.paginationAria |
Pagination text |
i18n.locales.<locale>.messages.blog.jumpTo |
Pagination text |
i18n.locales.<locale>.messages.blog.jumpInputLabel |
Pagination text |
i18n.locales.<locale>.messages.blog.jumpGo |
Pagination text |
i18n.locales.<locale>.messages.blog.tags |
Tag text |
i18n.locales.<locale>.messages.blog.noTags |
Tag text |
i18n.locales.<locale>.messages.blog.taggedPosts |
Tag text |
theme.toc.enabled |
Article feature switches |
theme.math.enabled |
Article feature switches |
theme.effects.enableRedQueen |
Article feature switches |
theme.search.enabled |
Site-search switch |
theme.socialImage.enabled |
Article feature switches |
site.author |
Site and shared-interface settings |
site.ogImage |
Site and shared-interface settings |
theme.enableAboutPage |
About switch |
theme.footer.showCredits |
Site and shared-interface settings |
theme.comments.enabled |
Giscus settings |
i18n.locales.<locale>.messages.blog.rqBadge |
Article messages |
i18n.locales.<locale>.messages.blog.rqReplayAria |
Article messages |
i18n.locales.<locale>.messages.blog.backToTop |
Article messages |
i18n.locales.<locale>.messages.blog.toastP10 |
Article messages |
i18n.locales.<locale>.messages.blog.toastP30 |
Article messages |
i18n.locales.<locale>.messages.blog.toastP60 |
Article messages |
i18n.locales.<locale>.messages.blog.toastDone |
Article messages |
i18n.locales.<locale>.messages.blog.metaPublished |
Article messages |
i18n.locales.<locale>.messages.blog.metaAuthor |
Article messages |
i18n.locales.<locale>.messages.blog.metaUpdated |
Article messages |
i18n.locales.<locale>.messages.blog.systemStatusAria |
Article messages |
i18n.locales.<locale>.messages.blog.systemModelLabel |
Article messages |
i18n.locales.<locale>.messages.blog.systemModeLabel |
Article messages |
i18n.locales.<locale>.messages.blog.systemStateLabel |
Article messages |
i18n.locales.<locale>.messages.blog.promptContextLabel |
Article messages |
i18n.locales.<locale>.messages.blog.heroMonitor |
Article messages |
i18n.locales.<locale>.messages.blog.heroSignalSync |
Article messages |
i18n.locales.<locale>.messages.blog.heroModelOnline |
Article messages |
i18n.locales.<locale>.messages.blog.toc |
Article messages |
i18n.locales.<locale>.messages.blog.responseOutput |
Article messages |
i18n.locales.<locale>.messages.blog.statsWords |
Article messages |
i18n.locales.<locale>.messages.blog.statsTokens |
Article messages |
i18n.locales.<locale>.messages.blog.copySectionLink |
Article messages |
i18n.locales.<locale>.messages.blog.regenerate |
Article messages |
i18n.locales.<locale>.messages.blog.relatedAria |
Article messages |
i18n.locales.<locale>.messages.blog.related |
Article messages |
i18n.locales.<locale>.messages.blog.backToBlogAria |
Article messages |
i18n.locales.<locale>.messages.blog.backToBlog |
Article messages |
i18n.locales.<locale>.messages.blog.comments |
Article messages |
i18n.locales.<locale>.messages.blog.metaReadMinutes |
Article messages (currently unused) |
i18n.locales.<locale>.messages.blog.latencyLabel |
Article messages (currently unused) |
i18n.locales.<locale>.messages.blog.confidenceLabel |
Article messages (currently unused) |
i18n.locales.<locale>.messages.codeCopy.copy |
Reading interaction text |
i18n.locales.<locale>.messages.codeCopy.copied |
Reading interaction text |
i18n.locales.<locale>.messages.codeCopy.failed |
Reading interaction text |
i18n.locales.<locale>.messages.imagePreview.open |
Reading interaction text |
i18n.locales.<locale>.messages.imagePreview.close |
Reading interaction text |
theme.fragments.pageSize |
Fragments per page |
theme.fragments.comments.enabled |
Fragment comments |
i18n.locales.<locale>.messages.fragments.description |
Fragment messages |
i18n.locales.<locale>.messages.fragments.empty |
Fragment messages |
i18n.locales.<locale>.messages.fragments.comments |
Fragment messages |
i18n.locales.<locale>.messages.fragments.previous |
Fragment messages (currently unused) |
i18n.locales.<locale>.messages.fragments.next |
Fragment messages (currently unused) |
i18n.locales.<locale>.messages.fragments.loading |
Fragment messages |
i18n.locales.<locale>.messages.fragments.error |
Fragment messages |
i18n.locales.<locale>.messages.fragments.retry |
Fragment messages |
i18n.locales.<locale>.messages.fragments.copyLink |
Fragment messages |
i18n.locales.<locale>.messages.fragments.linkCopied |
Fragment messages |
i18n.locales.<locale>.messages.fragments.copyLinkFailed |
Fragment messages |
i18n.locales.<locale>.messages.fragments.notFound |
Fragment messages |
i18n.locales.<locale>.messages.fragments.indexError |
Fragment messages |
theme.comments.repo |
Giscus settings |
theme.comments.repoId |
Giscus settings |
theme.comments.category |
Giscus settings |
theme.comments.categoryId |
Giscus settings |
i18n.locales.<locale>.about.metaLine |
About body |
i18n.locales.<locale>.about.sections.who |
About body |
i18n.locales.<locale>.about.sections.what |
About body |
i18n.locales.<locale>.about.sections.ethos |
About body |
i18n.locales.<locale>.about.sections.now |
About body |
i18n.locales.<locale>.about.sections.contactLead |
About body |
i18n.locales.<locale>.about.sections.signature |
About body |
i18n.locales.<locale>.about.contact.email |
About contact |
i18n.locales.<locale>.about.contact.githubUrl |
About contact |
i18n.locales.<locale>.about.contact.githubLabel |
About contact |
i18n.locales.<locale>.about.sidebar.dlData |
About tool entries |
i18n.locales.<locale>.about.sidebar.ai |
About tool entries |
i18n.locales.<locale>.about.sidebar.decryptor |
About tool entries |
i18n.locales.<locale>.about.sidebar.help |
About tool entries |
i18n.locales.<locale>.about.sidebar.allScripts |
About tool entries |
i18n.locales.<locale>.about.scriptsPath |
About tool entries |
i18n.locales.<locale>.about.labels.modalOutput |
About common text (check usage status) |
i18n.locales.<locale>.about.labels.modalClose |
About common text |
i18n.locales.<locale>.about.labels.responseOutput |
About common text |
i18n.locales.<locale>.about.labels.contactEmailLead |
About common text |
i18n.locales.<locale>.about.labels.contactConnectLead |
About common text |
i18n.locales.<locale>.about.labels.backToTop |
About common text |
i18n.locales.<locale>.about.labels.quickAccess |
About common text |
i18n.locales.<locale>.about.labels.contactEmailLabel |
About common text |
i18n.locales.<locale>.about.modals.dlData.title |
About tool dialogs |
i18n.locales.<locale>.about.modals.dlData.subtitle |
About tool dialogs |
i18n.locales.<locale>.about.modals.ai.title |
About tool dialogs |
i18n.locales.<locale>.about.modals.ai.lines |
About tool dialogs |
i18n.locales.<locale>.about.modals.decryptor.title |
About tool dialogs |
i18n.locales.<locale>.about.modals.decryptor.header |
About tool dialogs (check usage status) |
i18n.locales.<locale>.about.modals.decryptor.keysLabel |
About tool dialogs (check usage status) |
i18n.locales.<locale>.about.modals.decryptor.currentPassphraseLabel |
About tool dialogs (check usage status) |
i18n.locales.<locale>.about.modals.decryptor.masterKeyLabel |
About tool dialogs (check usage status) |
i18n.locales.<locale>.about.modals.decryptor.transientKeyLabel |
About tool dialogs (check usage status) |
i18n.locales.<locale>.about.modals.help.title |
About tool dialogs |
i18n.locales.<locale>.about.modals.help.statsLabel |
About tool dialogs |
i18n.locales.<locale>.about.modals.help.typedPrefix |
About tool dialogs |
i18n.locales.<locale>.about.modals.help.typedSuffix |
About tool dialogs |
i18n.locales.<locale>.about.modals.allScripts.title |
About tool dialogs |
i18n.locales.<locale>.about.effects.backgroundLines |
About effects (check usage status) |
i18n.locales.<locale>.about.effects.scrollToasts.p30 |
About effects |
i18n.locales.<locale>.about.effects.scrollToasts.p60 |
About effects |
i18n.locales.<locale>.about.effects.scrollToasts.p90 |
About effects |
i18n.locales.<locale>.messages.about.title |
About and shared controls |
i18n.locales.<locale>.messages.about.description |
About and shared controls |
i18n.locales.<locale>.messages.about.who |
About and shared controls |
i18n.locales.<locale>.messages.about.what |
About and shared controls |
i18n.locales.<locale>.messages.about.ethos |
About and shared controls |
i18n.locales.<locale>.messages.about.now |
About and shared controls |
i18n.locales.<locale>.messages.about.contact |
About and shared controls |
i18n.locales.<locale>.messages.about.regenerate |
About and shared controls |
i18n.locales.<locale>.messages.windowControls.collapse |
About and shared controls |
i18n.locales.<locale>.messages.windowControls.expand |
About and shared controls |
i18n.locales.<locale>.messages.windowControls.restore |
About and shared controls |
i18n.locales.<locale>.messages.windowControls.fullscreen |
About and shared controls |
i18n.locales.<locale>.messages.scriptFolders.copyTitle |
About and shared controls |
i18n.locales.<locale>.messages.scriptFolders.copied |
About and shared controls |
i18n.locales.<locale>.messages.scriptFolders.failed |
About and shared controls |
theme.enableDecoderPage |
Decoder switch |
i18n.locales.<locale>.messages.nav.about |
Site and shared-interface settings |
i18n.locales.<locale>.messages.decoder.input |
Decoder messages |
i18n.locales.<locale>.messages.decoder.placeholder |
Decoder messages |
i18n.locales.<locale>.messages.decoder.format |
Decoder messages |
i18n.locales.<locale>.messages.decoder.auto |
Decoder messages |
i18n.locales.<locale>.messages.decoder.decode |
Decoder messages |
i18n.locales.<locale>.messages.decoder.clear |
Decoder messages |
i18n.locales.<locale>.messages.decoder.copy |
Decoder messages |
i18n.locales.<locale>.messages.decoder.reuse |
Decoder messages |
i18n.locales.<locale>.messages.decoder.supported |
Decoder messages |
i18n.locales.<locale>.messages.decoder.html |
Decoder messages |
i18n.locales.<locale>.messages.decoder.unicode |
Decoder messages |
i18n.locales.<locale>.messages.decoder.jwtWarning |
Decoder messages |
i18n.locales.<locale>.messages.decoder.copied |
Decoder messages |
i18n.locales.<locale>.messages.decoder.copyFailed |
Decoder messages |
i18n.locales.<locale>.messages.decoder.output |
Decoder messages |
i18n.locales.<locale>.messages.decoder.local |
Decoder messages |
i18n.locales.<locale>.messages.decoder.ready |
Decoder messages |
i18n.locales.<locale>.messages.decoder.running |
Decoder messages |
i18n.locales.<locale>.messages.decoder.done |
Decoder messages |
i18n.locales.<locale>.messages.decoder.empty |
Decoder messages |
i18n.locales.<locale>.messages.decoder.tooLong |
Decoder messages |
i18n.locales.<locale>.messages.decoder.invalid |
Decoder messages |
i18n.locales.<locale>.messages.decoder.binary |
Decoder messages |
i18n.locales.<locale>.messages.decoder.unknown |
Decoder messages |
i18n.locales.<locale>.messages.decoder.ambiguous |
Decoder messages |
i18n.locales.<locale>.messages.decoder.example |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.description |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.fullTool |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.task |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.textTask |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.callTask |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.addressTask |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.addressHint |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.chain |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.decimals |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.precisionHint |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.network |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.history |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.back |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.export |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.limits |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.callNotice |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.addressNotice |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.unsupported |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.checksum |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.length |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.wrongNetwork |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.stepLimit |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.budget |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.addressParse |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.addressCheck |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.addressResult |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.callParse |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.rawOnly |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.amountResult |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.inputHint |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.loadFailed |
Decoder messages |
i18n.locales.<locale>.messages.decoderPage.readings.tribute |
Decoder reading area |
i18n.locales.<locale>.messages.decoderPage.readings.links |
Decoder reading area |
i18n.locales.<locale>.messages.decoderPage.readings.links[].title |
Decoder reading area |
i18n.locales.<locale>.messages.decoderPage.readings.links[].href |
Decoder reading area |
i18n.locales.<locale>.messages.decoderPage.readings.links[].author |
Decoder reading area |
i18n.locales.<locale>.messages.decoderPage.readings.links[].year |
Decoder reading area |
i18n.locales.<locale>.messages.decoderPage.readings.links[].cover |
Decoder reading area |
theme.music.enabled |
Music settings |
theme.music.tracks |
Music settings |
theme.music.tracks[].title |
Music settings |
theme.music.tracks[].artist |
Music settings |
theme.music.tracks[].src |
Music settings |
i18n.locales.<locale>.messages.music.label |
Music messages |
i18n.locales.<locale>.messages.music.play |
Music messages |
i18n.locales.<locale>.messages.music.pause |
Music messages |
i18n.locales.<locale>.messages.music.prev |
Music messages |
i18n.locales.<locale>.messages.music.next |
Music messages |
i18n.locales.<locale>.messages.music.open |
Music messages |
i18n.locales.<locale>.messages.music.close |
Music messages |
i18n.locales.<locale>.messages.music.progress |
Music messages |
i18n.locales.<locale>.messages.music.volume |
Music messages |
i18n.locales.<locale>.messages.music.queue |
Music messages |
i18n.locales.<locale>.messages.music.mute |
Music messages |
i18n.locales.<locale>.messages.music.unmute |
Music messages |
i18n.locales.<locale>.messages.music.idle |
Music messages |
i18n.locales.<locale>.messages.music.loading |
Music messages |
i18n.locales.<locale>.messages.music.playing |
Music messages |
i18n.locales.<locale>.messages.music.paused |
Music messages |
i18n.locales.<locale>.messages.music.blocked |
Music messages |
i18n.locales.<locale>.messages.music.error |
Music messages |
i18n.locales.<locale>.messages.music.noScript |
Music messages |
theme.comments.shareAcrossLocales |
Giscus settings |
theme.comments.mapping |
Giscus settings |
theme.comments.term |
Giscus settings |
theme.comments.number |
Giscus settings |
theme.comments.strict |
Giscus settings |
theme.comments.reactionsEnabled |
Giscus settings |
theme.comments.emitMetadata |
Giscus settings |
theme.comments.inputPosition |
Giscus settings |
theme.comments.theme |
Giscus settings |
theme.comments.lang |
Giscus settings |
theme.comments.loading |
Giscus settings |
theme.comments.crossorigin |
Giscus settings |
i18n.defaultLocale |
Language and fallback settings |
i18n.locales |
Language and fallback settings |
i18n.locales.<locale> |
Language and fallback settings |
i18n.routing.defaultLocalePrefix |
Language and fallback settings |
i18n.locales.<locale>.meta |
Language and fallback settings |
i18n.locales.<locale>.meta.label |
Language and fallback settings |
i18n.locales.<locale>.meta.hreflang |
Language and fallback settings |
i18n.locales.<locale>.meta.ogLocale |
Language and fallback settings |
i18n.locales.<locale>.meta.enabled |
Language and fallback settings |
i18n.locales.<locale>.meta.fallback |
Language and fallback settings |
i18n.locales.<locale>.site |
Language and fallback settings |
i18n.locales.<locale>.messages |
Language and fallback settings |
i18n.locales.<locale>.about |
Language and fallback settings |
i18n.locales.<locale>.messages.langLabel |
Language and fallback settings |
i18n.locales.<locale>.aiReadableContent |
GA4 and AI-readable context |
i18n.locales.<locale>.aiReadableContent.notes |
GA4 and AI-readable context |
i18n.locales.<locale>.aiReadableContent.links |
GA4 and AI-readable context |
i18n.locales.<locale>.aiReadableContent.links[].label |
GA4 and AI-readable context |
i18n.locales.<locale>.aiReadableContent.links[].href |
GA4 and AI-readable context |
i18n.locales.<locale>.messages.search.label |
Search messages |
i18n.locales.<locale>.messages.search.close |
Search messages |
i18n.locales.<locale>.messages.search.placeholder |
Search messages |
i18n.locales.<locale>.messages.search.hint |
Search messages |
i18n.locales.<locale>.messages.search.loading |
Search messages |
i18n.locales.<locale>.messages.search.empty |
Search messages |
i18n.locales.<locale>.messages.search.error |
Search messages |
i18n.locales.<locale>.messages.search.retry |
Search messages |
i18n.locales.<locale>.messages.search.more |
Search messages |
i18n.locales.<locale>.messages.search.results |
Search messages |
i18n.locales.<locale>.messages.search.dev |
Search messages |
analytics |
GA4 and AI-readable context |
analytics.googleAnalyticsId |
GA4 and AI-readable context |
aiReadableContent |
GA4 and AI-readable context |
aiReadableContent.notes |
GA4 and AI-readable context |
aiReadableContent.links |
GA4 and AI-readable context |
aiReadableContent.links[].label |
GA4 and AI-readable context |
aiReadableContent.links[].href |
GA4 and AI-readable context |
site.title |
Site and shared-interface settings |
site.description |
Site and shared-interface settings |
site.url |
Site and shared-interface settings |
site.tagline |
Site and shared-interface settings |
social.links |
Site and shared-interface settings |
social.links[].href |
Site and shared-interface settings |
social.links[].label |
Site and shared-interface settings |
social.links[].rel |
Site and shared-interface settings |
social.links[].icon |
Site and shared-interface settings |
social.links[].iconSrc |
Site and shared-interface settings |
theme.footer.links |
Site and shared-interface settings |
theme.footer.links[].label |
Site and shared-interface settings |
theme.footer.links[].href |
Site and shared-interface settings |
i18n.locales.<locale>.messages.nav.home |
Site and shared-interface settings |
i18n.locales.<locale>.messages.nav.blog |
Site and shared-interface settings |
i18n.locales.<locale>.messages.nav.status |
Site and shared-interface settings |
i18n.locales.<locale>.messages.nav.statusAria |
Site and shared-interface settings |
i18n.locales.<locale>.messages.footer.theme |
Site and shared-interface settings |
i18n.locales.<locale>.messages.footer.builtWith |
Site and shared-interface settings |
i18n.locales.<locale>.messages.terminal.commandInput |
Terminal messages |
i18n.locales.<locale>.messages.terminal.hint |
Terminal messages |
i18n.locales.<locale>.messages.terminal.help |
Terminal messages |
i18n.locales.<locale>.messages.terminal.syntax |
Terminal messages |
i18n.locales.<locale>.messages.terminal.usage |
Terminal messages |
i18n.locales.<locale>.messages.terminal.unknown |
Terminal messages |
i18n.locales.<locale>.messages.terminal.notFound |
Terminal messages |
i18n.locales.<locale>.messages.terminal.notDirectory |
Terminal messages |
i18n.locales.<locale>.messages.terminal.isDirectory |
Terminal messages |
i18n.locales.<locale>.messages.terminal.failed |
Terminal messages |
i18n.locales.<locale>.messages.terminal.tooLarge |
Terminal messages |
i18n.locales.<locale>.messages.terminal.empty |
Terminal messages |
i18n.locales.<locale>.messages.terminal.loading |
Terminal messages |
i18n.locales.<locale>.messages.terminal.readerTitle |
Terminal messages (currently unused) |
i18n.locales.<locale>.messages.terminal.readerHint |
Terminal messages |
i18n.locales.<locale>.messages.terminal.readerCommand |
Terminal messages |
Look up article fields separately
Article frontmatter does not belong in the preceding site.config table: content, dates and images, OUTPUT statistics/status, and compatibility/unused fields.
The three fragment frontmatter fields are documented separately under fragment content; do not mix them with article fields.
Per-article site-search inclusion uses search, not a site.config field or privacy switch.
How to read field entries
Every module follows the same conventions: full path, type, theme default, actual purpose, restrictions, conditions and examples. A field without a consumer must not be described as active merely because its type is accepted.
| Status | Meaning |
|---|---|
| Active | Consumed by the current implementation. |
| Conditional | Requires a feature/page condition or no higher-priority override. |
| Currently unused | Accepted by types without a current effect; do not set it expecting a visible change. |
| Compatibility | Retained for an explicit compatibility purpose; the entry states what remains and whether it is displayed. |
Theme defaults come from package configuration or built-in messages. The starter may override them, and the demo has personal overrides again. Demo author names, titles and playlists are not every new blog’s defaults.
Language defaults vary by locale and fallback chain. Entries identify unset values, built-in current-language messages or exact values. Tables showing only Simplified Chinese/English say so instead of presenting them as universal defaults.
Where do settings go, and how are they merged?
Merge fragments into the existing defineThemeConfig({...}) in src/site.config.ts. Keep imports, exports and personal configuration, without duplicating theme/i18n in one object.
Objects merge recursively, omitted fields retain defaults, arrays replace whole arrays, and undefined overrides are skipped. Empty strings, empty arrays and false have field-specific meanings, not a universal “restore default” meaning. Empty homepage hero clears text, while blank homeTitle continues fallback.
Check the affected page in dev after changes; environment overrides require restarting dev. Production changes need a rebuild and deployment, not merely saving local configuration.
Article frontmatter, Astro configuration and environment variables have different locations. References explain relationships without pretending they are site.config fields. See installation/upgrades and local preview/deployment.