অনুবাদ
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-এর উদ্দেশ্যে স্পষ্টভাবে মেলানো সোর্স/অনুবাদ অনুচ্ছেদ-জোড়া প্রস্তুত করুন; ক্রমিক অবস্থান ধরে স্বয়ংক্রিয়ভাবে অনুচ্ছেদ জোড়া বানাবেন না। অর্থগত ফলাফল কেবল পরামর্শমূলক: জানানো সমস্যা ও অনিশ্চয়তা খতিয়ে দেখুন, এবং ডিটারমিনিস্টিক কোড/লিংক/অ্যাড্রেস চেকগুলো বজায় রাখুন।