- 后端
【免费下载链接】lang
List of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.
本文基于 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 相同(即回退到英文原文);
- 表格下方导航:
[ [go back](https://link.gitcode.com/i/27bd64a5a69808d1189c08559947aca0) | [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%。
- 后端
【免费下载链接】lang
List of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.
相关推荐
Laravel 本地化斯洛文尼亚语(sl)缺失条目清单与补齐指南
Laravel 本地化斯洛文尼亚语(sl)缺失条目清单与补齐指南 本篇指南围绕 Laravel Lang 多语言包项目中斯洛文尼亚语( sl )的翻译完成度展开
后端Laravel 本地化完成度分析:sr_Latn_ME(黑山塞尔维亚语拉丁字母)语言包缺失词条全解读
Laravel 本地化完成度分析:sr_Latn_ME(黑山塞尔维亚语拉丁字母)语言包缺失词条全解读 本文聚焦于 Laravel 官方多语言生态仓库中 sr_L
后端Laravel Localizations 中的马尔加什语(mg)本地化状态解析:缺失词条清单、来源追踪与补全指南
Laravel Localizations 中的马尔加什语(mg)本地化状态解析:缺失词条清单、来源追踪与补全指南 马尔加什语(Malagasy,代码 mg )
后端
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考