airflow-translations

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

Add or update translations for the Apache Airflow UI. Guides through setting up locales, scaffolding translation files, translating with locale-specific guidelines, and validating results. Use when working with i18n tasks in airflow-core/src/airflow/ui/public/i18n/locales/.

.agents/skills/airflow-translations/SKILL.md

Download bundle ↓
main · 2aca1aa20 bundle filesScanned 2026-09-14

locales/ca.md

2,052 tokens · o200k_base · 9,031 bytes

Catalan (ca) Translation Agent Skill

Locale code: ca Preferred variant: Standard Catalan (ca), consistent with existing translations in airflow-core/src/airflow/ui/public/i18n/locales/ca/

This file contains locale-specific guidelines so AI translation agents produce new Catalan strings that stay 100% consistent with the existing translations.

1. Core Airflow Terminology

The following terms must remain in English unchanged (case-sensitive):

  • Dag / Dags — Airflow concept; never write "DAG"
  • XCom / XComs — Airflow cross-communication mechanism
  • Asset / Assets — Data dependency tracked by Airflow
  • Plugin / Plugins — Airflow extensibility mechanism (translated as "Extensió" in nav/labels — keep English in code references)
  • Pool / Pools — Resource constraint mechanism
  • Provider / Providers — Airflow extension package name
  • Map Index — Task mapping index
  • PID — Unix process identifier
  • ID — Universal abbreviation
  • UTC — Time standard
  • JSON — Standard technical format name
  • REST API — Standard technical term
  • Log levels: CRITICAL, ERROR, WARNING, INFO, DEBUG

2. Standard Translations

The following Airflow-specific terms have established Catalan translations that must be used consistently:

English TermCatalan TranslationNotes
TaskTasca / tascaLowercase in compound contexts
Task InstanceInstància de tascaPlural: "Instàncies de tasca"
Task GroupGrup de tasques
Dag RunExecució de DagPlural: "Execucions de Dag"
BackfillReomplimentPlural: "Reompliments"
Trigger (noun)Disparador
Trigger RuleRegla d'execució
TriggererTriggererComponent name; keep English in technical refs
SchedulerProgramador
Schedule (noun)Programació
ExecutorExecutor
ConnectionConnexióPlural: "Connexions"
VariableVariablePlural: "Variables"
Audit LogRegistre d'auditoria
LogRegistre
StateEstat
Queue (noun)Cuae.g., "En cua" for "queued"
Config / ConfigurationConfiguració
OperatorOperadorPlural: "Operadors"
Asset EventEsdeveniment d'AssetKeep "Asset" in English
Dag ProcessorDag ProcessorComponent name; keep English
HeartbeatBatec
PluginExtensióIn UI nav/labels only

3. Task/Run States

English StateCatalan Translation
runningExecutant-se
failedFallit
successExitós
queuedEn cua
scheduledProgramat
skippedSaltat
deferredDiferit
removedEliminat
restartingReiniciant
up_for_retryA reintentar
up_for_rescheduleA reprogramar
upstream_failedFallit aigües amunt
no_status / noneSense estat
plannedPlanificat
openObert

4. Catalan-Specific Guidelines

Tone and Register

  • Use a formal, professional register suitable for technical software UIs.
  • Avoid colloquialisms; prefer neutral and precise language.
  • Keep UI strings concise — they appear in buttons, labels, and tooltips.

Gender Agreement

  • Catalan nouns have grammatical gender; match adjectives and articles accordingly:
    • "Dag" is treated as masculine: "el Dag", "un Dag"
    • "Tasca" is feminine: "la tasca", "una tasca"
    • "Execució" is feminine: "una execució", "l'execució"
    • "Connexió" is feminine: "la connexió"
    • "Variable" is feminine: "la variable"
    • "Instància" is feminine: "la instància"

Plural Forms

  • Catalan uses i18next plural suffixes _one and _other. Add -s or -es according to standard Catalan rules, or use the established glossary form:

    "task_one": "Tasca",
    "task_other": "Tasques"
    
    "dagRun_one": "Execució de Dag",
    "dagRun_other": "Execucions de Dag"
    

Capitalization

  • Use sentence case for descriptions and longer strings.
  • Use title-like capitalization for headers, labels, and button text (match the style of existing translations).
  • Capitalize proper terms: "Dag", "Asset", "XCom", "Pool", etc.
  • Do not capitalize common nouns mid-sentence.

Elision and Contractions

  • Apply standard Catalan elision and contraction rules:
    • de + vowel → d' (e.g., "Registre d'auditoria", "ID d'execució")
    • el/la + vowel → l' (e.g., "l'execució", "l'operador")
  • Prepositions a + elal; de + eldel

Diacritics

  • Always preserve Catalan diacritics: à, è, é, ï, ò, ó, ú, ü, ç, · (interpunct in l·l).
  • Never drop or substitute accents.

Word Order

  • Standard SVO word order — similar to English.
  • Adjectives typically follow nouns (e.g., "interval de dates", "execució activa").

5. Examples from Existing Translations

Always keep in English:

  • "Dag" → "Dag"
  • "Asset" → "Asset"
  • "XCom" → "XCom"
  • "Pool" → "Pool"
  • "Provider" → "Provider"

Common translation patterns:

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 d'Asset"
assetEvent_other      → "Esdeveniments d'Asset"
running               → "Executant-se"
failed                → "Fallit"
success               → "Exitós"
queued                → "En cua"
scheduled             → "Programat"

Action verbs (buttons):

Add     → "Afegir"
Delete  → "Eliminar"
Edit    → "Editar"
Save    → "Desar"
Reset   → "Restablir"
Cancel  → "Cancel·lar"
Confirm → "Confirmar"
Import  → "Importar"
Export  → "Exportar"
Search  → "Cercar"
Filter  → "Filtrar"

6. Agent Instructions (DO / DON'T)

DO:

  • Match tone, style, gender agreement, and casing from existing ca/*.json files
  • Use formal Catalan register throughout
  • Preserve all i18next placeholders: {{count}}, {{dagName}}, {{type}}, etc.
  • Apply correct Catalan elision (d', l', contractions al, del)
  • Preserve all diacritics (à, è, é, ï, ò, ó, ú, ü, ç, ·)
  • Provide all needed plural suffixes (_one, _other) for each key

DON'T:

  • Translate Airflow-specific terms listed in section 1
  • Drop or substitute diacritics (e.g., never write "Execucio" for "Execució")
  • Change hotkey values (e.g., "hotkey": "e" must stay "e")
  • Invent new vocabulary when an equivalent already exists in the current translations
  • Use "DAG" — always write "Dag"
  • Capitalize common nouns mid-sentence

Version: 1.0 — derived from existing ca/*.json locale files (March 2026)

Referenced from SKILL.md