已完成2

最后更新于:

已完成

(已解决)目前hugo-teek换到默认侧边栏后,是有一定的Bug的,点击某个文档后,这个文档名称会往下缩进一下的,这个的修复下

(已解决)悬浮文章右侧目录后,怎么不显示 多余的内容了?(把之前功能修复丢了🤣)

2026年1月7日记录。

(已解决)文章右侧 的 左侧分界虚线怎么没了? 不然别人都不知道咋们的目录能左右拖动宽度。

2026年1月7日记录。

(已解决)(紧急重大bug、性能问题)当前的hugo-teek侧边栏体验很卡–>丢弃转teek语法这个步骤 & 使用hugo默认的短代码配置侧边栏

2026年1月7日记录。

https://lotusdocs.dev/docs/

https://www.docsy.dev/

https://imfing.github.io/hextra/

Hextra侧边栏用的hugo原生union .context.RegularPages .context.Sections 37行, teekhugo侧边栏弄了995行

已切换到hugo默认短代码了。

不可以再在目录/文档前加svg图标了。。。

gpt答复

结论

(已解决)(非常影响体验)总感觉当前hugo-teek的侧边栏体验,切换文件这个效果还是有点卡顿,是我站点文章里图片多导致的嘛? w3c这个就很轻。 应该是代码层的问题。。

2026年1月7日记录。

(已解决)侧边栏切换文件时整个侧边栏会刷新(@one)

2025年12月26日记录。

存在问题:

当前白木修复后的侧边栏切换文件时整个侧边栏会刷新,影响用户体验。

(已解决)告警容器里的图片语法没被正确渲染

image-20251220092420034

image-20251220092502282

(已解决)容器里反引号和链接语法hugo-teek没识别

2025年12月17日提出。

image-20251217213328326

ty里md内容:

image-20251217213404914

hugo-teek渲染效果:

image-20251217213430396

(已解决)文档的最后更新时间应该从 文档修改时间取值,当时是从commit时间取值的

2026年1月4日记录。

(已解决)(紧急重大bug):当前最新版本,侧边栏问题解决了50%,目前第一次点击进去后,侧边栏还是有问题,重新点击一个文件后,整个侧边栏才会正常,可以看下我这个录屏

2026年1月3日记录。

且,点击后,怎么其它目录也展开了,理想状况,是到当前页面,其它默认保持收缩状态。

(已解决)(bug)文章底部版权模块 文章链接 出现的是中文乱码

2026年1月3日记录。

(已解决)(优化)40.专题 下目录的数字序号没必要给显示出来哇,这个是排序用的

2026年1月3日记录。

(已解决)(优化)图片加阴影,hover后再出现蓝色边框(@白木)

2025年12月26日记录。

当前白木修改后的特性是:图片正常是蓝色边框,hover后蓝色边框消失了,不合理。

具体原因:

(已解决)(优化)个人头像hover效果需改进

2025年12月20日记录。

当前悬浮后,是顺时针旋转一次;

理想效果:hover后,先逆时针旋转一次,鼠标离开后,又转一圈恢复回来,这样效果会更友好点。

image-20251220085301605

(已解决)(优化)当前的h2级别目录最好也能往前移动下,会好看点

image-20251217215836793

hugo-teek的:

image-20251217215851095

teek的:

image-20251217215859545

(已解决)代码块需要优化下,加长最后一行距离底部边缘距离(@白木)

(已解决)(bug)首页文章 hover后卡片边框会出现一个白色,这个白色圈能否去掉,每次出现有点难受(之前teek博客是没这个问题的)

群主回复:(2025年11月23日)

之前都解决了,不过后来开发过程中又复现了。。。。🤣🤣🤣

image-20251124075245727


image-20251122204352298

image-20251122204404208

(已解决)(紧急重大bug)最新版 代码块折叠功能失效了(很影响用户阅读博客体验)

2025年12月27日记录。

(已解决)(严重影响体验)没法自动定位文件位置

2025年12月24日测试。

pc段,首页文章点进去之后,依然无法自动定位到文件位置,但是文件有被重点标注:

移动端,点击文章进去后,侧边栏对应起文件没重点标注,也没自动定位位置:


(严重影响用户文档库的体验)bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置

bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置。

之前vp就存在这个bug,官网也没修复。不知道Hugo-teek修复不?

合理情况应该是,点击首页文章后,会直接跳转到对应文章,且侧边栏也应该直接滑动到对应位置才对,而不是一直往下滑动自己找那个文件位置

作者答复:(2025年11月17日记录)

image-20251117165955148

image-20251117170019611

(已解决)cnb私有库 往 公开库 推送dist数据还是有点耗时哇,需要9.2s | 钉钉推送也有点耗时了,需要4.6s (待后续研究,目前速度基本够用)

image-20251220022814574

image-20251220022846309


2025年12月20日记录:

image-20251220022508906


还可以优化钉钉

image-20251220214707311

image-20251220214613793

(已解决)可以支持全文搜索了哦,真不错(@xgq)

  • Flexsearch文章字数越多索引就越长

(已解决)站点信息的行距可以更紧凑些

hugo-teek博客:

image-20251125065057725

teek博客:

image-20251125065159335

(已解决)让文章卡片和左侧卡片栏高度保持一致(让首页文章数量多一些)

image-20251125070557053

(已解决)让首页加载更丝滑

案例:

https://lisir.me/ 基于vitepress

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

(已解决)文章顶部的tag悬浮后没弹出其余tag

image-20251125065620899

(已解决)footer底部元素的间距太大

hugo-teek存在的问题:

image-20251113094220377

teek效果:

https://onedayxyy.cn/

image-20251113094303133

(已解决)(优化)移动版首页 文章卡片 两边留白可以再小点 (@尘影|chiplayout.top)

2025年12月24日记录。

🔴(紧急重大bug):之前说的侧边栏还是有一定问题的,从首页文章点进去的侧边栏是可以正常点击切换的。但是把侧边栏收缩后,再次想点开目录就会失败了,无法点开。[捂脸]

2025年12月26日记录。

(已解决)小火箭和评论的图标稍微再大点,目前有点小

hugo-teek效果:

image-20251127053555579

teek效果:

image-20251127053844720

(已解决)首页 最新评论样式又出bug了

2025年12月22日记录。

(已解决).gitignore里docs目录注释问题

官网仓库 .gitignore里的docs目录需被注释

(已解决)移动端 文章 左右2侧的小目录按钮 位置

image-20251111213546186

image-20251111213602332

image-20251111213613155

讨论:

image-20251111213631442

image-20251111213657730

image-20251111213713606

(已解决)全文模糊搜索

理想需求

如vscode、word、有道云笔记等可以实现全文精确查找。

必要性

不管是个人笔记,还是博客网站,如果能做到全文模糊搜索就尤其重要;

algolia方案(不能实现全文模糊搜索🤣)

pagefind方案(不能实现全文模糊搜索🤣)

pagefind extend版本 虽然 支持中文,但是对 断词做的不好,官网有说明(@时光)

image-20251218121849909

image-20251218121905480

image-20251218121919672

为什么 md 目录大纲在 Pagefind 里效果差?(@官方解释)(待xgq大佬研究)

2025年12月18日记录。

image-20251218122053271

image-20251218122223918

案例:wp支持全文模糊搜索

image-20251218221719112

image-20251218221727654

image-20251218221805160

Fuse.js方案(待xgq测试)

2025年12月18日记录。

image-20251218221859213

(已解决)(优化)文章右侧目录行间距有点大,显得很奇怪,需改进

2025年12月15日提出

image-20251215115118188

(已解决)移动端 侧边栏和文章目录 按钮点击后内容的弹出方式

当前hugo-teek效果:

image-20251117163249040

还是之前的teek效果nice:

2025年12月23日讨论:

之前群主讨论:

image-20251117163342301

image-20251117163409162

(已解决)移动端 个人头像 右下角 小表情 白色圈太大;pc端也有小白圈;

image-20251114072825517

image-20251115064458904

teek博客风格:

image-20251123050903065

(已解决)线上和本地侧边栏没问题,但是移动端侧边栏又出问题了

2025年12月22日产生:

(已解决)(优化)移动端正文字体有点小,🉐往大调一下

2025年12月23日记录:

(已解决)图片查看器新增点击图片区域外,可关闭图片,增强交互体验

白木图片样式优化:

https://gl.baimu.live/1109

image-20251217210902236

(已解决)移动端适配图片查看器

(已解决)(比较影响体验)目录层级影响打包体积(侧边栏问题)

问题背景

目录层级不要太深(尽量限制在5级内)

2025年12月23日记录。


再次记录:2025年12月24日

w3c大佬提供的建议(使用hugo自身的语法重写侧边栏)

(已解决)导航栏 样式问题

🔴🔴待后续继续优化(2025年11月23日)

额,刚体验了下,hugo-teek的导航栏字体随着背景色深浅会切换成白色/黑色字体,这个效果体验不是很好,常规来说,作为导航栏字体,不能来回变化字体颜色,不然很奇怪,严重影响体验。

推荐按白木方式 让豆包重写下样式为好。

另外: teek博客的导航栏只有在鼠标往上滑动时,导航栏背景才会出现毛玻璃,默认情况,只有字体出现在导航栏区域的。 这个效果也是不错的,可以很好配合白木实现的导航栏风格。

xgq群主这个解决方案没问题了(对白色壁纸场景);但存在问题(在呼吸时候偶尔看不大清)

image-20251123105624340

2025年11月23日记录。

image-20251123105313947

image-20251123105333609


但存在一个问题:

image-20251123105420289

image-20251123105441005

(闭环)hugo-teek的导航栏样式依然存在问题(字体一会儿为白色,一会儿为黑色;且当壁纸背景为白色时,字体也为白色,就会出现看不清字体问题,这个需要加上白木优化过的代码。)已提供css代码;

字体一会儿为黑色:

image-20251123051332662

字体一会儿为白色:

image-20251123051344774


白木优化过的代码:

image-20251123051623880

image-20251123052502650

最新代码:

 1/* 仅首页全屏 Banner 时的导航栏样式美化 */
 2.tk-layout .VPNavBar.home.full-img-nav-bar:not(.screen-open) {
 3  /* 控制文字的阴影颜色 */
 4  .VPNavBarTitle .title,
 5  .VPNavBarMenuLink,
 6  .VPNavBarMenuGroup .text,
 7  .VPSocialLink {
 8    color: var(--vp-c-white) !important;
 9    text-shadow:
10      2px 2px 4px rgba(0, 0, 0, 0.5),
11      -2px 2px 4px rgba(0, 0, 0, 0.5),
12      2px -2px 4px rgba(0, 0, 0, 0.5),
13      -2px -2px 4px rgba(0, 0, 0, 0.5);
14
15    /* 添加平滑过渡动画 */
16    transition:
17      color 0.3s ease,
18      text-shadow 0.3s ease;
19
20    /* 控制鼠标悬停文字后的文字颜色 */
21    &.active,
22    &:hover {
23      color: rgba(0, 110, 255, 1) !important; // 修改文字颜色
24      text-shadow: none !important;
25    }
26  }
27
28  /* 控制搜索栏的阴影颜色 */
29  .DocSearch-Button,
30  .DocSearch-Input {
31    background-color: rgba(0, 0, 0, 0.5);
32    border-radius: 8px;
33    padding: 0.5rem 1rem;
34    color: var(--vp-c-white);
35    text-shadow:
36      2px 2px 4px rgba(0, 0, 0, 0.5),
37      -2px 2px 4px rgba(0, 0, 0, 0.5),
38      2px -2px 4px rgba(0, 0, 0, 0.5),
39      -2px -2px 4px rgba(0, 0, 0, 0.5);
40  }
41
42  .DocSearch-Button-Placeholder {
43    text-shadow:
44      2px 2px 4px rgba(0, 0, 0, 0.5),
45      -2px 2px 4px rgba(0, 0, 0, 0.5),
46      2px -2px 4px rgba(0, 0, 0, 0.5),
47      -2px -2px 4px rgba(0, 0, 0, 0.5);
48  }
49
50  /* 控制配置切换图标的描边颜色 */
51  .tk-icon {
52    cursor: pointer;
53    filter: drop-shadow(0 0 1px rgba(255, 0, 212, 0.5)) // 可修改描边颜色🔽颜色要与下面保持一致
54      drop-shadow(0 0 0.5px rgba(255, 0, 212, 0.5)); // 可修改描边颜色🔼颜色要与上面保持一致
55  }
56
57  /* 控制时钟容器背景色 */
58  #clock {
59    display: inline-flex;
60    align-items: center;
61    gap: 0.2rem;
62    position: relative;
63    border-radius: 0.5rem;
64    padding: 0.2rem 0.5rem;
65    background-color: rgba(0, 0, 0, 0.2); //可修改背景色
66  }
67
68  /* 控制时钟文字颜色 */
69  #clock .hour,
70  #clock .minute,
71  #clock .second,
72  #clock .separator {
73    color: rgba(255, 255, 255, 1); // 可修改文字颜色
74  }
75}

(闭环)(严重影响体验)希望把白木给teek博客贡献的导航栏样式给加上,不然,目前黑色壁纸背景导致菜单栏字体更笨看不清……

  • 目前hugo-teek壁纸背景存在问题 截图:

image-20251121121702102

  • 修复办法代码链接:

https://onedayxyy.cn/teek/b2i4t

image-20251121121524265

  • 解决问题的背景:

image-20251121121544904

  • 解决思路

image-20251121121742398

  • 最终效果:

image-20251121121620068

(已解决)刚点文章进去,二级标题是黑色的,稍等一会儿就变成粉色的了

2025年12月25日记录。

(已解决)(优化)让md文章 图片得居中,当前是居左的

(已解决)为啥文章目录底部这里多了个白条,遮挡了视线,效果很不好,之前都没的

image-20251220092820906

(已解决)文章面包屑失效了

image-20251220163119134

(已解决)发布时间又增加到28s了??(因为侧边看渲染级别增加)

2025年12月22日产生:

背景:

(已解决) (bug、紧急)本地的侧边栏没了,线上是有的

2025年12月16日测试:

image-20251216185654096

image-20251216185721383

image-20251216185840614

(已解决)线上部分目录下的文档未正常显示。。。

2025年12月20日记录。

线上渲染:异常

image-20251220211606902

本地文档:

image-20251220211752839

(已解决)白木提供的2个好看的明亮和暗黑切换svg图标

2025年12月20日记录。

效果:

image-20251220110253490

image-20251220110309604

下载位置:

https://img.onedayxyy.cn/images/20251220-shiguang-two-icon.zip

(已解决)cnb流水线代码2个问题得再优化下

1在把私有库dist数据推送到公开库dist分支,init dist branch (public)阶段的代码还得再优化下,目前公开库dist分支体积持续增大,导致cnb流水线耗时加长。  
2
3包括上面如果公开库是空仓库时,也需要自动创建下dist分支。
4
5上面2部分的代码还得再优化下,我记录下。晚点我用豆包试试。[破涕为笑]

问题1:

1在把私有库dist数据推送到公开库dist分支,init dist branch (public)阶段的代码还得再优化下,目前公开库dist分支体积持续增大,导致cnb流水线耗时加长。

image-20251220111212113

image-20251220111219278

image-20251220111225480

image-20251220111233190

问题2:

1包括上面如果公开库是空仓库时,也需要自动创建下dist分支。

image-20251220111321943

(已解决)(待改进)之前的一个老问题,新建的md,直接提交后cnb后,流水线会发布失败

2025年12月17日测试。

image-20251217192806363

image-20251217192839062

(已解决)(待测试)(回退后出现的bug)下划线开头的文件或目录依然会出现在网站上

(已解决)(运行/构建太耗时)必须 极致优化hugo-teek的运行时间 & 构建时间

image-20251218123027565


image-20251218123057891


teek运行本地项目,很快的,几乎秒开。


(已解决)(运行 太耗时)每次本地运行项目太耗时了,能不能快速拉起来hugo-teek项目?

(已解决)如今的hugo-teek博客 发布有点耗时,660多文件,需要4min57s多了。。。。需优化

2025年12月17日测试

check也耗时40s 部署也得耗费56s [捂脸] 构建3min

image-20251217192535599

image-20251217192554644


仔细分析:

image-20251217205938746

image-20251217210002222

image-20251217210012943

image-20251217210019706

1私有库(博客主站点):https://cnb.cool/onedayxyy/hugo-teek-private 7.71 MiB
2公开库(dist内容):https://cnb.cool/onedayxyy/hugo-teek-public-dist 965.41 MiB

image-20251217210033316

image-20251217210042161


排查结果:w3c大佬反馈的

image-20251217221655498

image-20251217221706475

image-20251217221725432

image-20251217222141068

推荐使用微信支付
微信支付二维码
推荐使用支付宝
支付宝二维码
最新文章

本页导航

文档导航