卡片栏配置

homeCardSort

• 类型：("topArticle"|"category"|"tag"|"friendLink"|"docAnalysis")[]
• 默认值：["topArticle","category","tag","friendLink","docAnalysis"]

首页卡片的位置排序，当设置了 homeCardSort但没有全部补全内容，Teek 会将剩余内容按照 homeCardSort的顺序进行添加。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({homeCardSort:["topArticle","category","tag","friendLink","docAnalysis"],});

index.md

---tk:homeCardSort:- topArticle- category- tag- friendLink- docAnalysis---

bgColor

• 类型：string[]
• 默认值：["#e74c3c","#409EFF","#DAA96E","#0C819F","#27ae60","#ff5c93","#fd726d","#f39c12","#9b59b6"]

主题背景色，用于精选文章卡片的 top + sticky功能和标签卡片的标签，背景色按顺序显示。

当在文章页的 frontmatter配置时，如果颜色值有 #号时请添加引号。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({bgColor:["#e74c3c","#409EFF","#DAA96E","#0C819F","#27ae60","#ff5c93","#fd726d","#f39c12","#9b59b6"],});

index.md

---tk:bgColor:- "#e74c3c"- "#409EFF"- "#DAA96E"- "#0C819F"- "#27ae60"- "#ff5c93"- "#fd726d"- "#f39c12"- "#9b59b6"---

blogger

博主信息，显示在首页左边第一个卡片。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({blogger:{name:"天客",avatar:"https:slogan:"朝圣的使徒，正在走向编程的至高殿堂！",shape:"square",},});

index.md

---tk:blogger:name:天客avatar:https:slogan:朝圣的使徒，正在走向编程的至高殿堂！shape:square---

更多配置项

interfaceBlogger{name:string;avatar:string;slogan?:string;shape?:TkAvatarProps["shape"] |"circle-rotate";}

topArticle

精选文章卡片配置。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({topArticle:{enabled:true,limit:5,autoPage:false,pageSpeed:4000,},});

index.md

---tk:topArticle:enabled:truelimit:5autoPage:falsepageSpeed:4000---

更多配置项

interfaceTopArticle{enabled?:boolean;title?:string|((svg:string) =>string);emptyLabel?:string;limit?:number;autoPage?:boolean;pageSpeed?:number;}

category

分类卡片配置。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({category:{enabled:true,limit:5,autoPage:false,pageSpeed:4000,},});

index.md

---tk:category:enabled:truelimit:5autoPage:falsepageSpeed:4000---

更多配置项

interfaceCategory{enable?:boolean;path?:string;pageTitle?:string|((svg:string) =>string);homeTitle?:string|((svg:string) =>string);emptyLabel?:string;limit?:number;autoPage?:boolean;pageSpeed?:number;}

tag

标签卡片配置。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({tag:{enabled:true,limit:21,autoPage:false,pageSpeed:4000,},});

index.md

---tk:tag:enabled:truelimit:5autoPage:falsepageSpeed:4000---

更多配置项

interfaceTag{enabled?:boolean;path?:string;pageTitle?:string|((svg:string) =>string);homeTitle?:string|((svg:string) =>string);emptyLabel?:string;limit?:number;autoPage?:boolean;pageSpeed?:number;bgColor?:string[];}

friendLink

友情链接卡片配置。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({friendLink:{enabled:true,list:[{avatar:"/img/bg1.jpg",name:"测试1",desc:"这是一个友链测试1",link:"https:{avatar:"/img/ui.png",name:"测试2",desc:"这是一个友链测试2222111啊"},{avatar:"/img/web.png",name:"测试3测试3测试3测试3测试3测试3",desc:"这是一个友链测试3"},{avatar:"/img/more.png",name:"测试4",desc:"这是一个友链测试4"},{avatar:"/img/ui.png",name:"测试22",desc:"这是一个友链测试2"},{avatar:"/img/other.png",name:"测试11",desc:"这是一个友链测试1"},{avatar:"/img/more.png",name:"测试44",desc:"这是一个友链测试4"},{avatar:"/img/web.png",name:"测试33",desc:"这是一个友链测试3"},{avatar:"/img/other.png",name:"测试111",desc:"这是一个友链测试1"},{avatar:"/img/web.png",name:"测试333",desc:"这是一个友链测试3"},{avatar:"/img/more.png",name:"测试444",desc:"这是一个友链测试4"},{avatar:"/img/ui.png",name:"测试222",desc:"这是一个友链测试2"},],limit:5,autoScroll:false,scrollSpeed:2500,autoPage:false,pageSpeed:4000,},});

index.md

---tk:friendLink:enabled:truelist:- avatar:/img/bg1.jpgname:测试1desc:这是一个友链测试1link:https:- avatar:/img/ui.pngname:测试2desc:这是一个友链测试2222111啊limit:5autoScroll:falsescrollSpeed:2500autoPage:falsepageSpeed:4000---

更多配置项

interfaceFriendLink{enabled?:boolean;list?:{name:string;avatar?:string;desc?:string;link?:string;alt?:string;}[];title?:string|((svg:string) =>string);emptyLabel?:string;limit?:number;autoScroll?:boolean;scrollSpeed?:number;autoPage?:boolean;pageSpeed?:number;}

docAnalysis

站点信息卡片配置。

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({docAnalysis:{enabled:true,createTime:"2021-10-19",wordCount:true,readingTime:true,statistics:{provider:"busuanzi",siteView:true,pageView:true,siteIteration:2000,pageIteration:2000,},overrideInfo:[{key:"lastActiveTime",label:"活跃时间",value:(_,currentValue) =>(currentValue +"").replace("前",""),show:true,},],appendInfo:[{key:"index",label:"序号",value:"天客 99"}],},});

index.md

---tk:docAnalysis:enabled:truecreateTime:2021-10-19wordCount:truereadingTime:truestatistics:provider:"busuanzi"siteView:truepageView:trueappendInfo:- key:"index"label:"序号"value:"天客 99"---

更多配置项

interfaceDocAnalysis{enabled?:boolean;title?:string|((svg:string) =>string);createTime?:string;wordCount?:boolean;readingTime?:boolean;statistics?:{provider?:""|"busuanzi";siteView?:boolean;pageView?:boolean;iteration?:boolean;siteIteration?:number;pageIteration?:number;};overrideInfo?:(Omit<PartialKey<DocAnalysisInfo,"label">,"value">&{value?:(originValue:string|number,currentValue?:string|number) =>string;})[];appendInfo?:(Omit<DocAnalysisInfo,"key">&{key:string})[];}interfaceDocAnalysisInfo{key:|"totalPosts"|"weekAddNum"|"monthAddNum"|"runtime"|"totalWordCount"|"lastActiveTime"|"viewCount"|"visitCount"|string;label:string;value:string;show?:boolean;}

提示

如果想开启访问量、访客数统计，请使用 statistics配置项，目前支持 busuanzi统计方式。

当想修改站点信息内置的信息时，可以使用 overrideInfo配置项，该配置项是一个数组对象，对象的 key为信息标识，value是一个函数，接收两个参数 originValue和 currentValue：

• originValue：站点信息卡片的原始值，如创建时间为 2021-10-19
• currentValue：站点信息卡片当前渲染的值，如创建时间渲染的值为 N 天前

比如想将 文章数目改为 文章总数目：

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({docAnalysis:{overrideInfo:[{key:"totalPosts",label:"文章总数目"}],},});

比如想隐藏最后活动时间：

config.ts

import{defineTeekConfig } from"vitepress-theme-teek/config";constteekConfig=defineTeekConfig({docAnalysis:{overrideInfo:[{key:"lastActiveTime",show:false}],},});

key 可选值如下：

• totalPosts：文章总数
• weekAddNum：近一周新增
• monthAddNum：近一月新增
• runtime：已运行时间
• totalWordCount：本站总字数
• lastActiveTime：最后活动时间
• viewCount：本站被访问了
• visitCount：本站曾来访过