用途:把一段时间的社群或技术动态整理成可上台、可分享、可查证的 HTML 简报,输出为单一自包含 HTML 加 assets 资料夹,无框架、无 build step、离线可跑,可直接部署成网址。适用于每月社群小聚汇报、产业动态整理,以及已有简报要改版面、补素材、加页或部署;不适用于纯文字月报文章或需正式排版的长文件。
流程:1. 取材,先读 references/source-recipes.md,含 Reddit/YouTube/Medium/GitHub/会议官网被挡后的可行路径;版本号取自官方机器可读来源,影片查 uploadDate 确认属本期,每个数字可指回 URL,缺数据要标注不用推测;素材用 python3 scripts/harvest_media.py manifest.json --root assets 批次下载到本机。2. 按听众关心程度排序内容。3. 从 assets/deck-template.html 复制,按 references/slide-patterns.md 选版面,每页需有秒懂视觉,撰稿以「谁、何时、做了什么、数字多少」为主。4. 用 python3 scripts/verify_deck.py path/to/slides.html 验证 overflow、破图、孤行并产出 contact sheet,exit code 0 干净/1 有问题。5. 用 python3 scripts/refresh_fonts.py path/to/slides.html 做字体子集化,改文字后需重跑。6. 按 references/publish.md 部署,现场放映用 assets/serve.sh 走 localhost,因 YouTube 拒绝 file:// 内嵌。
限制:素材须离线可用;选择托管需计算流量;不要在个人 vault repo 开 Pages;部署后需实测素材、字体与 YouTube 播放;中文文件名在 GitHub Pages 会 404,需改 ASCII 文件名。其余细节暂未提供。