मुख्य सामग्रीवर जा

भाषांतरे

about साइट about/public/translations/{lang}/default.json येथील i18next JSON वापरते. Docusaurus ची सोर्स भाषांतरे स्वतंत्रपणे docs/i18n/ मध्ये असतात.

About-साइटच्या की​

.agents/skills/translate/SKILL.md वापरा. सध्याचे लोकेल डिस्कवरून शोधा, आणि प्लेसहोल्डर्स, मार्कअप, तांत्रिक संज्ञा आणि ब्रँड नावे जपा. मोठ्या विनंत्यांसाठी चाइल्ड एजंट स्वतंत्र मॅप्स तयार करू शकतात, पण प्रत्येक लोकेलमधील लेखन एकच पॅरेंट एकामागोमाग एक लागू करतो; अपडेटरमध्ये रायटर लॉक नाही.

टास्कच्या मालकीचा, अद्वितीय मॅप पथ वापरा. node scripts/update-translations.js --key <key> --map <map.json> --include-en --dry ने प्रीव्ह्यू पाहा, आणि मग तेच आर्ग्युमेंट्स आणि --write वापरून लागू करा. लिहिल्यानंतर कव्हरेज/मूल्ये पडताळा, आणि फक्त या टास्कच्या मालकीचे तात्पुरते मॅप्सच काढून टाका.

विनंती केलेल्या काढण्यांसाठी --delete वापरा. अधिकृत --audit --write चालवण्यापूर्वी --audit --dry चे निष्कर्ष तपासा; डायनॅमिक भाषांतर कींसाठी सोर्सचा हाताने आढावा घ्यावा लागतो. इंग्रजी मजकूर प्रत्येक लोकेलमध्ये फक्त तांत्रिक संज्ञा, ब्रँड किंवा प्लेसहोल्डरसाठीच कॉपी करा.

Docusaurus पाने​

scripts/translate-docs.py हा सर्व पाने/लोकेलसाठीचा बल्क रायटर आहे आणि त्यात प्रति-फाइल फिल्टर नाही; भाषांतरातील छोट्या संपादनासाठी तो वापरू नका. scripts/check-docs-translations.py हा फक्त-वाचन व्हेरिफायर आहे आणि तो --locales आणि --paths यांना पाठिंबा देतो.

कोड फेन्सेस, लिंक, इनलाइन कोड, कॉन्ट्रॅक्ट पत्ते, हेडिंग्ज, तक्ते आणि ॲडमोनिशन्स इंग्रजी सोर्सशी जुळलेले ठेवा. व्हेरिफायरच्या एरर सोडवा; ब्रँड-नावांसाठीच्या frontmatter-untranslated चेतावण्या अपेक्षित असू शकतात. डॉक्स थीम किंवा i18n वर्तन बदलताना docs/AGENTS.md पाळा आणि रूटमधूनच बिल्ड करा, जेणेकरून स्टॅटिक आउटपुट आणि Pagefind जुळलेले राहतील.

पर्यायी अर्थविषयक आढावा​

निवडक i18next कींसाठी scripts/jev/translation-README.md वापरा. दस्तऐवज पानांसाठी आधी node scripts/jev/docs-translations.mjs --locales it,de --paths browser-p2p.md चालवा. यासाठी लोकेल/पानांची स्पष्ट निवड आवश्यक असते; ही कमांड स्ट्रक्चरल व्हेरिफायर चालवते, आणि लाइव्ह इन्फरन्स सक्षम होईपर्यंत अर्थविषयक आढावा पडताळलेला नाही असे नोंदवते. टास्कसाठी प्रदात्याची अधिकृतता आणि बजेट असेल तेव्हाच --live जोडा; सामायिक खाजगी मशीन कॉन्फिगरेशन क्रेडेन्शियल्स आणि पिन केलेले मॉडेल पुरवते. एन्व्हायर्नमेंट व्हेरिएबल्स आणि --model ही रचना ओव्हरराइड करू शकतात. ही कमांड भाषांतरे कधीही संपादित करत नाही.

पान ॲडॉप्टर संपूर्ण पानाचा संदर्भ जपतो, आणि प्रत्येक पानाला 24 KB ची व प्रत्येक रनला 30 जोड्यांची मर्यादा घालतो. मोठ्या पानांसाठी translations.mjs --pairs करिता स्पष्टपणे जुळवलेल्या सोर्स/भाषांतर परिच्छेद-जोड्या तयार करा; अनुक्रमांकानुसार परिच्छेद आपोआप जोडू नका. अर्थविषयक निकाल केवळ सल्लागार स्वरूपाचे आहेत: नोंदवलेल्या समस्या आणि अनिश्चितता तपासा, आणि निश्चित कोड/लिंक/पत्ता तपासण्या कायम ठेवा.