Koji se dijelovi mogu prevesti tijekom JSON lokalizacije, a koji se dijelovi ne smiju mijenjati?
Gumbi na stranici prevedeni su na engleski, ali program ne može pronaći stavku konfiguracije. Ova vrsta kvara često se događa u JSON lokalizaciji: svaki niz u objektu predaje se prevoditelju, a naziv ključa, usmjeravanje i poslovno kodiranje također se mijenjaju zajedno. Sigurniji pristup nije pogađati koje žice zvuče kao ljudski govor, već izričito dopustiti prijevod kojih staza.
Uobičajeni kvar u lokalizaciji JSON-a je: gumbi stranice promijenjeni su na engleski, ali program ne može pronaći odgovarajuće konfiguracijske stavke. Razlog je obično taj što se svaki niz u objektu predaje prevoditelju na obradu, a naziv ključa, usmjeravanje i poslovno kodiranje također se mijenjaju u skladu s tim. Ovaj je članak napisan za programere i osoblje za lokalizaciju odgovorno za međunarodnu konfiguraciju. Objašnjava kako najprije ocrtati putanje polja koja se mogu prevoditi, a zatim izvršiti prihvaćanje.
Primjeri koriste sintetičke uzorke za demonstraciju metoda obrade, a kod je provjeren u izoliranom okruženju, ali to ne predstavlja jamstvo svih stvarnih datoteka ili performansi proizvoda. Prije obrade važnih dokumenata, molimo vas da sačuvate izvornike i pregledate ih prema granicama i stavkama prihvaćanja u tekstu.
Što se može prevesti tijekom JSON lokalizacije? Zaključak jedne rečenice
Bit će prevedeni samo unaprijed navedeni putovi pisanja teksta. Nazivi ključeva, vrijednosti usmjeravanja i poslovni kodovi ostat će isti, a popis za provjeru prihvaćanja koristit će se za potvrdu da nepromijenjeni dijelovi doista nisu promijenjeni.
| vaša situacija | Preporučene prakse | razlog |
|---|---|---|
Kopirajting sučelja, kao što je buttons.save | Stavite ga na popis dopuštenih puteva i potvrdite prije prijevoda. | Put je jasna adresa, što je pouzdanije od nagađanja sliči li niz ljudskom govoru. |
| Vrijednost usmjeravanja, šifra usluge | Ostavite kako jest i ne ulazite u opseg prijevoda | Program se oslanja na te vrijednosti. Nakon izmjene pojavit će se problem da se stavka konfiguracije ne može pronaći. |
| Rezervirana mjesta, HTML isječci, URL-ovi u poljima za kopiranje | Dodajte pravila zaštite sljedeće razine | Polja unutar dopuštene staze još uvijek mogu sadržavati sadržaj koji treba zaštititi |
| elementi niza | Koristite mapiranje ID-a kada postoji stabilan ID | Nakon što su elementi preuređeni, indeks može pokazivati na drugu kopiju |
| Putanja nestaje nakon ažuriranja izvorne datoteke | Prijavite pogrešku i ažurirajte izvornu verziju bez automatskog vraćanja starog prijevoda. | Slični nazivi polja mogu uzrokovati da prijevod bude napisan na pogrešnom mjestu |
Započnite s putanjom polja umjesto da prelazite sve nizove
Tretiranje buttons.save kao adrese je pouzdanije od zamjene niza "save" kada ga vidite. Ista rečenica može se pojaviti u kopiji sučelja, uzorcima dnevnika i testnim slučajevima u isto vrijeme, a prijevod možda neće biti potreban na sva tri mjesta.
Staze bi trebale biti predstavljene nedvosmisleno pomoću torki ili JSON pokazivača. Kod jednostavnog spajanja s točkama, dvosmislenost će se pojaviti ako sam naziv ključa sadrži točke.
Sljedeći primjer ograničava samo dvije određene staze, ostavljajući ostali sadržaj kakav jest. Ovo je strategija lokalizacije za ovaj članak, a ne zahtjev samog JSON formata. Sintetički uzorak sadrži tekst sučelja i vrijednost usmjeravanja koja se ne smije mijenjati kako bi se olakšala provjera granica.
Odjednom mijenjajte samo eksplicitno dopuštene vrijednosti
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")
Primjer samo demonstrira razinu objekta, ne implementira indeksiranje polja i ne poziva uslugu prevođenja. Prilikom podnošenja stvarnom cjevovodu, popis dopuštenih putova treba odrediti prije prijevoda, a strani koja generira prijevod ne može se dopustiti da istovremeno proširi opseg vlastitih izmjena.
Duboka kopija može spriječiti da se ulazni objekti mijenjaju na mjestu, ali to nije transakcijski sustav. Postojanost još treba posebno osmisliti.
Prihvaćanje ovisi o nepromijenjenim dijelovima
| ispitati | normalan rezultat | Radnje u slučaju iznimke |
|---|---|---|
| Zbirka imena ključeva | u skladu s izvornom datotekom | Spriječiti prepisivanje izvorne datoteke |
| Neovlašteni put | vrijednost ostaje nepromijenjena | Pronađite izmjene izvan granica |
| Vrsta ciljnog polja | Još uvijek niz | Odbijte implicitne pretvorbe tipa |
| staza koja nedostaje | Jasno prijavite grešku | Ažurirajte izvornu verziju bez automatskog stvaranja polja |
Nije dovoljno potvrditi da je "ciljni jezik prisutan". Treba također spremiti popis hashova izvorne datoteke i staza. Ako se put izbriše nakon ažuriranja izvorne datoteke, stari prijevod se ne može automatski vratiti sa sličnim nazivima polja.
Polje, nulte vrijednosti i duplicirane ključeve treba razmotriti odvojeno
- Niz: Nakon što su elementi preuređeni, indeks možda još uvijek neće pokazivati na izvornu kopiju. Kada postoji stabilan ID, ID se prvi koristi za mapiranje.
- Null:
nullnije prazan niz i ne bi ga trebalo zamijeniti doslovnim "prazno" radi lakšeg prijevoda. - Dvostruki ključ: Duplicirane informacije o ključu možda su izgubljene nakon dovršetka normalnog JSON parsiranja. Da biste odbili duplikate ključeva, to treba učiniti tijekom faze parsiranja, a ne čekati dok se prijevod ne završi. Referenca Python JSON dokumentacija.
Ovaj je primjer prikladan za lokalizaciju dobro strukturirane konfiguracije, a ne proizvoljni JSON automatski prevoditelj. Prilikom prihvaćanja prijevoda najprije potvrdite da se struktura i zaštićena polja nisu promijenili, a zatim razgovarajte o tome je li jezik prirodan. Redoslijed rješavanja problema bit će jasniji.
📊 Osnovna usporedba
| Način | praksa | Glavni rizici | Primjenjivi scenariji |
|---|---|---|---|
| Iteracija kroz sve nizove | Svaki niz se daje prevoditelju | Nazivi ključeva, usmjeravanje i poslovni kodovi mogu se mijenjati zajedno | Nije obuhvaćeno izvornim člankom |
| Popis dopuštenih prema putu polja | Prevodite samo unaprijed navedene staze | Potrebno je održavati popis puta | Dobro strukturirana lokalizacija konfiguracije |
🎯 Koja je metoda prikladna za vas?
ako ti……
- Za održavanje konfiguracijske datoteke sučelja, ako želite da se kopija gumba može prevoditi i da konfiguracija programa ostane nepromijenjena, koristite popis dopuštenih putanja polja i odredite popis putanja prije prijevoda.
- Elementi polja mogu se preuređivati, dajte prednost korištenju stabilnih ID-ova za mapiranje umjesto oslanjanja na indekse.
- Izvorna datoteka će se stalno ažurirati. Spremite hash izvorne datoteke i popis staza. Ako staza nestane, pojavit će se pogreška i stari prijevod neće biti automatski vraćen.
- Ako trebate obraditi stvarnu isporuku dokumenata, napravite popis dopuštenih putova, izvornog teksta i prijevoda i pregledajte ih jednog po jednog.
❓ Često postavljana pitanja (FAQ)
1. Zašto ne biste izravno preveli sve nizove u JSON?
Budući da isti niz može biti kopija sučelja, naziv programskog ključa ili poslovni kod u isto vrijeme. Kada se svaki niz preda prevoditelju, naziv ključa, usmjeravanje i poslovno kodiranje također se mogu promijeniti zajedno, uzrokujući da program ne pronađe konfiguracijsku stavku.
2. Koji je problem s korištenjem točaka za spajanje staza?
Ako samo ime ključa sadrži točku, ulančavanje točaka uzrokovat će dvosmislenost. Izvorni članak preporučuje korištenje nedvosmislenog predstavljanja kao što su torke ili JSON pokazivač.
3. Je li dovoljno samo provjeriti je li ciljni jezik uključen u prijevod?
nije dovoljno. Također biste trebali provjeriti je li skup naziva ključeva u skladu s izvornom datotekom, ostaje li vrijednost neovlaštene staze nepromijenjena, je li ciljno polje još uvijek niz i jesu li staze koje nedostaju izričito prijavljene kao pogreške.
4. Može li se null zamijeniti tekstom "prazno"?
ne mogu null nije prazan niz i ne bi ga trebalo zamijeniti tekstom radi lakšeg prijevoda.
5. Što treba koristiti za mapiranje pri prevođenju nizova?
Kada postoji stabilan ID, ID se prvi koristi za mapiranje. Oslanjajući se samo na indeks, pogrešna kopija može odgovarati nakon što se elementi preurede.
📝 Sažetak
Prije prevođenja JSON konfiguracije najprije razjasnite putove koji dopuštaju prevođenje, a zatim upotrijebite kontrolni popis za prihvaćanje da provjerite nepromijenjene dijelove. To olakšava lociranje problema kada nešto pođe po zlu.
Isprobajte sada: prenesite dokument za početak prijevoda, zadržavajući izvorni izgled


