Cloudflare

读《内观——葛印卡的解脱之道》时记了几百段读书笔记，一直想让这些内容能公开分享、随时随地读。于是把它做成了一个多页 HTML 电子书网页版。 项目已收录 → 项目页：《内观》电子书网页版 这个项目挺有代表性——一本书变成一个可交互的阅读站，中间踩了不少坑。这篇复盘完整记录做法。 项目概况 项目 数据 书籍 《内观——葛印卡的解脱之道》（威廉·哈特） 输出 28 页 HTML 静态站 配图 657 张（AI 生成 + 压缩） 金句音频 506 条（本地 TTS） 书评 33 条（微信读书） 域名 vip.uuunit.com 托管 Cloudflare Pages 总大小 175MB（含音频） 全流程 1. 内容提取 & 结构化 先解决源头问题：内容从哪来？ EPUB：本质是 zip 包，里面是 HTML 文件。用 Python 解压 → 正则去标签 → 纯文本 Obsidian 笔记：读书时已经按段拆分了 546 段，格式是 ### {章节}-{段号} {标题} 用正则 r'### ([\\d]+)-([\\d]+) (.*?) — (.+)' 把笔记解析成结构化 JSON，每章一个文件。 ...

最近把 Hugo 博客部署到 Cloudflare Pages，看着简单，结果踩了一堆坑。记录一下，给后面的人省点时间。 坑一：主题文件别手写 一开始图省事，手动推了个简化版 PaperMod 主题到仓库。结果功能不全、CSS 缺失、搜索用不了。 正确做法： 构建时直接拉官方主题，别自己维护一份。 git clone --depth 1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod 坑二：HUGO_VERSION 必须和主题匹配 PaperMod 要求 Hugo >= 0.146.0，但 Cloudflare 默认可能是老版本。 解决： 在 Cloudflare Pages 环境变量里指定版本。 HUGO_VERSION = 0.146.0 坑三：TOML 语法别用 YAML 的写法 minify: 这种冒号写法是 YAML 的，TOML 要用 [minify] 表头。Cloudflare 用的是标准 TOML 解析器，一个字符错就整个构建失败。 [minify] disableXML = true 坑四：代码块要标注语言 Markdown 代码块如果不标注语言，Hugo 可能渲染异常。目录结构这种用 text： project/ |-- file1.py +-- file2.py 坑五：域名要加到 Pages 白名单 光在 DNS 配 CNAME 不够，Pages 项目本身也要把域名加进去，否则不响应请求。 坑六：构建日志看不到 Cloudflare Pages 的构建日志 API 不开放，只能网页上看。构建失败时，把日志贴出来就能定位。 ...