Laravel 本地化斯洛文尼亚语(sl)缺失条目清单与补齐指南

原创2026-09-27 14:15:171,828 阅读
文章标签:后端

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 生态的斯洛文尼亚语用户提供完整的本地化体验。

登录后查看全文
lang