待办
待办

目录
[toc]
🔴🔴(重要)hugo-teek的一键升级
预期需求
本地运行图形化管理后台后,wed点击一键升级到最新版,即可。
XGQ群主 和 teek群主 讨论



如何实现:在一键升级新版的同时能保证自己之前配置的自定义用户信息不变?
🔴🔴(重要)hugo-teek的配置中心
核心思想
博客配置 和 md文档 完全分离,对小白用户来说,只需专心维护md就行,博客配置只需要在图形化上傻瓜式的点点点就行,无需接触底层代码,即可拥有一个超级无敌的丝滑博客,彻底解放了双手。
1.需求背景
任何一款全新的博客,对小白用户来说,如何快速部署起来?如何配置成自己的用户信息?如何自行选择开启或者关闭博客里的一些功能?如何快速升级到最新版本?等等。
对于传统的博客(ssg静态博客、动静分离、动态博客等),以上问题都是一个相对很麻烦的事情。
或许你说有群主耐心的解释、群主详细的文档、群里小伙伴热心的答疑、群里热心小伙伴详细的手把手文档,但是,用户在实际部署和配置过程中,99%存在各种各样的问题🤣。同样,后续新进来的小伙伴也会遇到相同的问题。这样无疑浪费了彼此的大量时间😂。
那么,有什么办法可以解决以上问题呢?
so,hugo-teek的配置中心就可完美解决以上问题。
小白博客用户 拉取
hugo-teek源码后,双击点击start.bat脚本后,我们在浏览器通过ip:端口就会打开一个图形化界面。此时,小白用户只需在图形化界面配置一些自己的用户信息,自己选择开启或者关闭一些博客功能,根本无需接触代码,有手就好。
这样是不是非常简单,屏蔽了底层的代码,把简单留给用户,代码开发留给开发者,可以让博客用户专心维护自己的md文档数据,更笨无需关心复杂的博客配置。另外,后续升级,也可以在web上点击一键更新,就可升级到最新版本,尽情享用。
提示
1. 如果你是小白用户,hugo-teek博客就非常适合你,你无需接触代码,就可享受一个简约、唯美、丝滑、强大的博客,你唯一需要关心的就是你自己的md内容。
2. 如果你懂代码,想二开hugo-teek,作者源码是公开的,你可以自己二开次项目。或者你懂hugo主题的开发,你也可以提pr。或者你有好的想法或建议,都可以在群里提出来,作者会根据用户需求意愿来决定是否开发次功能。
2.理想需求
小白博客用户 部署完hugo-teek博客后,需要将原有一些用户自定义信息修改为自己的信息,一般只需要修改如下事项。那么我们只需要在开发模式下运行博客后台,通过图形化界面的 点点点操作 即可完成如下的用户自定义配置信息,非常简单,有手就行。😍
- 添加/删除 首页壁纸;更改显示方式(顺序显示/随机显示);
- 自定义打字机内容;选择打字机风格;
- 选择向下滚动小箭头风格;
- 添加/删除 首页文章封面;
- 修改 博客名称、logo 图片、标签页名称及副标题
- 修改 个人头像、个人头像背景、个人头像下座右铭、个人联系方式、github地址、首页侧边栏微信公众号
- 修改 footer 备案号,公安备案号,座右铭
- 搜索配置、评论配置
- 选择 网站主题色
- 选择 网站字体;新增/删除 网站字体;
- 选择 网站风格:文档风、简约博客风、完整博客风(文章卡片风、文章列表风、半图背景、全图背景)等
- 添加友联(需要区分为首页友链 和 独立页面友链);
- 添加赞赏人员名单;
- f11屏保模式:是否需要显示博客名称、打字机、大波浪;
- 丝滑的md编辑界面;
- 一键批量导出所有md;
…(目前已知的就这些)
3.实现方式
单纯就是基于hugo配置文件搞,省去使用者修改配置文件的时间。
图形化动态修改博客配置, 如果要持久化到数据库 就违背了做 静态站的初衷了。
可视化配置后直接修改配置文件吗,是的。只有开发模式才能看到后台,部署到公网不会有后台的。
hugo-teek的配置中心(图形化后台)(只存在开发模式下);
1、紧急 待办(重要功能开发 & bug修复)
🔴🔴页面切换过度效果
2025年12月6日记录。
xgq 的hugo-teek博客:记得之前都弄过来了,后面不知道回退啥的,给弄没了。
时光:快速过度
群主:丝滑过度
时光效果:(teek主题)
teek群主:
- teek群主存在的问题:
群主那个效果跟无障碍有冲突,难关移动端分数起不来。


1# Mizuki 3.2.2 动画修复记录
2
3## 问题概述
4在Mizuki 3.2.2版本中,页面切换动画和波浪效果均失效,而3.1版本正常工作。
5
6## 修复过程
7
8### 第一阶段:页面切换动画修复
9**问题原因:**
101. CSS优先级冲突 - 3.2.2版本中的复杂CSS选择器和`!important`规则覆盖了动画效果
112. Swup配置不完整 - 缺少`animationSelector`配置导致动画无法正确触发
123. 动画CSS优先级不足 - 动画样式被其他CSS规则覆盖
13
14**修复方案:**
151. **增强transition.css** - 为所有动画添加`!important`规则确保优先级
162. **完善Swup配置** - 添加`animationSelector: '.transition-swup-fade'`配置
173. **优化动画参数** - 调整动画延迟和持续时间,确保流畅性
18
19**具体修改:**
20- `src/styles/transition.css`:为所有动画样式添加`!important`
21- `astro.config.mjs`:添加`animationSelector: '.transition-swup-fade'`
22
23### 第二阶段:波浪效果修复
24**问题原因:**
253.2.2版本新增了无障碍支持功能,其中包含`prefers-reduced-motion: reduce`媒体查询,该查询会禁用所有动画效果,包括波浪动画。
26
27**问题文件:**
28- `src/styles/gallery.css` - 第399-404行
29- `src/styles/widget-responsive.css` - 第419-426行
30
31**修复方案:**
32为波浪动画添加例外规则,确保在减少动画模式下波浪效果仍然正常工作。
33
34## 技术分析
35
36### 关键差异文件
371. **transition.css** - 动画样式定义
382. **astro.config.mjs** - Swup配置
393. **gallery.css** - 新增的无障碍支持规则
404. **widget-responsive.css** - 减少动画模式设置
41
42### 根本原因
433.2.2版本在追求无障碍支持的过程中,过度限制了动画效果,导致波浪动画被意外禁用。
44
45## 后续建议
461. **选择性禁用动画** - 对于关键视觉效果(如波浪)应保持动画
472. **渐进式增强** - 确保核心功能在减少动画模式下仍然可用
483. **测试策略** - 增加不同辅助功能模式下的视觉测试
49
50## 验证结果
51- ✅ 页面切换动画已修复
52- ⚠️ 波浪效果待修复(需要添加例外规则)
53
54---
55*文档生成时间:2025-11-09*

🔴🔴最近几次为啥提交cnb后报错,得删除dist仓库才行
2025年12月6日记录。


ai回答:

🔴为啥新建md后,不执行start.bat,直接提交后cnb构建会报错

🔴(回退后出现的bug)下划线开头的文件或目录依然会出现在网站上
🔴(回退后出现的bug)目录和文件按序号排序,目前效果存在问题
🔴文章右侧目录高度可以直接铺满(目前效果看起啦有点难受)
hugo-teek效果:

teek效果:

让md文章 图片得居中,当前是居左的
🔴文章正文和文章名称之间建议还是放一条分割线把,显得更简洁
hugo-teek博客:

teek博客:

移动端页面太窄
hugo-teek效果:

teek博客效果:

(疑难杂症bug)首页移动端 左边宽右边窄(很奇怪的一个bug)

2、teek功能待实现 待办
希望增加和teek一样的主题色、布局切换、博客风格切换、可以支持多种好看的中文字体功能

讨论:
2025年11月18日


footer底部 需显示hugo-teek版本
teek博客效果:https://onedayxyy.cn/

网址风险提示
希望能支持 网址风险提示 功能

rss功能
hyde大佬:https://teek.seasir.top/

文章发布较早提示功能
teek博客效果:
https://onedayxyy.cn/zhuanti/blog-index

3、样式细节需优化 待办
小火箭和评论的图标稍微再大点,目前有点小
hugo-teek效果:

teek效果:

站点信息的行距可以更紧凑些
hugo-teek博客:

teek博客:

footer底部元素的间距太大
hugo-teek存在的问题:

teek效果:

首页友联 和 单独友联 文件 需分离
讨论:
2025年11月18日






白木-toc文章右侧目录竖线优化
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 }
文章顶部的tag悬浮后没弹出其余tag

(待讨论)文章部分 向上滑动后,内容区域好像超出了 左侧侧边栏和右侧目录顶部哦

(优化)让首页加载更丝滑
案例:
https://lisir.me/ 基于vitepress
https://www.vvhan.com/ 基于Astro
(待讨论)teek博客的打字机、向下箭头貌似更好看些哦?
teek博客:

hugo-teek博客:

(待讨论)首页 twikoo最新评论 风格 是否和 友情链接 风格保持一致为好呢,显得更加协调
twikoo最新评论 风格:

友情链接 风格:

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

导航栏菜单项和图标
案例:emoj表情
图标可以是emoj表情 或者是 第三方图标(尽可能自建图标库)。
1🏡 首页
2
3📚 技术分类
4 🖥️ 运维 ❌
5 🎨 前端
6 💻 编程 ❌
7 🔐 黑客
8
9🛠️ 专题
10 📝 博客搭建 ❌
11 🎯 前端Demo ❌
12 🔧 Git ❌
13 💼 面试
14 🗄️ NAS
15 📜 脚本
16 🔨 工具
17 🌟 开源项目
18🏓 娱乐
19 📷 相册
20 🎬 电影
21 🎵 音乐
22
23👏 索引
24 📃 分类页
25 🔖 标签页
26 📚 归档页
27
28🍷 关于
29 👋 关于我
30 🎉 关于本站
31 💖 友链
32 🌐 网站导航
33 👂 留言区
34 💡 思考
35 ⏱️ 时间轴
36 📊 网站统计
37 🔍 站点监控
38 🙏 致谢名单
案例:时光自建图标库

3.5、(bug)后续尽可能需要优化的问题(会严重影响用户体验)
(需优化)文章 左上角 侧边栏 收缩按钮 往右点会更好;(或者往左点)
2025年11月23日提出。

(暂时无法去掉。。)(影响首页体验)首页文章 hover后卡片边框会出现一个白色,这个白色圈能否去掉,每次出现有点难受(之前teek博客是没这个问题的)
群主回复:(2025年11月23日)
之前都解决了,不过后来开发过程中又复现了。。。。🤣🤣🤣



(待优化,暂无好的方法。。)移动端 菜单栏 展开后样式有点不太协调,部分超出区域了

(待优化,暂无好的方法。。)移动端 侧边栏和文章目录 按钮点击后内容的弹出方式



(暂时没法解决,待定。。)bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置
bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置。
之前vp就存在这个bug,官网也没修复。不知道Hugo-teek修复不?
合理情况应该是,点击首页文章后,会直接跳转到对应文章,且侧边栏也应该直接滑动到对应位置才对,而不是一直往下滑动自己找那个文件位置
作者答复:(2025年11月17日记录)


(后续再优化)(影响首页体验)移动端 个人头像 右下角 小表情 白色圈太大;pc端也有小白圈;


teek博客风格:

toc内联目录 悬浮后 会出现字体颜色 模糊的效果?

文章 右侧目录 字体默认颜色是浅色模糊的,悬浮后字体颜色才正常?

导航栏 样式问题
🔴🔴待后续继续优化(2025年11月23日)
额,刚体验了下,hugo-teek的导航栏字体随着背景色深浅会切换成白色/黑色字体,这个效果体验不是很好,常规来说,作为导航栏字体,不能来回变化字体颜色,不然很奇怪,严重影响体验。
推荐按白木方式 让豆包重写下样式为好。
另外: teek博客的导航栏只有在鼠标往上滑动时,导航栏背景才会出现毛玻璃,默认情况,只有字体出现在导航栏区域的。 这个效果也是不错的,可以很好配合白木实现的导航栏风格。
xgq群主这个解决方案没问题了(对白色壁纸场景);但存在问题(在呼吸时候偶尔看不大清)

2025年11月23日记录。


但存在一个问题:


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

字体一会儿为白色:

白木优化过的代码:


最新代码:
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壁纸背景存在问题 截图:

- 修复办法代码链接:
https://onedayxyy.cn/teek/b2i4t

- 解决问题的背景:

- 解决思路

- 最终效果:

4、实用功能 待办
(后续优化)(待测试)推荐 把文档存放目录 放在/docs目录下;(测试后,存放在根目录下的文档,没法被formatter强制注入参数。)

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


(待开发完成)(formatter工具)写一个 批量删除所有formatter参数的工具(用以完整迁移文档库)
(待开发完成)(formatter工具)写一个 批量删除所有md封面的 工具(用于批量更换文章封面)
(待开发完成)(formatter工具)写一个 对某个目录 批量添加相同的分类和标签的 工具(这个功能还是挺实用的)
一个专题/目录下的分类和tag基本是一样的;
且分类和tag基本只会写一个就够了;
可以设置一个目录的默认 分类和tag,让他放置在目录下的_index.md文件里,利用工具注入时从这个文件里取即可。
漂亮、实用的博客图标自建/使用
文章右侧目录具有展开/收缩小按钮
案例:typora风格
例如这个效果:

案例: https://blog.grtsinry43.com/
2025年9月11日记录
https://blog.grtsinry43.com/posts/hands-on-vue-docs

视频效果:
🔴(重要)文章开头ai自动输出本文摘要功能
案例:张洪Heo
(2025年7月25日记录)
https://blog.zhheo.com/p/v4jy226i.html

案例:WJX大佬
2025年11月9日记录。

(存在争议)移动端 文章 左右2侧的小目录按钮 位置



讨论:



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



(hugo的规则就这样,没法去掉?)把url后的 斜杠 给去掉

群主回复:




代码块换行 功能

- 效果:https://vp.xiaoying.org.cn/pages/9d746f/#-docssecureinfo

首页提示有多少人正在浏览网站
案例:https://blog.grtsinry43.com/
2025年11月26日记录。


5、让博客功能更加完整 待办
关于本站
案例:张洪heo风格
hyde大佬移植到teek博客的:https://teek.seasir.top/homepage

时间轴 模块
思考 模块
https://onedayxyy.cn/about/thouht

相册
案例:张洪Heo

案例:宇阳-Thrix博客作者


音乐
案例:网页 音乐
hyde大佬:https://teek.seasir.top/

案例:张洪Heo
https://music.zhheo.com/?id=8668419170&server=tencent

强加密
看hugo-teek是否可支持强加密?
案例:w3c提供的解决方案


朋友圈
2025年11月11日提出。
希望hugo-teek内置支持一个朋友圈功能,可以分享一些日常动态。
https://onedayxyy.cn/about/pyq

情侣相册 模块
https://onedayxyy.cn/about/love

时间轴 模块
https://onedayxyy.cn/about/time-line

ip、天气、欢迎语卡片
- 案例:hyde弄的风格

案例:nas大佬
http://blog.wilsonzy.cn/ 群里nas大佬


1// 获取浏览器信息
2function getBrowserInfo() {
3 const userAgent = navigator.userAgent;
4 const browserMatchers = [
5 { name: "Edge", regex: /Edg\/(\d+\.\d+)/ },
6 { name: "Chrome", regex: /Chrome\/(\d+\.\d+)/ },
7 { name: "Firefox", regex: /Firefox\/(\d+\.\d+)/ },
8 { name: "Safari", regex: /Safari\/(\d+\.\d+)/ },
9 { name: "Internet Explorer", regex: /(MSIE (\d+\.\d+)|Trident\/(\d+\.\d+))/ },
10 { name: "Android 浏览器", regex: /Android (\d+\.\d+)/ },
11 { name: "移动设备浏览器", regex: /Mobile/ }
12 ];
13
14 for (const { name, regex } of browserMatchers) {
15 const match = userAgent.match(regex);
16 if (match) {
17 return `${name} ${match[1] || "未知版本"}`;
18 }
19 }
20 return "未知浏览器";
21}
22
23// 获取IP和城市信息,使用ip-api.com
24async function getCityInfo() {
25 try {
26 const response = await fetch('http://ip-api.com/json');
27 const data = await response.json();
28 const { query: ip, city = '未知城市', regionName: region = '未知地区', country = '未知国家', lat, lon } = data;
29 return { ip, city, region, country, loc: [lat, lon] };
30 } catch (error) {
31 console.error("获取城市信息失败", error);
32 return { ip: '未知IP', city: '未知城市', region: '未知地区', country: '未知国家', loc: ['0', '0'] };
33 }
34}
天气:
1天气 <iframe·width="100%"·height="60px"·src="https://i.tianqi.com/?c=code&a=getcode&id=84&color=#2266b8&icon=1"·frameborder="0"></iframe>
https://www.tianqi.com/plugin/

需开发一个功能:hugo-teek后台可查看有哪些域名使用了hugo-teek博客
6、FAQ
私有库推送到公开库:eop反代
问题:
1目前cnb仓库是公开库,里面的dist分支存储构建产物,如何把构建产物存储到其它开源库呢?
2
3私有库:https://cnb.cool/onedayxyy/hugo-teek-private (存储hugo-teek源码及核心Md文档)
4公开库:https://cnb.cool/onedayxyy/hugo-teek-dist(dist分支,用于存放每次构建好的dist产物) -- eop反代
5
6这个方式的.cnb.yml好写嘛?
🔴🔴其它用户想配置为自己喜欢的风格,该怎么办呢?
有如下一个场景:
例如博客首页的打字机和向下箭头效果,目前hugo-teek博客的风格和teek博客风格是不同的。但是xgq作者喜欢当前hugo-teek的风格,而有的小伙伴依然喜欢teek博客的风格,此时该如何做呢?
用户可以自己二开hugo-teek,但是这个没法和xgq作者维护的版本进行合并哦?
方案1:由xgq作者全权决定hugo-teek博客使用哪种风格;
方案2:作者继续把老风格写到hugo-teek里,在配置中心里,提供2种风格,供用户自己切换。(这个方案还是比较合理的,基本上每个模块只提供一个风格就足够了,但是有些元素比较有争议,可以提供2种风格哦,也不错。🤣🤣)
eop 云函数使用、反代
将博客图片全部转为webp格式
需求

webp图片截图工具

亲自测试 截图后 png图片和webp图片大小
用户如何开发新的页面到hugo-teek里?
默认png 184K
用imagine压缩后是 49k

如何评测网站性能?
(用于提升性能)让首页 文章封面 采用缩略图格式?
w3c大佬提出
-2025年11月19日



xgq群主回复
2025年11月23日回复。

再次提出问题
2025年11月23日提出。



w3c大佬-hugo自带的图片处理系统
https://gohugo.io/content-management/image-processing/


xgq再测试(将图片全部弄到本地后,的确可以压缩图片,但是构建太耗时了,已回退,搁置此问题🔴)

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.webp?w=1200&h=690&fit=crop&fm=webp&q=80




7、博客最佳实践
- 风格简约、体验丝滑、性能强悍、模块完整优先
- 尽量减少第三方服务依赖(必须功能可以除外,例如评论、不算子等)
8、博客依赖的第三方服务
- eop(托管web服务)
- cnb(存储代码,提供流水线服务)
- nginx图床(nginx.conf)–云服务器
- twikoo(docker部署)、自建二开不算子(go二进制部署)–云服务器
9、博客性能优化
针对图片的性能优化
- 以后截图一律使用webp格式的图片;
- 博客在构建是,使用脚本强博客所有图片全部强制转换为webp格式图片;
- 首页文章封面 使用缩略图;(博客在构建时利用脚本把文章封面全部转为其对应缩略图)
结束


文档导航
本页导航
- 待办
- 目录
- 🔴🔴(重要)hugo-teek的一键升级
- 🔴🔴(重要)hugo-teek的配置中心
- 1、紧急 待办(重要功能开发 & bug修复)
- 2、teek功能待实现 待办
- 3、样式细节需优化 待办
- 3.5、(bug)后续尽可能需要优化的问题(会严重影响用户体验)
- (需优化)文章 左上角 侧边栏 收缩按钮 往右点会更好;(或者往左点)
- (暂时无法去掉。。)(影响首页体验)首页文章 hover后卡片边框会出现一个白色,这个白色圈能否去掉,每次出现有点难受(之前teek博客是没这个问题的)
- (待优化,暂无好的方法。。)移动端 菜单栏 展开后样式有点不太协调,部分超出区域了
- (待优化,暂无好的方法。。)移动端 侧边栏和文章目录 按钮点击后内容的弹出方式
- (暂时没法解决,待定。。)bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置
- (后续再优化)(影响首页体验)移动端 个人头像 右下角 小表情 白色圈太大;pc端也有小白圈;
- toc内联目录 悬浮后 会出现字体颜色 模糊的效果?
- 文章 右侧目录 字体默认颜色是浅色模糊的,悬浮后字体颜色才正常?
- 导航栏 样式问题
- 4、实用功能 待办
- (后续优化)(待测试)推荐 把文档存放目录 放在
/docs目录下;(测试后,存放在根目录下的文档,没法被formatter强制注入参数。) - (待开发完成)(formatter工具)写一个 批量删除所有formatter参数的工具(用以完整迁移文档库)
- (待开发完成)(formatter工具)写一个 批量删除所有md封面的 工具(用于批量更换文章封面)
- (待开发完成)(formatter工具)写一个 对某个目录 批量添加相同的分类和标签的 工具(这个功能还是挺实用的)
- 漂亮、实用的博客图标自建/使用
- 文章右侧目录具有展开/收缩小按钮
- 🔴(重要)文章开头ai自动输出本文摘要功能
- (存在争议)移动端 文章 左右2侧的小目录按钮 位置
- typora和teek渲染后换行不一致问题
- (hugo的规则就这样,没法去掉?)把url后的 斜杠 给去掉
- 代码块换行 功能
- 首页提示有多少人正在浏览网站
- (后续优化)(待测试)推荐 把文档存放目录 放在
- 5、让博客功能更加完整 待办
- 6、FAQ
- 7、博客最佳实践
- 8、博客依赖的第三方服务
- 9、博客性能优化
- 结束