मैं अपनी पहली ट्रांसलेशन keys कैसे जोड़ूँ?

ट्रांसलेशन keys आपके कोड और आपके अनुवादों के बीच सेतु हैं। इन्हें जोड़ने के तीन तरीके हैं।

विकल्प A: CLI से कोडबेस स्कैन करें (अनुशंसित)

CLI स्वचालित रूप से आपके कोड में सभी t() कॉल्स ढूँढता है और उन्हें Better i18n से सिंक करता है।

# CLI इंस्टॉल करें
bun add -g @better-i18n/cli

# लॉग इन करें
better-i18n login

# अपना प्रोजेक्ट स्कैन करें
better-i18n scan

स्कैनर इन पैटर्न को पहचानता है:

• t('key.name') — स्टैंडर्ड ट्रांसलेशन कॉल
• t('namespace:key.name') — नेमस्पेस्ड keys
• useTranslations('namespace') — नेमस्पेस डिक्लेरेशन

स्कैन के बाद, खोजी गई keys को डैशबोर्ड पर भेजने के लिए better-i18n sync चलाएँ।

विकल्प B: डैशबोर्ड में मैन्युअल रूप से keys जोड़ें

1. डैशबोर्ड में अपने प्रोजेक्ट पर जाएँ
2. "Key जोड़ें" पर क्लिक करें
3. Key नाम दर्ज करें (जैसे common.save_button)
4. स्रोत भाषा का मान जोड़ें (जैसे "Save")
5. वैकल्पिक रूप से संदर्भ जोड़ें ताकि अनुवादक समझ सकें key कहाँ उपयोग होती है

विकल्प C: MCP के साथ AI कोडिंग एजेंट का उपयोग करें

यदि आप Claude Code, Cursor, या किसी अन्य MCP-compatible एजेंट का उपयोग करते हैं, तो Better i18n MCP सर्वर सीधे keys बना सकता है:

"common.welcome_message ट्रांसलेशन key 'Welcome back!' मान के साथ जोड़ें"

एजेंट इसे आपके प्रोजेक्ट में जोड़ने के लिए createKeys टूल का उपयोग करेगा।

Key नामकरण की सर्वोत्तम प्रथाएँ

पैटर्न	उदाहरण	कब उपयोग करें
namespace.descriptor	common.save	साझा UI तत्व
page.section.element	settings.profile.title	पेज-विशिष्ट सामग्री
feature.action	auth.login_button	फ़ीचर-विशिष्ट

सुझाव:

• पदानुक्रम के लिए डॉट नोटेशन उपयोग करें: settings.profile.title
• संबंधित keys को ग्रुप करने के लिए नेमस्पेस उपयोग करें: common, auth, dashboard
• अस्पष्ट keys में संदर्भ जोड़ें ताकि अनुवादक उद्देश्य समझ सकें
• Keys को वर्णनात्मक लेकिन संक्षिप्त रखें

अपनी keys सत्यापित करें

Keys जोड़ने के बाद, सब कुछ सिंक में है यह सत्यापित करने के लिए better-i18n check चलाएँ:

better-i18n check
# ✓ 42 keys in sync
# ⚠ 3 keys in code but not in dashboard
# ⚠ 1 key in dashboard but not in code

अगले कदम

• AI से अनुवाद करें
• अनुवाद प्रकाशित करें