Ce părți pot fi traduse în timpul localizării JSON și care părți nu trebuie schimbate?
Butoanele de pe pagină sunt traduse în engleză, dar programul nu poate găsi elementul de configurare. Acest tip de eșec apare adesea în localizarea JSON: fiecare șir din obiect este predat traducătorului, iar numele cheii, rutarea și codificarea afacerii sunt, de asemenea, schimbate împreună. O abordare mai sigură nu este de a ghici care șiruri sună ca vorbire umană, ci de a permite în mod explicit traducerea căilor.
Un eșec comun în localizarea JSON este: butoanele paginii au fost schimbate în engleză, dar programul nu poate găsi elementele de configurare corespunzătoare. Motivul este de obicei că fiecare șir din obiect este predat traducătorului pentru procesare, iar numele cheii, rutarea și codificarea afacerii se modifică, de asemenea, în consecință. Acest articol este scris pentru dezvoltatori și personalul de localizare responsabil cu configurația internațională. Acesta explică cum să delimitați mai întâi căile de câmp translabile și apoi să faceți acceptarea.
Exemplele folosesc mostre sintetice pentru a demonstra metodele de procesare, iar codul a fost verificat într-un mediu izolat, dar aceasta nu reprezintă o garanție a tuturor fișierelor reale sau a performanței produsului. Înainte de a procesa documente importante, vă rugăm să păstrați originalele și să le revizuiți în funcție de limitele și elementele de acceptare din text.
Ce poate fi tradus în timpul localizării JSON? O singură propoziție concluzie
Vor fi traduse doar căile de copywriting enumerate în prealabil. Numele cheilor, valorile de rutare și codurile de afaceri vor rămâne aceleași, iar o listă de verificare de acceptare va fi utilizată pentru a confirma că părțile neschimbate nu au fost într-adevăr modificate.
| situatia ta | Practici recomandate | motiv |
|---|---|---|
Copywriting interfață, cum ar fi buttons.save | Puneți-l în lista de căi permise și confirmați-l înainte de traducere. | Calea este o adresă clară, care este mai de încredere decât a ghici dacă șirul seamănă cu vorbirea umană. |
| Valoare de rutare, cod de serviciu | Lăsați-l așa cum este și nu intrați în domeniul traducerii | Programul se bazează pe aceste valori. După modificare, va apărea o problemă că elementul de configurare nu poate fi găsit. |
| Substituenți, fragmente HTML, adrese URL în câmpurile de copiere | Adăugați reguli de protecție de nivel următor | Câmpurile din calea permisă pot conține în continuare conținut care trebuie protejat |
| elemente de matrice | Utilizați maparea ID-ului când există un ID stabil | După ce elementele sunt rearanjate, indexul poate indica o altă copie |
| Calea dispare după ce fișierul sursă este actualizat | Raportați o eroare și actualizați versiunea sursă fără a scrie automat traducerea veche. | Nume similare de câmpuri pot face ca traducerea să fie scrisă într-o poziție greșită |
Începeți cu calea câmpului în loc să traversați toate șirurile
Tratarea buttons.save ca pe o adresă este mai de încredere decât înlocuirea șirului „salvare"când îl vedeți. Aceeași propoziție poate apărea în copierea interfeței, mostrele de jurnal și cazurile de testare în același timp, iar traducerea poate să nu fie necesară în toate cele trei locuri.
Căile ar trebui să fie reprezentate fără ambiguitate folosind tupluri sau pointeri JSON. Atunci când pur și simplu îmbinați cu puncte, va apărea ambiguitate dacă numele cheii în sine conține puncte.
Următorul exemplu limitează doar două căi specifice, lăsând alt conținut așa cum este. Aceasta este o strategie de localizare pentru acest articol, nu o cerință a formatului JSON în sine. Eșantionul sintetic conține atât textul interfeței, cât și o valoare de rutare care nu trebuie modificată pentru a facilita verificarea limitelor.
Modificați doar valorile permise explicit la un moment dat
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")
Exemplul demonstrează doar nivelul obiectului, nu implementează indexarea matricei și nu apelează serviciul de traducere. Atunci când trimiteți la conducta reală, lista căilor permise ar trebui să fie determinată înainte de traducere, iar părții care generează traducerea nu i se poate permite să extindă domeniul de aplicare al propriilor modificări în același timp.
Copierea profundă poate împiedica modificarea obiectelor de intrare, dar nu este un sistem de tranzacții. Persistența trebuie încă proiectată separat.
Acceptarea depinde de părțile neschimbate
| examina | Rezultate normale | Acțiune în caz de anomalie |
|---|---|---|
| Colecția de nume cheie | În concordanță cu fișierul sursă | Preveniți suprascrierea fișierului original |
| Calea neautorizată | Valoarea rămâne neschimbată | Găsiți modificările care sunt în afara limitelor |
| Tipul câmpului țintă | Tot un fir | Respinge conversia implicită a tipului |
| Traiectorie lipsă | Eroare clară raportată | Actualizați versiunea sursă fără a crea automat câmpuri |
Simpla verificare a faptului că "limba-țintă a apărut" nu este suficientă. Hash-urile fișierelor sursă și listele de căi trebuie de asemenea salvate. Dacă fișierul sursă este actualizat și calea este ștearsă, traducerea veche nu poate fi rescrisă automat pe baza unor nume similare de câmpuri.
Array-urile, valorile null și cheile repetate trebuie luate în considerare separat
- Array: După rearanjarea elementelor, indexul poate să nu mai indice textul original. Când există un ID stabil, ID-ul este prioritizat pentru mapare.
- Valoare null:
nullnu este un șir gol și nu trebuie înlocuit cu textul "null" pentru o traducere mai ușoară. - Chei repetate: Parsarea JSON obișnuită poate fi pierdut informațiile de cheie duplicate după finalizare. Pentru a respinge cheile duplicate, acestea trebuie gestionate în faza de analizare, în loc să așteptăm finalizarea traducerii. Referință Documentația Python JSON.
Acest exemplu este potrivit pentru localizarea unei configurații bine structurate, nu pentru un traducător automat JSON arbitrar. În timpul acceptării traducerii, confirmați mai întâi că structura și câmpurile protejate nu s-au schimbat, apoi discutați dacă limba este naturală; acest lucru va clarifica ordinul de inspecție.
📊 Comparație cu nucleele
| Metodă | Metodă | Principalele riscuri | Scenarii aplicabile |
|---|---|---|---|
| Parcurge toate corzile | Fiecare șir este predat traducătorului | Denumirile cheilor, codurile de rutare și de serviciu pot fi schimbate împreună | Nu este menționat în textul original |
| Listă albă după calea câmpului | Traduce doar căile specificate în avans | Este necesară mentenanța listei de rute | Localizare clar structurată a configurației |
🎯 Care abordare ți se potrivește?
Dacă ......
- Păstrați fișierele de configurare a interfeței. Dacă doriți ca textul butonului să fie traducibil și configurația programului neschimbată, folosiți o listă albă de căi de câmp și confirmați lista de căi înainte de traducere.
- Elementele matricei pot fi rearanjate; prioritizează maparea cu ID-uri stabile, în loc să se bazeze pe indexuri.
- Fișierele sursă vor fi actualizate continuu. Vă rugăm să salvați lista de hash-uri și căi ale fișierelor sursă. Dacă calea dispare, va fi raportată o eroare, iar traducerea veche nu va fi rescrisă automat.
- Pentru a gestiona livrarea documentelor autentice, vă rugăm să creați o listă de verificare cu căile permise, textele originale și traducerile și să revizuiți fiecare element în parte.
❓ Întrebări frecvente (FAQ)
1. De ce să nu traduci direct toate șirurile în JSON?
Pentru că același șir poate servi simultan drept copie de interfață, cheie de program sau cod de business. Transmiterea fiecărui șir de caractere către traducător poate cauza, de asemenea, modificarea simultană a numelor de chei, rutarea și codificarea business, ceea ce face ca programul să nu găsească elemente de configurare.
2. Care sunt problemele cu îmbinarea traseelor cu puncte?
Dacă numele cheii în sine conține puncte, concatenarea punctelor va cauza ambiguitate. Textul original sugerează folosirea unor reprezentări neechivoce, precum tuple sau pointeri JSON.
3. Verifică doar dacă traducerea conține suficiente limbi țintă?
Nu e suficient. De asemenea, ar trebui să verificați dacă setul de chei corespunde fișierului sursă, dacă valoarea traseelor neautorizate rămâne neschimbată, dacă câmpul țintă este încă un șir de caractere și dacă calea lipsă arată clar erori.
4. null: Poți să-l înlocuiești cu textul "vid"?
Nu. null nu este un șir gol și nu ar trebui înlocuit cu text pentru comoditatea traducerii.
5. Ce ar trebui folosit pentru traducerea matricii de mapare?
Când există un ID stabil, ID-ul este prioritizat pentru mapare. Bazarea exclusivă pe indexuri poate duce la rearanjarea elementelor astfel încât să corespundă copiilor incorecte.
📝 Rezumat
Înainte de a traduce configurația JSON, specificați mai întâi căile de traducere permise, apoi folosiți lista de verificare a acceptării pentru a verifica părțile neschimbate. Acest lucru face mai ușoară identificarea problemei atunci când apar erori.
Încearcă acum: Încarcă documentul pentru a începe traducerea, păstrând formatul original


