Laravel Lang 保加利亚语（bg）翻译状态深度解读：缺失清单、来源定位与补全实践

后端【免费下载链接】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点击查看免费下载导读本文围绕 docs/statuses/bg.md 展开逐项拆解 Laravel Lang 项目中保加利亚语bg语言包的翻译缺口当前共有 15 个未翻译条目json 11 个、php 2 个、php-inline 2 个覆盖 Laravel Passkeys、框架环境文件加密命令与表单验证规则三个来源。读者读完本文将能读懂状态报告中的每个缺失项从哪个源码文件而来、对应仓库中哪个语言文件、以及如何快速补全并验证翻译。一、背景bg 状态报告在 Laravel Lang 项目中的定位laravel-lang/lang是一个为 Laravel 生态提供多语言翻译的 Composer 包覆盖 Laravel Framework、Jetstream、Fortify、Breeze、Cashier、Nova、Spark 与 UI 等组件参见 composer.json 中的description。每个语言目录如 locales/bg下都存放着json.json、json-inline.json、php.json、php-inline.json四类语言文件。docs/statuses/目录为每种语言生成一份翻译完成状态报告docs/status.md 是汇总入口当前整体完成度为97.82%147.1K / 150.4K。而 docs/statuses/bg.md 正是保加利亚语的明细报告它不展示已翻译内容而是精确列出**仍然缺失未翻译**的 key作为维护者补全翻译的行动清单。这类状态文件由laravel-lang/status-generator自动生成见 composer.json 的require-dev配置它会把每种语言的翻译与英文源文件逐 key 比对凡是值仍为英文原文即尚未翻译的条目都会落入对应语言的 status 报告中。二、bg 缺失全景15 个待翻译条目总览根据 docs/statuses/bg.md 的统计保加利亚语包共缺 15 个条目按文件类型分布如下文件类型缺失数量缺失 keyjson11Invalid credential format.、Passkey not recognized.等 8 个 Passkeys 相关消息 3 个环境文件加密相关消息php2array_keys、base64php-inline2array_keys、base64三类文件各司其职json系列locales/bg/json.jsonLaravel 应用中通过__()/trans()使用的键值对包含 Passkeys 与框架环境加密等新特性的消息php系列locales/bg/php.json供lang/目录下 PHP 语言文件使用的验证规则消息key 为array_keys、base64这类规则名php-inline系列验证规则的内联inline变体即验证规则直接写在字段上时展示的短消息key 与php相同但文案以 This field ... 而非 The :attribute field ... 开头。值得注意php与php-inline缺失的 key 完全一致都是array_keys与base64说明这两条规则在两个格式中均未翻译补全时需两处同时处理。三、json 缺失项溯源Passkeys 与 env 加密命令3.1 八个 Passkeys 相关消息json 缺失的 11 个条目中有 8 个来自 Laravel Passkeys 功能。它们分布在两份源文件中源文件一source/passkeys/main/passkeys.json3 个缺失 key含义Invalid credential format.凭据格式无效Passkey registration session expired. Please try again.注册会话过期请重试Passkey verification session expired. Please try again.验证会话过期请重试源文件二source/passkeys/extended.json5 个缺失 key含义Passkey not recognized. It may have been removed from your account.Passkey 无法识别可能已从账户中移除Unable to register passkey. Please try again.无法注册 Passkey请重试Unable to register this passkey.无法注册该 PasskeyUnable to sign in with this account.无法使用此账户登录Unable to verify passkey. Please try again.无法验证 Passkey请重试这些消息在 locales/bg/json.json 中仍然保留英文原文例如第 340、502-504、777-781 行因此被状态生成器判定为缺失。它们全部与 Passkeys无密码登录的用户交互流程相关注册、验证、会话过期、凭据无法识别等场景是保加利亚语用户在无密码登录时直接会看到的提示文案。3.2 三个环境文件加密相关消息其余 3 个缺失条目来自 Laravel Framework 的环境文件加密功能env:encrypt/env:decrypt命令缺失 key含义The existing encrypted environment file is not in readable format. Use --force to overwrite it.已存在的加密环境文件不可读请使用--force覆盖The existing encryption key is required to update the encrypted environment file.更新加密环境文件需要提供现有加密密钥Unable to write the encrypted environment file.无法写入加密环境文件这几条是 Laravel 11.0.7 之后新增的环境加密错误消息——这也解释了为什么 composer.json 中声明了conflict: { laravel/framework: 11.0.7 }该项目要求的最低框架版本恰好包含这些新消息。框架侧对应的基础键如Encrypted environment file already exists.、A decryption key is required.等可见于 source/framework/master/framework.json而上述三条属于较新的错误分支bg 语言包尚未跟进翻译。四、php 与 php-inline 缺失项验证规则 array_keys 与 base64php 与 php-inline 各缺 2 个 key均为框架验证器Validator的规则消息。它们对应的英文源文本在框架验证语言文件中可以精确找到source/framework/master/validation.php 第 16 行定义了array_keysThe :attribute field must only contain the following keys: :values.第 19 行定义了base64The :attribute field must be a valid Base64 string.。array_keys要求字段必须只包含指定的键集合用于校验关联数组的键名:values会被替换为允许的键列表。base64要求字段必须是合法的 Base64 编码字符串常用于文件上传或二进制数据的校验。在 locales/bg/php.json 中这两条规则的值仍是英文第 12、15 行array_keys: The :attribute field must only contain the following keys: :values., base64: The :attribute field must be a valid Base64 string.补全时可按保加利亚语习惯译为类似形式并保留:attribute、:values占位符array_keys: Полето :attribute трябва да съдържа само следните ключове: :values., base64: Полето :attribute трябва да бъде валиден Base64 низ.php-inline 变体locales/bg/php-inline.json则使用This field句式且无需:attribute占位符例如This field must only contain the following keys: :values.。五、源码侧工作机制Plugin 映射与发布流程状态报告中每个缺失项都能在源码侧找到对应发布映射这是理解整个翻译流水线的关键。Laravel Lang 通过插件Plugin机制把source/下的英文源文件按版本发布到目标语言目录src/Plugins/Passkeys/Main.php 声明了 Passkeys 的映射规则public function files(): array { return [ passkeys/main/passkeys.json {locale}.json, passkeys/extended.json {locale}.json, ]; }即source/passkeys/main/passkeys.json与source/passkeys/extended.json会合并进各语言含 bg的{locale}.json文件——这正是 8 个 Passkeys 缺失项进入 bg 语言包的路径。src/Plugins/Laravel/Master.php 则映射框架内容framework/master/framework.json {locale}.json, framework/extended.json {locale}.json, framework/master/auth.php {locale}/auth.php, framework/master/validation.php {locale}/validation.php, ...其中framework/master/validation.php对应 php 语言文件framework/master/framework.json与framework/extended.json合并进 json 语言文件。这两个插件共同决定了 bg 语言包中 json/php 文件的最终键集合也即状态报告比对的基准。插件由 src/ServiceProvider.php 在运行时注册当检测到LaravelLang\Publisher\Plugins\Provider类存在时自动注册Plugin从而将各插件的映射加载到发布流程中依赖laravel-lang/publisher ^16.0见 composer.json。六、_excludes.json 与语言包边界保加利亚语包的 locales/bg/_excludes.json 中声明了 3 个被排除的 key[ CSV (.csv), Excel (.xlsx), Nova ]这意味着这 3 个条目不参与bg 语言包的翻译与统计因此也不会出现在 docs/statuses/bg.md 的缺失清单中。这类排除通常是因为目标语言环境下该文案保持原文更合适例如文件格式名称或者该功能Nova对特定语言采用不同的本地化策略。理解_excludes.json有助于解释为什么某个英文词条既不在语言文件中、也不在缺失列表中。七、如何补全并验证翻译7.1 定位待翻译文件根据状态报告的缺失清单逐项在对应语言文件中补全缺失类型待修改文件json 缺失Passkeys env 加密locales/bg/json.jsonphp 缺失array_keys、base64locales/bg/php.jsonphp-inline 缺失array_keys、base64locales/bg/php-inline.json7.2 补全要点保留占位符json消息中的:count、:date、:amount等参数必须原样保留否则运行时替换会失效保留复数形式如(and :count more errors)这类带|分隔的复数形式需按保加利亚语复数规则通常 1 / 其他 两组保持对应结构区分两种验证文案php使用The :attribute field ...句式php-inline使用This field ...句式两者占位符不同不可混用参照邻近语言同为西里尔字母语系的其他语言如 locales/ru/json.json可作为翻译风格的参考但不可直接照搬。7.3 验证流程补全后可运行项目自带的 Composer 脚本见 composer.json验证composer run format # 执行 vendor/bin/lang sync 同步翻译并运行代码风格检查 composer test # 运行 PHPUnit 测试套件vendor/bin/lang sync会把source/的最新英文源同步进各语言文件并执行格式化随后laravel-lang/status-generator重新生成状态报告docs/statuses/bg.md 中的缺失数量会相应减少直到归零。八、环境与依赖要求参与该项目翻译补全需要满足以下环境条件以 composer.json 为准PHP^8.2扩展ext-json核心依赖laravel-lang/publisher ^16.0冲突限制laravel/framework 11.0.7因为 env 加密相关的新消息依赖 11.0.7 的框架版本开发依赖laravel-lang/status-generator ^2.11生成 status 报告、phpunit/phpunit ^11.0 || ^12.0测试、dragon-code/codestyler ^6.0与laravel/pint代码风格。安装方式为标准的 Composer 开发依赖引入composer require --dev laravel-lang/lang安装后即可在 Laravel 应用中把config/app.php的locale设为bg使用该语言包。九、小结通过 docs/statuses/bg.md 这份状态报告可以完整梳理保加利亚语语言包的补全路线8 个 Passkeys 交互消息 3 个环境文件加密消息补齐 json 缺口array_keys与base64两条验证规则同时补齐 php 与 php-inline 缺口即可使 bg 语言包达到 100% 完成度。过程中结合 source/、src/Plugins 与 locales/bg 的源码证据可以清晰地理解 Laravel Lang英文源文件 → 插件映射 → 语言文件 → 状态报告的完整翻译流水线这套方法论同样适用于仓库中其余 127 种语言的维护工作。赞分享后端【免费下载链接】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点击查看免费下载相关推荐Fluxer 客户端保加利亚语bg本地化指南LOCALIZATION_PROMPT 规范与源码级实践Fluxer 客户端保加利亚语bg本地化指南LOCALIZATION_PROMPT 规范与源码级实践 本篇指南以 fluxer_app/src/featuml-mastery-zh完全指南从零开始掌握机器学习的终极资源ml mastery zh完全指南从零开始掌握机器学习的终极资源 想要快速掌握机器学习但不知从何开始ml mastery zh项目是您学习机器学习的终极指南OpenProject 12.4.1 补丁版本深度解读15 项缺陷修复的完整清单与对应源码定位OpenProject 12.4.1 补丁版本深度解读15 项缺陷修复的完整清单与对应源码定位 OpenProject 12.4.1 是 12.x 系列的一个后端前端项目管理企业应用协同办公上一篇JsonUnit开源项目使用指南下一篇Pico CMS 使用与安装指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考