Configuration Reference: Where Is the Setting I Need?

$ published 2026-11-13 | | updated 2026-11-14
Context: The configuration-reference entry point, distinguishing field locations, defaults and status, with complete module and field indexes.

Find site.config settings by page, feature or full configuration path.


Output
words 1.7k tokens 2.3k

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.