图片 alt 不是塞关键词的地方：翻译时如何保留用途

本文使用合成样本演示处理方法。代码已通过隔离环境中的示例检查；这不代表对所有真实文件或产品效果的保证。处理重要文件前，请保留原件，并按文中的边界与验收项复核。 当翻译团队把 <img alt=""> 统一标记为“缺失替代文本”并要求补全时，他们可能正在破坏网页的无障碍体验。空 alt 属性在 HTML 规范中是合法的，它明确告诉屏幕阅读器跳过该图片。真正的故障不是 alt 为空，而是译者无法区分这张图是承载核心数据的图表、纯粹的氛围装饰，还是点击后触发操作的按钮图标。将所有图片的 alt 都翻译成描述性长句，不仅冗余，还会让视障用户在导航时被迫收听大量无效信息。解决这一问题的关键，在于建立一套可执行的分类校验机制，而非依赖译者的主观猜测。 三类图片的语义边界与翻译策略 处理图片替代文本的第一步是分类，而非直接打开词典。信息图（Infographic）包含正文未重复的关键数据或流程，其 alt 必须完整传达这些视觉信息，翻译时应视为独立段落进行本地化，必要时补充文化背景注释。装饰图（Decorative Image）仅用于排版美化或情绪渲染，如分隔线、背景纹理、无文字插图，这类图片的 alt 应当保持为空字符串 "" ，翻译任务中应直接跳过，不应添加任何描述。功能图（Functional Image）作为交互控件存在，例如放大镜图标代表搜索、信封图标代表联系，其 alt 应描述动作或目标状态（如“搜索”“发送邮件”），而非外观（如“蓝色放大镜”“白色信封”）。混淆这三类会导致译文要么信息过载，要么关键操作不可达。在工程实践中，这种分类不能仅靠人工记忆，而应转化为可被脚本辅助识别的规则。 合成示例：正确输出与边界输入处理 以下合成示例展示一个包含三类图片的 HTML 片段及其预期翻译行为。输入片段中，第一张图为数据图表，第二张为装饰花纹，第三张为提交按钮图标。正确输出应保留第一张图的详细中文描述，第二张图的 alt="" 不变，第三张图的 alt 译为“提交表单”。一个常见的错误边界输入是装饰图被误标为 alt="decorative flower" ，此时脚本不应将其翻译为“装饰性花朵”，而应识别其语义角色并修正为空值；另一个边界是功能图缺少 alt 属性，此时应记录警告但不自动填充猜测性描述，因为错误的功能描述比缺失更危险。这些判断依赖上下文人工审核，代码仅能辅助标记可疑项。本示例完全在内存中构造，不涉及任何外部文件读取或网络请求，确保教学环境的安全性与可复现性。 基于 Beautiful Soup 的属性校验脚本 以下 Python 示例使用 Beautiful Soup 4.12.x 版本（需自行安装 beautifulsoup4 ）在内存中构造样本，演示如何提取并初步分类 img 标签的 alt 属性。此脚本仅为外围校验工具，并非完整的翻译决策引擎，实际应用中需结合人工审查。注意：示例不读取外部文件，所有 HTML 内容均在代码内定义；断言检查的是脚本自身的解析逻辑是否符合预设规则，而非验证翻译质量。根据官方文档，Beautiful Soup 将 HTML 文档转换为 Tag、NavigableString 等对象树，我们通过 .get('alt') 安全访问属性，避免 KeyError 异常。 from bs4 import BeautifulSoup # 合成示例HTML，包含三类图片及一个边界案例 # 注意：此为教学演示数据，无需准备外部文件 html_snippet = """ <div> <img src="chart.png" alt="Q3 revenue increased by 15% compared to Q2"> <img src="divider.svg" alt=""> <img src="submit-icon.png" alt="Submit"> <img src="flower-bg.jpg" alt="decorative flower"> </div> """ # 使用html.parser解析器，避免XML模式对多值属性的特殊处理 soup = BeautifulSoup(html_snippet, 'html.parser') imgs = soup.find_all('img') results = [] for img in imgs: # 使用.get()安全获取属性，避免KeyError alt = img.get('alt') src = img.get('src', '') # 简单启发式分类（非标准，仅作演示） # 实际项目中应结合ARIA角色、CSS类名等更多上下文 if alt is None: category = 'missing' elif alt == '': category = 'decorative' elif any(kw in src.lower() for kw in ['icon', 'btn', 'button']): category = 'functional' else: category = 'informative' results.append({'src': src, 'alt': alt, 'category': category}) # 断言校验脚本自身逻辑是否正确执行 assert len(results) == 4 assert results[0]['category'] == 'informative' assert results[1]['category'] == 'decorative' assert results[2]['category'] == 'functional' # 边界案例：误标的装饰图被归为informative待审，而非自动修正 assert results[3]['category'] == 'informative' 验收清单与人工审查触发条件 观察现象 处理决定 是否需人工审查 alt 为空且 src 含 decorative/bg/pattern 等关键词 保留空 alt，跳过翻译 否 alt 为空但 src 无装饰线索，且周围文本未提及图片内容 标记为“疑似缺失”，暂不翻译 是 alt 非空且 src 含 icon/btn/button 检查 alt 是否描述动作而非外观 是 alt 为非空描述性文本，但正文已有相同信息 评估是否冗余，可能改为空 alt 是 alt 包含品牌名或专有名词 核对术语表一致性 是 此表格仅覆盖常见模式，不适用于 SVG 内嵌文本、Canvas 绘图或动态生成图片。遇到这些情况，必须交由熟悉前端实现的人工审查。代码演示的输出仅是分类标签，端到端效果仍需结合页面渲染和无障碍测试工具验证。特别注意：脚本中的启发式规则基于文件名关键词，未考虑 CSS 背景图、data URI 或 ARIA 角色等复杂场景，因此绝不能作为自动化翻译的唯一依据。 参考资料与下一步行动 Beautiful Soup 官方文档 - Attributes: https://www.crummy.com/software/BeautifulSoup/bs4/doc/#attributes 下一步：选取你当前项目中的 5–10 个含图片的 HTML 页面，按上述分类手动标注一次，再运行校验脚本对比结果。若偏差集中在某一类图片，优先修订该类别的翻译指引而非调整脚本阈值。记住，alt 属性的本质是语义载体而非 SEO 关键词容器，翻译工作的目标是还原其原始用途，而非创造新的描述。 将这份检查清单用于文档翻译 网页文档的正文、链接、代码与结构要分别处理。把受保护的部分列入验收清单，再评估翻译后的可读性与页面展示。 OmniDoc（产品入口） 提供多格式文档翻译入口，官网介绍了 OCR、术语表与双语对照功能。对希望直接从文件开始处理的团队，这是一条值得用实际样本评估的路径。请使用有权上传的脱敏文件，并用本篇的检查项复核结果；这里不声称 OmniDoc 使用了本文的开源库或内部算法，也不以示例代替产品性能测试。 - 1 -