我的博客开源啦

简介

简单说一下吧，就是之前的博客使用的是valaxy架构配合sakura主题，后面经过AIOVTUE-雪的一系列魔改才有了如今的模样，怀念的小伙伴可以去这里看看AIOVTUE-valaxy,你会发现其实和现在没什么区别，因为我将他完完全全的在hugo进行了重构，由于是重构，所以整体项目和文件会更加清晰，配置也会更加简单，由于之前是魔改的，导致东一块西一块的，这也是重构的原因之一，另一个重构的原因就是，AIOVTUE-雪很久之前就听说hugo的速度多么多么块，实际体验下来也很震惊，真的很快，就是主题太稀缺了，而且大都不符合AIOVTUE-雪的审美，因此进行了重构，重构后的主题AIOVTUE-雪觉得在hugo的主题里应该也算能排得上号了吧，至少按我的审美是这样的啦~

预览一下站点

看看站点截图吧（斯~，为什么要让你们在这个站点看这个站点的截图）

开源地址

先附上开源地址吧Hugo-aiovtue,点击链接fork到自己的仓库之后在修改哦，记得给AIOVTUE-雪点个star哦，谢谢啦~

自定义

目录结构

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/
│   └── migrate-content.mjs  # 从上级 Valaxy 项目批量同步内容
├── 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：

---
title: "文章标题"
description: "摘要，用于 SEO 和分享卡片"
date: 2026-06-20
lastmod: 2026-06-20          # 可选，最后修改时间
cover: "https://example.com/cover.jpg"   # 封面图 URL
categories:
  - 分类名
tags:
  - 标签一
  - 标签二
weight: 1                     # 可选，越小越靠前（置顶用）
---

正文使用 **Markdown** 书写。

支持代码块、图片、表格等。图片可写：

![说明](https://example.com/image.jpg)

保存后，本地 npm run dev 即可在浏览器预览。

编辑 / 删除文章

• 编辑： 直接改对应的 content/posts/*.md
• 删除： 删除该 .md 文件，然后执行 npm run build（会清理 public/ 中的旧页面）

Front Matter 说明

页面位置

Hugo 中「页面」分两类：

独立页面（单文件）

位于 content/ 根目录，通过 front matter 的 layout 指定模板：

编辑关于页： 改 content/about.md 的 Markdown 正文即可。

编辑友链： 改 data/links.yaml（不是 links.md）。

栏目 / 列表页（目录 + _index.md）

分类页、标签详情页由 Hugo 根据文章 front matter 自动生成，无需手动创建。

相册（特殊页面）

content/gallery/
├── _index.md          # 相册列表（albums 字段控制显示哪些相册）
├── bizhi/index.md     # 相册「一些壁纸」→ /gallery/bizhi/
└── jiamio/index.md    # 相册「秘密哦」→ /gallery/jiamio/

新建相册：

1. 创建 content/gallery/新相册名/index.md
2. 在 content/gallery/_index.md 的 albums 列表中加入 新相册名

相册 front matter 示例：

---
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 中配置。

选择评论服务

[params.comment]
  provider = 'waline'   # waline | twikoo

Waline

1. 在 Waline 或托管平台（如 HouLang 评论服务 文档所列）创建站点，获得 serverURL。
2. 填入 hugo.toml：

[params.waline]
  # Waline 服务端地址（创建应用后获得，末尾不要加 /）
  serverURL = 'https://你的地址'
  placeholder = '分享你的想法...'   # 评论框占位文字（可选）

3. 保存后重新构建部署。评论区会随站点 html.dark 类自动切换深浅色。

Twikoo

若改 Twikoo，将 provider 设为 twikoo 并配置：

[params.twikoo]
  envId = 'https://你的-twikoo-地址/'

关闭单篇文章评论

在文章 front matter 中加：

comment: false

站点配置

修改 hugo.toml 后，开发服务器会自动热重载；改 static/ 文件后刷新浏览器即可。

重要： 部署前确认 hugo.toml 顶部 baseURL 与线上域名一致

部署教程

部署步骤很简单啦，支持cloudflare，vercel，netlify等平台，构建命令使用npm run build，构建目录使用public,其他不变，然后直接点击部署即可 好啦，这期就到这里啦，我们下期再见咯~ 记得给AIOVTUE-雪点star哦！