绝美hugo主题博客-行星环

简介

本项目基于hugo进行构建，主题为aiovt-simple主题，主题的制作参考了开源项目Shiro,部分页面几乎一样，感谢大佬开源，本项目也已经开源

开源地址： https://github.com/AIOVTUE/hugo-theme-asimple

原创部分为行星环 采用绝无仅有的方式展示你的文章，本项目更适合用作记录而非发布，下面是预览图片展示

下面是行星环深色模式动态演示

部署教程

快速开始

本地开放，先克隆仓库，再运行预览

# 克隆仓库
git clone https://github.com/AIOVTUE/hugo-theme-aiovtue.git
cd hugo-theme-aiovtue

# 修改 hugo.toml 中的 baseURL、站点信息等

# 本地开发（含草稿，热更新）
hugo server -D
# 生产构建
hugo --minify --gc

构建输出在 public/

项目结构

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].desktoppostsview | orbit 或 timeline |
| 动态分页 | [params.thoughts] | initialcount / loadbatch |
| 加载动画 | [params.loader] | minduration / maxduration |
| 站内搜索 | [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） |
| 环境变量 | HUGOVERSION、HUGOENV=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
构建配置：