155 lines
4.2 KiB
Markdown
155 lines
4.2 KiB
Markdown
# FuKun.Net
|
||
|
||
基于 [Hugo](https://gohugo.io/) + [Hextra](https://github.com/imfing/hextra) 构建的个人站点，部署在腾讯云 Lighthouse 自托管服务器上。
|
||
|
||
---
|
||
|
||
## 技术栈
|
||
|
||
| 层面 | 选型 |
|
||
|------|------|
|
||
| 静态生成器 | Hugo v0.161+ (extended) |
|
||
| 主题 | Hextra |
|
||
| CSS | Tailwind CSS v4（Hextra 内置） |
|
||
| 站内搜索 | FlexSearch（客户端全文搜索） |
|
||
| 字体 | iA Writer Quattro S（自托管） + Noto Sans SC（Google Fonts） |
|
||
| Web 服务器 | Nginx on Ubuntu 24.04 |
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
Hugo/
|
||
├── hugo.yaml # 站点配置
|
||
├── README.md
|
||
│
|
||
├── content/
|
||
│ ├── _index.md # 首页（Hero + 最新文章）
|
||
│ ├── about/
|
||
│ │ └── _index.md # 关于页
|
||
│ └── blog/
|
||
│ ├── _index.md # 文章列表
|
||
│ └── *.md # 单篇文章
|
||
│
|
||
├── layouts/
|
||
│ ├── hextra-home.html # 自定义首页布局（覆盖主题）
|
||
│ └── _partials/
|
||
│ └── custom/
|
||
│ └── head-end.html # 字体预加载
|
||
│
|
||
├── assets/
|
||
│ └── css/
|
||
│ └── custom.css # 字体覆盖、导航栏修复
|
||
│
|
||
├── i18n/
|
||
│ └── zh-cn.yaml # 覆盖页脚版权文案
|
||
│
|
||
├── static/
|
||
│ ├── images/
|
||
│ │ ├── logo.svg # FK 图标（浅色模式）
|
||
│ │ └── logo-dark.svg # FK 图标（深色模式）
|
||
│ └── fonts/
|
||
│ └── iAWriterQuattroSRegular.ttf
|
||
│
|
||
├── themes/
|
||
│ ├── hextra/ # 当前主题
|
||
│ ├── PaperMod/ # 备用主题
|
||
│ ├── terminal/
|
||
│ └── minimal/
|
||
│
|
||
└── archetypes/
|
||
└── default.md # 新文章模板
|
||
```
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 本地开发（热重载）
|
||
hugo server
|
||
|
||
# 包含草稿
|
||
hugo server -D
|
||
|
||
# 生产构建
|
||
hugo --gc --minify
|
||
|
||
# 新建文章
|
||
hugo new blog/文章名.md
|
||
|
||
# 预览其他主题
|
||
hugo server -t PaperMod
|
||
hugo server -t terminal
|
||
```
|
||
|
||
构建产物输出到 `public/`，通过 Nginx 提供服务。
|
||
|
||
## 关键配置
|
||
|
||
`hugo.yaml` 中的核心设置：
|
||
|
||
| 参数 | 值 | 说明 |
|
||
|------|-----|------|
|
||
| `baseURL` | `https://fukunee.net/` | 生产环境域名 |
|
||
| `theme` | `hextra` | 当前主题 |
|
||
| `hasCJKLanguage` | `true` | 中日韩语言优化 |
|
||
| `navbar.displayTitle` | `false` | 导航栏仅显示图标 |
|
||
| `navbar.displayLogo` | `true` | 启用 40×40 FK 图标 |
|
||
| `search.type` | `flexsearch` | FlexSearch 全文搜索 |
|
||
| `blog.list.pagerSize` | `10` | 每页文章数 |
|
||
| `comments.enable` | `false` | 评论系统关闭 |
|
||
|
||
---
|
||
|
||
## TODO
|
||
|
||
### 品牌与图标
|
||
|
||
- [ ] FK 手写书法风格图标，黑底 `#111`，白字
|
||
- [x] 浅色/深色双版图标（`logo.svg` / `logo-dark.svg`）
|
||
- [x] 导航栏仅显示图标，隐藏标题文字，40×40px
|
||
- [x] 多平台 favicon 适配
|
||
- [ ] 自定义 OG 社交分享图（1200×630）
|
||
- [ ] iOS/Android 触屏图标
|
||
|
||
### 首页（参考 Dan Koe 风格）
|
||
|
||
- [x] Hero 标题：**FuKun**
|
||
- [x] 副标题：*FuKun.Net — Tech notes & life*
|
||
- [x] 最新文章列表（6 篇）
|
||
- [x] **Slogan 重写** — 参照 Dan Koe 的文案风格：
|
||
- 一句话价值主张（如 "The Art of..." / "How to..." 句式）
|
||
- 个人使命宣言
|
||
- 读者能获得什么（结果导向，而非信息罗列）
|
||
- [ ] 视觉层级：标题 → slogan → 行动号召 → 文章列表
|
||
- [ ] Newsletter 订阅入口（可选）
|
||
|
||
### 关于页
|
||
|
||
- [ ] 个人介绍 — 我是谁、做什么、为什么
|
||
- [ ] 技能与兴趣
|
||
- [ ] 社交链接 / 联系方式
|
||
|
||
### 内容
|
||
|
||
- [x] 12 篇文章（中文 9 篇 + 英文 3 篇）
|
||
- [ ] 中英文内容策略 — 分开分类还是统一展示？
|
||
- [ ] 选题队列 — 草稿池
|
||
- [ ] 系列文章 / 合集支持
|
||
|
||
### 技术优化
|
||
|
||
- [x] Google Fonts：Noto Sans SC
|
||
- [x] 自托管字体：iA Writer Quattro S
|
||
- [x] 导航栏底部阴影线已移除
|
||
- [ ] TTF 转 woff2 以提升加载性能
|
||
- [ ] 图片优化管线
|
||
- [ ] CI/CD 推送自动部署
|
||
- [ ] 访问统计
|
||
|
||
### SEO 与元数据
|
||
|
||
- [x] OpenGraph 已启用
|
||
- [x] Schema.org 结构化数据已启用
|
||
- [ ] 单篇文章自定义 meta（description、keywords）
|
||
- [ ] Sitemap 验证
|
||
- [ ] robots.txt 调优
|