Solitude Docs

Configuration reference

Browse the complete defaults for this edition.

These defaults come from src/lib/defaults.json. See site configuration for top-level fields and src/site.config.ts for template overrides. Objects merge recursively; arrays replace defaults. Retained compatibility fields may have no visible effect.

Base defaults and template overrides

FeatureBaseTemplate
Comments / music hallDisabled, empty identifiersDisabled
CapsuleDisabledSample Qishui playlist
Cover samplingDisabledLocal mode
Updates / shortcutsDisabledEnabled
Local searchOn demandPreloaded
PWA manifestDisabledEnabled, no offline cache

site

FieldDefault
theme.site.name.class"text"
theme.site.name.custom"Solitude"
theme.site.icon"/img/logo.png"
FieldDefault
theme.nav.group{}
theme.nav.right.randomtrue
theme.nav.right.custom[]

hometop

FieldDefault
theme.hometop.enabletrue
theme.hometop.banner.title"Solitude"
theme.hometop.banner.desc"A fast, elegant and feature-rich Astro theme"
theme.hometop.banner.icon{}
theme.hometop.group{}
theme.hometop.recommendList[]

aside

FieldDefault
theme.aside.position1
theme.aside.home.noSticky"about"
theme.aside.home.Sticky"allInfo"
theme.aside.post.noSticky"about"
theme.aside.post.Sticky"newestPost,allInfo"
theme.aside.page.noSticky"about"
theme.aside.page.Sticky"newestPost,allInfo"
theme.aside.my_card.author.img"/img/logo.png"
theme.aside.my_card.author.emojinull
theme.aside.my_card.author.stickernull
theme.aside.my_card.description"An Astro theme for expressive personal sites."
theme.aside.my_card.content"Write, collect, and share with Solitude."
theme.aside.my_card.state.morning"Good morning"
theme.aside.my_card.state.noon"Good noon"
theme.aside.my_card.state.afternoon"Good afternoon"
theme.aside.my_card.state.night"Good evening"
theme.aside.my_card.state.goodnight"Good night"
theme.aside.my_card.witty_words[]
theme.aside.my_card.information[]
theme.aside.toc.posttrue
theme.aside.toc.pagetrue
theme.aside.toc.vaguetrue
theme.aside.tags.enabletrue
theme.aside.tags.limit20
theme.aside.tags.highlight_list[]
theme.aside.siteinfo.postcounttrue
theme.aside.siteinfo.wordcounttrue
theme.aside.siteinfo.updatetimetrue
theme.aside.siteinfo.runtimeenabletrue
theme.aside.siteinfo.runtime"2023-04-20 00:00:00"

page

FieldDefault
theme.page.errortrue
theme.page.tagstrue
theme.page.categoriestrue
theme.page.archives0
theme.page.links.async_threshold200
theme.page.default.cover["/img/default.avif"]

post

FieldDefault
theme.post.default.cover["/img/default.avif"]
theme.post.default.locate"China"
theme.post.default.copyright.enabletrue
theme.post.default.copyright.author"/img/logo.png"
theme.post.default.copyright.author_background""
theme.post.default.copyright.license"CC BY-NC-SA 4.0"
theme.post.default.copyright.licenurl"https://creativecommons.org/licenses/by-nc-sa/4.0/"
theme.post.meta.datetrue
theme.post.meta.updatedtrue
theme.post.meta.locatetrue
theme.post.meta.wordcounttrue
theme.post.meta.readtimetrue
theme.post.meta.pvfalse
theme.post.meta.commentfalse
theme.post.award.enablefalse
theme.post.award.list[]
theme.post.share.enablefalse
theme.post.share.list[]
theme.post.rss"/index.xml"
theme.post.covercolor.enablefalse
theme.post.covercolor.mode"local"
theme.post.covercolor.api"https://api.qjqq.cn/api/Imgcolor?img="
theme.post.covercolor.time43200000

theme_color

FieldDefault
theme.theme_color.dark"#ffc848"
theme.theme_color.light"#425aef"
theme.theme_color.nav_hover_text.dark"#1b1c20"
theme.theme_color.nav_hover_text.light"#ffffff"

display_mode

FieldDefault
theme.display_mode.type"auto"

font

FieldDefault
theme.font.font_size"16px"
theme.font.code_font_size"16px"
theme.font.font_family"system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
theme.font.code_font_family"ui-monospace, SFMono-Regular, Menlo, monospace"

index_post_list

FieldDefault
theme.index_post_list.direction"column"
theme.index_post_list.column2
theme.index_post_list.cover"both"

related_post

FieldDefault
theme.related_post.enabletrue
theme.related_post.limit3
theme.related_post.date_type"created"

expire

FieldDefault
theme.expire.enablefalse
theme.expire.time30
theme.expire.position"top"
theme.expire.text_prev"This post was last updated "
theme.expire.text_next" days ago. Some information may be out of date."

right_menu

FieldDefault
theme.right_menu.enabletrue
theme.right_menu.exclude["music"]
theme.right_menu.commentBarragefalse
theme.right_menu.ctrlOriginalMenufalse
theme.right_menu.translatefalse
theme.right_menu.musicfalse
theme.right_menu.limit50
theme.right_menu.author"Author: "
theme.right_menu.link"Link: "
theme.right_menu.source"Source: Solitude"
theme.right_menu.info""
theme.right_menu.img_error"Unable to download image"
theme.right_menu.mode.dark"Dark mode"
theme.right_menu.mode.light"Light mode"
theme.right_menu.barrage.open"Show comment barrage"
theme.right_menu.barrage.close"Hide comment barrage"
theme.right_menu.custom_list[]

copy

FieldDefault
theme.copy.enabletrue
theme.copy.copyright.enablefalse
theme.copy.copyright.limit50

mermaid

FieldDefault
theme.mermaidtrue

chart

FieldDefault
theme.charttrue

typeit

FieldDefault
theme.typeittrue

console

FieldDefault
theme.console.enabletrue
theme.console.recentComment.enablefalse
theme.console.recentComment.storage0.2
theme.console.card.tagstrue
theme.console.card.archive"month"

translate

FieldDefault
theme.translate.enablefalse
theme.translate.defaultEncoding2
theme.translate.translateDelay0

rightside

FieldDefault
theme.rightside.enabletrue
theme.rightside.hide.enabletrue
theme.rightside.hide.translatetrue
theme.rightside.hide.modetrue
theme.rightside.hide.asidetrue
FieldDefault
theme.footer.randomlinkfalse
theme.footer.information.author"/img/logo.png"
theme.footer.information.left[]
theme.footer.information.right[]
theme.footer.group{}
theme.footer.links[]
theme.footer.beian[]

errorpage

FieldDefault
theme.errorpage.img"/img/404.avif"
theme.errorpage.text"=awa= Page Not Found"
theme.errorpage.recommendListtrue

capsule

FieldDefault
theme.capsule.enablefalse
theme.capsule.id""
theme.capsule.server"netease"
theme.capsule.type"playlist"
theme.capsule.volume0.8

music

FieldDefault
theme.music.enablefalse
theme.music.id""
theme.music.server"netease"
theme.music.type"playlist"
theme.music.volume0.8
theme.music.mutextrue
theme.music.order"list"

meting_api

FieldDefault
theme.meting_api"https://meting.efu.me/?server=:server&type=:type&id=:id&r=:r"

keyboard

FieldDefault
theme.keyboard.enablefalse
theme.keyboard.list[]

lazyload

FieldDefault
theme.lazyload.enabletrue
theme.lazyload.field"site"
theme.lazyload.placeholder""
theme.lazyload.errorimg"/img/error_load.avif"

loading

FieldDefault
theme.loading.fullpagefalse
theme.loading.pacetrue

highlight

FieldDefault
theme.highlight.enabletrue
theme.highlight.copytrue
theme.highlight.line_numberstrue
theme.highlight.themes.light"github-light"
theme.highlight.themes.dark"github-dark"
theme.highlight.max_height360
FieldDefault
theme.lightbox"fancybox"

memorial

FieldDefault
theme.memorial.enablefalse
theme.memorial.date[]

katex

FieldDefault
theme.katex.enabletrue
theme.katex.per_pagetrue
theme.katex.copytextrue

pwa

FieldDefault
theme.pwa.enablefalse
theme.pwa.manifest"/manifest.json"
theme.pwa.theme_color"#425aef"
theme.pwa.mask_icon"/img/pwa/favicon.png"
theme.pwa.apple_touch_icon"/img/pwa/favicon.png"
theme.pwa.favicon_32_32"/img/pwa/favicon_32.png"
theme.pwa.favicon_16_16"/img/pwa/favicon_16.png"
theme.pwa.bookmark_icon"/img/pwa/favicon.png"

comment

FieldDefault
theme.comment.use""
theme.comment.commentBarragefalse
theme.comment.lazyloadfalse
theme.comment.countfalse
theme.comment.sidebarfalse
theme.comment.pvfalse
theme.comment.avatar"https://weavatar.com"
theme.comment.hot_tip.enablefalse
theme.comment.hot_tip.count3
theme.comment.newest_comment.enablefalse
theme.comment.newest_comment.storage0.5
theme.comment.newest_comment.limit5

twikoo

FieldDefault
theme.twikoo.envId""
theme.twikoo.region""
theme.twikoo.styletrue
theme.twikoo.accessToken""
theme.twikoo.option{}

waline

FieldDefault
theme.waline.serverURL""
theme.waline.pageviewfalse
theme.waline.option{}

valine

FieldDefault
theme.valine.appId""
theme.valine.appKey""
theme.valine.serverURLs""
theme.valine.avatar"mp"
theme.valine.visitorfalse
theme.valine.styletrue
theme.valine.option{}

artalk

FieldDefault
theme.artalk.server""
theme.artalk.site""
theme.artalk.option{}

giscus

FieldDefault
theme.giscus.repo""
theme.giscus.repo_id""
theme.giscus.category_id""
theme.giscus.mapping"pathname"
theme.giscus.theme.light"light"
theme.giscus.theme.dark"dark"
theme.giscus.option{}
FieldDefault
theme.search.enabletrue
theme.search.type"local"
theme.search.tags[]
theme.search.local.preloadfalse
theme.search.local.CDN"/search.xml"
theme.search.algolia.appId""
theme.search.algolia.apiKey""
theme.search.algolia.indexName""
theme.search.algolia.hits.per_page6
theme.search.docsearch.appId""
theme.search.docsearch.apiKey""
theme.search.docsearch.indexName""
theme.search.docsearch.placeholder""
theme.search.docsearch.option{}

envelope

FieldDefault
theme.envelope.enablefalse
theme.envelope.line10
theme.envelope.speed20
theme.envelope.hovertrue
theme.envelope.looptrue
theme.envelope.page"/message/"

brevity

FieldDefault
theme.brevity.enablefalse
theme.brevity.home_minifalse
theme.brevity.musicfalse
theme.brevity.page"/essay/"
theme.brevity.style1
theme.brevity.strip30

recent_comments

FieldDefault
theme.recent_comments.enablefalse
theme.recent_comments.limit50
theme.recent_comments.cache0.2
theme.recent_comments.page"/recentcomments/"

verify_site

FieldDefault
theme.verify_site[]

extends

FieldDefault
theme.extends.head[]
theme.extends.body[]

cdn

FieldDefault
theme.cdn.fontawesome"https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@7.3.0/css/all.min.css"
theme.cdn.snackbar"https://cdn.jsdelivr.net/npm/node-snackbar@0.1.16/dist/snackbar.min.js"
theme.cdn.lazyload"https://cdn.jsdelivr.net/npm/vanilla-lazyload@19.1.3/dist/lazyload.iife.min.js"
theme.cdn.fancyapps_css"https://cdn.jsdelivr.net/npm/@fancyapps/ui@6.1.14/dist/fancybox/fancybox.css"
theme.cdn.fancyapps_js"https://cdn.jsdelivr.net/npm/@fancyapps/ui@6.1.14/dist/fancybox/fancybox.umd.js"
theme.cdn.mermaid"https://cdn.jsdelivr.net/npm/mermaid@11.16.0/dist/mermaid.min.js"
theme.cdn.chart"https://cdn.jsdelivr.net/npm/chart.js@4.5.1/dist/chart.umd.min.js"
theme.cdn.abcjs"https://cdn.jsdelivr.net/npm/abcjs@6.6.4/dist/abcjs-basic-min.js"
theme.cdn.typeit"https://cdn.jsdelivr.net/npm/typeit@8.8.7/dist/index.umd.min.js"
theme.cdn.katex_css"https://cdn.jsdelivr.net/npm/katex@0.16.47/dist/katex.min.css"
theme.cdn.katex_copytex"https://cdn.jsdelivr.net/npm/katex@0.16.47/dist/contrib/copy-tex.min.js"
theme.cdn.aplayer_css"https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.css"
theme.cdn.aplayer_js"https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.js"
theme.cdn.meting_js"https://cdn.jsdelivr.net/npm/meting@2.0.2/dist/Meting.min.js"
theme.cdn.colorthief"https://cdn.jsdelivr.net/npm/colorthief@3.4.0/dist/umd/color-thief.global.min.js"
theme.cdn.twikoo"https://cdn.jsdelivr.net/npm/twikoo@1.6.44/dist/twikoo.all.min.js"
theme.cdn.waline_css"https://cdn.jsdelivr.net/npm/@waline/client@3.6.0/dist/waline.css"
theme.cdn.waline"https://cdn.jsdelivr.net/npm/@waline/client@3.6.0/dist/waline.umd.js"
theme.cdn.valine"https://cdn.jsdelivr.net/npm/valine@1.5.3/dist/Valine.min.js"
theme.cdn.blueimp_md5"https://cdn.jsdelivr.net/npm/blueimp-md5@2.19.0/js/md5.min.js"
theme.cdn.artalk_css"https://cdn.jsdelivr.net/npm/artalk@2.9.1/dist/Artalk.css"
theme.cdn.artalk"https://cdn.jsdelivr.net/npm/artalk@2.9.1/dist/Artalk.js"
theme.cdn.algoliasearch"https://cdn.jsdelivr.net/npm/algoliasearch@5.46.3/dist/lite/builds/browser.umd.js"
theme.cdn.instantsearch_css"https://cdn.jsdelivr.net/npm/instantsearch.css@8.9.0/themes/satellite-min.css"
theme.cdn.instantsearch"https://cdn.jsdelivr.net/npm/instantsearch.js@4.84.0/dist/instantsearch.production.min.js"
theme.cdn.docsearch_css"https://cdn.jsdelivr.net/npm/@docsearch/css@4.5.0/dist/style.css"
theme.cdn.docsearch_js"https://cdn.jsdelivr.net/npm/@docsearch/js@4.5.0/dist/umd/index.js"

Site configuration · Advanced configuration

On this page

Base defaults and template overridessitenavhometopasidepageposttheme_colordisplay_modefontindex_post_listrelated_postexpireright_menucopymermaidcharttypeitconsoletranslaterightsidefootererrorpagecapsulemusicmeting_apikeyboardlazyloadloadinghighlightlightboxmemorialkatexpwacommenttwikoowalinevalineartalkgiscussearchenvelopebrevityrecent_commentsverify_siteextendscdnRelated guides
云小站官方上云
云服务精选

云小站官方上云

稳定可靠，全球部署，助力企业数字化转型

云服务精选 · 云小站官方上云

稳定可靠，全球部署，助力企业数字化转型