DESIGN.md omitted配置:明确哪些章节故意省略,别用空章节遮住缺项 素材身份:作者原创输入/可编辑参考。目标工具未在本轮执行。 先打开 index.html;input.csv 是原始字段,reference.csv 是验收基准,negative.csv 是故意构造的坏样例。 actual-results.csv 保留未测状态,实际执行后再填写。 前置条件: Node.js与npm已可运行;练习只需本地文本文件和官方@google/design.md CLI,不需要Stitch账号或付费生成。 固定当前CLI版本并保留版本号;DESIGN.md仍为alpha格式,升级前先在练习副本复核。 本课给出作者自制规则文件和预期,不把预期JSON冒充已执行的官方CLI返回。 操作步骤: 1. 写出有意和无意两类缺项 准备一个无阴影的预约面板,注明它刻意保持平面层次。 同时故意漏写正文typography,让两个问题在同一练习中可被区别。 2. 查看当前alpha规范 使用designmd spec --rules查看已安装版本的omitted结构与规则,同时保存版本。 不要从旧博客复制可能过期的字段形状,本课以实际规范为准。 3. 只标记有理由的省略 按当前规范在omitted中说明不使用rounded;无阴影取舍写入Elevation的用途说明。 正文仍需要排版数据,不能把漏字体也声明为“故意省略”来压掉提示。 4. 运行并读取不同finding lint后记录当前版本实际规则:本课0.4.0出现declared-omission、unknown-omission、missing-typography等;main规则名不等于已发布版全部相同。 info、warning和error分开列,不能用总条数减少就判设计更完整。 5. 补回必要的字体规范 加入body-md字体与行高,保留无阴影决定。 不需要的章节不填空值,避免产生一份表面齐全但无法消费的文件。 6. 检查多余与拼错的省略项 在负例中加入一个当前规范不识别的omitted名称,观察真实反馈。 只记录当前版本实际行为,不把未知名称默默接受当跨版本保证。 7. 交付取舍与完整性说明 保存正确omitted、负例、字体补全记录以及平面界面预览。 列出还需由页面实现的层次线索,例如间距和边框,而不是仅写“不用阴影”。 验收: 故意省略的项有明确用途理由。 必需字体被补全,未以omitted掩盖缺项。 当前spec、CLI版本和实际finding一起保存。 官方资料: https://github.com/google-labs-code/design.md https://github.com/google-labs-code/design.md/blob/main/docs/spec.md https://github.com/google-labs-code/design.md/blob/main/docs/spec.md https://github.com/google-labs-code/design.md/blob/main/docs/spec.md 图片身份:assets/ 为内置image_gen生成的原创练习输入缩略版,原始文件保留在网站图片来源地址。可编辑SVG为作者原生排版。