后端【免費下載鏈接】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、框架環(huán)境文件加密命令與表單驗證規(guī)則三個來源。讀者讀完本文將能讀懂狀態(tài)報告中的每個缺失項從哪個源碼文件而來、對應倉庫中哪個語言文件、以及如何快速補全并驗證翻譯。一、背景bg 狀態(tài)報告在 Laravel Lang 項目中的定位laravel-lang/lang是一個為 Laravel 生態(tài)提供多語言翻譯的 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/目錄為每種語言生成一份翻譯完成狀態(tài)報告docs/status.md 是匯總入口當前整體完成度為97.82%147.1K / 150.4K。而 docs/statuses/bg.md 正是保加利亞語的明細報告它不展示已翻譯內容而是精確列出**仍然缺失未翻譯**的 key作為維護者補全翻譯的行動清單。這類狀態(tài)文件由laravel-lang/status-generator自動生成見 composer.json 的require-dev配置它會把每種語言的翻譯與英文源文件逐 key 比對凡是值仍為英文原文即尚未翻譯的條目都會落入對應語言的 status 報告中。二、bg 缺失全景15 個待翻譯條目總覽根據 docs/statuses/bg.md 的統(tǒng)計保加利亞語包共缺 15 個條目按文件類型分布如下文件類型缺失數(shù)量缺失 keyjson11Invalid credential format.、Passkey not recognized.等 8 個 Passkeys 相關消息 3 個環(huán)境文件加密相關消息php2array_keys、base64php-inline2array_keys、base64三類文件各司其職json系列l(wèi)ocales/bg/json.jsonLaravel 應用中通過__()/trans()使用的鍵值對包含 Passkeys 與框架環(huán)境加密等新特性的消息php系列l(wèi)ocales/bg/php.json供lang/目錄下 PHP 語言文件使用的驗證規(guī)則消息key 為array_keys、base64這類規(guī)則名php-inline系列驗證規(guī)則的內聯(lián)inline變體即驗證規(guī)則直接寫在字段上時展示的短消息key 與php相同但文案以 This field ... 而非 The :attribute field ... 開頭。值得注意php與php-inline缺失的 key 完全一致都是array_keys與base64說明這兩條規(guī)則在兩個格式中均未翻譯補全時需兩處同時處理。三、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 行因此被狀態(tài)生成器判定為缺失。它們全部與 Passkeys無密碼登錄的用戶交互流程相關注冊、驗證、會話過期、憑據無法識別等場景是保加利亞語用戶在無密碼登錄時直接會看到的提示文案。3.2 三個環(huán)境文件加密相關消息其余 3 個缺失條目來自 Laravel Framework 的環(huán)境文件加密功能env:encrypt/env:decrypt命令缺失 key含義The existing encrypted environment file is not in readable format. Use --force to overwrite it.已存在的加密環(huán)境文件不可讀請使用--force覆蓋The existing encryption key is required to update the encrypted environment file.更新加密環(huán)境文件需要提供現(xiàn)有加密密鑰Unable to write the encrypted environment file.無法寫入加密環(huán)境文件這幾條是 Laravel 11.0.7 之后新增的環(huán)境加密錯誤消息——這也解釋了為什么 composer.json 中聲明了conflict: { laravel/framework: 11.0.7 }該項目要求的最低框架版本恰好包含這些新消息?？蚣軅葘幕A鍵如Encrypted environment file already exists.、A decryption key is required.等可見于 source/framework/master/framework.json而上述三條屬于較新的錯誤分支bg 語言包尚未跟進翻譯。四、php 與 php-inline 缺失項驗證規(guī)則 array_keys 與 base64php 與 php-inline 各缺 2 個 key均為框架驗證器Validator的規(guī)則消息。它們對應的英文源文本在框架驗證語言文件中可以精確找到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要求字段必須只包含指定的鍵集合用于校驗關聯(lián)數(shù)組的鍵名:values會被替換為允許的鍵列表。base64要求字段必須是合法的 Base64 編碼字符串常用于文件上傳或二進制數(shù)據的校驗。在 locales/bg/php.json 中這兩條規(guī)則的值仍是英文第 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 映射與發(fā)布流程狀態(tài)報告中每個缺失項都能在源碼側找到對應發(fā)布映射這是理解整個翻譯流水線的關鍵。Laravel Lang 通過插件Plugin機制把source/下的英文源文件按版本發(fā)布到目標語言目錄src/Plugins/Passkeys/Main.php 聲明了 Passkeys 的映射規(guī)則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 文件的最終鍵集合也即狀態(tài)報告比對的基準。插件由 src/ServiceProvider.php 在運行時注冊當檢測到LaravelLang\Publisher\Plugins\Provider類存在時自動注冊Plugin從而將各插件的映射加載到發(fā)布流程中依賴laravel-lang/publisher ^16.0見 composer.json。六、_excludes.json 與語言包邊界保加利亞語包的 locales/bg/_excludes.json 中聲明了 3 個被排除的 key[ CSV (.csv), Excel (.xlsx), Nova ]這意味著這 3 個條目不參與bg 語言包的翻譯與統(tǒng)計因此也不會出現(xiàn)在 docs/statuses/bg.md 的缺失清單中。這類排除通常是因為目標語言環(huán)境下該文案保持原文更合適例如文件格式名稱或者該功能Nova對特定語言采用不同的本地化策略。理解_excludes.json有助于解釋為什么某個英文詞條既不在語言文件中、也不在缺失列表中。七、如何補全并驗證翻譯7.1 定位待翻譯文件根據狀態(tài)報告的缺失清單逐項在對應語言文件中補全缺失類型待修改文件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等參數(shù)必須原樣保留否則運行時替換會失效保留復數(shù)形式如(and :count more errors)這類帶|分隔的復數(shù)形式需按保加利亞語復數(shù)規(guī)則通常 1 / 其他 兩組保持對應結構區(qū)分兩種驗證文案php使用The :attribute field ...句式php-inline使用This field ...句式兩者占位符不同不可混用參照鄰近語言同為西里爾字母語系的其他語言如 locales/ru/json.json可作為翻譯風格的參考但不可直接照搬。7.3 驗證流程補全后可運行項目自帶的 Composer 腳本見 composer.json驗證composer run format # 執(zhí)行 vendor/bin/lang sync 同步翻譯并運行代碼風格檢查 composer test # 運行 PHPUnit 測試套件vendor/bin/lang sync會把source/的最新英文源同步進各語言文件并執(zhí)行格式化隨后laravel-lang/status-generator重新生成狀態(tài)報告docs/statuses/bg.md 中的缺失數(shù)量會相應減少直到歸零。八、環(huán)境與依賴要求參與該項目翻譯補全需要滿足以下環(huán)境條件以 composer.json 為準PHP^8.2擴展ext-json核心依賴laravel-lang/publisher ^16.0沖突限制laravel/framework 11.0.7因為 env 加密相關的新消息依賴 11.0.7 的框架版本開發(fā)依賴laravel-lang/status-generator ^2.11生成 status 報告、phpunit/phpunit ^11.0 || ^12.0測試、dragon-code/codestyler ^6.0與laravel/pint代碼風格。安裝方式為標準的 Composer 開發(fā)依賴引入composer require --dev laravel-lang/lang安裝后即可在 Laravel 應用中把config/app.php的locale設為bg使用該語言包。九、小結通過 docs/statuses/bg.md 這份狀態(tài)報告可以完整梳理保加利亞語語言包的補全路線8 個 Passkeys 交互消息 3 個環(huán)境文件加密消息補齊 json 缺口array_keys與base64兩條驗證規(guī)則同時補齊 php 與 php-inline 缺口即可使 bg 語言包達到 100% 完成度。過程中結合 source/、src/Plugins 與 locales/bg 的源碼證據可以清晰地理解 Laravel Lang英文源文件 → 插件映射 → 語言文件 → 狀態(tài)報告的完整翻譯流水線這套方法論同樣適用于倉庫中其余 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 規(guī)范與源碼級實踐Fluxer 客戶端保加利亞語bg本地化指南LOCALIZATION_PROMPT 規(guī)范與源碼級實踐 本篇指南以 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 系列的一個后端前端項目管理企業(yè)應用協(xié)同辦公上一篇JsonUnit開源項目使用指南下一篇Pico CMS 使用與安裝指南創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考