Laravel Localizations 拉脱维亚语(lv)语言包缺失词条清单与本地化补全指南
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 词条的操作路径
若要确认缺失状态并着手补全,可按以下路径操作(仓库只读,以下均为查看与核对流程):
- 查看总览:打开 docs/status.md,确认
lv的❗状态,以及全局 97.82% 完成度; - 查看明细:打开 docs/statuses/lv.md,对照本文上表逐条核对 17 条缺失词条;
- 定位产物文件:在 locales/lv 目录下分别编辑
json.json/json-inline.json/php-inline.json/php.json中的对应 Key; - 对照上游原文:翻译前先在 source 目录(如 source/passkeys/main/passkeys.json、source/framework/13.x/framework.json、source/framework/13.x/validation.php)确认英文原文语境,保证译文与组件实际使用场景一致;
- 注意复数与占位符:翻译时保留
:attribute、:values、:count等占位符,并留意 Laravel 复数规则(lv的复数形式可参考 json.json 中(and :count more errors)已采用的竖线分隔复数写法); - 关注排除清单:若新增词条属于国家名等类别,先检查 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%。