基础配置

新建文章

文章和各种页面的编辑地址，\content这个文件夹立面放的是各种页面,\content\posts 这个文件夹里面则是文章啦，发布新文章就在这个文件夹立面新建一个.md文件即可，每个文章除了正文还需要一些属性，大体有以下这些：

title: "Hello World"
description: "这是本站的第一篇文章哦~"
date: 2024-04-20
lastmod: 2024-04-20
categories:
  - 随笔
tags:
  - 随笔
tocStartLevel: 3
tocEndLevel: 4

文章 Front Matter 字段说明

一些站点的基础配置~

文章目录

tocStartLevel和tocEndLevel是什么呢，页面右侧会有一个文章标题目录，本博客支持六级目录，但是全部渲染的话不太现实，这两行可以指定渲染的标题级别，start是开始，end是结束，拿上面的举例，就是从三级标题（###）开始渲染，到四级标题（####）结束渲染，默认也不会是全部渲染啦，没有特别需求其实可以不写这两行哦~

友链页面

友链页面的数据储存位置，即新增友链在哪里加，/data文件夹下方有一个links.yaml文件，这个文件里面写的就是友链信息啦~

友链下方的公告怎么修改呢，一般情况下网站会自动获取你的地址，头像这些，不过也不能避免的需要修改，修改位置在主题文件夹立面\themes\aiovtue\layouts\partials有一个名为friend-link-notice.html的文件，使用记事本或者编辑器打开整个文件，找到如下部分：

        本站友链信息如下：
      </p>
      <ul class="friend-link-site-info__list">
        <li>站点名称：<span class="friend-link-highlight">{{ .Site.Title }}</span></li>
        <li>站点链接：<span class="friend-link-highlight">{{ .Site.BaseURL }}</span></li>
        <li>站长头像：<span class="friend-link-highlight">{{ .Site.Params.author.avatar }}</span></li>
        <li>站点描述：<span class="friend-link-highlight">雨滴会记录生命中的每一个瞬间</span></li>
        <li>站点截图：<span class="friend-link-highlight">https://r2tc.20030327.xyz/file/博客/主题/1780909850378_1780909790262.png</span></li>

修改也很简单，替换诸如{{ .Site.BaseURL }}为你想替换的内容即可，具体参考站点截图那里的样子

网页信息

网页的大部分配置都在网页的配置文件之中，即根目录的hugo.toml文件，里面的注释挺完善的，跟着注释修改就好啦~

1. 独立页面（单文件）

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

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

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

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

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

3. 相册（特殊页面）

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
---

本地构建（模拟上线产物）

pnpm build

构建结果在 public/ 目录。--cleanDestinationDir 会先清空旧文件，避免已删文章残留。

本地预览构建结果（可选）：

npx --yes serve public
# 或任意静态文件服务器指向 public/

云端部署（Cloudflare Pages）

本站为纯静态站点，构建产物为 public/ 目录，适合 Cloudflare Pages。

1. 将 hugo-blog/ 推送到 GitHub / GitLab 等
2. 登录 Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git
3. 选择仓库，配置构建设置：

4. 保存并部署。首次成功后获得 *.pages.dev 预览地址。

5. 绑定自定义域名： Pages 项目 → Custom domains → 添加你的域名，按提示在 Cloudflare DNS 添加 CNAME。

6. 确认 hugo.toml 中 baseURL 与最终访问域名一致，改完后重新部署。

云端部署（vercel）

直接选择hugo即可，依旧配置好了，正常会自己跳出来 vercel新建项目，选择连接github，选择本项目，配置界面直接选hugo即可，如果失败的话，可以手动选择构建命令为npm run build, 输出目录public, 如何直接部署即可

云端部署（netlify）

直接选择hugo即可，依旧配置好了，正常会自己跳出来 netlify新建项目，选择连接github，选择本项目，配置界面直接选hugo即可，如果失败的话，可以手动选择构建命令为npm run build, 输出目录public, 如何直接部署即可

其实都是一样的啦，要么直接选hugo预设，要么手动输入构建命令和输出目录，一通百通~

常用命令速查

pnpm dev     # 本地开发预览
pnpm build   # 构建到 public/（部署用）