Ktoré časti je možné preložiť počas lokalizácie JSON a ktoré časti sa nesmú meniť?

Tlačidlá na stránke sú preložené do angličtiny, ale program nemôže nájsť konfiguračnú položku. Tento druh zlyhania sa často vyskytuje v lokalizácii JSON: každý reťazec v objekte sa odovzdá prekladateľovi a spoločne sa zmení aj názov kľúča, smerovanie a obchodné kódovanie. Bezpečnejším prístupom nie je hádať, ktoré struny znejú ako ľudská reč, ale výslovne umožniť preklad ktorých ciest.

Bežná chyba v lokalizácii JSON je: tlačidlá stránok boli zmenené na anglické, ale program nemôže nájsť zodpovedajúce konfiguračné položky. Dôvodom je zvyčajne to, že každý reťazec v objekte sa odovzdá na spracovanie prekladateľovi a podľa toho sa zmení aj názov kľúča, smerovanie a obchodné kódovanie. Tento článok je napísaný pre vývojárov a lokalizačných pracovníkov zodpovedných za medzinárodnú konfiguráciu. Vysvetľuje, ako najskôr vymedziť preložiteľné poľné cesty a potom ich prijať.

Príklady používajú syntetické vzorky na demonštráciu metód spracovania a kód bol skontrolovaný v izolovanom prostredí, čo však nepredstavuje záruku všetkých skutočných súborov alebo výkonu produktu. Pred spracovaním dôležitých dokumentov si uschovajte originály a skontrolujte ich podľa hraníc a akceptačných položiek v texte.

Čo je možné preložiť počas lokalizácie JSON? Záver jednou vetou

Preložia sa iba vopred uvedené cesty copywritingu a názvy kľúčov, smerovacie hodnoty a obchodné kódy zostanú rovnaké a na potvrdenie, že nezmenené časti sa skutočne nezmenili, sa použije kontrolný zoznam pre prijatie.

vaša situáciaOdporúčané postupydôvod
Copywriting rozhrania, ako napríklad buttons.saveVložte ho do zoznamu povolených ciest a pred prekladom ho potvrďte.Cesta je jasná adresa, ktorá je spoľahlivejšia ako hádanie, či reťazec pripomína ľudskú reč.
Smerovacia hodnota, servisný kódNechajte to tak, ako je, a nezadávajte rozsah prekladuProgram sa spolieha na tieto hodnoty. Po úprave sa vyskytne problém, že položku konfigurácie nemožno nájsť.
Zástupné symboly, úryvky HTML, adresy URL v poliach kopírovaniaPridajte pravidlá ochrany ďalšej úrovnePolia v rámci povolenej cesty môžu stále obsahovať obsah, ktorý je potrebné chrániť
prvky poľaPoužite mapovanie ID, keď existuje stabilné IDPo preusporiadaní prvkov môže index ukazovať na inú kópiu
Po aktualizácii zdrojového súboru cesta zmizneNahláste chybu a aktualizujte zdrojovú verziu bez automatického odpisovania starého prekladu.Podobné názvy polí môžu spôsobiť, že preklad bude napísaný na nesprávnej pozícii

Začnite s poľnou cestou namiesto prechádzania všetkých reťazcov

Zaobchádzanie s buttons.save ako s adresou je spoľahlivejšie ako nahradenie reťazca „uložiť", keď ho uvidíte. Rovnaká veta sa môže objaviť v kópii rozhrania, vzorkách denníka a testovacích prípadoch súčasne a preklad sa nemusí vyžadovať na všetkých troch miestach.

Cesty by mali byť reprezentované jednoznačne pomocou n-tic alebo ukazovateľov JSON. Pri jednoduchom spájaní bodkami nastane nejednoznačnosť, ak samotný názov kľúča obsahuje bodky.

Nasledujúci príklad obmedzuje iba dve konkrétne cesty, pričom ostatný obsah ponecháva tak, ako je. Toto je lokalizačná stratégia pre tento článok, nie požiadavka samotného formátu JSON. Syntetická vzorka obsahuje text rozhrania aj smerovaciu hodnotu, ktorá sa nesmie meniť, aby sa uľahčila kontrola hraníc.

Naraz meňte iba výslovne povolené hodnoty

import copy

source = {"buttons": {"save": "保存", "cancel": "取消"},
          "route": "/settings", "version": 1}
approved = {("buttons", "save"): "Save",
            ("buttons", "cancel"): "Cancel"}

def apply_texts(document, replacements):
    result = copy.deepcopy(document)
    for path, translated in replacements.items():
        if not path or not isinstance(translated, str):
            raise ValueError("invalid replacement")
        parent = result
        for key in path[:-1]:
            parent = parent[key]
        key = path[-1]
        if key not in parent or not isinstance(parent[key], str):
            raise ValueError("target must be an existing string")
        parent[key] = translated
    return result

result = apply_texts(source, approved)
assert result["buttons"]["save"] == "Save"
assert result["route"] == source["route"]
assert source["buttons"]["save"] == "保存"
try:
    apply_texts(source, {("version",): "one"})
except ValueError:
    pass
else:
    raise AssertionError("numeric field must be rejected")

Príklad iba demonštruje úroveň objektu, neimplementuje indexovanie poľa a nevolá prekladateľskú službu. Pri odovzdávaní do reálneho potrubia by mal byť zoznam povolených ciest určený ešte pred prekladom a zároveň nie je možné povoliť, aby strana, ktorá preklad generuje, rozširovala rozsah vlastných úprav.

Hlboká kópia môže zabrániť úprave vstupných objektov na mieste, nejde však o transakčný systém. Vytrvalosť je stále potrebné navrhnúť samostatne.

Prijatie závisí od nezmenených častí

InšpekciaNormálne výsledkyOpatrenie v prípade abnormality
Kolekcia kľúčových názvovKonzistentné so zdrojovým súboromZabrániť prepísaniu pôvodného súboru
Neoprávnená cestaHodnota zostáva nezmenenáZistite úpravy mimo hraníc
Typ cieľového poľaStále len šnúraOdmietnite implicitnú konverziu typu
Chýbajúca cestaNahlásená chyba vymazaťAktualizujte zdrojovú verziu bez automatického vytvárania polí

Len overiť, že "cieľový jazyk sa objavil", nestačí. Hashy zdrojových súborov a zoznamy ciest by mali byť tiež uložené. Ak je zdrojový súbor aktualizovaný a cesta je vymazaná, starý preklad nie je možné automaticky prepísať na základe podobných názvov polí.

Polia, nulové hodnoty a opakované kľúče je potrebné posudzovať samostatne

  • Pole: Po preusporiadaní prvku nemusí index stále ukazovať na pôvodný text. Keď je stabilné ID, ID má prioritu pri mapovaní.
  • Null: null nie je prázdny reťazec a nemal by byť nahradený textom "null" pre jednoduchší preklad.
  • Opakované kľúče: Bežné JSON parsovanie mohlo po dokončení stratiť informácie o duplicitnom kľúči. Ak chcete odmietnuť duplicitné kľúče, mali by sa spracovávať počas fázy parsovania, namiesto čakania na dokončenie prekladu. Referencia Dokumentácia Python JSON.

Tento príklad je vhodný pre dobre štruktúrovanú lokalizáciu konfigurácie, nie pre ľubovoľný automatický JSON prekladač. Počas prekladu najprv potvrďte, že štruktúra a chránené oblasti sa nezmenili, potom diskutujte, či je jazyk prirodzený; tým sa objasní poradie kontroly.

📊 Porovnanie jadra

MetódaMetódaHlavné rizikáPoužiteľné scenáre
Prechádzať všetkými reťazcamiKaždý reťazec sa odovzdá prekladateľoviNázvy kľúčov, smerovanie a servisné kódy môžu byť zmenené spoločneV pôvodnom texte to nie je uvedené
Biely zoznam podľa cesty poľaPrekladajte iba cesty určené vopredJe potrebná údržba zoznamu ciestJasne štruktúrovaná lokalizácia konfigurácie

🎯 Ktorý prístup ti vyhovuje?

Ak ......

  • Udržiavajte konfiguračné súbory rozhrania. Ak chcete, aby bol text tlačidiel prekladateľný a konfigurácia programu nezmenená, použite biely zoznam ciest polí a potvrďte zoznam ciest pred prekladom.
  • Prvky poľa môžu byť preusporiadané; uprednostnite mapovanie so stabilnými ID namiesto spoliehania sa na indexy.
  • Zdrojové súbory budú priebežne aktualizované. Uložte, prosím, hash a zoznam ciest zdrojového súboru. Ak cesta zmizne, bude nahlásená chyba a starý preklad sa automaticky neprepíše.
  • Na doručenie pravých dokumentov si prosím vytvorte kontrolný zoznam povolených ciest, originálnych textov a prekladov a skontrolujte každú položku samostatne.

❓ Často kladené otázky (FAQ)

1. Prečo neprekladať všetky reťazce priamo v JSON?

Pretože ten istý reťazec môže súčasne slúžiť ako kópia rozhrania, programový kľúč alebo obchodný kód. Odovzdanie každého reťazca prekladateľovi môže tiež spôsobiť zmenu názvov kľúčov, smerovania a obchodného kódovania spolu, čo spôsobí, že program nenájde konfiguračné položky.

2. Aké sú problémy so spájaním ciest bodkami?

Ak samotný názov kľúča obsahuje bodky, zreťazenie bodiek spôsobí nejednoznačnosť. Pôvodný text navrhuje používať jednoznačné reprezentácie ako n-tice alebo JSON ukazovatele.

3. Len skontrolovať, či preklad obsahuje dostatok cieľových jazykov?

Nie dosť. Mali by ste tiež skontrolovať, či sada kľúčov zodpovedá zdrojovému súboru, či hodnota neoprávnených ciest zostáva nezmenená, či je cieľové pole stále reťazec a či chýbajúca cesta jasne zobrazuje chyby.

4. null: Môžete ho nahradiť textom "empty"?

Nie. null nie je prázdny reťazec a nemal by byť nahradený textom pre pohodlie prekladu.

5. Čo by sa malo použiť na preklad mapovacích polí?

Keď je stabilné ID, ID má prioritu pri mapovaní. Spoliehanie sa iba na indexy môže viesť k preusporiadaniu prvkov tak, aby zodpovedali nesprávnemu textu.

📝 Zhrnutie

Pred prekladom konfigurácie JSON najprv zadajte povolené cesty prekladu, potom použite kontrolný zoznam akceptácie na kontrolu nezmenených častí. To uľahčuje presné identifikovanie problému, keď sa vyskytnú chyby.

Vyskúšajte to teraz: Nahrajte svoj dokument a začnite prekladať, pričom zachovajte pôvodné formátovanie

Aktualizované 2026-11-17