英语词汇闪卡 Lite

要解决的问题

把一份结构化的单词表（音标、词性、释义、搭配、例句、文化背景）批量变成可直接打印的闪卡 PNG，听起来简单，实际踩坑不少：

• 混排排版：IPA 音标、中文释义、英文例句挤在同一张卡上，字体处理稍有不慎就是满屏"豆腐块"；
• 打印可用性：屏幕上好看的配色，打出来可能灰成一片，需要专门为黑白输出校准对比度与灰阶；
• 体积与分发：内置完整 CJK 字体的完整版约 40MB，而多数场景只需要一张张小卡片，包体越小越好分发；
• 批量容错：一批词条里一条缺字段就整批崩溃，或者长词条被静默截断，都是高频事故。

@user_1745aec9/vocab-cards-lite 就是冲着这几个问题来的。

它是怎么工作的

输入是一个 JSON 数组，只有 word 是必填字段，其余字段（ipa_uk/ipa_us、pos、level、cn、en、coll、examples、note）缺失时自动补默认值并打印中文提示，不再抛 KeyError。

对每条词条，脚本按需生成三件套 PNG：

• 主卡：单词、UK/US 音标、词性徽章、难度、中英释义、固定搭配、双语例句、文化背景；
• 副卡：相关信息、相关词汇、地道表达、记忆提示（仅当条目含 side 字段）；
• 二维码卡：右下角叠加 180px 百度百科二维码（仅当条目含 baike_url）。

几个值得注意的实现细节：

• 三字体策略：IPA 音标与英文走系统 DejaVu，中文走系统 NotoSansCJK，从根源避免混排缺字；
• 分段渲染 + 基线对齐：三类文本分开测量绘制，混排不歪斜；
• 智能换行：英文不拆词、括号成对闭合、标点不落在行首；
• 动态画布：宽度固定 1000px，高度随内容伸缩（1700–3200px），长词条不再被静默截断，超出才告警截断；
• 黑白配色：白底 #fff、黑字 #000、灰阶 #374151/#6b7280/#d1d5db，专为打印校准；
• 批量容错：单条失败打印 FAIL: 后继续，全部失败或跳过才返回退出码 3，输入文件非法返回 2，方便脚本链式判断。

适用边界

• 只做黑白打印优化，需要彩色或设计感强的卡片请换工具；
• 依赖系统已安装 NotoSansCJK 与 DejaVu 字体，生僻字显示方框时需补装字体，或改用内置字体的完整版 vocab-cards-pro；
• 不做纯文本释义/翻译，不做 PDF 解析、OCR 或全文排版；
• 输出必须是 PNG 文件，只想要纯文本结果的场景用不上它。