拓十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Laravel Localizations 夏威夷语(haw)语言包翻译缺口全解析:基于 docs/statuses/haw.md 的 16 项缺失键清单与源码溯源

Laravel Localizations 夏威夷语(haw)语言包翻译缺口全解析:基于 docs/statuses/haw.md 的 16 项缺失键清单与源码溯源 后端【免费下载链接】langList of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.项目地址https://gitcode.com/gh_mirrors/la/lang点击查看免费下载本文以 laravel-lang/lang 仓库的 haw 语言状态报告 为骨架系统梳理夏威夷语语言包当前尚未完成本地化的 16 个翻译键它们分布在 json、php、php-inline 三种语言格式中分别来自 Laravel Passkeys、加密环境文件env:encrypt相关命令以及 Laravel Framework 的array_keys/base64验证规则。读完本文你将能读懂 statuses 状态文件的字段结构定位每个缺失键对应的上游源码与使用场景并掌握如何结合 locales/haw/ 目录下的语言文件判断和补全这些翻译缺口。一、haw 语言包在项目中的定位本项目laravel-lang/lang为 Laravel 生态提供 128 种语言的本地化文件覆盖 Laravel Framework、Jetstream、Fortify、Breeze、Cashier、Nova、Spark、UI 等官方组件见 composer.json 中的包描述与 src/Plugin.php 中注册的组件插件列表。夏威夷语代码haw是其中的语言之一其语言文件存放在 locales/haw/ 目录下包含 5 个文件json.json—— 供__()辅助函数使用的一般性 JSON 翻译键值对php.json—— 框架级 PHP 数组翻译带:attribute占位符php-inline.json—— 验证消息的「字段名内联」变体不带:attribute前缀_excludes.json—— 被排除、不参与翻译统计的键列表json-inline.json—— JSON 内联变体。每个语言的翻译完成状态由docs/statuses/目录下的独立 Markdown 文件跟踪docs/status.md提供 128 种语言的全局完成率总览如haw ❗标记表示该语言仍有缺口。本文的主角 docs/statuses/haw.md 正是这份针对夏威夷语的「未完成清单」。二、状态文件结构如何读懂 haw.mdhaw.md 的正文结构非常紧凑共分三大部分顶部标注##### All missed: 16总计缺失 16 个键然后按语言文件类型分节统计小节缺失数量对应语言文件### json12locales/haw/json.json### php-inline2locales/haw/php-inline.json### php2locales/haw/php.json每个小节内部使用table呈现Key → Value两列Key 列是待翻译的英文源字符串Value 列是当前状态文件记录的值未翻译时通常保持英文原文占位。文件末尾的[ [go back](https://link.gitcode.com/i/a87057891736c90c44d8ed78c9037735) | [to top](#) ]导航指向语言总览页对应仓库根目录下的 docs/status.md。这类状态文件由laravel-lang/status-generator工具生成见 composer.json 的require-dev依赖用于持续追踪每个语言包相对上游源文件的对齐进度。三、json 格式缺失的 12 个键Passkeys 与加密环境文件json 节是缺口最集中的部分12 个可以清晰分为两个主题域。3.1 Laravel Passkeys 组件相关7 个以下 7 个键全部与 Laravel 的无密码登录Passkeys功能相关Key英文源串Value当前占位Invalid credential format.Invalid credential format.Passkey not recognized. It may have been removed from your account.Passkey not recognized. It may have been removed from your account.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.Unable to register passkey. Please try again.Unable to register passkey. Please try again.Unable to register this passkey.Unable to register this passkey.Unable to verify passkey. Please try again.Unable to verify passkey. Please try again.这些键的上游来源是 source/passkeys/main/passkeys.json。对照该源文件可以发现Invalid credential format.、Passkey registration session expired. Please try again.、Passkey verification session expired. Please try again.三个键直接来自 passkeys 源而其余键如Passkey not recognized...、Unable to register passkey...、Unable to verify passkey...则来自 passkeys 的扩展源 source/passkeys/extended.json该文件存在于 source 目录的 passkeys 子目录中。这 7 个键覆盖了 WebAuthn 认证流的典型错误场景凭据格式校验失败、设备端 passkey 被移除、注册/验证会话过期、注册与验证过程的通用失败提示等。3.2 加密环境文件env:encrypt相关4 个Key英文源串Value当前占位The existing encrypted environment file is not in readable format. Use --force to overwrite it.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.The existing encryption key is required to update the encrypted environment file.Unable to write the encrypted environment file.Unable to write the encrypted environment file.Encrypted environment file already exists.已翻译见下文——这 4 个缺失键对应 Laravel 框架php artisan env:encrypt/env:decrypt命令的异常分支当已存在加密环境文件但格式不可读时提示使用--force覆盖、更新加密文件时需要提供既有加密密钥、写入加密文件失败等。值得注意的是json.json中同类主题的Encrypted environment file already exists.与Encrypted environment file not found.等键已经完成夏威夷语翻译说明该主题域的翻译工作正在持续推进仅剩上述少量键未覆盖。3.3 其他1 个KeyValueHong KongHong Kong该键属于国家/地区名称列表见 locales/haw/json.json 中大量国家名称条目。由于「Hong Kong」在夏威夷语中本身保持原样statuses 文件将其记录为缺失——这提示状态报告以「是否仍为英文原文」作为判定标准而非「是否有值」。3.4 源码印证缺失键在当前语言文件中的真实状态打开 locales/haw/json.json 可以验证上述状态并非「键不存在」而是「键存在但值为英文原文未翻译占位」——例如第 340 行的Invalid credential format.: Invalid credential format.、第 502504 行的三条 passkey 会话过期提示、第 702703 行的两条加密环境文件提示、第 777781 行的四条Unable to ...提示值均为英文。这印证了 statuses 文件记录的正是「待本地化」清单键已随上游源文件同步进语言包但夏威夷语译文尚未提供Laravel 在运行时将回退显示英文原文。四、php 与 php-inline 格式缺失的 2 个键新验证规则缺口php 与 php-inline 两个小节各自恰好缺失 2 个键且键名完全相同区别仅在消息措辞键php 格式带 :attributephp-inline 格式内联array_keysThe :attribute field must only contain the following keys: :values.This field must only contain the following keys: :values.base64The :attribute field must be a valid Base64 string.This field must be a valid Base64 string.4.1 上游规则定义这两个键对应 Laravel Framework 验证器的两条规则定义在 source/framework/master/validation.php第 16 行array_keys The :attribute field must only contain the following keys: :values.—— 校验数组只能包含指定的键集合array_keys规则在 Laravel 11.x 中加入第 19 行base64 The :attribute field must be a valid Base64 string.—— 校验字段值必须是合法的 Base64 字符串。由于这两条是较新的验证规则haw 语言包尚未为其提供夏威夷语译文因此在php.json与php-inline.json中仍以英文原文占位可分别在 locales/haw/php.json 第 12 行与第 15 行、locales/haw/php-inline.json 第 12 行与第 15 行核实。4.2 两种格式的差异与运行机制php.json普通验证消息与php-inline.json内联验证消息是 Laravel 验证错误提示的两套并行文案前者面向「字段名 规则」组合输出如The email field must ...后者面向表单字段内联提示如This field must ...。因此同一条验证规则需要维护两份翻译这也是array_keys、base64各以 2 个键计数、合计 4 个键出现在All missed: 16中的原因。五、从 16 个缺失键看 haw 语言包的完成度综合三节数据可以得出 haw 语言包的缺口画像总量16 个未完成键其中 json 12 个、php-inline 2 个、php 2 个主题集中度约 2/3 的缺口集中在 Passkeys7 个与加密环境文件4 个这两个较新加入的 Laravel 功能域说明旧有功能域的翻译已相当完善规则新增追踪array_keys/base64两个缺失键揭示了语言包对 Laravel 新增验证规则的跟进节奏对照参考在 docs/status.md 总览表中haw 与绝大多数语言一样标记为❗仍有缺口而如 ko韩语等已标记为✔完整。贡献者可按此清单逐项补齐译文提交后由laravel-lang/status-generator重新生成状态文件并更新完成率。六、如何基于本清单继续工作若你要为 haw 语言包补全这些缺口操作路径如下定位文件编辑 locales/haw/json.json、locales/haw/php.json、locales/haw/php-inline.json 中对应的英文占位值参照上下文结合 source/passkeys/main/passkeys.json、source/passkeys/extended.json 与 source/framework/master/validation.php 理解每个键在 UI 上的触发时机保持占位符翻译时务必保留:attribute、:values等 Laravel 占位符否则验证消息将无法正确插入字段名与参数确认排除项留意 locales/haw/_excludes.json——某些键如Nova、Taiwan、Vanuatu等被显式排除在翻译统计之外避免对已排除键做无用功验证进度翻译完成后状态文件会通过生成工具自动更新缺失计数从 16 逐步归零直至 haw 在 docs/status.md 中转为✔。总结docs/statuses/haw.md虽然只是一份紧凑的状态清单但它精确刻画了夏威夷语语言包与上游 Laravel 生态之间的翻译差距16 个缺失键分别指向 Passkeys 无密码登录7 个、加密环境文件命令4 个、新验证规则array_keys/base644 个分 php 与 php-inline 两种格式以及一个保持原形的地区名称。借助 source/ 目录下的源文件与 locales/haw/ 语言文件开发者可以快速定位每个缺失键的来源、触发场景与补全位置将状态报告转化为可执行的本地化任务清单。赞分享后端【免费下载链接】langList of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.项目地址https://gitcode.com/gh_mirrors/la/lang点击查看免费下载相关推荐Laravel 芬兰语fi本地化翻译缺失清单解析从 docs/statuses/fi.md 到源码溯源Laravel 芬兰语fi本地化翻译缺失清单解析从 docs/statuses/fi.md 到源码溯源 本篇指南以仓库中的 docs/statuses/f后端Laravel Lang 世界语eo语言包翻译状态解析缺失键清单与源码溯源Laravel Lang 世界语eo语言包翻译状态解析缺失键清单与源码溯源 本篇指南以 docs/statuses/eo.md https://link.后端Laravel Lang 古吉拉特语gu语言包翻译状态解析docs/statuses/gu.md 缺失清单与源码级补全指南Laravel Lang 古吉拉特语gu语言包翻译状态解析docs/statuses/gu.md 缺失清单与源码级补全指南 本文围绕 docs/statu后端上一篇Magic-Grid实战案例如何在电商网站中构建完美的产品展示网格下一篇 CS自学指南终极教程快速上手完整自学路线创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表