Ποια μέρη μπορούν να μεταφραστούν κατά την τοπική προσαρμογή JSON και ποια μέρη δεν πρέπει να αλλάξουν;
Τα κουμπιά στη σελίδα μεταφράζονται στα αγγλικά, αλλά το πρόγραμμα δεν μπορεί να βρει το στοιχείο διαμόρφωσης. Αυτό το είδος αποτυχίας εμφανίζεται συχνά στην τοπική προσαρμογή JSON: κάθε συμβολοσειρά στο αντικείμενο παραδίδεται στον μεταφραστή και το όνομα του κλειδιού, η δρομολόγηση και η κωδικοποίηση επιχείρησης αλλάζουν επίσης μαζί. Μια ασφαλέστερη προσέγγιση δεν είναι να μαντέψετε ποιες χορδές ακούγονται σαν ανθρώπινη ομιλία, αλλά να επιτρέψετε ρητά τη μετάφραση ποιων μονοπατιών.
Μια συνηθισμένη αποτυχία στην τοπική προσαρμογή JSON είναι: τα κουμπιά σελίδας έχουν αλλάξει σε Αγγλικά, αλλά το πρόγραμμα δεν μπορεί να βρει τα αντίστοιχα στοιχεία διαμόρφωσης. Ο λόγος είναι συνήθως ότι κάθε συμβολοσειρά στο αντικείμενο παραδίδεται στον μεταφραστή για επεξεργασία και το όνομα του κλειδιού, η δρομολόγηση και η κωδικοποίηση της επιχείρησης αλλάζουν επίσης ανάλογα. Αυτό το άρθρο είναι γραμμένο για προγραμματιστές και προσωπικό εντοπισμού που είναι υπεύθυνο για τη διεθνή διαμόρφωση. Εξηγεί πώς να οριοθετήσετε πρώτα μεταφράσιμα μονοπάτια πεδίου και μετά να κάνετε αποδοχή.
Τα παραδείγματα χρησιμοποιούν συνθετικά δείγματα για να επιδείξουν μεθόδους επεξεργασίας και ο κώδικας έχει ελεγχθεί σε απομονωμένο περιβάλλον, αλλά αυτό δεν αποτελεί εγγύηση για όλα τα πραγματικά αρχεία ή την απόδοση του προϊόντος. Πριν επεξεργαστείτε σημαντικά έγγραφα, διατηρήστε τα πρωτότυπα και ελέγξτε τα σύμφωνα με τα όρια και τα στοιχεία αποδοχής στο κείμενο.
Τι μπορεί να μεταφραστεί κατά την τοπική προσαρμογή JSON; Μια φράση συμπέρασμα
Θα μεταφραστούν μόνο οι διαδρομές που αναφέρονται εκ των προτέρων και τα ονόματα κλειδιών, οι τιμές δρομολόγησης και οι κωδικοί επιχείρησης θα παραμείνουν τα ίδια και θα χρησιμοποιηθεί μια λίστα ελέγχου αποδοχής για να επιβεβαιωθεί ότι τα αμετάβλητα μέρη δεν έχουν όντως αλλάξει.
| την κατάστασή σας | Συνιστώμενες πρακτικές | λόγος |
|---|---|---|
Διεπαφή copywriting, όπως το buttons.save | Τοποθετήστε το στη λίστα επιτρεπόμενων διαδρομών και επιβεβαιώστε το πριν από τη μετάφραση. | Το μονοπάτι είναι μια ξεκάθαρη διεύθυνση, η οποία είναι πιο αξιόπιστη από το να μαντέψει κανείς εάν η χορδή μοιάζει με την ανθρώπινη ομιλία. |
| Τιμή δρομολόγησης, κωδικός υπηρεσίας | Αφήστε το ως έχει και μην εισάγετε το πεδίο εφαρμογής της μετάφρασης | Το πρόγραμμα βασίζεται σε αυτές τις τιμές. Μετά την τροποποίηση, θα υπάρξει πρόβλημα ότι το στοιχείο διαμόρφωσης δεν μπορεί να βρεθεί. |
| Placeholders, αποσπάσματα HTML, URL σε πεδία αντιγραφής | Προσθέστε κανόνες προστασίας επόμενου επιπέδου | Τα πεδία εντός της επιτρεπόμενης διαδρομής ενδέχεται να εξακολουθούν να περιέχουν περιεχόμενο που πρέπει να προστατεύεται |
| στοιχεία πίνακα | Χρησιμοποιήστε αντιστοίχιση αναγνωριστικών όταν υπάρχει σταθερό αναγνωριστικό | Μετά την αναδιάταξη των στοιχείων, το ευρετήριο μπορεί να δείχνει ένα άλλο αντίγραφο |
| Η διαδρομή εξαφανίζεται μετά την ενημέρωση του αρχείου προέλευσης | Αναφέρετε ένα σφάλμα και ενημερώστε την αρχική έκδοση χωρίς αυτόματη εγγραφή της παλιάς μετάφρασης. | Παρόμοια ονόματα πεδίων μπορεί να κάνουν τη μετάφραση να γραφτεί σε λάθος θέση |
Ξεκινήστε με τη διαδρομή πεδίου αντί να διασχίζετε όλες τις συμβολοσειρές
Η αντιμετώπιση του buttons.save ως διεύθυνσης είναι πιο αξιόπιστη από την αντικατάσταση της συμβολοσειράς "αποθήκευση" όταν τη βλέπετε. Η ίδια πρόταση μπορεί να εμφανίζεται ταυτόχρονα σε αντίγραφα διασύνδεσης, δείγματα αρχείων καταγραφής και δοκιμαστικές περιπτώσεις και ενδέχεται να μην απαιτείται μετάφραση και στα τρία σημεία.
Οι διαδρομές θα πρέπει να αναπαρίστανται με σαφήνεια χρησιμοποιώντας πλειάδες ή δείκτες JSON. Όταν γίνεται απλή σύνδεση με τελείες, θα προκύψει ασάφεια εάν το ίδιο το όνομα του κλειδιού περιέχει τελείες.
Το ακόλουθο παράδειγμα περιορίζει μόνο δύο συγκεκριμένες διαδρομές, αφήνοντας το άλλο περιεχόμενο ως έχει. Αυτή είναι μια στρατηγική τοπικής προσαρμογής για αυτό το άρθρο, όχι μια απαίτηση της ίδιας της μορφής JSON. Το συνθετικό δείγμα περιέχει τόσο κείμενο διεπαφής όσο και μια τιμή δρομολόγησης που δεν πρέπει να αλλάξει για να διευκολυνθεί ο έλεγχος ορίων.
Αλλάξτε μόνο ρητά επιτρεπόμενες τιμές κάθε φορά
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")
Το παράδειγμα δείχνει μόνο το επίπεδο αντικειμένου, δεν εφαρμόζει ευρετηρίαση πίνακα και δεν καλεί την υπηρεσία μετάφρασης. Κατά την υποβολή στην πραγματική διοχέτευση, η λίστα των επιτρεπόμενων διαδρομών θα πρέπει να καθορίζεται πριν από τη μετάφραση και δεν επιτρέπεται στο μέρος που δημιουργεί τη μετάφραση να επεκτείνει το εύρος των δικών του τροποποιήσεων ταυτόχρονα.
Το Deep copy μπορεί να αποτρέψει την τροποποίηση των αντικειμένων εισόδου στη θέση τους, αλλά δεν είναι σύστημα συναλλαγών. Το Persistence πρέπει ακόμα να σχεδιαστεί ξεχωριστά.
Η αποδοχή εξαρτάται από τα αμετάβλητα μέρη
| εξετάζω | φυσιολογικό αποτέλεσμα | Ενέργειες σε περίπτωση εξαίρεσης |
|---|---|---|
| Συλλογή ονομάτων κλειδιού | συμβατό με το αρχείο προέλευσης | Αποτρέψτε την αντικατάσταση του αρχικού αρχείου |
| Μη εξουσιοδοτημένη διαδρομή | η τιμή παραμένει αμετάβλητη | Βρείτε τροποποιήσεις εκτός ορίων |
| Τύπος πεδίου στόχου | Ακόμα μια χορδή | Απόρριψη σιωπηρών μετατροπών |
| μονοπάτι που λείπει | Αναφέρετε ξεκάθαρα ένα σφάλμα | Ενημερώστε την αρχική έκδοση χωρίς αυτόματη δημιουργία πεδίων |
Δεν αρκεί να επαληθεύσουμε ότι "η γλώσσα στόχος είναι παρούσα". Θα πρέπει επίσης να αποθηκευτεί μια λίστα κατακερματισμών και διαδρομών του αρχείου προέλευσης. Εάν η διαδρομή διαγραφεί μετά την ενημέρωση του αρχείου προέλευσης, η παλιά μετάφραση δεν μπορεί να επανεγγραφεί αυτόματα με παρόμοια ονόματα πεδίων.
Οι πίνακες, οι μηδενικές τιμές και τα διπλά κλειδιά πρέπει να εξετάζονται ξεχωριστά
- Πίνακας: Μετά την αναδιάταξη των στοιχείων, το ευρετήριο ενδέχεται να μην δείχνει ακόμα στο αρχικό αντίγραφο. Όταν υπάρχει σταθερό αναγνωριστικό, το αναγνωριστικό χρησιμοποιείται πρώτα για αντιστοίχιση.
- Null: Το
nullδεν είναι κενή συμβολοσειρά και δεν πρέπει να αντικατασταθεί με το κυριολεκτικό "κενό" για διευκόλυνση της μετάφρασης. - Διπλότυπο κλειδί: Διπλότυπες πληροφορίες κλειδιού ενδέχεται να έχουν χαθεί μετά την ολοκλήρωση της κανονικής ανάλυσης JSON. Για να απορρίψετε τα διπλά κλειδιά, αυτό θα πρέπει να γίνει κατά τη φάση ανάλυσης αντί να περιμένετε μέχρι να ολοκληρωθεί η μετάφραση. Αναφορά Τεκμηρίωση Python JSON.
Αυτό το παράδειγμα είναι κατάλληλο για καλά δομημένη τοπική προσαρμογή διαμόρφωσης και όχι για αυθαίρετο αυτόματο μεταφραστή JSON. Κατά την αποδοχή μετάφρασης, πρώτα επιβεβαιώστε ότι η δομή και τα προστατευμένα πεδία δεν έχουν αλλάξει και, στη συνέχεια, συζητήστε εάν η γλώσσα είναι φυσική. Η σειρά αντιμετώπισης προβλημάτων θα είναι πιο ξεκάθαρη.
📊 Βασική σύγκριση
| Τρόπος | πρακτική | Κύριοι κίνδυνοι | Ισχύοντα σενάρια |
|---|---|---|---|
| Επανάληψη σε όλες τις χορδές | Κάθε συμβολοσειρά δίνεται στον μεταφραστή | Τα ονόματα κλειδιών, η δρομολόγηση και οι κωδικοί επιχείρησης μπορούν να αλλάξουν μαζί | Δεν καλύπτεται στο αρχικό άρθρο |
| Λίστα επιτρεπόμενων ανά διαδρομή πεδίου | Μεταφράστε μόνο τις διαδρομές που έχουν καθοριστεί εκ των προτέρων | Ανάγκη διατήρησης λίστας μονοπατιών | Καλά δομημένος εντοπισμός διαμόρφωσης |
🎯 Ποια μέθοδος είναι κατάλληλη για εσάς;
αν……
- Για να διατηρήσετε το αρχείο διαμόρφωσης της διεπαφής, εάν θέλετε το αντίγραφο του κουμπιού να είναι μεταφράσιμο και η διαμόρφωση του προγράμματος να παραμείνει αμετάβλητη, χρησιμοποιήστε τη λίστα επιτρεπόμενων διαδρομών πεδίου και προσδιορίστε τη λίστα διαδρομής πριν από τη μετάφραση.
- Τα στοιχεία πίνακα ενδέχεται να αναδιαταχθούν, παρακαλούμε δώστε προτεραιότητα στη χρήση σταθερών αναγνωριστικών για αντιστοίχιση αντί να βασίζεστε σε ευρετήρια.
- Το αρχείο προέλευσης θα ενημερώνεται συνεχώς. Αποθηκεύστε τη λίστα κατακερματισμού και διαδρομής του αρχείου προέλευσης. Εάν η διαδρομή εξαφανιστεί, θα προκύψει σφάλμα και η παλιά μετάφραση δεν θα επανεγγραφεί αυτόματα.
- Εάν χρειάζεται να επεξεργαστείτε την παράδοση πραγματικών εγγράφων, κάντε μια λίστα ελέγχου των επιτρεπόμενων διαδρομών, του πρωτότυπου κειμένου και της μετάφρασης και ελέγξτε τα ένα προς ένα.
❓ Συχνές ερωτήσεις (FAQ)
1. Γιατί να μην μεταφράσετε απευθείας όλες τις συμβολοσειρές σε JSON;
Επειδή η ίδια συμβολοσειρά μπορεί να είναι ταυτόχρονα αντίγραφο διεπαφής, όνομα κλειδιού προγράμματος ή κωδικός επιχείρησης. Όταν κάθε συμβολοσειρά παραδίδεται στον μεταφραστή, το όνομα του κλειδιού, η δρομολόγηση και η κωδικοποίηση επιχείρησης μπορούν επίσης να αλλάξουν μαζί, με αποτέλεσμα το πρόγραμμα να μην βρίσκει το στοιχείο διαμόρφωσης.
2. Ποιο είναι το πρόβλημα με τη χρήση κουκκίδων για το μάτισμα μονοπατιών;
Εάν το ίδιο το όνομα κλειδιού περιέχει τελεία, η συνένωση κουκκίδων θα προκαλέσει ασάφεια. Το αρχικό άρθρο συνιστά τη χρήση ξεκάθαρων αναπαραστάσεων, όπως πλειάδες ή δείκτες JSON.
3. Αρκεί απλώς να ελέγξετε εάν η γλώσσα-στόχος περιλαμβάνεται στη μετάφραση;
δεν είναι αρκετό. Θα πρέπει επίσης να ελέγξετε εάν το σύνολο των ονομάτων κλειδιών είναι συμβατό με το αρχείο προέλευσης, εάν η τιμή της μη εξουσιοδοτημένης διαδρομής παραμένει αμετάβλητη, εάν το πεδίο προορισμού εξακολουθεί να είναι μια συμβολοσειρά και εάν οι διαδρομές που λείπουν αναφέρονται ρητά ως σφάλματα.
4. Μπορεί το null να αντικατασταθεί με το κείμενο "κενό";
Κλίση. Το null δεν είναι κενή συμβολοσειρά και δεν πρέπει να αντικατασταθεί με κείμενο για διευκόλυνση της μετάφρασης.
5. Τι πρέπει να χρησιμοποιείται για την αντιστοίχιση κατά τη μετάφραση πινάκων;
Όταν υπάρχει σταθερό αναγνωριστικό, το αναγνωριστικό χρησιμοποιείται πρώτα για αντιστοίχιση. Βασιζόμενοι μόνο στο ευρετήριο, μπορεί να αντιστοιχιστεί λάθος αντίγραφο μετά την αναδιάταξη των στοιχείων.
📝 Περίληψη
Πριν μεταφράσετε τη διαμόρφωση JSON, πρώτα διευκρινίστε τις διαδρομές που επιτρέπουν τη μετάφραση και, στη συνέχεια, χρησιμοποιήστε τη λίστα ελέγχου αποδοχής για να ελέγξετε τα αμετάβλητα μέρη. Αυτό διευκολύνει τον εντοπισμό του προβλήματος όταν κάτι πάει στραβά.
Δοκιμάστε το τώρα: Ανεβάστε το έγγραφο για να ξεκινήσει η μετάφραση, διατηρώντας την αρχική διάταξη


