我的博客开源啦

发表于· 分类：开源· 标签：#教程, #博客, #开源

简介

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

预览一下站点

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




开源地址

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

自定义

目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
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：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
---
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 说明
字段 必填 说明
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 自动生成，无需手动创建。

相册（特殊页面）
1
2
3
4
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 示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
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 中配置。

选择评论服务

1
2
[params.comment]
  provider = 'waline'   # waline | twikoo
Waline
  1. 在 Waline 或托管平台（如 HouLang 评论服务 文档所列）创建站点，获得 serverURL。
  2. 填入 hugo.toml：
1
2
3
4
[params.waline]
  # Waline 服务端地址（创建应用后获得，末尾不要加 /）
  serverURL = 'https://你的地址'
  placeholder = '分享你的想法...'   # 评论框占位文字（可选）
  1. 保存后重新构建部署。评论区会随站点 html.dark 类自动切换深浅色。
Twikoo

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

1
2
[params.twikoo]
  envId = 'https://你的-twikoo-地址/'
关闭单篇文章评论

在文章 front matter 中加：

1
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哦！

我的博客开源啦
© AIOVTUE · https://20030327.xyz/posts/c8f00873/· 更新于 2026-06-22