Μεταφράσεις
Το site about χρησιμοποιεί αρχεία JSON του i18next στο about/public/translations/{lang}/default.json. Οι μεταφράσεις των πηγαίων αρχείων του Docusaurus βρίσκονται χωριστά, στο docs/i18n/.
Κλειδιά του site about
Χρησιμοποιήστε το .agents/skills/translate/SKILL.md. Εντοπίστε τα τρέχοντα locales από τον δίσκο και διατηρήστε τα placeholders, το markup, τους τεχνικούς όρους και τις εμπορικές ονομασίες. Σε μεγαλύτερα αιτήματα, θυγατρικοί πράκτορες μπορούν να παράγουν ανεξάρτητους χάρτες, αλλά ένας μόνο γονικός πράκτορας εφαρμόζει σειριακά κάθε εγγραφή σε locale· το script ενημέρωσης δεν διαθέτει κλείδωμα εγγραφής.
Χρησιμοποιήστε μια μοναδική διαδρομή χάρτη που ανήκει στην εργασία. Κάντε προεπισκόπηση με node scripts/update-translations.js --key <key> --map <map.json> --include-en --dry και έπειτα εφαρμόστε με τα ίδια ορίσματα και --write. Μετά την εγγραφή, επαληθεύστε την κάλυψη/τις τιμές και αφαιρέστε μόνο τους προσωρινούς χάρτες που ανήκουν σε αυτή την εργασία.
Χρησιμοποιήστε --delete για αφαιρέσεις που ζητήθηκαν. Εξετάστε τα ευρήματα του --audit --dry πριν από ένα εξουσιοδοτημένο --audit --write· τα δυναμικά κλειδιά μετάφρασης απαιτούν χειροκίνητο έλεγχο του πηγαίου κώδικα. Αντιγράψτε το αγγλικό κείμενο σε κάθε locale μόνο για τεχνικό όρο, εμπορική ονομασία ή placeholder.
Σελίδες Docusaurus
Το scripts/translate-docs.py είναι μαζικός εγγραφέας για όλες τις σελίδες και όλα τα locales και δεν έχει φίλτρο ανά αρχείο· μην το χρησιμοποιείτε για μια περιορισμένη αλλαγή σε μετάφραση. Το scripts/check-docs-translations.py είναι ο επαληθευτής, λειτουργεί μόνο για ανάγνωση και υποστηρίζει --locales και --paths.
Κρατήστε τα μπλοκ κώδικα, τους συνδέσμους, τον ενσωματωμένο κώδικα, τις διευθύνσεις συμβολαίων, τις επικεφαλίδες, τους πίνακες και τα admonitions ευθυγραμμισμένα με την αγγλική πηγή. Επιλύστε τα σφάλματα του επαληθευτή· οι προειδοποιήσεις frontmatter-untranslated για εμπορικές ονομασίες είναι αναμενόμενες. Ακολουθήστε το docs/AGENTS.md και κάντε build από τη ρίζα όταν αλλάζετε το θέμα ή τη συμπεριφορά i18n της τεκμηρίωσης, ώστε η στατική έξοδος και το Pagefind να παραμένουν ευθυγραμμισμένα.
Προαιρετικός σημασιολογικός έλεγχος
Για επιλεγμένα κλειδιά i18next, χρησιμοποιήστε το scripts/jev/translation-README.md. Για σελίδες τεκμηρίωσης, εκτελέστε πρώτα node scripts/jev/docs-translations.mjs --locales it,de --paths browser-p2p.md. Η εντολή απαιτεί ρητή επιλογή locale/σελίδας, εκτελεί τον δομικό επαληθευτή και αναφέρει τον σημασιολογικό έλεγχο ως μη επαληθευμένο μέχρι να ενεργοποιηθεί το ζωντανό inference. Προσθέστε --live μόνο εφόσον η εργασία έχει εξουσιοδότηση για τον πάροχο και προϋπολογισμό· η κοινή ιδιωτική ρύθμιση του μηχανήματος παρέχει τα διαπιστευτήρια και ένα καρφιτσωμένο μοντέλο. Οι μεταβλητές περιβάλλοντος και το --model μπορούν να παρακάμψουν αυτή τη ρύθμιση. Η εντολή δεν επεξεργάζεται ποτέ μεταφράσεις.
Ο προσαρμογέας σελίδων διατηρεί το context ολόκληρης της σελίδας και περιορίζει κάθε σελίδα στα 24 KB και κάθε εκτέλεση στα 30 ζεύγη. Για μεγαλύτερες σελίδες, προετοιμάστε ρητά ευθυγραμμισμένα ζεύγη παραγράφων πηγής/μετάφρασης για το translations.mjs --pairs· μην αντιστοιχίζετε αυτόματα παραγράφους με βάση τη θέση τους. Τα σημασιολογικά αποτελέσματα είναι συμβουλευτικά: εξετάστε τα ζητήματα και την αβεβαιότητα που αναφέρονται, και διατηρήστε τους ντετερμινιστικούς ελέγχους κώδικα/συνδέσμων/διευθύνσεων.