Přeskočit na obsah

Bulk text-replace překladových párů kontaminuje sdílené i18n komponenty

import { Aside } from ‘@astrojs/starlight/components’;

Po hromadné aplikaci ~65 překladových párů (vygenerovaných diffem „aktuální build ↔ referenční build”) se na stránkách výchozího jazyka objevily texty druhého jazyka: patička, eyebrow sekce, labely formulářů. Zároveň se rozjely stringy, které se vyskytovaly na dvou místech s různým zněním (krátká varianta v kroku postupu vs. dlouhá varianta v ceníku) — replace přepsal oba výskyty na jedno znění. Vznikl i překlep zdvojením koncovky (Kostenloses + replace → Kostenlosess).

Pár „starý → nový” nenese kontext souboru ani jazyka. Agent aplikoval páry globálně přes celý strom zdrojáků:

  1. Pár s OLD textem ve výchozím jazyce (např. Design & realizace → Design & Umsetzung) zasáhl sdílenou komponentu, která tentýž string renderuje pro obě jazykové mutace.
  2. Pár s OLD textem vyskytujícím se vícekrát přepsal všechny výskyty, i když referenční build měl na jednom místě krátkou a na druhém dlouhou variantu.
  3. Substring kolize a řetězení replaců vytvořily překlepy, které v žádném vstupu nebyly.
  1. Překladový soubor rozdělit na jazykové poloviny (const cs = {…} / const de = {…}) a páry aplikovat jen do cílové poloviny (split na marker, replace, join).
  2. Před aplikací každého páru zkontrolovat, zda OLD text existuje v korpusu stránek druhého jazyka referenčního buildu — pokud ano, pár neaplikovat automaticky, ale ručně přepsat sdílenou komponentu na jazykovou podmínku (isDe ? "…" : "…").
  3. Verifikace: skript, který ze všech vyrenderovaných stránek obou jazyků vytáhne viditelný text (strip tagů/skriptů/stylů po řádcích) a porovná množiny řádků s referencí — regrese ve výchozím jazyce se jinak nenajdou, protože se diffuje jen opravovaná mutace.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: po hromadném replace grep na slova druhého jazyka v šablonách/komponentách bez jazykové podmínky; full-page text diff obou mutací proti referenci.
  • Anti-pattern: replace(old, new) přes celý strom zdrojáků pro páry vygenerované z jednojazyčného diffu; spoléhání, že „string je dost unikátní”.
  • Lepší přístup: aplikovat změny na úrovni struktur (klíč v překladovém objektu), ne na úrovni surového textu; kde struktura není, omezit scope replacu na jazykový blok a všechny kolizní páry eskalovat na ruční edit.

Sister bugs / související

Sekce “Sister bugs / související”
  • Obecná past find-replace: string s více výskyty a různým cílovým zněním nelze řešit jedním párem — vždy nejdřív spočítat výskyty a rozhodnout per výskyt.
Přidal aiarchitekt.cz · 25. 9. 2026 2:00
Provozuje aiarchitekt.cz