Skip to content

themeConfig参数说明

ts
// config.mts
export default defineConfigWithTheme<ThemeConfig>({
  // ...
  themeConfig: {
    // ...
  }
})

author

  • 类型:string
  • 要求:可选
  • 作者名称

docCount

  • 类型:number
  • 要求:可选
  • 默认值:10
  • 博客首页文章列表的每页展示文章数量

startYear

  • 类型:number
  • 要求:可选
  • 博客起始时间

headImage

  • 类型:string
  • 要求:可选
  • 头图url

headStyle

  • 类型:object
  • 要求:可选
  • 头图样式

authorImage

  • 类型:string
  • 要求:可选
  • 作者头像url

umami

  • 要求:可选
  • 站点统计

umamiToken

  • 类型:string
  • 要求:必选
  • umamiToken,用于站点统计

umamiUrl

  • 类型:string
  • 要求:必选
  • umamiApi地址,用于站点统计,在开发环境下不启用,需要使用代理

umamiId

  • 类型:string
  • 要求:必选
  • umami被统计网站的id

comment

  • 要求:可选
  • 评论配置

repo

  • 类型:string
  • 要求:必选
  • 仓库地址,用于评论

repoId

  • 类型:string
  • 要求:必选
  • 仓库Id,用于评论

categoryId

  • 类型:string
  • 要求:必选
  • 分类id,用于评论

reactionsEnabled

  • 类型:0 | 1
  • 要求:必选
  • 默认值:1
  • 启用主帖子上的反应

fall

  • 要求:可选
  • 在屏幕上渲染一些装饰效果

image

  • 类型:month | BuiltinImageName | string
  • 要求:必选
  • 渲染的图片。如果使用 month,将根据月份自动选择 @night-tea/sakura-fall 内置的 12 张水彩素材。
  • 也可以指定内置素材名,或传入自定义图片 URL。

count

  • 类型:number
  • 要求:可选
  • 默认值:15
  • 渲染数量

iconTags

  • 类型:boolean
  • 要求:可选
  • 默认值:false
  • 采用 shields.io图片作为标签风格
  • 参考网址1
  • 参考网址2
  • iconTagStyle
  • 类型:object
  • 要求:可选
  • 默认值:{height:20px}
  • 标签样式

blogList

  • 要求:可选
  • 博客列表设置,一旦设置会给列表设置背景图片
  • 后续会增加自定义图片设置

imagesSize

  • 类型:small | medium | large
  • 要求:可选
  • 默认值:medium
  • 背景图片大小

imagesLocation

  • 类型:left | right | center | reversal (左右交替) | leftRight (左右)
  • 要求:可选
  • 默认值:center
  • 背景图片位置

memo

  • 要求:可选
  • 碎片笔记

memoUrl

  • 类型:string
  • 要求:必选
  • 碎片笔记的接口地址

memoUser

  • 类型:string
  • 要求:必选
  • 笔记的用户名称

memoToken

  • 类型:string
  • 要求:必选
  • 接口token

route

页面内路由跳转

category

  • 类型:string
  • 要求:可选
  • 默认值:category
  • 分类跳转的页面(md),只需要名称,不需要文件后缀

tag

  • 类型:string
  • 要求:可选
  • 默认值:tag
  • 标签跳转的页面(md),只需要名称,不需要文件后缀
  • filter

  • 类型:string
  • 要求:可选
  • 默认值:filter
  • 分类和标签跳转的页面(md),只需要名称,不需要文件后缀
夜茶 2020 ~ 2026