Logo Kit 品牌资产包 是做什么的?
一个 SVG 标志 → 完整的客户交付套件,由 logo_kit.py 生成(该文件位于本文件所在目录)。它使用 headless Chrome 渲染,macOS 上无需 Python 包。
切勿手动创建这些文件:运行脚本,然后检查结果。
步骤
- 找到来源 SVG:完整的标志 SVG 文件,以及如果存在的话,单独的符号(不含文字)SVG 文件。 如果只有 PNG/JPG → 停止:标志必须先矢量化;告知用户。
- 运行:在项目根目录下运行(一分钟以内)。
<skill-dir>是包含本文件的文件夹:在 Windows 上使用python3 <skill-dir>/logo_kit.py path/logo.svg --nom "客户名称" \ --symbole path/symbol.svg --nom-couleur goldpython而非python3。 - 查看
kit-logo/apercu.png:使用图片查看工具,检查每一行(参见“需要检查的内容”)。 如果有缺陷 → 通过某个选项修复,再次运行并加上--ecraser,再次查看预览。 - 交付:为用户打开
kit-logo/apercu.html(macOS 使用open,Linux 使用xdg-open,Windows 使用start),然后提供压缩包路径kit-logo/<名称>-kit-logo.zip。
选项
选项和套件文件夹名称均为法语:套件按原样交付给法语客户。
| 选项 | 作用 | 默认值 |
|---|---|---|
--nom | 品牌名称(文件前缀、预览标题) | 必填 |
--symbole | 单独的符号:用于图标和头像 | 完整标志 |
--nom-couleur | 文件名中原始彩色版本的名称(gold、blue……) | couleur |
--accent | 品牌色彩:“强调”背景、光晕、可读变体的选择 | SVG 中的第一种颜色 |
--fond | 视觉元素的深色背景 | #0a0a0a |
--sortie | 套件输出文件夹 | ./kit-logo |
--ecraser | 替换现有套件 | 如果文件夹存在则拒绝 |
套件包含的内容
| 文件夹 | 内容 |
|---|---|
1-vectoriel | 原始 SVG / 黑色 / 白色(标志和符号)、原始和黑色 PDF |
2-png-transparent | 1000、2000 和 4000 像素的标志;1000 和 2000 像素的符号;全部 3 种色调 |
3-reseaux-sociaux | 8 种格式(Instagram、Story、Facebook、LinkedIn、X、16:9)× 3 种样式(深色、光晕、浅色)+ 4 个头像 |
4-autres-usages | 纯色背景、16 → 1024 像素图标、水印、电子邮件签名 |
| 根目录 | apercu.html、apercu.png、压缩包 |
需要在预览中检查的内容
| 你看到的内容 | 原因 | 修复方法 |
|---|---|---|
| 标志在背景上难以辨认,或“强调”背景错误 | 多色标志:SVG 中的第一种颜色不是品牌色 | --accent "#rrggbb" |
| 黑色或白色版本变成了实心块,细节丢失 | 标志使用了白色形状或蒙版来“切割” | 告知用户:这些版本需要专用的单色 SVG |
| 标志文本显示为其他字体 | <text> 未转换为路径(脚本已给出警告) | 在源 SVG 中将文本转换为路径 |
| 图标不清晰(宽标志被挤压到正方形中) | 未提供 --symbole | 请求或提取单独的符号,使用 --symbole 重新运行 |
常见错误
- 将套件放在
public/目录中:它将会随网站一起发布。请保留在项目根目录。 - 不查看
apercu.png就说“完成”。脚本只检查尺寸,不检查可读性。 - 对非生成的套件文件夹使用
--ecraser:先查看其中包含的内容。
要求
- Python 3.9+ 以及 Google Chrome、Chromium 或 Microsoft Edge(如果未找到,设置
CHROME=/path/to/chrome环境变量)。 - 小尺寸图片使用
sips(macOS 内置)缩;其他平台使用 Pillow(pip install pillow)或 ImageMagick。
脚本可通过 python3 <skill-dir>/logo_kit.py --test 自检。