अनुवाद
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 हेतु स्पष्ट रूप से संरेखित सोर्स/अनुवाद अनुच्छेद-जोड़ियाँ तैयार करें; अनुच्छेदों की जोड़ियाँ इंडेक्स के आधार पर अपने आप न बनाएँ। सिमैंटिक परिणाम केवल सलाह हैं: रिपोर्ट की गई समस्याएँ और अनिश्चितता जाँचें, और कोड/लिंक/पतों की नियतात्मक जाँचें बनाए रखें।