简介
简单说一下吧，就是之前的博客使用的是valaxy架构配合sakura主题，后面经过AIOVTUE-雪的一系列魔改才有了如今的模样，怀念的小伙伴可以去这里看看AIOVTUE-valaxy,你会发现其实和现在没什么区别，因为我将他完完全全的在hugo进行了重构，由于是重构，所以整体项目和文件会更加清晰，配置也会更加简单，由于之前是魔改的，导致东一块西一块的，这也是重构的原因之一，另一个重构的原因就是，AIOVTUE-雪很久之前就听说hugo的速度多么多么块，实际体验下来也很震惊，真的很快，就是主题太稀缺了，而且大都不符合AIOVTUE-雪的审美，因此进行了重构，重构后的主题AIOVTUE-雪觉得在hugo的主题里应该也算能排得上号了吧，至少按我的审美是这样的啦~
预览一下站点
看看站点截图吧（斯~，为什么要让你们在这个站点看这个站点的截图） 
开源地址
先附上开源地址吧Hugo-aiovtue,点击链接fork到自己的仓库之后在修改哦，记得给AIOVTUE-雪点个star哦，谢谢啦~
自定义
目录结构
text
hugo-blog/
├── hugo.toml # ★ 主配置（站点信息、导航、Hero、评论、赞助等）
├── data/
│ └── links.yaml # ★ 友链卡片数据
├── content/ # ★ 所有文章与页面（Markdown）
│ ├── posts/ # 博客文章
│ ├── gallery/ # 相册
│ ├── about.md # 关于页
│ ├── links.md # 友链页（壳子，数据在 data/links.yaml）
│ ├── comment.md # 留言页
│ ├── search.md # 搜索页
│ ├── archives/ # 归档页
│ ├── categories/ # 分类列表页
│ └── tags/ # 标签列表页
├── static/ # ★ 原样复制的静态文件（favicon、hero、envelope）
├── themes/aiovtue/ # 主题（一般不改，除非调样式/布局）
├── scripts/
│ ├── build.mjs # 正式构建
│ └── fetch-links-rss.mjs
├── package.json # npm 脚本
└── public/ # 构建输出（自动生成，勿手改，已 gitignore）标 ★ 的是日常最常改动的位置。hugo.toml 和 data/links.yaml 内已写中文注释，可直接打开查看说明
文章位置
路径： content/posts/ 每篇文章一个 .md 文件，文件名即 URL 别名（slug）。例如 content/posts/memos-web.md 对应 /posts/memos-web/
新建文章
在 content/posts/ 下新建 my-new-post.md：
markdown
---
title: "文章标题"
description: "摘要，用于 SEO 和分享卡片"
date: 2026-06-20
lastmod: 2026-06-20 # 可选，最后修改时间
cover: "https://example.com/cover.jpg" # 封面图 URL
categories:
- 分类名
tags:
- 标签一
- 标签二
weight: 1 # 可选，越小越靠前（置顶用）
---
正文使用 **Markdown** 书写。
支持代码块、图片、表格等。图片可写：
保存后，本地 npm run dev 即可在浏览器预览。
编辑 / 删除文章
- 编辑： 直接改对应的
content/posts/*.md - 删除： 删除该
.md文件，然后执行npm run build（会清理public/中的旧页面）
Front Matter 说明
字段
必填
说明
title
是
标题
date
是
发布日期
description
建议
摘要（搜索、OG 分享）
cover
建议
封面图
categories
建议
分类（自动生成分类页）
tags
建议
标签
lastmod
否
最后修改时间
weight
否
排序权重，数字越小越靠前
页面位置
Hugo 中「页面」分两类：
独立页面（单文件）
位于 content/ 根目录，通过 front matter 的 layout 指定模板：
文件
访问路径
layout
说明
about.md
/about/
about
关于页，正文写在文件里
links.md
/links/
links
友链页壳子，卡片在 data/links.yaml
comment.md
/comment/
comment
留言页（Waline + 信封动画）
search.md
/search/
search
全文搜索页
编辑关于页： 改 content/about.md 的 Markdown 正文即可。
编辑友链： 改 data/links.yaml（不是 links.md）。
栏目 / 列表页（目录 + _index.md）
目录
访问路径
说明
content/archives/_index.md
/archives/
归档（含统计图）
content/categories/_index.md
/categories/
全部分类
content/tags/_index.md
/tags/
全部标签
content/gallery/_index.md
/gallery/
相册列表
分类页、标签详情页由 Hugo 根据文章 front matter 自动生成，无需手动创建。
相册（特殊页面）
text
content/gallery/
├── _index.md # 相册列表（albums 字段控制显示哪些相册）
├── bizhi/index.md # 相册「一些壁纸」→ /gallery/bizhi/
└── jiamio/index.md # 相册「秘密哦」→ /gallery/jiamio/新建相册：
- 创建
content/gallery/新相册名/index.md - 在
content/gallery/_index.md的albums列表中加入新相册名
相册 front matter 示例：
markdown
---
title: "相册标题"
date: 2025-08-18
cover: "https://example.com/cover.jpg"
desc: "相册描述"
location: "重庆"
encrypted: false # true 时启用密码门
password: "your-password" # encrypted 为 true 时填写
source: local
tags:
- 壁纸
photos:
- url: "https://example.com/photo1.jpg"
date: 2026-6-1
- url: "https://example.com/photo2.jpg"
date: 2026-5-20
---友链（特殊页面）
友链公告文件位置：themes/aiovtue/layouts/partials/friend-link-notice.html
评论系统
评论出现在文章详情页、友链页、留言页底部，在 hugo.toml 中配置。
选择评论服务
toml
[params.comment]
provider = 'waline' # waline | twikooWaline
- 在 Waline 或托管平台（如 HouLang 评论服务 文档所列）创建站点，获得 serverURL。
- 填入
hugo.toml：
toml
[params.waline]
# Waline 服务端地址（创建应用后获得，末尾不要加 /）
serverURL = 'https://你的地址'
placeholder = '分享你的想法...' # 评论框占位文字（可选）- 保存后重新构建部署。评论区会随站点
html.dark类自动切换深浅色。
Twikoo
若改 Twikoo，将 provider 设为 twikoo 并配置：
toml
[params.twikoo]
envId = 'https://你的-twikoo-地址/'关闭单篇文章评论
在文章 front matter 中加：
yaml
comment: false站点配置
想改什么
改哪个文件
站点名、域名、导航、Hero、社交、赞助、评论、页脚
hugo.toml
友链卡片
data/links.yaml
首页轮播图 / 留言信封图
static/hero/、static/envelope/
网站图标
static/favicon.png
主题样式、布局
themes/aiovtue/（进阶）
修改 hugo.toml 后，开发服务器会自动热重载；改 static/ 文件后刷新浏览器即可。
重要： 部署前确认 hugo.toml 顶部 baseURL 与线上域名一致
部署教程
部署步骤很简单啦，支持cloudflare，vercel，netlify等平台，构建命令使用npm run build，构建目录使用public,其他不变，然后直接点击部署即可 好啦，这期就到这里啦，我们下期再见咯~ 记得给AIOVTUE-雪点star哦！
- 本文链接：https://zzhitao.site/posts/hugo-theme/aiovtue/hugotheme-aiovtue
- 版权声明：本博客所有文章除特别声明外，均默认采用 CC BY-NC-SA 许可协议。
