Laravel 本地化斯洛文尼亚语(sl)缺失条目清单与补齐指南
Laravel 本地化斯洛文尼亚语(sl)缺失条目清单与补齐指南
本篇指南围绕 Laravel Lang 多语言包项目中斯洛文尼亚语(
sl)的翻译完成度展开:先精确定位当前仍未翻译的 16 条英文文案及其所属语言文件类型(json / php-inline / php),再逐条给出英文原文与待翻译的斯洛文尼亚语对照,并结合仓库源码说明这些缺失条目的来源(Laravel 框架、Passkeys 扩展、校验规则等),最后给出在locales/sl下补齐翻译并验证完成度的实操步骤。
Laravel Lang(laravel-lang/lang)为 Laravel Framework、Jetstream、Fortify、Breeze、Cashier、Nova、UI 等组件维护了 128 种语言的本地化文案。本文以语言完成度状态页 docs/statuses/sl.md 为依据,聚焦斯洛文尼亚语(sl,ISO 639-1 代码,用于斯洛文尼亚)当前尚未翻译的 16 条英文文案,帮助你快速定位、理解并补齐缺口。
一、状态文档的定位与整体完成度
docs/statuses/sl.md 是仓库中针对单个语言生成的“缺失条目清单”,属于 docs/status.md 总览页的一部分。总览页显示整个本地化包翻译完成度约为 97.82%(147.1K / 150.4K),并逐一列出每种语言的完成状态;sl 在总览表中标记为 ❗(未完成),对应条目即本文要处理的 16 条。
缺失条目按语言文件类型分三组统计:
| 文件类型 | 缺失条数 | 对应语言文件 |
|---|---|---|
json |
12 | locales/sl/json.json |
php-inline |
2 | locales/sl/php-inline.json |
php |
2 | locales/sl/php.json |
| 合计 | 16 | — |
其中 json 对应 Laravel 中通过 __() 助手使用的 JSON 翻译文件,php 对应传统的 PHP 语言文件(如 lang/sl/validation.php),php-inline 则用于校验属性名内联到消息中的场景(php-inline.json 是 Laravel Lang 提供的内联变体,消息中不含 :attribute 前缀,而 php.json 中含 :attribute)。
二、json 类型缺失的 12 条(含来源分析)
json.json 中缺失的 12 条均为英文原文,尚未翻译成斯洛文尼亚语。逐条列出如下:
| # | Key(英文原文) |
|---|---|
| 1 | Invalid credential format. |
| 2 | OK |
| 3 | Passkey not recognized. It may have been removed from your account. |
| 4 | Passkey registration session expired. Please try again. |
| 5 | Passkey verification session expired. Please try again. |
| 6 | The existing encrypted environment file is not in readable format. Use --force to overwrite it. |
| 7 | The existing encryption key is required to update the encrypted environment file. |
| 8 | Unable to register passkey. Please try again. |
| 9 | Unable to register this passkey. |
| 10 | Unable to sign in with this account. |
| 11 | Unable to verify passkey. Please try again. |
| 12 | Unable to write the encrypted environment file. |
2.1 Passkeys 相关文案(#1、#3–#5、#8–#11)
这 8 条与 Laravel Passkeys 扩展(WebAuthn 无密码登录)相关,英文源文件为 source/passkeys/main/passkeys.json,其内容包含:
{
"Invalid credential format.": "Invalid credential format.",
"Passkey registration session expired. Please try again.": "Passkey registration session expired. Please try again.",
"Passkey verification session expired. Please try again.": "Passkey verification session expired. Please try again."
}
json.json 中与 Passkeys 相关的 8 条文案(除上述 3 条外,还有 "Passkey not recognized..."、"Unable to register passkey..."、"Unable to register this passkey."、"Unable to sign in with this account."、"Unable to verify passkey...")在 source/passkeys/extended.json 中也有对应,统一在状态文档中汇总展示。这些文案覆盖了通行密钥注册、验证、会话过期、凭证格式错误、账号登录失败等常见无密码认证失败场景。
2.2 环境文件加密相关文案(#6、#7、#12)
这 3 条与 Laravel 框架的 .env 加密命令(php artisan env:encrypt / env:decrypt)相关,英文原文位于 source/framework/13.x/framework.json(第 33–34、42 行),同文件还包含 "Encrypted environment file already exists."、"Encrypted environment file not found." 等相邻文案。它们提示:现有加密环境文件不可读时需使用 --force 覆盖、更新加密环境文件需要现有加密密钥、以及无法写入加密环境文件。
2.3 通用状态文案(#2 "OK")
"OK" 是框架通用状态文案,同样来自 source/framework/13.x/framework.json,在界面按钮、状态提示中广泛使用。
三、php 与 php-inline 类型缺失的 2 条(校验规则)
php.json 与 php-inline.json 各自缺失 2 条,均属于 Laravel 表单校验规则,英文源定义在 source/framework/13.x/validation.php 的第 16、19 行:
'array_keys' => 'The :attribute field must only contain the following keys: :values.',
'base64' => 'The :attribute field must be a valid Base64 string.',
两类文件的差异在于消息中是否内联属性名:
| 规则 | php(含 :attribute) | php-inline(不含 :attribute) |
|---|---|---|
array_keys |
The :attribute field must only contain the following keys: :values. | This field must only contain the following keys: :values. |
base64 |
The :attribute field must be a valid Base64 string. | This field must be a valid Base64 string. |
array_keys:array_keys校验规则要求数组字段只能包含指定的键集合,values为允许的键列表;base64:base64校验规则要求字段值为合法的 Base64 编码字符串。
这两条规则属于 Laravel 框架较新的校验能力,因此也是各语言包中常见的待补条目。参考 source/framework/13.x/validation.php 第 76、142 行还可看到同族规则 in_array_keys、required_array_keys 的英文模板,便于统一规划斯洛文尼亚语翻译风格。
四、补齐翻译的实操步骤
4.1 确认缺失与现有译文
状态文档列出的是英文 Key 与英文 Value 完全相同的条目(即未翻译项)。以 sl 的 json.json 为例,其已翻译内容如:
"A decryption key is required.": "Potreben je ključ za dešifriranje.",
"All rights reserved.": "Vse pravice pridržane."
(见 locales/sl/json.json 第 12、47 行),说明该语言文件整体已完成主体翻译,仅剩上述 16 条英文占位。
4.2 在对应文件中补充斯洛文尼亚语译文
在 locales/sl/json.json、locales/sl/php.json、locales/sl/php-inline.json 中,将英文 Key 的 Value 替换为斯洛文尼亚语译文。以 json.json 为例,可将 Value 从英文占位改为斯洛文尼亚语(示意,需由母语者校对):
"OK": "V redu",
"Invalid credential format.": "Neveljaven format poverilnic."
php.json 与 php-inline.json 同理,分别补上含与不含 :attribute 的 array_keys、base64 译文。
4.3 校验并查看完成度
补齐后可通过 docs/status.md 观察整体完成度提升,或重新生成 docs/statuses/sl.md 状态页确认 sl 的 16 条缺失清零。仓库中 tests/PluginTest.php 与 src/Plugin.php、src/ServiceProvider.php 等源码负责校验语言文件的结构与覆盖情况,可作为翻译正确性的回归参考;各组件版本化的语言源文件位于 source 目录(如 source/framework/13.x 下的 framework.json、validation.php、auth.php、passwords.php、pagination.php),翻译时应保持与英文源 Key 一一对应。
五、小结
斯洛文尼亚语 sl 的本地化仅差最后 16 条英文文案即可补齐:12 条集中在 JSON 类型文件(Passkeys 无密码认证与 .env 加密相关),4 条集中在校验规则文件(array_keys 与 base64)。通过本文的条目清单、来源定位与补齐步骤,你可以快速完成剩余翻译,使 docs/statuses/sl.md 的 All missed 归零,并为 Laravel 生态的斯洛文尼亚语用户提供完整的本地化体验。