# 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://fukun.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

### 品牌与图标

- [x] FK 手写书法风格图标，黑底 `#111`，白字
- [x] 浅色/深色双版图标（`logo.svg` / `logo-dark.svg`）
- [x] 导航栏仅显示图标，隐藏标题文字，40×40px
- [ ] 多平台 favicon 适配
- [ ] 自定义 OG 社交分享图（1200×630）
- [ ] iOS/Android 触屏图标

### 首页（参考 Dan Koe 风格）

- [x] Hero 标题：**FuKun**
- [x] 副标题：*FuKun.Net — Tech notes & life*
- [x] 最新文章列表（6 篇）
- [ ] **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 调优