博客搭建日志

2025.4.10

根据网上的教程搭配ai成功把博客的整个框架搭建好了，初具雏形

2025.6.24

功能增加

• 增加评论区功能
• 增加打赏功能
• 增加友链功能
• 给每个文章增加返回键（致敬不知名张某，没有返回键的流氓网页）

内容补充

• 运用ai编写了脚本，给本地md文件增加frontmatter、更改文件名等等
• 持续搬运本地笔记中….

2025.6.25

功能增加

• 增加根据搜索tag功能和同一个tag下搜索文章功能
• 为dates页面添加相同的搜索功能，保持界面一致性
  • 年份搜索：可以快速搜索特定年份
  • 文章搜索：在每个年份下搜索具体文章
  • 支持键盘快捷键（Ctrl+F聚焦搜索框，Esc清空搜索）
  • 实时统计搜索结果数量
• 增加鼠标点击特效
  • 多种特效类型：普通波纹、彩色渐变、爱心形状、星星爆炸
  • 粒子系统：点击时爆炸式粒子效果 - 交互方式：左键、右键、双击、键盘快捷键
  • 智能避让：在交互元素上不触发特效
  • 性能优化：自动清理，支持触摸设备
• 重新设计首页
  • 欢迎区域：渐变背景 + 博客统计数据
  • 特色功能展示：4个特色功能卡片介绍
  • 最新文章预览：卡片式布局展示最新6篇文章
  • 热门标签云：动态标签展示，按文章数量排序
  • 交互动画：数字统计动画、打字机效果、悬浮特效 - 响应式设计：完美适配各种设备
  • 暗色主题支持：自动适配系统主题

问题解决记录

GitHub Pages 构建失败修复（2025.6.25）

问题症状：

• GitHub Pages 构建失败，显示 “github-pages gem can’t satisfy your Gemfile’s dependencies”
• 构建日志显示依赖冲突

解决方案：

1. 修复 Gemfile 依赖：
   • 移除不兼容的 gemspec 引用
   • 使用官方 github-pages gem 替代单独的插件
   • 移除 jekyll-collection 等不支持的插件
2. 修复文件名问题：
   • 重命名 2025-04-04-SQL数据查询（单表.md 为 2025-04-04-SQL数据查询（单表）.md
   • 修复文件名中的未配对括号
3. 优化配置文件：
   • 统一 _config.yml 中的插件配置
   • 添加 GitHub Pages 兼容性配置
   • 移除重复的插件声明
4. 修复 SCSS 语法：
   • 移除 _home.scss 中可能导致问题的 SVG URL
   • 清理 styles.scss 中的重复导入
5. 文件清理：
   • 删除不需要的 not-pure-poole.gemspec
   • 更新 .gitignore 排除构建文件

结果：构建成功，网站正常部署

GitHub Pages 首页构建问题修复（2025.6.25 补充）

问题症状：

• 添加新首页后 GitHub Pages 构建失败
• 复杂的 CSS 和 Liquid 模板可能导致编译错误

解决方案：

1. 简化首页布局：
   • 移除复杂的统计数据计算
   • 简化 Liquid 模板语法
   • 移除可能有问题的 JavaScript 脚本
2. 简化 CSS 样式：
   • 重写 _home.scss，使用基础样式
   • 移除复杂的动画和特效
   • 保留核心的欢迎区域样式
3. 优化布局结构：
   • 使用更简单的 HTML 结构
   • 移除可能导致问题的高级功能
   • 保持响应式设计的核心功能

当前状态：

• 首页保留核心功能：欢迎区域 + 文章列表
• 样式简洁但美观
• 构建应该能够成功

花里胡哨特效大升级（2025.6.25 继续）

新增功能：

1. 动态背景粒子效果：
   • 首页专属粒子动画背景
   • 100个动态粒子，随机颜色和运动轨迹
   • 边界反弹效果，流畅动画
   • 低性能影响，支持响应式调整
2. 阅读进度条：
   • 文章页面顶部进度指示器
   • 渐变色彩，实时更新阅读进度
   • 毛玻璃效果，不影响内容阅读
   • 自动计算文档滚动百分比
3. 智能回到顶部按钮：
   • 滚动300px后自动显示
   • 平滑滚动动画
   • 悬浮特效和阴影
   • 移动端优化尺寸
4. 打字机效果：
   • 首页欢迎文字动态打字
   • 多句话循环播放
   • 可配置打字速度和停顿时间
   • 光标闪烁动画
5. 随机鼓励语句：
   • 30秒间隔显示励志语句
   • 10+条精选诗词和名言
   • 弹窗式显示，3秒自动消失
   • 优雅的淡入淡出动画
6. 动态统计数据：
   • 实时计算文章数量、总字数
   • 模拟访客数和咖啡消耗量
   • 数字递增动画效果
   • 卡片式布局展示
7. 增强文章元数据：
   • 彩色标签，悬浮特效
   • 自动计算阅读时间
   • 模拟浏览量计数
   • 文章分类和标签展示
8. 智能文章目录：
   • 自动提取文章标题生成目录
   • 平滑滚动定位
   • 可折叠/展开
   • 层级缩进显示
9. 今日诗词：
   • 15+条经典诗词轮播
   • 点击刷新功能
   • 渐变文字特效
   • 中华传统文化展示
10. 简易音乐播放器：
    • 8首模拟音乐列表
    • 播放/暂停/切换功能
    • 音量控制滑块
    • 悬浮式播放器界面
11. 天气小组件：
    • 8个城市天气数据模拟
    • 实时刷新功能
    • 根据时间自动调整天气
    • 可见度、湿度、风速详情

技术特性：

• 全响应式设计，适配所有设备
• 完整暗色主题支持
• 性能优化，资源自动清理
• 模块化设计，可独立开关
• 兼容 GitHub Pages 构建限制

文件新增：

• assets/js/fancy-effects.js - 核心特效脚本
• _sass/_fancy-effects.scss - 特效样式文件
• _sass/_post-enhanced.scss - 文章增强样式
• _includes/post-meta-enhanced.html - 文章元数据组件
• _includes/daily-poetry.html - 今日诗词组件
• _includes/music-player.html - 音乐播放器组件
• _includes/weather-widget.html - 天气小组件

预期效果：

• 大幅提升用户体验和视觉效果
• 增强博客互动性和趣味性
• 保持稳定的 GitHub Pages 构建
• 为后续功能扩展打下基础