Skip to content
0

修改为默认博客风

修改为默认博客风

环境

Teek@1.5.0-2025.9.23

自己的开源库《vitepress-theme-teek-one》 --(克隆自 作者Teeker的文档风开源库《vitepress-theme-teek-docs-template》)

2025年9月24日测试

背景

作者提供的开源库默认是文档风,如何设置它为博客风呢?

image-20250923225025365

这里面干净的空空如也哇……🤣

image-20250924064943229

配置

说明

以下配置是在 群主 文档风开源库《vitepress-theme-teek-docs-template》下,将文档风修改为博客风的一些配置,请阅读。

1、删除原有的.vitepress目录下所有内容

image-20250924072708986

2、拷贝开发库里的内容过来

拷贝开发库里的内容过来,放到如下docs\.vitepress目录下:

image-20250924072746966

3、配置一些地方

配置如下6个文件:

bash
docs\.vitepress\config.ts报错
docs\.vitepress\theme\config\teekConfig.ts报错
docs\.vitepress\teekConfig.ts报错
docs\.vitepress\theme\index.ts报错

docs\.vitepress\theme\composables\useRibbon.ts报错
docs\.vitepress\theme\components\ConfigSwitch.vue报错

01处报错:

image-20250924073052655

按注释修改:

编辑docs\.vitepress\config.ts文件:

bash
import { version } from "vitepress-theme-teek/es/version";

image-20250924073310698

02处报错:

image-20250924073112033

编辑docs\.vitepress\theme\config\teekConfig.ts文件:

@teek修改为vitepress-theme-teek

bash
import type { TeekConfig } from "vitepress-theme-teek/config";

image-20250924073334215

03处报错:

image-20250924073403649

编辑docs\.vitepress\teekConfig.ts文件:

按注释提示修改:

image-20250924073427172

04处报错

再次运行测试:

报其它的错误:

image-20250924073532597

编辑docs\.vitepress\theme\index.ts文件:

按注释提示修改:

image-20250924073635190

修改好了:

image-20250924073751856

再次测试:

还是报错:(为啥呢,都已经使用在线版本了啊……)

image-20250924073814494

image-20250924074257278

和之前私有库做个对比?

image-20250924074348487

应该就是这里的问题:

https://vp.teek.top/guide/styles-plus.html#样式增强

image-20250924075040694

我先引入这些scss:

image-20250924075458191

再次运行,观察效果:

报其它错了哦:

image-20250924075536969

2处报错:

image-20250924075648690

05处报错

image-20250924075716903

编辑docs\.vitepress\theme\composables\useRibbon.ts文件:

之前私有库配置:

image-20250924075849410

修复拉:

bash
import { computed, type MaybeRef, toValue } from "vue";
import { isClient, useScopeDispose } from "vitepress-theme-teek";

image-20250924075936989

06处报错

image-20250924075754714

编辑docs\.vitepress\theme\components\ConfigSwitch.vue文件:

问题原因:

image-20250924121709583

修改后:

vue
import {
  TkThemeEnhanceBaseTemplate as BaseTemplate,
} from "vitepress-theme-teek";
import { useClipboard, useStorage } from "vitepress-theme-teek";

image-20250924121801790

以上全部修改完成。

4、验证

image-20250924122707301

扩展(测试过程,可忽略)

拷贝本地的teekConfig.template.ts文件(测试步骤,可忽略)

对原来的teekConfig.ts文件做好备份(teekConfig.ts.bak)

拷贝teekConfig.template.ts文件到teekConfig.ts

image-20250924070259272

配置完后,再次运行:

依旧没博客风,但是多了一个公告弹窗栏:

image-20250924070439420

image-20250924070453157

只能拷贝作者的Teek开发库里相关的代码了

image-20250924070713150

image-20250924070844435

image-20250924070859389

🚩开始切换

🚩删除原有的.vitepress目录下所有内容

image-20250924072708986

拷贝开发库里的内容过来

image-20250924072746966

🚩处理报错过程

直接运行后报错:

image-20250924072949173

01处报错:

image-20250924073052655

按注释修改:

bash
import { version } from "vitepress-theme-teek/es/version";

image-20250924073310698

02处报错:

image-20250924073112033

@teek修改为vitepress-theme-teek

bash
import type { TeekConfig } from "vitepress-theme-teek/config";

image-20250924073334215

03处报错:

image-20250924073403649

按注释提示修改:

image-20250924073427172

04处报错

再次运行测试:

报其它的错误:

image-20250924073532597

按注释提示修改:

image-20250924073635190

修改好了:

image-20250924073751856

再次测试:

还是报错:(为啥呢,都已经使用在线版本了啊……)

image-20250924073814494

image-20250924074257278

和之前私有库做个对比?

image-20250924074348487

应该就是这里的问题:

https://vp.teek.top/guide/styles-plus.html#样式增强

image-20250924075040694

我先引入这些scss:

image-20250924075458191

再次运行,观察效果:

报其它错了哦:

image-20250924075536969

2处报错:

image-20250924075648690

05处报错

image-20250924075716903

之前私有库配置:

image-20250924075849410

修复拉:

bash
import { computed, type MaybeRef, toValue } from "vue";
import { isClient, useScopeDispose } from "vitepress-theme-teek";

image-20250924075936989

06处报错

image-20250924075754714

问题原因:

image-20250924121709583

修改后:

vue
import {
  TkThemeEnhanceBaseTemplate as BaseTemplate,
} from "vitepress-theme-teek";
import { useClipboard, useStorage } from "vitepress-theme-teek";

image-20250924121801790

再次验证:OK啦。😜

image-20250924122707301

结束。

最近更新