Hiensou 使用指南

这个博客基于 Astro 构建，采用代码仓库 + 内容仓库分离架构。对于本指南中未提及的 Astro 相关内容，请参考 Astro 文档。

由于不愿再维护一个服务器来部署博客故将博客从 WordPress 迁移至 Astro。

架构说明#

1
Hiensou （代码仓库）            Hiensou-Content （内容仓库）
2
   博客引擎、主题、配置             纯文章 markdown + 图片
3
   └── 部署在 Vercel              └── 推送即自动更新博客

你只需要在内容仓库写文章，推送后 Vercel 自动重新构建部署。

快速开始#

使用 Web 管理器（推荐）#

在内容仓库根目录双击 start-manager.bat，浏览器自动打开管理界面。支持：

新建 / 编辑 / 删除文章 — 表单式操作，支持 markdown 文件导入
标签和分类管理 — 标签 chips 输入，已有标签自动建议
按分类整理文件夹 — 一键将文章移动到分类子目录
推送部署 — 点击「推送」按钮，commit + push 一键完成

手动创建文章#

在内容仓库中按以下结构放置文件：

1
Hiensou-Content/
2
  posts/
3
    分类名/           ← 按分类整理的子目录（可选）
4
      文章目录/
5
        index.md      ← 文章内容
6
        cover.avif    ← 封面图
7
  essays/
8
    随笔名.md         ← 随笔（扁平文件，不需要子目录）
9
  gallery/
10
    相册id/
11
      album.md        ← 相册元信息
12
      photo1.avif     ← 照片

文章的 Frontmatter#

每篇文章的开头需要 YAML 格式的元信息：

1
---
2
title: 我的第一篇文章
3
published: 2026-07-09
4
description: 文章简介，显示在首页卡片上
5
image: ./cover.avif
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

字段说明#

属性	必填	说明
`title`	是	文章标题
`published`	是	发布日期，格式`YYYY-MM-DD`
`description`	否	文章简介，显示在首页和 SEO
`image`	否	封面图路径，支持相对路径（`./cover.avif`）、`public` 目录、远程 URL
`tags`	否	标签数组，如`[前端, 教程]`
`category`	否	分类名，用于分类页和组织文件夹
`slug`	否	自定义 URL 路径。默认用文件夹名
`draft`	否	草稿模式，设为`true` 时不显示。默认 `false`
`pinned`	否	置顶，设为`true` 时排在列表最前
`comment`	否	是否开启评论，默认`true`
`password`	否	文章密码，设置后需输入密码才能查看
`passwordHint`	否	密码提示文字
`author`	否	作者名
`licenseName`	否	许可协议名称
`licenseUrl`	否	许可协议链接
`sourceLink`	否	原文链接或参考资料
`updated`	否	更新日期，不设置则用发布日期
`lang`	否	语言代码，仅当与站点默认语言不同时需要

自定义 URL（Slug）#

如果不设置 slug，URL 使用文章所在文件夹名。设置 slug 可以覆盖：

1
---
2
title: 如何使用 Hiensou 博客
3
slug: how-to-use-hiensou
4
---

这个文章无论放在哪个文件夹，URL 始终是 /posts/how-to-use-hiensou。

整理分类文件夹时，管理器会自动写入 slug 字段，确保 URL 不会因移动而改变。

随笔#

随笔是简短的随想记录，区别于正式的技术文章。只需标题、日期、正文：

1
---
2
title: 今天的一点想法
3
published: 2026-07-09
4
---
5

6
正文内容...

随笔文件直接放在 essays/ 目录下（.md 扁平文件，不需要子目录），不会出现在归档、分类和标签页中。

系列文章#

将多篇文章组织成一个系列。

创建系列#

在 series/ 目录创建文件，或使用管理器「系列」Tab：

1
---
2
id: unity-tutorial
3
name: Unity 入门教程
4
description: 从零开始学习 Unity 游戏开发
5
---

将文章加入系列#

在文章 frontmatter 中添加：

1
---
2
series: unity-tutorial
3
seriesOrder: 2
4
---

同一 series 值的文章自动聚合，按 seriesOrder 排序。文章页面底部自动出现系列导航。

相册#

相册也由内容仓库管理。每个相册是一个独立目录：

1
gallery/
2
  tokyo-2026/
3
    album.md       ← 元信息
4
    cover.avif     ← 封面图（可选）
5
    photo-1.avif   ← 照片
6
    ...

album.md 格式：

1
---
2
name: 东京游记
3
description: 记录东京的每一个美好瞬间
4
date: "2026-07-09"
5
location: 日本东京
6
tags: [旅行, 东京]
7
password: ""        # 留空不加密
8
passwordHint: ""    # 密码提示
9
---

照片支持 jpg / png / webp / avif / gif 格式。cover.* 文件会自动作为封面。

工作流#

1
管理器编辑 → 推送 → Vercel 自动部署 → 博客更新

音乐