क्विकस्टार्ट: प्रोजेक्ट और कीज़
इस साइट का हर प्लेग्राउंड एक साझा डेमो प्रोजेक्ट पर चलता है, इसलिए आप बिना अकाउंट के भी इसे आज़मा सकते हैं। अपने ऐप का अनुवाद करने के लिए आपको Langsys डैशबोर्ड से तीन चीज़ें चाहिए: एक प्रोजेक्ट, एक राइट की (write key) और एक रीड-ओनली की। बस दो मिनट, और सिर्फ़ एक बार।
सेटअप
- app.langsys.dev पर साइन इन करें — अगर आपके पास खाता नहीं है तो नया खाता बनाएँ।
- एक प्रोजेक्ट बनाएँ। बेस लोकेल चुनें (वह भाषा जिसमें आपके स्रोत फ़्रेज़ लिखे हैं) और वे टारगेट लोकेल चुनें जिनके अनुवाद आप चाहते हैं। प्रोजेक्ट आईडी कॉपी करें।
- प्रोजेक्ट के लिए दो API की जनरेट करें: एक राइट की और एक रीड-ओनली की। यह बँटवारा ही पूरा सुरक्षा मॉडल है — की और एनवायरनमेंट में बताया गया है कि क्यों।
- इन्हें अपने env में डालें और अपने स्टैक के लिए SDK इंस्टॉल करें। डेवलप करते समय राइट की का उपयोग करें ताकि बनाते समय नए वाक्यांश रजिस्टर हों और मशीन से अनूदित हों; रिलीज़ में रीड-ओनली की दें।
# .env.local — development (Vite-style names; adjust the prefix to your bundler)
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key # discovers + registers new phrases
# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key # only fetches — safe to ship in the browser # .env (Laravel, or your PHP app's environment)
LANGSYS_PROJECT_ID=your-project-id
LANGSYS_API_KEY=write-key # server-side, so the write key can stay —
# switch to read-only anywhere that must not
# register phrases (e.g. a public sandbox) कौन-सी की कहाँ लगेगी? ब्राउज़र को हमेशा सिर्फ़ रीड-ओनली की मिलती है — इससे सिर्फ़ अनुवाद फ़ेच किए जा सकते हैं, और कुछ नहीं, इसलिए इसे पब्लिक बंडल में रखना सुरक्षित है। राइट की नए फ़्रेज़ रजिस्टर करती है, इसलिए यह सिर्फ़ डेवलपमेंट और सर्वर पर ही रहनी चाहिए।
फिर अपना SDK चुनें
हर SDK पेज Install से शुरू होता है और मानकर चलता है कि आपका सेटअप ठीक यही है — आपके env में प्रोजेक्ट आईडी और कुंजी:
फ़्रंटएंड
TypeScript, React, Vue और Svelte, हर एक के साथ लाइव प्लेग्राउंड।
बैकएंड
PHP और Laravel — पेज पहले से ही स्थानीयकृत होकर पहुँचता है।
मेटा-फ़्रेमवर्क
Next.js, Nuxt और SvelteKit — सर्वर पर सीड करें, क्लाइंट पर हाइड्रेट करें।
इनके पीछे के विचार नए लगते हैं? पहले Concepts देखें — वाक्यांश ही कुंजी है, टोकन डिस्कवरी और लोकेल स्टोर — फिर यहाँ लौट आएँ।