快捷菜单
常用功能一站直达
更多功能请点顶栏「快捷菜单」
2025年12月30日记录。

2025年12月20日更新。

2026年1月18日记录。
故障文章url:https://onedayxyy.cn/topic/HugoTeek-is-yyds/


白木回复:
1
2【解:VP原生就有这个问题,当前没有更好的解决方案,最好的办法还是别加emoji表情符号,实在需要只能做emoji库,把emoji表情符号转为图片格式】2025年12月20日更新。

白木回复:
1
2【解:一条是目录的,一条是H2的,去掉谁的都不合理了,万一目录下的是H3(没有上分割线),那目录跟H3没有区分了】2025年12月29日记录。


白木回复:
1
2【解:这是识别客户端环境的字体作为网站字体的,比如说你电脑是微软雅黑,手机是宋体,肯定就是不一致的,所以吖,这不用优化哦】2026年1月3日记录。

2026年1月3日记录。

2026年1月13日记录。
2026年1月12日记录。
2026年1月12日记录。
2026年1月13日记录。
移动端:

pc端:

2026年1月12日记录。
之前侧边栏版本:

当前侧边栏版本:

2026年1月12日记录。

2026年1月14日记录。(其它群友提出的)

2026年1月14日记录。
https://docusaurus.io/zh-CN/docs/markdown-features



2026年1月12日记录。

2026年1月12日记录。


2025年12月27日记录。
🔴hugo-teek的win 二进制程序下载速度贼慢,需早日优化,影响本地运行(等待cnb官网发布新版本)
2025年12月15日提出。

方案:cnb附件-大文件-lfs标识









1git lfs migrate import --above=50MB --everything
2这样转存现有超过50M文件到lfs




余温作者弄好了:



https://lfs.cnb.cool/lfs/objects/btkIzsEqnKx810358p9H0YcxkOB

upx下:






解决方案:等待cnb官方修复api
2025年12月18日提的issue




/docs目录下;(测试后,存放在根目录下的文档,没法被formatter强制注入参数。)
另外,你看下你hugo-teek官方库文档要改下存放路径不,都放在/docs目录下不,因为其它ssg一般都放在/docs下,保持一致也挺不错。(看下会对博客开发产生啥影响不,没影响,可以考虑放在/docs目录下)
存在问题:
测试后,存放在根目录下的文档,没法被formatter强制注入参数。


2025年12月26日记录。







默认png 184K
用imagine压缩后是 49k

2026年1月13日记录。

2025年11月19日提出。





1// 💫 嵌套列表的缩进效果
2 .VPDocOutlineItem.root {
3 // h2 标题的子级(h3-h6)
4 li > ul.VPDocOutlineItem.nested {
5 margin-left: 16px !important;
6 padding-left: 12px !important;
7 border-left: 1px solid rgba(156, 163, 175, 0.2) !important;
8
9 // h3 标题的子级(h4-h6)
10 li > ul.VPDocOutlineItem.nested {
11 margin-left: 16px !important;
12 padding-left: 12px !important;
13 border-left: 1px solid rgba(156, 163, 175, 0.15) !important;
14
15 // h4 标题的子级(h5-h6)
16 li > ul.VPDocOutlineItem.nested {
17 margin-left: 16px !important;
18 padding-left: 12px !important;
19 border-left: 1px solid rgba(156, 163, 175, 0.1) !important;
20 }
21 }
22 }
23 }2025年12月25日记录。

-2025年11月19日



2025年11月23日回复。

2025年11月23日提出。



https://gohugo.io/content-management/image-processing/



1● 这篇 Hugo 文档主要讲了 Hugo 的图片处理功能,我给你总结一下核心内容:
2
3 主要内容概览
4
5 1. 图片资源的三种访问方式
6
7 - Page resource (页面资源) - page bundle 里的图片
8 - Global resource (全局资源) - assets/ 目录下的图片
9 - Remote resource (远程资源) - HTTP/HTTPS 远程图片
10
11 2. 核心图片处理方法
12
13 - Resize - 调整宽高(可能变形)
14 - Fit - 按比例缩小,保持宽高比
15 - Fill - 裁剪+缩放到指定尺寸
16 - Crop - 仅裁剪,不缩放
17 - Filter - 应用滤镜(高斯模糊、像素化等)
18 - Process - 通用处理方法(可替代上述所有方法)
19
20 3. 处理选项
21
22 - 尺寸:600x400
23 - 旋转:r90(逆时针90度)
24 - 格式转换:webp、jpg、png
25 - 质量:q75(1-100)
26 - 锚点:TopLeft、Center、Smart(智能裁剪)
27 - 背景色:#ffffff
28 - 重采样滤镜:Lanczos、Box 等
29
30 4. 其他功能
31
32 - EXIF 读取 - 提取照片元数据(拍摄时间、GPS、光圈等)
33 - Colors - 提取图片主色调
34 - Smart cropping - 智能识别图片重点区域进行裁剪
35
36 5. 性能优化
37
38 - Hugo 会将处理后的图片缓存在 resources/ 目录
39 - 建议将此目录加入版本控制,避免 CI/CD 时重复处理
40 - 使用 hugo --gc 清理未使用的图片
41
42 典型用法示例
43
44 {{/* 调整宽度为600px,保持比例 */}}
45 {{ $image := $image.Resize "600x" }}
46
47 {{/* 裁剪+缩放到 600x400,智能裁剪 */}}
48 {{ $image := $image.Fill "600x400 Smart" }}
49
50 {{/* 转换为 WebP 格式,质量50 */}}
51 {{ $image := $image.Resize "600x webp q50" }}
52
53 {{/* 旋转90度 */}}
54 {{ $image := $image.Process "r90" }}1
1https://img.xxdevops.cn/blog/article_cover/photo-1667372393119-3d4c48d07fc9.avif?w=1200&h=690&fit=crop&fm=webp&q=80



2026年1月14日记录。

2025年12月30日记录。



2025年12月17日提出。


2025年11月23日提出。

2026年1月7日记录。
2026年1月7日记录。

2026年1月7日记录。
https://imfing.github.io/hextra/



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









2026年1月7日记录。
2025年12月26日记录。
存在问题:
当前白木修复后的侧边栏切换文件时整个侧边栏会刷新,影响用户体验。


2025年12月17日提出。

ty里md内容:

hugo-teek渲染效果:

2026年1月4日记录。

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

2026年1月3日记录。

2026年1月3日记录。

2025年12月26日记录。
当前白木修改后的特性是:图片正常是蓝色边框,hover后蓝色边框消失了,不合理。
具体原因:


2025年12月20日记录。
当前悬浮后,是顺时针旋转一次;
理想效果:hover后,先逆时针旋转一次,鼠标离开后,又转一圈恢复回来,这样效果会更友好点。


hugo-teek的:

teek的:

群主回复:(2025年11月23日)
之前都解决了,不过后来开发过程中又复现了。。。。🤣🤣🤣



2025年12月27日记录。

2025年12月24日测试。
pc段,首页文章点进去之后,依然无法自动定位到文件位置,但是文件有被重点标注:
移动端,点击文章进去后,侧边栏对应起文件没重点标注,也没自动定位位置:
(严重影响用户文档库的体验)bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置
bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置。
之前vp就存在这个bug,官网也没修复。不知道Hugo-teek修复不?
合理情况应该是,点击首页文章后,会直接跳转到对应文章,且侧边栏也应该直接滑动到对应位置才对,而不是一直往下滑动自己找那个文件位置
作者答复:(2025年11月17日记录)




2025年12月20日记录:

还可以优化钉钉





hugo-teek博客:

teek博客:


案例:
https://lisir.me/ 基于vitepress
https://www.vvhan.com/ 基于Astro

hugo-teek存在的问题:

teek效果:

2025年12月24日记录。

2025年12月26日记录。
hugo-teek效果:

teek效果:

2025年12月22日记录。

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



讨论:



如vscode、word、有道云笔记等可以实现全文精确查找。
不管是个人笔记,还是博客网站,如果能做到全文模糊搜索就尤其重要;



2025年12月18日记录。





2025年12月18日记录。

2025年12月15日提出

当前hugo-teek效果:

还是之前的teek效果nice:
2025年12月23日讨论:




之前群主讨论:




teek博客风格:

2025年12月22日产生:

2025年12月23日记录:

白木图片样式优化:

问题背景
目录层级不要太深(尽量限制在5级内)
2025年12月23日记录。






再次记录:2025年12月24日

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



额,刚体验了下,hugo-teek的导航栏字体随着背景色深浅会切换成白色/黑色字体,这个效果体验不是很好,常规来说,作为导航栏字体,不能来回变化字体颜色,不然很奇怪,严重影响体验。
推荐按白木方式 让豆包重写下样式为好。
另外: teek博客的导航栏只有在鼠标往上滑动时,导航栏背景才会出现毛玻璃,默认情况,只有字体出现在导航栏区域的。 这个效果也是不错的,可以很好配合白木实现的导航栏风格。

2025年11月23日记录。


但存在一个问题:


字体一会儿为黑色:

字体一会儿为白色:

白木优化过的代码:


最新代码:
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}
https://onedayxyy.cn/teek/b2i4t




2025年12月25日记录。




2025年12月22日产生:

背景:


2025年12月16日测试:



2025年12月20日记录。
线上渲染:异常

本地文档:

2025年12月20日记录。
效果:


下载位置:
https://img.onedayxyy.cn/images/20251220-shiguang-two-icon.zip
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流水线耗时加长。



问题2:
1包括上面如果公开库是空仓库时,也需要自动创建下dist分支。
2025年12月17日测试。




teek运行本地项目,很快的,几乎秒开。
2025年12月17日测试
check也耗时40s 部署也得耗费56s [捂脸] 构建3min


仔细分析:




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

排查结果:w3c大佬反馈的




/docs目录下;(测试后,存放在根目录下的文档,没法被formatter强制注入参数。)日历 · 精选 · 友链 · 更多
如果内容对你有帮助,欢迎请我喝杯咖啡 ☕



One的公众号
爱折腾博客的小白