实验 12 · 30 分钟 · 入门

发布你的作品集

把十二课产物整理成作品集,完成发布前后两轮检查。

本课产物
portfolio/index.html
学习方式
边做边检查

完成后你能

本课目标

  • 整理稳定的文件与链接结构
  • 写清作品说明与页面元数据
  • 完成 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
  1. 挑选 3–5 个最能展示能力差异的作品。
  2. 把每个作品放进独立目录并使用 index.html。
  3. 逐个使用相对链接从作品集首页打开。

02 · 写作品说明,而不是文件清单

每个作品回答四件事:要解决的问题、你的角色、关键取舍、如何验证。读者不需要完整制作日记,但需要理解你做了哪些判断。

示例
问题:我需要快速判断一周学习是否偏离目标。
我的工作:定义主指标、组织信息层级、让 Agent 实现并完成移动端检查。
关键取舍:只保留一个主指标和两个辅助信号。
验证:在 1440px 与 390px 测试,并覆盖空数据状态。

03 · 生成作品集首页

作品集首页的任务是解释和导航,不需要用夸张包装替代真实项目证据。

复制给 Agent
请在 12-publish-portfolio/portfolio 中创建 index.html,作为我的网页作品集首页。

首页包含:一句定位;3–5 个作品条目;每项的“问题/我的工作/关键取舍/验证”摘要;打开作品的明确链接;联系邮箱。
技术要求:所有站内资源使用相对路径;设置中文 lang、唯一 title、description、viewport、主题色与分享图元数据;页面离线打开时核心文字和链接仍可用;不加载外部框架或字体;390px 与 1440px 均可用。
不要虚构访问量、客户、奖项或我的技能年限。完成后输出一张“链接来源→目标文件”的清单。

04 · 发布前检查

在本地逐个点击链接,并从一个空白浏览器窗口打开首页。注意文件名大小写:本机可用的链接,在 Linux 服务器上可能因大小写不一致而 404。

  1. 检查所有相对链接与图片路径。
  2. 确认 title 和 description 描述真实内容。
  3. 确认没有 API key、邮箱密码、个人地址或本地绝对路径。
  4. 打开浏览器开发者工具,检查控制台没有资源 404。
  5. 生成一张 1200×630 的分享预览图,内容与作品集一致。

05 · 发布与公开回归

把 portfolio 目录部署到支持静态文件与 HTTPS 的服务器。发布不是结束:必须使用公开 URL 重走一次关键路径。不同平台的具体命令不同,以你的服务器说明为准。

  1. 在无痕窗口打开公开 HTTPS 地址。
  2. 逐个打开作品,确认状态码与内容正确。
  3. 在真实手机或 390px 模拟器完成一次主要操作。
  4. 检查分享预览抓取的是公开图片而非本地路径。
  5. 记录发布时间、版本和回滚位置。
复制给 Agent
请为这个纯静态 portfolio 生成一份发布检查清单,不要执行部署。清单必须包含:备份旧版本、上传范围、HTTPS、首页状态码、所有作品链接、手机视口、控制台 404、分享元数据、回滚方法。把每项写成可以勾选的动作。

06 · 给作品留下一条成长线

在首页页尾写明版本日期和下一次准备改进的一件事。作品集不是“永远完成”,但每个公开版本都应该完整、可解释、可回退。

  1. 保存公开 URL。
  2. 保存发布版本的本地副本或版本记录。
  3. 写下下一次只改一件什么事。
  4. 回看第一课截图,记录你现在能独立完成的三件事。

不要跳过

完成检查

逐项在真实页面中验证。勾选状态只保存在这台设备的浏览器中。

0 / 7 已完成

常见错误

卡住时先看这里

上传整个工作目录
只发布需要公开的静态文件,先检查秘密与草稿。
本地通过就宣布发布
必须在公开 URL、无痕窗口和手机视口回归。
作品集只有缩略图和标题
补上问题、你的判断和验证证据。

可选加练

再多走一步

把作品集链接发给一位不了解课程的人,请他指出最想打开的作品和最不清楚的说明。