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ácia | Odporúčané postupy | dôvod |
|---|---|---|
Copywriting rozhrania, ako napríklad buttons.save | Vlož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ód | Nechajte to tak, ako je, a nezadávajte rozsah prekladu | Program 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írovania | Pridajte pravidlá ochrany ďalšej úrovne | Polia v rámci povolenej cesty môžu stále obsahovať obsah, ktorý je potrebné chrániť |
| prvky poľa | Použite mapovanie ID, keď existuje stabilné ID | Po preusporiadaní prvkov môže index ukazovať na inú kópiu |
| Po aktualizácii zdrojového súboru cesta zmizne | Nahlá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špekcia | Normálne výsledky | Opatrenie v prípade abnormality |
|---|---|---|
| Kolekcia kľúčových názvov | Konzistentné so zdrojovým súborom | Zabrániť prepísaniu pôvodného súboru |
| Neoprávnená cesta | Hodnota zostáva nezmenená | Zistite úpravy mimo hraníc |
| Typ cieľového poľa | Stále len šnúra | Odmietnite implicitnú konverziu typu |
| Chýbajúca cesta | Nahlá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:
nullnie 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óda | Metóda | Hlavné riziká | Použiteľné scenáre |
|---|---|---|---|
| Prechádzať všetkými reťazcami | Každý reťazec sa odovzdá prekladateľovi | Názvy kľúčov, smerovanie a servisné kódy môžu byť zmenené spoločne | V pôvodnom texte to nie je uvedené |
| Biely zoznam podľa cesty poľa | Prekladajte iba cesty určené vopred | Je potrebná údržba zoznamu ciest | Jasne š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.


