简介
本项目基于hugo进行构建，主题为aiovt-simple主题，主题的制作参考了开源项目Shiro,部分页面几乎一样，感谢大佬开源，本项目也已经开源
原创部分为行星环 采用绝无仅有的方式展示你的文章，本项目更适合用作记录而非发布，下面是预览图片展示 
下面是行星环深色模式动态演示
部署教程
快速开始
本地开放，先克隆仓库，再运行预览
bash
# 克隆仓库
git clone https://github.com/AIOVTUE/hugo-theme-aiovtue.git
cd hugo-theme-aiovtue
# 修改 hugo.toml 中的 baseURL、站点信息等
# 本地开发（含草稿，热更新）
hugo server -D
# 生产构建
hugo --minify --gc构建输出在 public/
项目结构
text
hugo-theme2/
├── hugo.toml # 站点主配置（菜单、Hero、Twikoo、首页、搜索等）
├── data/
│ └── friends.yaml # 友链分组与链接
├── content/ # Markdown 内容
│ ├── posts/ # 文章
│ ├── thoughts/ # 动态
│ ├── about/ # 关于
│ ├── archives/ # 归档
│ ├── friends/ # 友链页
│ └── guestbook/ # 留言
├── static/ # 原样复制到站点根（_headers、图片等）
├── archetypes/ # 新建内容模板
├── scripts/
│ └── build.sh # CI 构建脚本（自动处理预览 URL）
├── themes/aiovt-simple/ # 主题
│ ├── assets/ # CSS / JS（Hugo Pipes 打包）
│ └── layouts/ # 模板与 partials
├── netlify.toml # Netlify 部署
├── vercel.json # Vercel 部署
├── wrangler.toml # Cloudflare Pages 部署
└── package.json # npm 构建脚本（供 CI 使用）主要配置
配置项
位置
说明
站点信息 / 菜单
hugo.toml → [params]、[[menus.main]]
标题、头像、导航
Twikoo 评论
[params.twikoo]
envId 为评论服务地址，全站共用
友链列表
data/friends.yaml
分组与链接数据
首页视图
[params.home].desktop_posts_view
orbit 或 timeline
动态分页
[params.thoughts]
initial_count / load_batch
加载动画
[params.loader]
min_duration / max_duration
站内搜索
[params.search]
检索 posts、thoughts 等 section
一言
[params.hitokoto]
可配置类型、刷新间隔
页脚
[params.footer]
ICP、版权、生命计时
部署前请将 hugo.toml 顶部的 baseURL 改为你的正式域名。
部署
仓库已包含 Netlify、Vercel、Cloudflare Pages 的配置文件。三平台通用参数如下：
项
值
构建命令
npm run build（或直接 hugo --minify --gc）
输出目录
public
Hugo 版本
0.163.3（最低 0.146.0 Extended）
环境变量
HUGO_VERSION、HUGO_ENV=production（可选 HUGO_ENABLEGITINFO=true）
Netlify
- Netlify → Add new site → Import an existing project
- 连接 Git 仓库，Netlify 会自动读取
netlify.toml - 确认构建命令
npm run build、发布目录public - 绑定自定义域名后，将
hugo.toml中baseURL改为该域名
Vercel
- Vercel → Add New Project → 导入 Git 仓库
- Vercel 读取
vercel.json，Framework Preset 选 Other - 构建命令
npm run build，输出目录public
Cloudflare Pages
- Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git
- 构建配置： | Build command |
npm run build| | Build output directory |public| | Root directory |/（默认） |
- 本文链接：https://zzhitao.site/posts/hugo-theme/simple/aiovt-simple
- 版权声明：本博客所有文章除特别声明外，均默认采用 CC BY-NC-SA 许可协议。
