Laravel Localizations 拉脱维亚语(lv)语言包缺失词条清单与本地化补全指南

原创2026-09-27 20:59:521,985 阅读
文章标签:后端

Laravel Localizations 拉脱维亚语(lv)语言包缺失词条清单与本地化补全指南

本文基于 Laravel Localizations(laravel-lang/lang)仓库中的 lv 语言状态报告,系统性梳理拉脱维亚语(Latvian,语言代码 lv)语言包当前未翻译词条的全貌:包括 json、php-inline、php 三种格式的缺失条目明细、每条缺失词条对应的上游源码出处,以及如何在仓库中定位、核对并补全这些词条。读完本文,你将掌握该仓库本地化状态文档的解读方法,并能精准定位 lv 语言包缺失翻译的具体位置与对应源码。

背景:状态文档在本地化项目中的角色

Laravel Localizations 是一个为 Laravel 生态(Laravel Framework、Jetstream、Fortify、Breeze、Cashier、Nova、UI、Passkeys、Spark 等)提供 128 种语言本地化词条的开源仓库。仓库内每个语言目录(如 locales/lv)保存翻译产物,而 docs/statuses 目录下则存放每种语言的「完成度状态报告」,lv.md 就是拉脱维亚语的状态清单。

根据 docs/status.md 顶部给出的全局统计,整个仓库的翻译完成度为 97.82%(147.1K / 150.4K 词条),lv 在状态总览表中以 ❗ 标记(见 docs/status.md 中 lv 一行),表示该语言仍存在未翻译词条,尚未达到 100% 覆盖。状态文档正是用来精确回答「差哪些、差在哪、缺什么格式」这一问题的。

解读 lv 状态文档的总体结构

lv.md 是自动生成的报告,结构固定,核心信息一目了然:

  • 总缺失数:##### All missed: 17,即 lv 语言包当前共有 17 条英文词条未翻译;
  • 按格式分组:分别列出 json、php-inline、php 三种格式的缺失明细;
  • 逐条对照表:每张表左列为 Key(英文原文),右列为 Value(当前值)。由于词条未翻译,Value 目前与 Key 相同(即回退到英文原文);
  • 表格下方导航:<a href="https://link.gitcode.com/i/afb148d8d040866f8ff7bf64f4c57e89" target="_blank"> [go back</a> | [to top](#) ],原文档通过 ../status.md 回到总览页,对应仓库路径即 docs/status.md。

三种格式分别对应仓库中的不同产物文件:

格式 对应产物文件(locales/lv 目录下) 适用场景
json json.json、json-inline.json 前端 JavaScript / Inertia / Vue 组件消费的词条
php-inline php-inline.json 校验器内联消息(不含 :attribute 字段名前缀)
php php.json PHP 端 lang/lv/ 下的常规词条,含校验消息

json 格式缺失的 13 条词条明细

lv.md 的 json 小节列出 13 条未翻译词条。这些词条横跨多个 Laravel 生态组件,可依据仓库 source/ 目录中的上游源文件将它们归为三类:

1. Passkeys(通行密钥)相关消息(5 条)

Key(英文原文) 当前 Value
Passkey not recognized. It may have been removed from your account. 同左(未翻译)
Passkey registration session expired. Please try again. 同左(未翻译)
Passkey verification session expired. Please try again. 同左(未翻译)
Unable to register passkey. Please try again. 同左(未翻译)
Unable to register this passkey. 同左(未翻译)

这些消息源自 Laravel Passkeys 扩展包的上游词条。在仓库中,source/passkeys/main/passkeys.json 收录了 Invalid credential format.、Passkey registration session expired. Please try again.、Passkey verification session expired. Please try again. 三条基础词条,而 source/passkeys/extended.json 则进一步扩充了 Unable to register passkey. Please try again. 等更多错误消息。补全时可对照这两个文件。

2. 加密环境文件(encrypted env)相关消息(4 条)

Key(英文原文) 当前 Value
The existing encrypted environment file is not in readable format. Use --force to overwrite it. 同左(未翻译)
The existing encryption key is required to update the encrypted environment file. 同左(未翻译)
Unable to sign in with this account. 同左(未翻译)
Unable to write the encrypted environment file. 同左(未翻译)

注:Unable to sign in with this account. 在 lv.md 中与加密环境文件词条并列于 json 缺失清单中,其上游来源为 Laravel Framework 的 framework.json 词条集合。

加密环境文件相关消息源自 Laravel Framework 的命令行工具(php artisan env:encrypt / env:decrypt 相关错误提示),上游原文收录于 source/framework/13.x/framework.json(Framework 11.x / 12.x / master 分支下同样存在,见 source/framework 目录)。

3. 国家名称词条(2 条)

Key(英文原文) 当前 Value
Mali 同左(未翻译)
Tonga 同左(未翻译)

这两个是地址/账单表单中的国家名称词条,上游来源为 source/nova/5.x/nova.json、source/nova/4.x/nova.json 以及 source/spark/spark-stripe.json 中的国家列表(search 结果显示这些文件均包含 Mali 与 Tonga)。之所以出现在缺失清单中,是因为 locales/lv/_excludes.json(查看)虽然排除了 Angola、Aruba、Malta 等一批国家名,但 Mali 与 Tonga 并未被排除,因此仍属于需要翻译的 json 词条。

4. 其他 json 缺失词条(2 条)

Key(英文原文) 当前 Value
Invalid credential format. 同左(未翻译)
Unable to verify passkey. Please try again. 同左(未翻译)

Invalid credential format. 收录于 source/passkeys/main/passkeys.json 第 2 行;Unable to verify passkey. Please try again. 属于 Passkeys 验证流程错误消息,同样可在 source/passkeys/extended.json 中找到对应英文原文。

php-inline 与 php 格式缺失词条(各 2 条)

lv 的缺失并不仅限于 json 格式,PHP 端校验消息也差 2 条,且 php-inline 与 php 两种格式缺失的是同一对校验规则词条:

规则 Key php-inline(不含 :attribute 前缀) php(含 :attribute 前缀)
array_keys This field must only contain the following keys: :values. The :attribute field must only contain the following keys: :values.
base64 This field must be a valid Base64 string. The :attribute field must be a valid Base64 string.

这一对词条在 locales/lv/php-inline.json(第 12、15 行)与 locales/lv/php.json(第 12、15 行)中目前仍是英文原文。它们的上游定义位于 Laravel Framework 校验器的默认消息文件中,例如 source/framework/13.x/validation.php:

  • array_keys(第 16 行):The :attribute field must only contain the following keys: :values.——对应 Laravel 校验规则 array_keys,用于校验数组仅包含指定键;
  • base64(第 19 行):The :attribute field must be a valid Base64 string.——对应校验规则 base64,用于校验字段值是否为合法 Base64 字符串。

php-inline 与 php 两种格式的区别仅在于消息中是否包含 :attribute 占位符(前者面向 inline 场景,直接以「This field」指代字段,不插入字段名)。Framework 11.x、12.x、master 分支下的 validation.php 均定义了相同词条,补全时保持各分支一致即可。

在仓库中核对与补全 lv 词条的操作路径

若要确认缺失状态并着手补全,可按以下路径操作(仓库只读,以下均为查看与核对流程):

  1. 查看总览:打开 docs/status.md,确认 lv 的 ❗ 状态,以及全局 97.82% 完成度;
  2. 查看明细:打开 docs/statuses/lv.md,对照本文上表逐条核对 17 条缺失词条;
  3. 定位产物文件:在 locales/lv 目录下分别编辑 json.json / json-inline.json / php-inline.json / php.json 中的对应 Key;
  4. 对照上游原文:翻译前先在 source 目录(如 source/passkeys/main/passkeys.json、source/framework/13.x/framework.json、source/framework/13.x/validation.php)确认英文原文语境,保证译文与组件实际使用场景一致;
  5. 注意复数与占位符:翻译时保留 :attribute、:values、:count 等占位符,并留意 Laravel 复数规则(lv 的复数形式可参考 json.json 中 (and :count more errors) 已采用的竖线分隔复数写法);
  6. 关注排除清单:若新增词条属于国家名等类别,先检查 locales/lv/_excludes.json,确认该词条是否被明确排除、无需翻译。

结语

lv.md 虽然只是一份自动生成的状态报告,但它精确回答了拉脱维亚语语言包「差什么、缺在哪」:json 格式差 13 条(Passkeys 相关 7 条、加密环境文件相关 4 条、国家名 2 条),php/php-inline 格式各差 2 条校验规则词条(array_keys、base64),合计 17 条。借助 source 目录的上游原文与 locales/lv 的产物文件,任何人都能快速定位、核对并完成这最后一批翻译,将 lv 的完成度从「接近完整」推进到 100%。

登录后查看全文
lang