Apache Airflow 加泰羅尼亞語caUI 翻譯規(guī)范術(shù)語表、語法約定與 i18next 實踐指南【免費下載鏈接】airflowApache Airflow - A platform to programmatically author, schedule, and monitor workflows項目地址: https://gitcode.com/GitHub_Trending/ai/airflow本文聚焦 Apache Airflow 倉庫中加泰羅尼亞語Catalanlocale 代碼ca的 UI 翻譯指南文檔 .agents/skills/airflow-translations/locales/ca.md。該文檔是 Airflow 國際化i18n體系中面向 AI 翻譯代理的語言風格憲法規(guī)定了哪些 Airflow 專有術(shù)語必須保留英文、哪些概念有固定的加泰羅尼亞語譯法以及性數(shù)一致、縮略、變音符號等語言層面的硬性規(guī)則。讀完本文你將完整掌握calocale 的術(shù)語表與狀態(tài)詞匯、可直接復現(xiàn)的復數(shù)鍵plural key寫法并能結(jié)合倉庫中的真實翻譯文件與校驗工具鏈理解這些規(guī)則是如何被落地和驗證的。加泰羅尼亞語在 Airflow i18n 體系中的位置Airflow 新一代 UI 采用 i18next 方案所有翻譯文件以 JSON 命名空間namespace形式存放在airflow-core/src/airflow/ui/public/i18n/locales/locale/目錄下。calocale 目前已包含admin.json、assets.json、browse.json、common.json、components.json、ca/dag.json、dags.json、dashboard.json、hitl.json、tasks.json等文件例如 common.json、tasks.json與英文默認 locale 的命名空間一一對應。ca.md這類 locale 指南文件位于 .agents/skills/airflow-translations/SKILL.md 所定義的翻譯技能目錄下每個支持的語言都有一個對應的指南文件如locales/de.md、locales/zh-CN.md等。SKILL.md 明確了這些指南的用途翻譯前先閱讀目標語言的指南文件其中包含術(shù)語表glossary、語氣規(guī)則和格式約定當 locale 指南與全局翻譯規(guī)則沖突時以 locale 指南為準。也就是說ca.md的權(quán)威性高于 SKILL.md 中的全局規(guī)則。從倉庫源碼結(jié)構(gòu)看ca語言已在兩處被正式注冊UI 前端 config.ts 的supportedLanguages數(shù)組中包含{ code: ca, name: Català }默認語言為enBreeze 開發(fā)工具鏈 ui_commands.py 的PLURAL_SUFFIXES字典中ca映射到MOST_COMMON_PLURAL_SUFFIXES [_one, _other]即加泰羅尼亞語只需要_one和_other兩個復數(shù)后綴。這兩處注冊正是ca.md中復數(shù)規(guī)則與校驗工作流的底層實現(xiàn)依據(jù)。1. 必須保留英文的核心 Airflow 術(shù)語ca.md第 1 節(jié)列出了一組**必須原樣保留英文大小寫敏感**的 Airflow 專有術(shù)語。這條規(guī)則的目的是Airflow 的概念在代碼、文檔和社區(qū)中都以英文形式傳播UI 中保留英文可避免加泰羅尼亞語用戶跨文檔檢索時產(chǎn)生認知斷裂。完整清單如下術(shù)語說明Dag/DagsAirflow 核心概念嚴禁寫成 DAGXCom/XComsAirflow 跨任務通信機制Asset/AssetsAirflow 跟蹤的數(shù)據(jù)依賴Plugin/Plugins可擴展性機制導航/標簽中譯為 Extensió但代碼引用中保留英文Pool/Pools資源約束機制Provider/ProvidersAirflow 擴展包名Map Index任務映射索引PIDUnix 進程標識符ID通用縮寫UTC時間標準JSON標準技術(shù)格式名REST API標準技術(shù)術(shù)語日志級別CRITICAL、ERROR、WARNING、INFO、DEBUG在真實翻譯文件中可以印證這一規(guī)則。例如 common.json 中asset_one: Asset, asset_other: Assets, assetEvent_one: Esdeveniment dAsset, assetEvent_other: Esdeveniments dAssetAsset本身保留英文只有其修飾詞被翻譯dag_task_instance詳情面板中的pid、pool、executor鍵值也均為英文見 common.json 的taskInstance節(jié)。值得注意的是術(shù)語表允許語境化的例外Plugin在 UI 導航標簽中譯為 Extensió見 common.json 的admin.Plugins: Extensions與nav.plugins: Extensions但代碼引用處仍保留英文——這正是指南中nav/labels 中譯為 Extensió代碼引用保留英文的落地方式。2. 已確立的加泰羅尼亞語標準譯法第 2 節(jié)是calocale 的核心術(shù)語表。以下譯法必須被一致使用任何翻譯代理不得為同一概念發(fā)明新詞匯英文術(shù)語加泰羅尼亞語備注TaskTasca / tasca復合語境中用小寫Task InstanceInstància de tasca復數(shù) Instàncies de tascaTask GroupGrup de tasquesDag RunExecució de Dag復數(shù) Execucions de DagBackfillReompliment復數(shù) ReomplimentsTrigger名詞DisparadorTrigger RuleRegla dexecucióTriggererTriggerer組件名技術(shù)引用保留英文SchedulerProgramadorSchedule名詞ProgramacióExecutorExecutorConnectionConnexió復數(shù) ConnexionsVariableVariable復數(shù) VariablesAudit LogRegistre dauditoriaLogRegistreStateEstatQueue名詞Cua如 En cua 表示 queuedConfig / ConfigurationConfiguracióOperatorOperador復數(shù) OperadorsAsset EventEsdeveniment dAssetAsset 保留英文Dag ProcessorDag Processor組件名保留英文HeartbeatBatecPluginExtensió僅用于 UI 導航/標簽對照 common.json 的實際條目術(shù)語表與現(xiàn)有翻譯完全吻合dag_one: Dag、dagRun_one: Execució de Dag、dagRun_other: Execucions de Dag、backfill_one: Reompliment、taskInstance_one: Instància de tasca等。Triggerer保留英文這一點也能在taskInstance.triggerer子節(jié)中得到驗證title: Informació del Triggerer、assigned: Triggerer assignat組件名未被翻譯。3. Task/Run 狀態(tài)詞匯表第 3 節(jié)給出了 Airflow 任務與運行狀態(tài)的完整映射表這是狀態(tài)徽章、日志標簽等高頻 UI 元素的翻譯依據(jù)英文狀態(tài)加泰羅尼亞語runningExecutant-sefailedFallitsuccessExitósqueuedEn cuascheduledProgramatskippedSaltatdeferredDiferitremovedEliminatrestartingReiniciantup_for_retryA reintentarup_for_rescheduleA reprogramarupstream_failedFallit aigües amuntno_status / noneSense estatplannedPlanificatopenObert這份表與 common.json 中的states對象逐鍵對應。例如upstream_failed → Fallit aigües amunt直譯為上游失敗aigües amunt是上游的地道表達、up_for_retry → A reintentar、up_for_reschedule → A reprogramar。現(xiàn)有文件還額外包含awaiting_input → Esperant entrada這是指南術(shù)語表尚未收錄的狀態(tài)說明ca.md的術(shù)語表是存量沉淀而非封閉清單——新增狀態(tài)仍需遵循同樣的風格句首大寫、狀態(tài)短語保持簡短來補齊。4. 加泰羅尼亞語語言規(guī)則詳解第 4 節(jié)是本文檔的技術(shù)核心針對加泰羅尼亞語的語法特征給出翻譯層面的操作細則。語氣與語域Tone and Register使用正式、專業(yè)的語域適合技術(shù)軟件 UI避免口語化表達優(yōu)先選擇中性、精確的用詞UI 字符串保持簡短——它們出現(xiàn)在按鈕、標簽和工具提示中。這一語域約定在現(xiàn)有翻譯中體現(xiàn)為大量使用正式句式例如 common.json 中的錯誤提示Sha produ?t un error inesperat發(fā)生了一個意外錯誤與確認句Està segur que vol eliminar {{resourceName}}? Aquesta acció no es pot desfer.均為標準書面語而非口語。性數(shù)一致Gender Agreement加泰羅尼亞語名詞有陰陽性形容詞和冠詞必須與之匹配。指南固定了 Airflow 關(guān)鍵術(shù)語的性別歸屬Dag 按陽性處理el Dag、un DagTasca 為陰性la tasca、una tascaExecució 為陰性una execució、lexecucióConnexió 為陰性la connexióVariable 為陰性la variableInstància 為陰性la instància。這一規(guī)則解釋了為什么翻譯中會出現(xiàn)ID de lexecuciórunId陰性名詞 縮略冠詞與ID del DagdagId陽性名詞 del這樣的差異——冠詞與縮略形式由名詞性別直接決定翻譯時必須先判定性別再選擇el/la/del/de l等變體。復數(shù)形式i18next 復數(shù)后綴加泰羅尼亞語使用 i18next 的_one和_other兩個復數(shù)后綴與 Breeze 工具鏈中PLURAL_SUFFIXES[ca]的配置一致。按標準加泰羅尼亞語規(guī)則添加-s或-es或直接使用術(shù)語表的既定形式task_one: Tasca, task_other: TasquesdagRun_one: Execució de Dag, dagRun_other: Execucions de Dagui_commands.py 中的expand_plural_keys函數(shù)實現(xiàn)了配套邏輯它根據(jù)語言所需的后綴展開復數(shù)基礎鍵plural base并結(jié)合英文 locale 中是否包含{{count}}占位符來判斷哪些復數(shù)鍵是必需的從而避免把語言不需要的復數(shù)鍵誤報為 unused。這解釋了為什么ca的翻譯文件里每個可數(shù)資源如asset_*、backfill_*、taskGroup_*都成對出現(xiàn)_one/_other鍵。大小寫Capitalization描述性文字和較長字符串使用句首大寫sentence case標題、標簽和按鈕文本采用類標題大寫風格與現(xiàn)有翻譯保持一致專有術(shù)語首字母大寫Dag、Asset、XCom、Pool 等不得在句中給普通名詞大寫?？s略與冠詞融合Elision and Contractions必須應用加泰羅尼亞語標準縮略規(guī)則de 元音 →d例Registre dauditoria、ID dexecucióel/la 元音 →l例lexecució、loperador介詞融合ael→aldeel→del?，F(xiàn)有翻譯是這些規(guī)則的示范Temps despera de lexecució del DagDag 運行超時common.json 的dagDetails.dagRunTimeout在一句話里同時出現(xiàn)了d、l、del三種形態(tài)。變音符號Diacritics必須完整保留加泰羅尼亞語變音符號à、è、é、?、ò、ó、ú、ü、?以及l(fā)·l中的間隔點·。絕不省略或替換重音——例如絕不允許把 Execució 寫成 Execucio。注意間隔點案例Col·lapsar、Coincidir中的l·l是標準拼寫而非排版錯誤翻譯代理在 lint 或手工校對時需將其視為合法字符。語序Word Order加泰羅尼亞語采用與英語相同的 SVO 標準語序形容詞通常后置于名詞例如 interval de dates日期區(qū)間、execució activa活動運行。這一約定保證了從英文源串翻譯時句法結(jié)構(gòu)基本平移降低了錯譯風險。5. 從現(xiàn)有翻譯文件提取的實戰(zhàn)模式第 5 節(jié)從存量ca/*.json中歸納了三類可直接復用的模式。始終保持英文的術(shù)語Dag → Dag、Asset → Asset、XCom → XCom、Pool → Pool、Provider → Provider。通用翻譯鍵值模式與 common.json 實際內(nèi)容一致task_one → Tasca task_other → Tasques dagRun_one → Execució de Dag dagRun_other → Execucions de Dag backfill_one → Reompliment backfill_other → Reompliments taskInstance_one → Instància de tasca taskInstance_other → Instàncies de tasca assetEvent_one → Esdeveniment dAsset assetEvent_other → Esdeveniments dAsset running → Executant-se failed → Fallit success → Exitós queued → En cua scheduled → Programat操作動詞按鈕文案Add → Afegir Delete → Eliminar Edit → Editar Save → Desar Reset → Restablir Cancel → Cancel·lar Confirm → Confirmar Import → Importar Export → Exportar Search → Cercar Filter → Filtrar這些動詞在 common.json 的modal子節(jié)中均有對應實例add: Afegir、cancel: Cancel·lar、confirm: Confirmar、save: Desartasks.json中則有searchTasks: Cercar tasques、selectOperator: Seleccionar operadors等組合用法。6. 翻譯代理的 DO / DONT 清單第 6 節(jié)給出面向 AI 翻譯代理也是人工譯者的硬性約束可直接作為代碼評審 checklistDO必須做與現(xiàn)有ca/*.json文件的語氣、風格、性數(shù)一致和大寫方式保持一致全程使用正式的加泰羅尼亞語語域保留所有 i18next 占位符{{count}}、{{dagName}}、{{type}}等應用正確的加泰羅尼亞語縮略d、l與冠詞融合al、del保留所有變音符號à, è, é, ?, ò, ó, ú, ü, ?, ·為每個鍵提供所需的全部復數(shù)后綴_one、_other。DONT禁止做翻譯第 1 節(jié)列出的 Airflow 專有術(shù)語省略或替換變音符號例如絕不允許把 Execució 寫成 Execucio修改熱鍵值例如hotkey: e必須保持為e在現(xiàn)有翻譯已有對應詞匯時另造新詞使用 DAG——永遠寫 Dag在句中給普通名詞首字母大寫。關(guān)于占位符規(guī)則可以結(jié)合 SKILL.md 的全局規(guī)則進一步理解{{variable}}插值中的變量名絕不能翻譯或刪除但占位符位置可以為了符合目標語言語序而重排且變量大小寫必須精確保留如{{dagDisplayName}}。common.json 中的批量清理提示是典型范例description: {{count}} {{resourceName}} shan netejat correctament. Claus: {{keys}}{{count}}置于句首以匹配加泰羅尼亞語語序而{{resourceName}}、{{keys}}均原樣保留。熱鍵不翻譯的規(guī)則同樣可見download: { hotkey: d, tooltip: Prem {{hotkey}} per a descarregar els registres }——熱鍵值是字面按鍵綁定僅提示語被翻譯。7. 配套校驗工作流breeze 翻譯完整性檢查雖然ca.md本身只定義語言規(guī)則但它服務的翻譯任務最終要通過倉庫工具鏈驗收。按照 SKILL.md 的流程對ca這類已存在的 locale檢查完整性查看缺失鍵與覆蓋率breeze ui check-translation-completeness --language ca補齊缺失鍵生成TODO: translate:樁breeze ui check-translation-completeness --language ca --add-missing清理無用鍵英文 locale 中不存在、或該語言不需要的復數(shù)后綴breeze ui check-translation-completeness --language ca --remove-unused翻譯完成后驗證輸出表應顯示 0 missing、0 TODOs、0 unused、100% coverage隨后運行 pre-commit 鉤子修復格式、許可證頭與 lint 問題prek run --from-ref main --hook-stage pre-commit從源碼結(jié)構(gòu)看該命令的復數(shù)判定邏輯由 ui_commands.py 中PLURAL_SUFFIXES與expand_plural_keys共同實現(xiàn)對ca而言只有當英文源鍵包含{{count}}或英文側(cè)定義了多種復數(shù)形式時才會把復數(shù)基礎鍵展開為base _one/base _other并納入必需鍵集合——這與ca.md中提供每個鍵所需的全部復數(shù)后綴_one、_other的要求完全對應。因此翻譯代理只要遵循ca.md的術(shù)語表與復數(shù)規(guī)則breeze ui check-translation-completeness就能給出確定性的驗收結(jié)論。小結(jié)ca.md的價值在于它把翻譯加泰羅尼亞語 UI 字符串這一開放問題收斂為一套可機械執(zhí)行的規(guī)則集英文保留術(shù)語表Dag/XCom/Asset/Pool/Provider 等 固定譯法術(shù)語表Tasca、Execució de Dag、Reompliment 等 狀態(tài)詞匯表 六條語法硬規(guī)則語域、性數(shù)、復數(shù)、大小寫、縮略、變音符號、語序 DO/DONT 清單。配合倉庫中 ca locale 現(xiàn)有翻譯 作為風格范本、config.ts 中的語言注冊與 Breeze 完整性檢查工具 作為驗收手段這套規(guī)則保證了新產(chǎn)生的加泰羅尼亞語字符串與既有翻譯 100% 一致。文檔版本標注為 1.02026 年 3 月派生自現(xiàn)有ca/*.jsonlocale 文件后續(xù)若states等對象新增條目應按同樣的風格約定回填并更新指南。【免費下載鏈接】airflowApache Airflow - A platform to programmatically author, schedule, and monitor workflows項目地址: https://gitcode.com/GitHub_Trending/ai/airflow創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考