实验 12 · 30 分钟 · 入门
发布你的作品集
把十二课产物整理成作品集,完成发布前后两轮检查。
完成后你能
本课目标
- 整理稳定的文件与链接结构
- 写清作品说明与页面元数据
- 完成 HTTPS 公开页面回归
开始前
准备这些
- 收集前 11 课保留的 HTML 文件和截图
- 确定一个静态网站发布位置
- 新建 12-publish-portfolio/portfolio 文件夹
01 · 整理可迁移的目录
公开链接一旦分享就不应随意改变。使用小写英文、短横线和稳定目录,不把“最终版2”写进文件名。
如果某一课没有完成,可以在作品集写“制作中”,不要链接到不存在的页面。
示例
portfolio/
├── index.html
├── assets/
│ └── preview.png
├── first-artifact/
│ └── index.html
├── data-story/
│ └── index.html
└── practice-planner/
└── index.html- 挑选 3–5 个最能展示能力差异的作品。
- 把每个作品放进独立目录并使用 index.html。
- 逐个使用相对链接从作品集首页打开。
02 · 写作品说明,而不是文件清单
每个作品回答四件事:要解决的问题、你的角色、关键取舍、如何验证。读者不需要完整制作日记,但需要理解你做了哪些判断。
示例
问题:我需要快速判断一周学习是否偏离目标。
我的工作:定义主指标、组织信息层级、让 Agent 实现并完成移动端检查。
关键取舍:只保留一个主指标和两个辅助信号。
验证:在 1440px 与 390px 测试,并覆盖空数据状态。03 · 生成作品集首页
作品集首页的任务是解释和导航,不需要用夸张包装替代真实项目证据。
复制给 Agent
请在 12-publish-portfolio/portfolio 中创建 index.html,作为我的网页作品集首页。
首页包含:一句定位;3–5 个作品条目;每项的“问题/我的工作/关键取舍/验证”摘要;打开作品的明确链接;联系邮箱。
技术要求:所有站内资源使用相对路径;设置中文 lang、唯一 title、description、viewport、主题色与分享图元数据;页面离线打开时核心文字和链接仍可用;不加载外部框架或字体;390px 与 1440px 均可用。
不要虚构访问量、客户、奖项或我的技能年限。完成后输出一张“链接来源→目标文件”的清单。04 · 发布前检查
在本地逐个点击链接,并从一个空白浏览器窗口打开首页。注意文件名大小写:本机可用的链接,在 Linux 服务器上可能因大小写不一致而 404。
- 检查所有相对链接与图片路径。
- 确认 title 和 description 描述真实内容。
- 确认没有 API key、邮箱密码、个人地址或本地绝对路径。
- 打开浏览器开发者工具,检查控制台没有资源 404。
- 生成一张 1200×630 的分享预览图,内容与作品集一致。
05 · 发布与公开回归
把 portfolio 目录部署到支持静态文件与 HTTPS 的服务器。发布不是结束:必须使用公开 URL 重走一次关键路径。不同平台的具体命令不同,以你的服务器说明为准。
- 在无痕窗口打开公开 HTTPS 地址。
- 逐个打开作品,确认状态码与内容正确。
- 在真实手机或 390px 模拟器完成一次主要操作。
- 检查分享预览抓取的是公开图片而非本地路径。
- 记录发布时间、版本和回滚位置。
复制给 Agent
请为这个纯静态 portfolio 生成一份发布检查清单,不要执行部署。清单必须包含:备份旧版本、上传范围、HTTPS、首页状态码、所有作品链接、手机视口、控制台 404、分享元数据、回滚方法。把每项写成可以勾选的动作。06 · 给作品留下一条成长线
在首页页尾写明版本日期和下一次准备改进的一件事。作品集不是“永远完成”,但每个公开版本都应该完整、可解释、可回退。
- 保存公开 URL。
- 保存发布版本的本地副本或版本记录。
- 写下下一次只改一件什么事。
- 回看第一课截图,记录你现在能独立完成的三件事。
不要跳过
完成检查
逐项在真实页面中验证。勾选状态只保存在这台设备的浏览器中。
0 / 7 已完成
这一课完成了。产物留下来,下一课会继续用到。
常见错误
卡住时先看这里
- 上传整个工作目录
- 只发布需要公开的静态文件,先检查秘密与草稿。
- 本地通过就宣布发布
- 必须在公开 URL、无痕窗口和手机视口回归。
- 作品集只有缩略图和标题
- 补上问题、你的判断和验证证据。
可选加练
再多走一步
把作品集链接发给一位不了解课程的人,请他指出最想打开的作品和最不清楚的说明。