Bulk text-replace překladových párů kontaminuje sdílené i18n komponenty
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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).
Root cause
Sekce “Root cause”Pár „starý → nový” nenese kontext souboru ani jazyka. Agent aplikoval páry globálně přes celý strom zdrojáků:
- 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. - 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.
- Substring kolize a řetězení replaců vytvořily překlepy, které v žádném vstupu nebyly.
Fix
Sekce “Fix”- 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). - 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 ? "…" : "…"). - 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.