One

主题

00:00:00
2025-03-102025-09-05博客搭建Teek
5776
27.8m
0

文章发布较早，内容可能过时，阅读注意甄别。

Teek待办 ​

任务待办 ​

目录 ​

[toc]

优先待办 ​

Teek@1.4.6-2025.8.31待办清单： 1.首页壁纸上划 效果 2.autoformatter插件默认支持rewrite（清空permalink、强制注入/一级前缀/随机uid）、支持文章封面功能（清空coverimg、强制注入coverimg） 3.无侧边栏的文章 顶部有背景大图； 4.二丫不算子待实现 今日访问人数、今日访问量，昨日访问人数、昨日访问量 5.侧边卡片栏 需新增 最新评论 模块 6.需求：强加密；（和微信登录绑定等） 7.代码优化、性能优化、动画优化

  1. 🔨bug：首页，滑到最底部footer后，稍等几秒，会被强制网上滑动一下的。 （不知道是不是底下的小熊给影响了）

📌王嘉祥 开源的zola-theme-jiaxiang.wang主题（基于rust的zola主题，风格移植自张洪Heo），性能地表最强，体验无比丝滑的 静态ssg类型博客。为何如此丝滑？ ​

基于 zola-theme-jiaxiang.wang , 按voding思想（知识库和博客 2合一）二开新主题，力求达到和Teek一样的效果😜（理想状态）。

博客地址：blog.jiaxiang.wang

仓库地址：zola-theme-jiaxiang.wang

主题简单demo：theme.jiaxiang.wang

其它文章

回馈社区，本站博客主题正式开源！

zola-theme-jiaxiang.wang 主题介绍

从0到1：回顾建站历程

展示你独特的一面，个人主页主题正式开源！

🍀超级丝滑的页面滑动效果 ​

https://lisir.me/ 基于vitepress https://www.vvhan.com/article/Lenis-in-Astro 基于Astro

的确，这2个主题的页面滑动起来很丝滑，可以考虑给咋teek抄过来。

2025年9月5日记录。

image-20250905080549349

https://lisir.me/ 基于vitepress ​

image-20250904193225727

https://www.vvhan.com/ 基于Astro ​

滚动起来很丝滑

2025年8月26日 威威发现

https://www.vvhan.com/article/Lenis-in-Astro

image-20250826210809522

  • 效果

image-20250826210829371

bing搜索VitePress主题 ​

image-20250904211448837

image-20250904211500502

如何推广 Teek ​

给Teek录制推广视频 b站 ​

ai配音

bug-文章数量 和 不显示在首页 情况 ​

VitePress可视化配置客户端工具 ​

https://www.bilibili.com/video/BV1ki421y7uV/?spm_id_from=333.337.search-card.all.click&vd_source=77325423ced14ef15b0723db235167e3

image-20250904203349231

image-20250904210139501

image-20250904210114659

加个配置面板-但是是本地缓存的 ​

image-20250904211720541

image-20250904211758304

是否应该给teek加后台？📢 ​

方案1：无需后台

​ Teek-one模板使用文档写得详细点，只要有手，完全就足够了；

方案2：需要后台

​ 对不懂代码的小白友好些；

NOTE

  1. 一般能使用博客的基本都是懂点linux基础知识的，并且都有手。那么，方案1-无需后台，这个基本就满足99%的用户了。
  2. 另外，多了解下代码，也会对Teek主题更加熟悉一点，想二开或者自定义一些东西就更容易些。
  3. 不然，多开发一套后台，也浪费精力，有这些精力，作者可以腾出时间来处理好多 todo list了。
  4. 万一后面又换新的ssg了呢，例如说zola那个rust写的。😉

因此，基于以上，Teek不推荐开发后台！ --2025年9月4日

扩展：

image-20250904212211268

image-20250904212234551

image-20250904212251873

image-20250904212313713

动态路由问题 ​

已发布issue

https://github.com/Kele-Bingtang/vitepress-theme-teek/issues/142

你的项目使用了动态路由么？我说的是 https://vitepress.dev/zh/guide/routing#dynamic-routes 这个功能，用【路由模板路径加载器】和【路由模板】来渲染动态的文档。

友链 和 网站导航 选择2 选1 ？ ​

image-20250904192448027

image-20250904192504447

时光友链的 2个问题 ​

01.可以让 这个友链组件 也支持 右上角 弄个备注，会友好些

image-20250904192158124

image-20250904192207693

image-20250904192211749

02.居中

image-20250904192232999

image-20250904192249665

image-20250904192258011

twikoo-无服务器部署 vercel 钉钉通知 ​

image-20250828052045476

vp侧边栏风格 ​

vp默认 ​

https://vitepress.dev/zh/guide/what-is-vitepress

image-20250904202417730

Teek风格 ​

https://vp.teek.top/guide/intro.html

image-20250904202328571

Teek-one风格 ​

https://onedayxyy.cn/teek/teek-one

image-20250904202350730

https://lisir.me/风格 （有自己侧边栏 配置） ​

https://lisir.me/

image-20250904202203146

image-20250904202802969

image-20250904202850024

自定义css侧边栏 ​

image-20250827205035999

image-20250827205220551

image-20250827205226352

image-20250827205233281

👀

image-20250827205359365

https://vitepress.yiov.top/configuration.html

https://lisir.me/Notes/Job/求职扫盲/00.专业术语

image-20250827205418179

image-20250827205629085

👀待处理-cnb algolia配置 ​

image-20250827204845781

image-20250827204852691

🔴5级目录时permalink失效问题 ​

image-20250827181856107

移动端 feature和文字、箭头的bug ​

换成 小火箭 风格 ​

image-20250825230531712

支持 分享带图文 小卡片 ​

移除移动端右下角 几个图标 ​

提供一个全配置的config.template.ts 文件 ​

文档风格 & 博客风格 刷新失效问题 ​

博客默认是文档风格，但是选择博客卡片等风格后，再次刷新又恢复到文档风格了。 这个看起来不是很合理哦，体验下来也有点奇怪。

autoformatter插件改一级前缀 ​

image-20250825082345002

image-20250825082501809

image-20250825082513663

bug ​

我的首页会卡顿？ ​

image-20250824061437364

!

威威的：

!

image-20250824061747303

image-20250824061851795

image-20250824061902848

image-20250824061912817

image-20250824061919978

image-20250824062013560

image-20250824062021314

image-20250824062029614

image-20250824062036042

!

image-20250824062105424

image-20250824062110126

!

image-20250824062201508

image-20250824062205717

image-20250824062221555

image-20250824062225569

!

image-20250824062403773

image-20250824062424720

image-20250824062428900

image-20250824062435980

image-20250824062500741

image-20250824062548648

image-20250824062626439

image-20250824062647235

image-20250824062659890

！

image-20250824063208070

image-20250824063247267

image-20250824063352422

待优化 ​

另外，这个壁纸背景为白色的，导航栏文字，feature的文字，都看不清了。 感觉🉐再优化下，要么换壁纸，要么加代码优化[捂脸]

image-20250824061132997

🔨bug：f11壁纸模式后，出现白屏，之前版本都是正常的，只是无法禁用打字机、波浪、博客名称等效果。 ​

故障现象：

Teek@1.4.4-2025.8.23 测试现象；

image-20250824053453985

🔨bug：首页，滑到最底部footer后，稍等几秒，会被强制网上滑动一下的。 威威博客也有这个问题。 （不知道是不是底下的小熊给影响了） ​

2025年8月22日发现

Teek@1.4.3-2025.8.18 环境。

🔨bug：首页刷新后，文章列表会白一下，侧边卡片不会 ​

Teek@1.4.3-2025.8.18 环境。

2025年8月20日测试。

1

image-20250824060703482

image-20250824060725938

image-20250824060747459

！

image-20250824060818042

image-20250824060842268

image-20250824060911787

！

image-20250824061011152

image-20250824061051970

image-20250824061204526

image-20250824061226341

!

image-20250824061300066

image-20250824061306789

image-20250824061313589

!

image-20250824061400453

首页bug ​

2025年7月21日提出。

image-20250721192905721

image-20250721192915557

导航栏会跳一下 ​

  • 故障现象

image-20250731194726738

这个大佬解决了这个问题：

image-20250731194811431

image-20250731194844421

image-20250731194926995

image-20250731194931796

image-20250731195009357

image-20250731195016734

这个permalink是插件https://vp.xiaoying.org.cn/pages/47a27c

image-20250731215008331

image-20250731215109235

文章permalink问题 ​

  • 问题

image-20250721121150067

  • 其它

image-20250721121452883

image-20250721121501154

Teek彩带体验不如vdoing ​

提出问题

bash
teek最近实现的彩带使用下来感觉体验还是不如vdoing，彩带会影响阅读文章体验的，群主可以看看之前你说的“两层背景，一个灰底，一个文章页白底，然后彩带就在灰底之上，白底之下”，这个teek能实现不，效果会好很多。

vdoing彩带效果：https://wiki.onedayxyy.cn/

没彩带的话，网站/文章 界面 会显得太过单调，但是有了彩带后，彩带要不能穿透文章正文的，不然会影响阅读文章时专注度的。

vdoing彩带效果：

image-20250515212428613

Teek彩带效果：

image-20250515212441491

测试过程

image-20250515213427274

主题面板用第四个尺寸（文档有点窄，不灵活）

image-20250515213144980

image-20250515213201178

image-20250515213042164

自己测试的实际效果：

image-20250515212926470

image-20250515212937016

image-20250515213237160

image-20250515213252702

主题面板用第3个尺寸（彩带体验不太好，直接穿插出去了）

image-20250515212441491

需求 ​

公告卡片没有动画效果 ​

image-20250824060556695

首页文章 宽度填充问题 ​

2025年8月24日测试。

  • 问题现象

image-20250824060125231

image-20250824060130212

image-20250824060135747

image-20250824060215339

image-20250824060238996

image-20250824060306172

image-20250824060337082

image-20250824060342186

image-20250824060414927

image-20250824060422444

image-20250824060435861

image-20250824060446084

文章封面-不是随机排序-而是按图片顺序赋值 ​

这段代码，是把指定图片随机作为文章封面。能不能改下代码，把随机修改为按图片顺序给文章添加封面？

不然很容易造成相邻博客的封面图一样，有点丑。

image-20250819072457410

多种颜色 ​

image-20250819072108258

【置顶📌】Teek支持 全文搜索meilisearch ​

image-20250316093223649

image-20250316093249974

之前vdoing的时候，用的是 https://github.com/meilisearch/vuepress-plugin-meilisearch 这个插件

https://wiki.eryajf.net/pages/dfc792/

image-20250316093337274

【置顶📌】以_下划线开始的文件/目录被忽略构建 ​

docusaurus就可以支持这个。

【置顶📌】文章右侧目录具有展开/收缩小按钮 ​

例如这个效果：

image-20250719094456217

【置顶📌】文章右侧目录可以往宽拉伸 ​

（vp不支持🤣）

  • 2025年5月14日记录

image-20250514195803012

2025年3月18日记录。

  • 需求

如果文章目录的这个竖线能手动拉宽的话就更好了哈哈，不然文章目录是啥都不知道

image-20250318211449322

image-20250318211437111

【置顶📌】自建不算子 且 希望可以按文章的permalink来识别浏览量 ​

  • 提出问题

image-20250515212540164

image-20250515212554839

空模板 ​

image-20250813064258924

壁纸网上滑动的效果 ​

2025年8月6日记录

image-20250806100324624

效果：

image-20250806100549251

用自建不算子替换51la ​

2025年7月21日提出。

  • 需求

image-20250721121002571

image-20250721121008149

image-20250721121019560

网站标签页如何显示特定内容 ​

2025年7月18日提出问题。

  • 需求

自己网站标签页如何显示特定内容？

https://liuyuyang.net/

image-20250718034129190

image-20250718034145001

  • 自己配置后，存在的问题

image-20250718034216983

现象：。。。

image-20250718034242763

导航栏分组字体问题 ​

2025年7月3日提出。

  • 故障

image-20250703181700519

image-20250703181709018

image-20250719122028096

新增（电子时钟、卡随机文章、公告栏）卡片 ​

bash
个人简介 Ok
公告通知（待上线）
精选文章 ok 
随机文章（待上线）
文章分类 ok 
热门标签 ok 
友情链接 ok 
热门评论（待上线）
电子时钟（待上线）
站点信息 ok

赞赏风格 ​

案例：蘑菇社区 ​

image-20250815054654608

案例：HEO ​

https://blog.zhheo.com/

image-20250815054702385

公告栏还是建议放到个人简介栏下方 ​

  • 需求

image-20250316091855873

案例：小张的个人博客 ​

http://mrzym.top/#/home

image-20250815055346064

案例 ​

image-20250316091902934

https://kuailemao.xyz/

image-20250316091930846

案例 ​

https://masofod.github.io/

image-20250318210946287

案例 ​

https://docusaurus.io/

image-20250815054104565

希望支持强加密 ​

当前功能：

目前teek支持文章/站点登录，但是是弱加密，很容易被破解，希望能支持引入后端，支持强加密；

案例：《前端开发实战派》 ​

（2025年6月9日记录）

  • 某个目录加密后有图片提示；
  • 支持强加密；
  • 也支持注册；

https://ebook.ruidoc.cn/topay.html

image-20250609121611323

image-20250609121621579

案例：《VitePress会员主题》 ​

（2025年7月31日收录）

https://vitepress.mosong.cc/

image-20250731193839542

是否能让导航栏所有的子菜单所在的目录 按一级目录渲染呢？ ​

  • 需求

是否能让导航栏所有的子菜单所在的目录 按一级目录渲染呢？

  • 背景

我的Teek的docs目录下md笔记目录嵌套结构为如下：

bash
10.运维
	10.linux
	20.docker
20.前端
	10.html
	20.css
30.编程
	10.Python
	20.Go
……

我的 30.编程/10.Python 目录在2级目录，能不能实现在网站导航栏点击进后，出现的是一级目录的效果，就是这个目录下没其他知识点目录，不然用户阅读文章时，会被其它目录的内容干扰到。并且，我们底层维护md文档时，也可以按对应大的知识点来存放相关知识点目录，很友好。

image-20250526220720200

image-20250526220736305

方案1

image-20250526221125439

方案2

https://vitepress-sidebar.cdget.com/zhHans/

image-20250526221326438

回到顶部小火箭 ​

案例：《记得勇敢 写的代码》 ​

https://vp.xiaoying.org.cn/pages/47a27c 2025年7月31日记录

image-20250731194240252

image-20250731194510513

代码块里代码 切换自动换行按钮 ​

image-20250316063852782

image-20250316063910950

https://hydoc.netlify.app/docs/Blog/tutorial/Ruyu-Blog/###14部署rabbitmq

image-20250316064139472

image-20250316064448824

image-20250316064456990

image-20250316064503920

image-20250316064510404

移动端，这个箭头和文字也重合了 ​

2025年7月19日提出。

image-20250719122123704

image-20250719122057694

如何让这个配置保持默认呢？ ​

  • 需求

2025年7月20日提出

image-20250720175253780

好看的图标库 ​

2025年7月21日提出。

用于导航栏选项。

image-20250721192953839

这个gg2提交后，怎么不能直接生成封面图呢？ ​

问题：这个gg2提交后，怎么不能直接生成封面图呢？ 需要执行下td才行。

推手送后：

footer下的图标风格得统一下 ​

  • 问题

2025年7月22日提出。

footer下的图标也得统一下，现在这风格都不一致

image-20250722180122795

image-20250722180128031

自建首页 天气/位置/日期 接口 ​

  • 问题

2025年7月22日提出。

博客服务还的是自建，依赖免费的各种问题哈哈

image-20250722180254514

image-20250722180307041

关于我页面需优化 ​

2025年7月25日提出。

image-20250725042310260

image-20250725042314826

文章开头ai自动输出本文摘要功能 ​

案例-张洪Heo （2025年7月25日记录）

https://blog.zhheo.com/p/v4jy226i.html

站内搜索 功能 ​

案例-aubyn.github.io ​

https://aubyn.github.io/ （2025年7月25日记录）

https://jenkinsguide.opsre.top/

看到一个老哥的页面有个搜索功能，感觉不错，要了代码。有需要的可以抄一下

代码在这次变更里：https://cnb.cool/opsre/JenkinsGuide/-/commit/fc04d6afd8782a5919a886886f0b43774f13f93e?tab=diff

自己Teek待更新。

案例-张洪Heo ​

https://blog.zhheo.com/

相册 ​

案例-张洪Heo ​

https://plog.zhheo.com/

音乐 ​

案例-张洪Heo ​

https://music.zhheo.com/?id=8668419170&server=tencent

鼠标新样式 ​

  • 案例

https://note.noxussj.top/?s=y6

image-20250318211648094

生活感悟小卡片 ​

  • 需求

image-20250316064303186

image-20250316064311924

image-20250316064319663

https://blog.grtsinry43.com/thinkinghttps://wiki.onedayxyy.cn/ideal-website

image-20250316064418407

image-20250316064535394

情侣相册 ​

朋友圈 ​

-将md渲染成类似朋友圈动态功能

好看的导航页(rainbow渐变色) ​

  • 需求

https://yiov.top/guide/

image-20250316065736822

image-20250316065753411

坑人的阿里云cdn ​

经测试，发现是head 代码产生的bug；。。。。。

  • 故障记录

image-20250628123057610

image-20250628123119013

bash
群主，有空了拉下我仓库，帮我排查下这个问题哦：

故障现象：
基于你的vitepress-theme-teek-docs-template 做的这个简约版模板，其他都没啥问题了，但是只要在head里加入这3段代码里的其中一段，我把打包好的静态文件推送到云服务器后（网站加了阿里云cdn），就会出现这个问题；

试了好几次，hyde模板也会有这个问题，加了阿里云cdn就会有这个问题，去掉阿里云cdn，这个问题就会消失；  

奇怪，就是不知道哪里问题影响了 @Teeker | notes.teek.top
  • 结论

image-20250628123207123

image-20250628123216552

Teek docker部署/升级 ​

自己模板的rss/优化 待配置 ​

需要从hyde模板里拿取。

2025年6月9日记录。

案例：

效果：

image-20250609211631965

文档：https://teek.seasir.top/Rss

image-20250609211704131

image-20250609211819877

typora和teek渲染后换行不一致问题 ​

  • 存在问题

2025年7月19日提出。

还有个问题，typora里能正常显示换行内容，但是teek渲染后的页面，这些换行都没了，对用户不太友好。记得其它类型的静态构建站点都是一样的现象，这个有办法和typora里的换行保持一致吗？

image-20250719111925499

image-20250719111931463

image-20250719111936625

为何

Teek性能优化、代码优化、细节优化、动画优化 ​

构建耗时

警告

VitePress打包542篇md 快耗时5min，也挺久的……没更快的方法了嘛？

image-20250315101653536

支持按需引入组件

🍊群主回答：支持按需引入组件

并行打包参数

🍊并行打包参数

image-20250315102056587

image-20250315102125176

image-20250316091742860

image-20250316091800514

最近更新