Apache Airflow 加泰罗尼亚语caUI 翻译规范术语表、语法约定与 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 翻译代理的语言风格宪法规定了哪些 Airflow 专有术语必须保留英文、哪些概念有固定的加泰罗尼亚语译法以及性数一致、缩略、变音符号等语言层面的硬性规则。读完本文你将完整掌握calocale 的术语表与状态词汇、可直接复现的复数键plural key写法并能结合仓库中的真实翻译文件与校验工具链理解这些规则是如何被落地和验证的。加泰罗尼亚语在 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 明确了这些指南的用途翻译前先阅读目标语言的指南文件其中包含术语表glossary、语气规则和格式约定当 locale 指南与全局翻译规则冲突时以 locale 指南为准。也就是说ca.md的权威性高于 SKILL.md 中的全局规则。从仓库源码结构看ca语言已在两处被正式注册UI 前端 config.ts 的supportedLanguages数组中包含{ code: ca, name: Català }默认语言为enBreeze 开发工具链 ui_commands.py 的PLURAL_SUFFIXES字典中ca映射到MOST_COMMON_PLURAL_SUFFIXES [_one, _other]即加泰罗尼亚语只需要_one和_other两个复数后缀。这两处注册正是ca.md中复数规则与校验工作流的底层实现依据。1. 必须保留英文的核心 Airflow 术语ca.md第 1 节列出了一组**必须原样保留英文大小写敏感**的 Airflow 专有术语。这条规则的目的是Airflow 的概念在代码、文档和社区中都以英文形式传播UI 中保留英文可避免加泰罗尼亚语用户跨文档检索时产生认知断裂。完整清单如下术语说明Dag/DagsAirflow 核心概念严禁写成 DAGXCom/XComsAirflow 跨任务通信机制Asset/AssetsAirflow 跟踪的数据依赖Plugin/Plugins可扩展性机制导航/标签中译为 Extensió但代码引用中保留英文Pool/Pools资源约束机制Provider/ProvidersAirflow 扩展包名Map Index任务映射索引PIDUnix 进程标识符ID通用缩写UTC时间标准JSON标准技术格式名REST API标准技术术语日志级别CRITICAL、ERROR、WARNING、INFO、DEBUG在真实翻译文件中可以印证这一规则。例如 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节。值得注意的是术语表允许语境化的例外Plugin在 UI 导航标签中译为 Extensió见 common.json 的admin.Plugins: Extensions与nav.plugins: Extensions但代码引用处仍保留英文——这正是指南中nav/labels 中译为 Extensió代码引用保留英文的落地方式。2. 已确立的加泰罗尼亚语标准译法第 2 节是calocale 的核心术语表。以下译法必须被一致使用任何翻译代理不得为同一概念发明新词汇英文术语加泰罗尼亚语备注TaskTasca / tasca复合语境中用小写Task InstanceInstància de tasca复数 Instàncies de tascaTask GroupGrup de tasquesDag RunExecució de Dag复数 Execucions de DagBackfillReompliment复数 ReomplimentsTrigger名词DisparadorTrigger RuleRegla dexecucióTriggererTriggerer组件名技术引用保留英文SchedulerProgramadorSchedule名词ProgramacióExecutorExecutorConnectionConnexió复数 ConnexionsVariableVariable复数 VariablesAudit LogRegistre dauditoriaLogRegistreStateEstatQueue名词Cua如 En cua 表示 queuedConfig / ConfigurationConfiguracióOperatorOperador复数 OperadorsAsset EventEsdeveniment dAssetAsset 保留英文Dag ProcessorDag Processor组件名保留英文HeartbeatBatecPluginExtensió仅用于 UI 导航/标签对照 common.json 的实际条目术语表与现有翻译完全吻合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子节中得到验证title: Informació del Triggerer、assigned: Triggerer assignat组件名未被翻译。3. Task/Run 状态词汇表第 3 节给出了 Airflow 任务与运行状态的完整映射表这是状态徽章、日志标签等高频 UI 元素的翻译依据英文状态加泰罗尼亚语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。现有文件还额外包含awaiting_input → Esperant entrada这是指南术语表尚未收录的状态说明ca.md的术语表是存量沉淀而非封闭清单——新增状态仍需遵循同样的风格句首大写、状态短语保持简短来补齐。4. 加泰罗尼亚语语言规则详解第 4 节是本文档的技术核心针对加泰罗尼亚语的语法特征给出翻译层面的操作细则。语气与语域Tone and Register使用正式、专业的语域适合技术软件 UI避免口语化表达优先选择中性、精确的用词UI 字符串保持简短——它们出现在按钮、标签和工具提示中。这一语域约定在现有翻译中体现为大量使用正式句式例如 common.json 中的错误提示Sha produït un error inesperat发生了一个意外错误与确认句Està segur que vol eliminar {{resourceName}}? Aquesta acció no es pot desfer.均为标准书面语而非口语。性数一致Gender Agreement加泰罗尼亚语名词有阴阳性形容词和冠词必须与之匹配。指南固定了 Airflow 关键术语的性别归属Dag 按阳性处理el Dag、un DagTasca 为阴性la tasca、una tascaExecució 为阴性una execució、lexecucióConnexió 为阴性la connexióVariable 为阴性la variableInstància 为阴性la instància。这一规则解释了为什么翻译中会出现ID de lexecuciórunId阴性名词 缩略冠词与ID del DagdagId阳性名词 del这样的差异——冠词与缩略形式由名词性别直接决定翻译时必须先判定性别再选择el/la/del/de l等变体。复数形式i18next 复数后缀加泰罗尼亚语使用 i18next 的_one和_other两个复数后缀与 Breeze 工具链中PLURAL_SUFFIXES[ca]的配置一致。按标准加泰罗尼亚语规则添加-s或-es或直接使用术语表的既定形式task_one: Tasca, task_other: TasquesdagRun_one: Execució de Dag, dagRun_other: Execucions de Dagui_commands.py 中的expand_plural_keys函数实现了配套逻辑它根据语言所需的后缀展开复数基础键plural base并结合英文 locale 中是否包含{{count}}占位符来判断哪些复数键是必需的从而避免把语言不需要的复数键误报为 unused。这解释了为什么ca的翻译文件里每个可数资源如asset_*、backfill_*、taskGroup_*都成对出现_one/_other键。大小写Capitalization描述性文字和较长字符串使用句首大写sentence case标题、标签和按钮文本采用类标题大写风格与现有翻译保持一致专有术语首字母大写Dag、Asset、XCom、Pool 等不得在句中给普通名词大写。缩略与冠词融合Elision and Contractions必须应用加泰罗尼亚语标准缩略规则de 元音 →d例Registre dauditoria、ID dexecucióel/la 元音 →l例lexecució、loperador介词融合ael→aldeel→del。现有翻译是这些规则的示范Temps despera de lexecució del DagDag 运行超时common.json 的dagDetails.dagRunTimeout在一句话里同时出现了d、l、del三种形态。变音符号Diacritics必须完整保留加泰罗尼亚语变音符号à、è、é、ï、ò、ó、ú、ü、ç以及l·l中的间隔点·。绝不省略或替换重音——例如绝不允许把 Execució 写成 Execucio。注意间隔点案例Col·lapsar、Coincidir中的l·l是标准拼写而非排版错误翻译代理在 lint 或手工校对时需将其视为合法字符。语序Word Order加泰罗尼亚语采用与英语相同的 SVO 标准语序形容词通常后置于名词例如 interval de dates日期区间、execució activa活动运行。这一约定保证了从英文源串翻译时句法结构基本平移降低了错译风险。5. 从现有翻译文件提取的实战模式第 5 节从存量ca/*.json中归纳了三类可直接复用的模式。始终保持英文的术语Dag → Dag、Asset → Asset、XCom → XCom、Pool → Pool、Provider → Provider。通用翻译键值模式与 common.json 实际内容一致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子节中均有对应实例add: Afegir、cancel: Cancel·lar、confirm: Confirmar、save: Desartasks.json中则有searchTasks: Cercar tasques、selectOperator: Seleccionar operadors等组合用法。6. 翻译代理的 DO / DONT 清单第 6 节给出面向 AI 翻译代理也是人工译者的硬性约束可直接作为代码评审 checklistDO必须做与现有ca/*.json文件的语气、风格、性数一致和大写方式保持一致全程使用正式的加泰罗尼亚语语域保留所有 i18next 占位符{{count}}、{{dagName}}、{{type}}等应用正确的加泰罗尼亚语缩略d、l与冠词融合al、del保留所有变音符号à, è, é, ï, ò, ó, ú, ü, ç, ·为每个键提供所需的全部复数后缀_one、_other。DONT禁止做翻译第 1 节列出的 Airflow 专有术语省略或替换变音符号例如绝不允许把 Execució 写成 Execucio修改热键值例如hotkey: e必须保持为e在现有翻译已有对应词汇时另造新词使用 DAG——永远写 Dag在句中给普通名词首字母大写。关于占位符规则可以结合 SKILL.md 的全局规则进一步理解{{variable}}插值中的变量名绝不能翻译或删除但占位符位置可以为了符合目标语言语序而重排且变量大小写必须精确保留如{{dagDisplayName}}。common.json 中的批量清理提示是典型范例description: {{count}} {{resourceName}} shan netejat correctament. Claus: {{keys}}{{count}}置于句首以匹配加泰罗尼亚语语序而{{resourceName}}、{{keys}}均原样保留。热键不翻译的规则同样可见download: { hotkey: d, tooltip: Prem {{hotkey}} per a descarregar els registres }——热键值是字面按键绑定仅提示语被翻译。7. 配套校验工作流breeze 翻译完整性检查虽然ca.md本身只定义语言规则但它服务的翻译任务最终要通过仓库工具链验收。按照 SKILL.md 的流程对ca这类已存在的 locale检查完整性查看缺失键与覆盖率breeze ui check-translation-completeness --language ca补齐缺失键生成TODO: translate:桩breeze ui check-translation-completeness --language ca --add-missing清理无用键英文 locale 中不存在、或该语言不需要的复数后缀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从源码结构看该命令的复数判定逻辑由 ui_commands.py 中PLURAL_SUFFIXES与expand_plural_keys共同实现对ca而言只有当英文源键包含{{count}}或英文侧定义了多种复数形式时才会把复数基础键展开为base _one/base _other并纳入必需键集合——这与ca.md中提供每个键所需的全部复数后缀_one、_other的要求完全对应。因此翻译代理只要遵循ca.md的术语表与复数规则breeze ui check-translation-completeness就能给出确定性的验收结论。小结ca.md的价值在于它把翻译加泰罗尼亚语 UI 字符串这一开放问题收敛为一套可机械执行的规则集英文保留术语表Dag/XCom/Asset/Pool/Provider 等 固定译法术语表Tasca、Execució de Dag、Reompliment 等 状态词汇表 六条语法硬规则语域、性数、复数、大小写、缩略、变音符号、语序 DO/DONT 清单。配合仓库中 ca locale 现有翻译 作为风格范本、config.ts 中的语言注册与 Breeze 完整性检查工具 作为验收手段这套规则保证了新产生的加泰罗尼亚语字符串与既有翻译 100% 一致。文档版本标注为 1.02026 年 3 月派生自现有ca/*.jsonlocale 文件后续若states等对象新增条目应按同样的风格约定回填并更新指南。【免费下载链接】airflowApache Airflow - A platform to programmatically author, schedule, and monitor workflows项目地址: https://gitcode.com/GitHub_Trending/ai/airflow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考