作品集构建 是做什么的?
一个作品集第一次访问大约只有30秒。这个技能构建的网站能够充分利用这30秒: 第一屏展示你是谁、你做什么,旁边是真实作品,每个项目中你的角色清晰陈述, 以及一个明确的联系方式。
它修复结构,将外观留给用户。三种网格决定了内容的摆放位置和顺序。 字体、颜色、圆角半径和间距由用户在一个小模块中自行设置。 用这个技能构建的两个作品集应该阅读方式相同,但外观截然不同。
以下路径均相对于此技能的文件夹。
工作原理
一个文件 portfolio.json 包含了所有内容:用户是谁、项目、所选网格和外观。
一条命令即可将其转换为静态网站(纯HTML和CSS,无框架,无需安装):
python3 scripts/build.py path/to/their-site/portfolio.json
网站会生成在内容文件旁边。脚本随后会打印两个列表:一个是30秒审计仍然会标记出的问题,
每一行都关联到一个规则编号(references/rules.md 中每条规则占一行);
另一个是每个仍然等待填入事实的[slot](占位符)。将两者都视为待办事项列表。
步骤
1. 确定作品集的用途
询问,或从已有信息中推断出:
- 目标。 作品集面向的角色或客户。它决定了标题、项目顺序以及哪些内容可以省略。
- 作品。 哪些项目,以及每个项目:它是什么,用户的角色,为谁做的,年份,用户做的一个关键决定, 以及结果如何。
- 素材。 图片和视频的存放位置。
如果用户已有现有网站,请先阅读并沿用其中内容。如果 portfolio-audit 技能可用并且用户有一个在线网站,
先运行它可以准确告诉你需要修改什么。
只询问你找不到的信息。一个拥有图片文件夹和LinkedIn页面的用户已经提供了大部分信息。 如果没有人在那里回答,就利用已有信息继续,并使用占位符(第3步)。
用户不确定的素材(如速写本、学生项目、旧作品)应排除在外。他们对此有疑虑是有原因的, 因为作品集是根据其最薄弱的作品来评判的。说明你排除了哪些内容以及原因。 三个强有力的项目就是一个完整的作品集;不要为了凑数而增加到四个。
2. 让用户选择网格
阅读 references/grids.md。它描述了三种网格以及每种适合的用户。网格决定了整个网站的阅读方式,
因此这是用户的选择,而不是你的选择。你的任务是让这个选择变得简单。
在构建之前,用一条简短信息列出三种网格名称,每行一个,说明你推荐哪种网格以及原因 (基于他们的作品和目标),并询问他们想要哪种。将其与第1步中需要询问的其他问题合并在一起, 这样只有一轮问题,而不是两轮。
- 如果他们已指定了网格,直接使用,不要重新讨论。
- 如果他们选择了与你推荐不同的网格,按照他们的选择构建。如果会带来什么影响(例如,
index网格 没有地方放置“决策”和“结果”),说明一次,然后放弃争论。 - 如果对方不确定,或者没有人回答,就按照你的推荐继续,并在第5步中使用
--compare参数构建, 这样三种网格都可以并排打开查看。
切换网格只需修改文件中的一个词,所以不会被锁定。这是轻松提供选择的原因,而不是跳过它的理由。
3. 编写内容文件
复制 assets/example/portfolio.json 作为起点,并阅读 references/content.md 了解每个字段。\n将其放入将成为网站的文件夹中,图片也放在旁边。示例使用了 case 网格;
对于 index 和 columns 网格,decision 和 result 是可选的,并且很少需要 before/after 行。
如何编写最重要的部分:
- 标题: 一句话,说明他们做什么以及为谁做,并包含一个事实。这句话不能适用于其他任何人的作品集。 “金融科技应用的产品设计师。八年经验,最近担任Ledger储蓄流程的负责人。” 而不是“热爱打造体验的多领域创意工作者。”
- 证明: 标题后面紧跟着的三到四个最强的名称或数字。
- 排序: 最符合目标的项目排第一,无论其日期。四到八个项目。 次要领域(艺术总监的电影作品、产品设计师的插画)最好作为另一个网站(使用独立的内容文件),而不是混在一起。
- 每个项目: 一行摘要、角色,以及是为客户、雇主还是个人概念所做。对于产品和领导力目标, 添加决策和结果。
- 角色: 他们当前的职位名称,按原样写,不要写他们正在申请的职位。
- 行动号召: 在邮箱上方用一句话说明写信是为了什么。
- 语言: 用读者所使用的语言编写,并设置
site.lang。模板本身的语言(Index, Facts, Next…) 支持英语和西班牙语;对于任何其他语言,请在labels中设置。
只使用用户提供的事实或在其现有页面上出现的事实。你自己推断出的事实(例如从文件名读取的客户名称) 可以使用,但必须告知用户这是推断出来的,以便他们确认。
如果某个事实缺失,请用方括号写一个占位符([year]、[team size]、[what shipped])。
占位符会原样显示在网站上,并且构建脚本会列出每一个,所以:
- 保持标题中没有占位符:用你已知的信息来写。第一句中的占位符是访客读到的第一件事。
- 如果整个字段未知且为可选项(
city、team、site.url),则省略该字段。 - 对于没有结果的工作,说出真实情况:“于2024年交付;我没有具体数据”、“概念设计,未上线”。 这也是一个结果。空泛的影响承诺则不是。
- 含有占位符的网站是草稿。在交付时明确说明这一点。
带有诚实空白的作品集是可以接受的。带有虚构客户的作品集在面试中会是一个问题。
4. 设置外观
在 theme 模块中:明亮或暗色模式、一种强调色、字体、圆角半径、图片间距。
如果用户有品牌或现有网站,则从中获取这些设置。如果他们没有,选择一种适合其作品的字体和强调色,
并说明你的选择。不要复制示例或其他设计师网站的外观。
一种并非所有设备都自带的字体需要 font_url 来加载;仅设置 font 名称会回退到系统字体。
要么两者都指定,要么选择一个系统字体堆栈。
5. 构建、查看、修复
运行构建脚本。如果用户尚未选择网格,请添加 --compare 参数:
python3 scripts/build.py path/to/their-site/portfolio.json --compare
这还会将相同的内容以所有三种网格写入 compare/ 文件夹,并附上一个链接页。
向用户展示该页面,让他们选择。compare/ 仅用于选择:发布前请删除。
然后,在浏览器中以桌面和手机宽度查看(如果可以):在站点文件夹中启动
python3 -m http.server(case 网格链接到项目文件夹,需要服务器),
并亲自检查第一屏:姓名、做什么、证明、联系方式以及一个真实作品,无需滚动。
如果无法打开浏览器,请在交付时说明,并至少将标题和证明控制在约45个单词以内, 这将适合在手机屏幕上第一张图片之上显示。
逐一处理脚本打印的列表。修复你可以从内容层面处理的问题(缺失的角色描述、过大的图片、 过长的标题)。将剩余部分作为一份简短的清单交给用户,说明只有他们才能提供。
6. 交付
告知用户:使用了哪种网格,以及是他们自己选择的还是你推荐的(如果你构建了 compare/,
也要说明其他两种网格只需修改一个词即可切换,或者 compare/ 文件夹中已有);
你撰写了什么标题;你排除了哪些内容;任何你推断出的信息;仍需填充的占位符;
审计列表仍然显示的问题;以及如何修改内容(编辑 portfolio.json,再次运行构建)。
该文件夹是一个完整的静态网站:可以按原样上传到任何静态主机发布。
有两件事只有他们才能提供,因此在此处询问:网站将要使用的地址(site.url),
以及用于链接预览的 1200×630 图片(site.share_image);
使用第一个项目中最佳图片的裁剪版即可。
图片
- 导出时宽度最多 2000 像素,格式为 AVIF 或 WebP,每个文件不超过约 500 KB。构建脚本会对较大的图片发出警告。 JPEG、PNG 和 SVG 也支持。
- 当文件成对命名时,会自动使用较小尺寸的手机版图片:内容文件中使用
shot-lg.jpg, 旁边放置shot-sm.jpg。具有相同名称的.avif文件将优先提供给支持它的浏览器。 - 为每张图片提供
alt属性,说明其内容。如果没有提供,将使用项目标题,这对于搜索引擎或 AI 助手提供的信息非常少。如果你没有看到图片,请说明每张图片对应哪个作品,并请用户描述它们。 - 短视频循环(
.mp4、.webm)可以作为平铺网格展示。它们默认静音播放,仅在屏幕可见时播放。 为它们提供ratio属性。
不应做的事
- 不要添加开场动画、加载器、自定义光标或延迟内容显示的滚动效果。模板设计的目的就是让第一屏立即显示。
- 不要将项目标题隐藏在悬停效果后面。手机没有悬停状态。
- 不要移除“停靠栏”——这个包含姓名和邮箱的小栏目在联系区滚动移出屏幕后出现。 审阅者可能在浏览项目中途决定写信,而不是在页面末尾。
- 不要用过程图片(便利贴、人物画像)来填充薄弱的作品。一个清晰陈述的决策比什么都重要。
- 不要手动编辑生成的 HTML:下次构建会覆盖它。如果需要改变结构,请修改内容文件,
或者修改
assets/template/中的模板。