你好哇，我是豆沫！欢迎来到「Domal」——
一隅方寸藏山海，浅墨叙浮生。间或直抒胸臆，偶作闲语自呻吟。
这是一个基于 Hugo 搭建的静态博客主题，借鉴了 Shiro 的交互与 Yohaku 的视觉，翻译成纯静态的模板、CSS 与 JS，让文字与光影自己说话。

01 项目起源

「Domal」将两套优秀开源项目的设计基因移植到一个纯静态站点上：

Shiro —— 极简个人网站主题

为 Mix Space 生态设计的极简主义者主题，吸收其：

首页 Hero 区：标题 / 描述 / 头像 / 社交链接
活动区：四栏内容（纸上空谈 / 过眼烟云 / 静思笺 / 碎碎念）
聚合时间线：发丝图 + 每日发表量
弹性侧边导航栏 + 点赞交互

Yohaku / 余白 —— 为书写而生的排版系统

一种主色，三档中性灰，剩下都是留白。吸收其：

完整设计 token：#c56473 梅红强调色 / 10 阶中性灰 / 纸面底色
衬线标题 + 无衬线正文的字体契约
呼吸式动效与阅读节奏
书库、画廊、时间线等栏目版式

将两者的视觉与交互「翻译」成 Hugo 模板 / CSS / JS，部署为纯静态站点。
Domal.

02 功能特性

功能	方案
画廊灯箱	PhotoSwipe 5，支持左右滑动 / 缩放 / 键盘 / URL 直达
说说九宫格	微信朋友圈式图片布局（1~9 张自适应）+ PhotoSwipe 灯箱翻看
说说评论	每条说说独立评论区，手风琴展开 + 评论数徽标（QQ 空间式）
评论系统	Artalk（自托管 Go + SQLite，免登录匿名评论，深浅主题跟随）
文章点赞	Artalk 页面投票（真实计数，同访客防重复）
每日一句	一言 API（hitokoto.cn）+ 本地语录兜底
打字机效果	首页每日一句逐字打出 → 停顿 → 删除 → 切换下一句（多条语录轮换）
深浅主题	一键切换 + Artalk 同步换肤 + 无闪烁（FOUC 防护）
数学公式	KaTeX 按需加载
阅读量统计	Artalk 页面浏览量（真实计数）
返回导航	文章详情顶部 ← 返回栏目列表（Posts / Gallery / Thinking）
页脚彩蛋	品牌签名 + 隐藏链接「·」→ 书库 + 工信部备案号
时间线 Tooltip	独立 HTML 浮层，无裁切、自动翻转防越界、滚动跟随
响应式	桌面弹性侧栏 / 移动底部导航自适应

03 内容类型

栏目	首页活动区名	布局	数据来源
Posts	纸上空谈	分页列表 + 单篇文章	`content/posts/*.md`
Gallery	过眼烟云	相册网格 + 图片灯箱	`content/gallery/*/`（leaf bundle + 图片资源）
Thinking	静思笺	目录列表 + 详情	`content/thinking/*.md`
Says	碎碎念	竖版列表（锚点直达）+ 图片九宫格 + 每条独立评论	`content/says/.md` + `static/says//`
Books	藏书阁	书库 + 章节阅读	`data/books.yaml` + `content/books/*/`
Timeline	时间线	年份 Tab + 按月折叠	聚合所有公开内容类型
Friends	友链	好友卡片	`content/friends/*.md`
Projects	项目	卡片网格	`content/projects/*.md`
Tags	标签	Hugo 原生 Taxonomy	—

04 技术架构

hugo.yaml
  └─ themes/domal
      ├─ hugo.toml
      ├─ layouts
      │   ├─ baseof.html            # 骨架：主题初始化(防FOUC)/头部/导航/页脚/Artalk 配置
      │   ├─ home.html              # 首页：Hero + 四栏活动区 + 聚合时间线（Tooltip 独立浮层）
      │   ├─ _default/single.html   # 文章详情（返回导航/点赞/评论/阅读量）
      │   ├─ partials/              # 弹性导航/页脚/主题切换/评论(Artalk)
      │   ├─ gallery/               # 相册列表 + PhotoSwipe 详情页
      │   ├─ posts / books / thinking / timeline / friends / projects / says（各内容类型布局）
      │   └─ taxonomy/              # 标签 / 分类
      ├─ assets/css/domal.css       # 主样式：设计 token + 组件 + 深浅主题
      ├─ i18n/zh-CN.yaml
      └─ static/
          ├─ favicon / avatar / iconfont / artalk 前端
          └─ photoswipe/            # 内嵌 PhotoSwipe 5 库（无 CDN 依赖）

05 我在写什么

纸上空谈（文章）：长文、设计、代码与思考
过眼烟云（画廊）：光影流转，定格瞬间
藏书阁（书库）：平时写的文章与小说
碎碎念（说说）：一些短句与随拍

06 联系

07 废话

最初，博客只是简约的一方小天地，只想安静的记录文字。直到偶然遇见 Yohaku 的排版系统，那种书写美学，让我一见倾心。可我始终向往纯静态的站点，便萌生了将这份审美亲手移植到 Hugo 的念头。

这一做，就是三个多月。Hugo 的 Go 生态让我屡屡碰壁，移植路上障碍重重，几度想放弃。糟糕的是，某次回看时才发现原代码已被误删——只能咬着牙、含着泪，从残片里重新拼起，靠着翻案例，求 AI，直至最终完成。

关于