更新过程

最近将博客使用的 Hugo Stack 主题更新到了最新版本。以下是具体的更新步骤：

1. 初始化子模块

   git submodule init
   git submodule update
   

2. 更新到最新版本

   git submodule update --remote --merge themes/stack
   

3. 提交更改

   git add themes/stack
   git commit -m "Update Stack theme to latest version"
   

主要更新内容

这次更新带来了许多重要的改进和新功能：

1. 开发环境支持

• 新增 DevContainer 支持，方便在容器化环境中开发
• 改进了开发工具的配置

2. 评论系统增强

• 新增多种评论系统支持：
  • Giscus
  • Twikoo
  • DisqusJS
  • Cactus
  • Cusdis
  • Gitalk
  • Beaudar

3. 国际化支持

• 新增多种语言支持：
  • 阿拉伯语
  • 保加利亚语
  • 意大利语
  • 等多种语言

4. UI 改进

• 优化了文章布局和样式
• 改进了侧边栏组件
• 新增了目录（TOC）组件
• 优化了搜索功能

5. 新增功能

• 新增多个 shortcode：
  • gitlab
  • quote
  • video
• 新增分类组件
• 改进了图片处理功能

注意事项

在更新主题后，建议：

1. 检查配置文件是否需要调整
2. 本地运行 hugo server 测试网站
3. 如果有自定义修改，可能需要重新应用

配置修复

在更新过程中遇到了一些配置问题，以下是修复方法：

1. 菜单图标配置

新版本中菜单图标配置方式发生了变化，需要将 pre 字段改为使用 params.icon：

menu:
    main:
        - identifier: home
          name: Home
          url: /
          weight: -100
          params:
            icon: home

2. OpenGraph 模板错误

如果遇到 .Site.Lastmod 相关的错误，需要在配置文件中添加 lastmod 字段：

params:
    lastmod: 2024-03-21

总结

这次更新不仅带来了许多新功能，还改进了现有功能的性能和用户体验。建议定期更新主题以获取最新的功能和安全性改进。