记录本站从零到上线的主要步骤和要点。
环境搭建
使用 Hugo v0.161.1 extended 版，通过 hugo new site 创建项目骨架。主题选用 Stack（卡片式设计，支持亮暗切换）。
主题配置
主题通过 Git submodule 添加到 themes/stack，配置文件放在 config/_default/ 下，支持分文件管理：
| 文件 | 用途 |
|---|---|
hugo.toml |
站点基础配置 |
params.toml |
主题参数（侧栏、小组件、配色等） |
menu.toml |
导航菜单 |
markup.toml |
Markdown 渲染与语法高亮 |
配色支持亮色/暗色一键切换，默认亮色。
自定义样式
在 assets/scss/custom.scss 中通过 CSS 变量覆盖实现背景渐变和毛玻璃效果：
- 亮色：浅蓝/绿/黄多色渐变
- 暗色：深蓝紫渐变，柔和护眼
- 主容器添加
backdrop-filter: blur(8px)增强层次感
启动与调试
|
|
开发服务器支持热重载。若端口被占用，Hugo 会自动分配可用端口。
发布构建
|
|
生成的静态文件输出到 public/ 目录，可直接部署到任何静态托管平台（GitHub Pages、Netlify、Vercel 等）。