最小发布路径

09-03 最小发布路径

课程定位

这一课讲最小发布路径。学员前面已经能区分本地和线上，也知道发布前要检查什么。现在要让他们经历一次“作品拥有公开入口”的时刻。

本课重点是理解流程和完成体验。具体平台可以选 GitHub Pages、Cloudflare Pages 或课程当时统一采用的平台。讲课时把平台按钮当作工具入口，把流程讲成四步：准备项目、上传材料、获得链接、打开验收。

这一课的成果是一份「发布记录」。

本课目标

• 能说清发布的四个步骤。
• 能理解发布平台的作用。
• 能知道发布前先保存版本和 README。
• 能获得一个公开访问链接。
• 能打开线上链接并完成发布后检查。

录制建议

• 建议时长：25 到 40 分钟。
• 用静态 HTML 项目演示，减少构建复杂度。
• 平台选择保持统一，课堂中只展开一个主线平台。
• 操作中多停顿，让学员看清“我现在在哪一步”。
• 线上页面打开后，要给学员一个仪式感：作品有门牌号了。

课前准备

• 一个已通过发布前检查的本地项目。
• README。
• Git 版本记录。
• 平台账号。
• 浏览器。

讲稿正文

可以这样开场：

“这一课，我们做一件很有成就感的事：给自己的小作品一个公开门牌号。它以前躺在你的电脑里，现在要站到互联网的街边。”

先讲发布平台的作用。

发布平台像一排公共展柜。你把项目材料交给它，它帮你把页面放到互联网上，并给你一个可以访问的链接。学员暂时只需要理解这个关系：本地项目是材料，发布平台是展柜，公开链接是门牌号。

发布最小流程分四步：

第一步：准备项目。

确认页面能打开，README 写清楚，敏感内容已清理，Git 已保存当前版本。

第二步：上传或连接项目。

根据课程选择的平台，把项目交给发布平台。这里可以采用最简单的入口，例如上传文件夹、连接仓库或按平台指引选择项目。

第三步：等待平台生成链接。

平台处理完成后，会给出一个 https:// 开头的地址。这个地址就是作品的公开入口。

第四步：打开链接验收。

发布完成只是流程完成，验收要回到页面。打开线上链接，看内容、图片、按钮、链接、手机显示是否正常。

这里要讲一个很重要的心智：

“线上页面和本地页面可能有差异。看到差异，先把它当作发布现场给出的线索。回到发布记录，检查文件是否齐、路径是否对、平台是否完成处理。”

最后收束：

“最小发布的价值，远远超过这个页面本身。它让普通人第一次感受到：我可以把自己的数字作品送到世界上。”

屏幕演示流程

1. 打开项目，确认 README 和 Git 记录。
2. 打开发布前检查单，确认结论为可以发布。
3. 进入统一选择的发布平台。
4. 创建一个新项目或选择已有项目。
5. 按平台指引上传或连接项目。
6. 等待平台生成公开链接。
7. 打开公开链接。
8. 对照本地页面做一次线上验收。
9. 在工作日志里保存发布记录。

给 AI 的协作卡

我准备把这个本地静态网页发布到线上。
请根据我的项目文件和 README，帮我做三件事：
1. 复述当前项目是否适合发布
2. 列出发布前还要确认的事项
3. 给我一份发布后验收清单

如果我提供平台页面截图，请你只根据截图告诉我下一步该点击哪里，以及点击后要检查什么。

发布记录

• 项目名称：
• 本地项目位置：
• 发布前 Git 记录：
• 使用的平台：
• 公开链接：
• 发布日期：
• 线上页面检查结果：
• 本地与线上差异：
• 下一步修正：

课堂练习

学员完成一次最小发布，或者在老师演示环境中跟着填写发布记录。

要求：

• 记录本地项目位置。
• 记录公开链接。
• 截图线上页面。
• 写一句发布后验收结论。

常见卡点

• 平台入口太多：课堂只跟随主线入口。
• 线上页面空白：检查上传材料、入口文件、路径和平台处理状态。
• 图片丢失：检查图片是否放进项目、路径是否正确、文件名大小写是否一致。
• 改完本地后线上没变：重新发布或等待平台处理完成，再打开链接检查。
• 学员紧张：提醒他先发布一个最小作品，复杂功能留到专项课。

课后作业

完成一个最小页面的发布记录。

提交内容：

• 本地页面截图。
• 线上链接。
• 线上页面截图。
• 发布记录。
• 一句话复盘：这次发布卡在哪里，怎么解决。

课件页建议

• 第 1 页：给作品一个公开门牌号
• 第 2 页：项目材料、发布平台、公开链接
• 第 3 页：四步发布法：准备、上传、生成、验收
• 第 4 页：线上和本地差异怎么查
• 第 5 页：发布记录