frontmatter 配置
frontmatter 配置 frontmatter 支持基于页面的配置。在每个 Markdown 文件中，可以使用 frontmatter 配置来覆盖 主题配置 中的大部分选项。 首页配置 description Teek 提供了 description 选项，用于在首页 Banner 展示一些描述信息，您可以通过 tk.description 或者 tk.banner.description...
10.配置
2025年9月28日
浏览量：--
共找到 14 篇文章
显示 14 / 14 篇文章
功能页配置
功能页配置 私密文章（登录页） 什么是登录页？在导航栏 功能页 -> 登录页 点击查看效果。 您可以通过 teek-login-page 插槽自定义登录页。 使用登录页需要 2 个步骤： - 创建一个登录页，如何创建请看 登录页 - 开启私密文章监听 `ts // .vitepress/config.mts import { define Teek Config } from...
全局配置
全局配置 全局配置是影响范围较广的配置。 teek Theme - 类型：boolean - 默认值：true 是否启用主题，如果为 false，则不会启用主题的 99% 功能，只保留如下功能： - 自动添加侧边栏 - 自动添加一级标题 - 自动添加永久链接 - 文档内容分析（作者、创建时间、文章字数、预计阅读时间等信息） - 锚点滚动 - 深色/浅色模式过渡动画 ::: tip...
Banner 配置
Banner 配置 banner 首页 Banner 配置，位于首页顶部。 ::: tip 在首页 index.md 的 frontmatter 中，description 配置项除了 tk.banner.description 设置，也可以使用 tk.description 设置。 ::: ::: code-group `ts [config.mts] //...
文章列表配置
文章列表配置 post 文章列表配置。 ::: code-group `ts [config.mts] // .vitepress/config.mts import { define Teek Config } from "vitepress-theme-teek/config"; const teek Config = define Teek Config({ post: { post...
卡片栏配置
卡片栏配置 home Card Sort - 类型：("top Article" | "category" | "tag" | "friend Link" | "doc Analysis")[] - 默认值：["top Article", "category", "tag", "friend Link", "doc Analysis"] 首页卡片的位置排序，当设置了 home Card Sort...
页脚配置
页脚配置 social 社交信息配置，通常为一个社交图标，点击后将会跳转到社交软件的个人主页。 ::: tip social 在卡片栏的博主信息区和页脚都会生效。 ::: ::: code-group `ts [config.mts] // .vitepress/config.mts import { define Teek Config } from...
文章配置
文章配置 article Analyze 文章信息分析配置，分别作用在首页和文章页。 ::: tip 如果在 config.mts 中配置，则首页和文章页都生效。 文章页的图片点击可以预览，但是当图片元素的 class 里存在 no-preview，则不会触发预览，这对于兼容 Teek 的图片相关插件有所帮助。 ::: ::: code-group `ts [config.mts] //...
评论配置
comment 评论配置，目前内置 Giscus、Twikoo、Waline、Artalk 四种评论插件。 ::: tip 支持每个文章页配置不同的在评论区提供者 provider。 ::: ::: code-group `ts [config.mts] // .vitepress/config.mts import { define Teek Config } from...
插件配置
插件配置 vite Plugins 内置 Vite 插件配置。 Teek 内置的 Vite 插件详细介绍请看 Vite 插件。 ::: code-group `ts [config.mts] // .vitepress/config.mts import { define Teek Config } from "vitepress-theme-teek/config"; const teek...
主题增强拓展
主题增强拓展 在 主题增强 中介绍了主题风格的使用，而不同的用户有不同的审美需求，因此 Teek 支持用户修改自带的主题模式，也可以拓展全新的主题模式。 主题风格 主题风格修改 Teek 使用 Vite Press 的 css var 变量来实现主题风格。当切换尺寸时，Teek 会修改 html 标签的 theme-color 属性，进而改变 css var 变量，从而达到修改主题风格的效果。...
目录页配置
目录页配置 什么是目录页？可以在本文章最上方的面包屑里点击 指南 查看效果。 ::: warning 目录页数据来源于 vitepress-plugin-catalogue 插件实现，如果禁用了该插件，目录页将不会生效。 ::: 目录页本质上是一个 Markdown 文档，因此可以与其他文档一起放到任意目录下，如： ::: code-group `sh [当前文件夹] {4,10,15} . │...
功能页配置
功能页配置 Teek 支持构建分类页、标签页、归档页，文章清单页、登录页、风险链接提示页，这些页面本质上是一个 Markdown 文档，通过在 frontmatter 配置来开启功能，因此可以与其他文档一起放到任意目录下，并且和正常 Markdown 文档一样可以进行内容编写。 但是 Teek 建议放在 @pages 目录下，因为 Teek 不会对 @pages...
配置简介
配置简介 ::: tip Teek 内置了大量的主题配置，但不会影响 vitepress 原来的配置，两者是独立生效的。 ::: 主题的配置通常添加在 .vitepress/config.mts 文件中。 如下是一份简单的模板： `ts // .vitepress/config.mts import { define Config } from "vitepress"; import {...