跳到主要内容
修改为默认博客风
博客 Teek

修改为默认博客风

1560 字 8 分钟 -- 阅读 -- 评论
最后更新于:

修改为默认博客风

环境

Teek@1.5.0-2025.9.23

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

2025年9月24日测试

背景

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

image-20250923225025365
图片1

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

image-20250924064943229
图片2

配置

说明

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

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

image-20250924072708986
图片3

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

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

image-20250924072746966
图片4

3、配置一些地方

配置如下6个文件:

1docs\.vitepress\config.ts报错
2docs\.vitepress\theme\config\teekConfig.ts报错
3docs\.vitepress\teekConfig.ts报错
4docs\.vitepress\theme\index.ts报错
5
6docs\.vitepress\theme\composables\useRibbon.ts报错
7docs\.vitepress\theme\components\ConfigSwitch.vue报错

01处报错:

image-20250924073052655
图片5

按注释修改:

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

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

image-20250924073310698
图片6

02处报错:

image-20250924073112033
图片7

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

将@teek修改为vitepress-theme-teek

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

image-20250924073334215
图片8

03处报错:

image-20250924073403649
图片9

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

按注释提示修改:

image-20250924073427172
图片10

04处报错

再次运行测试:

报其它的错误:

image-20250924073532597
图片11

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

按注释提示修改:

image-20250924073635190
图片12

修改好了:

image-20250924073751856
图片13

再次测试:

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

image-20250924073814494
图片14

image-20250924074257278
图片15

和之前私有库做个对比?

image-20250924074348487
图片16

应该就是这里的问题:

https://vp.teek.top/guide/styles-plus.html#%E6%A0%B7%E5%BC%8F%E5%A2%9E%E5%BC%BA

image-20250924075040694
图片17

我先引入这些scss:

image-20250924075458191
图片18

再次运行,观察效果:

报其它错了哦:

image-20250924075536969
图片19

2处报错:

image-20250924075648690
图片20

05处报错

image-20250924075716903
图片21

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

之前私有库配置:

image-20250924075849410
图片22

修复拉:

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

image-20250924075936989
图片23

06处报错

image-20250924075754714
图片24

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

问题原因:

image-20250924121709583
图片25

修改后:

1import {
2  TkThemeEnhanceBaseTemplate as BaseTemplate,
3} from "vitepress-theme-teek";
4import { useClipboard, useStorage } from "vitepress-theme-teek";

image-20250924121801790
图片26

以上全部修改完成。

4、验证

image-20250924122707301
图片27

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

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

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

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

image-20250924070259272
图片28

配置完后,再次运行:

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

image-20250924070439420
图片29

image-20250924070453157
图片30

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

image-20250924070713150
图片31

image-20250924070844435
图片32

image-20250924070859389
图片33

🚩开始切换

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

image-20250924072708986
图片34

拷贝开发库里的内容过来

image-20250924072746966
图片35

🚩处理报错过程

直接运行后报错:

image-20250924072949173
图片36

01处报错:

image-20250924073052655
图片37

按注释修改:

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

image-20250924073310698
图片38

02处报错:

image-20250924073112033
图片39

将@teek修改为vitepress-theme-teek

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

image-20250924073334215
图片40

03处报错:

image-20250924073403649
图片41

按注释提示修改:

image-20250924073427172
图片42

04处报错

再次运行测试:

报其它的错误:

image-20250924073532597
图片43

按注释提示修改:

image-20250924073635190
图片44

修改好了:

image-20250924073751856
图片45

再次测试:

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

image-20250924073814494
图片46

image-20250924074257278
图片47

和之前私有库做个对比?

image-20250924074348487
图片48

应该就是这里的问题:

https://vp.teek.top/guide/styles-plus.html#%E6%A0%B7%E5%BC%8F%E5%A2%9E%E5%BC%BA

image-20250924075040694
图片49

我先引入这些scss:

image-20250924075458191
图片50

再次运行,观察效果:

报其它错了哦:

image-20250924075536969
图片51

2处报错:

image-20250924075648690
图片52

05处报错

image-20250924075716903
图片53

之前私有库配置:

image-20250924075849410
图片54

修复拉:

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

image-20250924075936989
图片55

06处报错

image-20250924075754714
图片56

问题原因:

image-20250924121709583
图片57

修改后:

1import {
2  TkThemeEnhanceBaseTemplate as BaseTemplate,
3} from "vitepress-theme-teek";
4import { useClipboard, useStorage } from "vitepress-theme-teek";

image-20250924121801790
图片58

再次验证:OK啦。😜

image-20250924122707301
图片59

结束。

最新文章

文档导航