अपने प्रोजेक्ट में i18n जोड़ें
यह सेक्शन उन प्रोजेक्ट के लिए वॉकथ्रू का एक सेट है जो आज एक ही भाषा में हैं. यहाँ से शुरू करें. नीचे दिया गया हर पेज, एक तरह के प्रोजेक्ट को सेटअप से लेकर पहली अनुवादित फ़ाइलों तक ले जाता है. शुरू करें में यह बताया गया है कि टूल क्या है, इसे इंस्टॉल करने के क्या विकल्प हैं, और प्रोवाइडर और मॉडल क्या हैं. आप उन पेजों को पहले पढ़े बिना भी कोई वॉकथ्रू खोल सकते हैं.
आप क्या करते हैं और टूल क्या करता है
| आप | टूल |
|---|---|
| आज़माने के लिए भाषाएँ, एक प्रोवाइडर और मॉडल चुनें | टेक्स्ट निकालता है, उसका अनुवाद करता है, नतीजे की जाँच करता है और कैटलॉग या पेज लिखता है |
टेक्स्ट को दृश्यमान बनाएं: ऐप कोड में t(), आपकी साइट फ्रेमवर्क का i18n, या README में एक भाषा-सूची मार्कर | हर अनुवाद को कैश करता है और अगली बार चलाने पर उसका पुन: उपयोग करता है |
| फ़ाइलें लोड करें और एक भाषा की जाँच करें | प्रगति दिखाता है, और आपको अनुवाद डैशबोर्ड में शब्दों की समीक्षा करने देता है |
वॉकथ्रू बताते हैं कि कौन से स्रोत संपादन आपके हैं। कोडिंग-एजेंट प्रॉम्प्ट शामिल किए गए हैं जहाँ वे संपादन यांत्रिक हैं। CLI कैटलॉग और अनुवादित फ़ाइलें लिखता है। यह i18next या आपकी साइट फ्रेमवर्क का i18n स्थापित नहीं करता है।
साझा सेटअप
हर वॉकथ्रू एक ही क्रम का पालन करता है। आप जो पृष्ठ चुनते हैं वह विवरण भरता है।
- CLI स्थापित करें और अपने प्रदाता की API कुंजी सेट करें। Ollama को किसी कुंजी की आवश्यकता नहीं है। स्थापना और प्रदाता और API कुंजी।
- उस पृष्ठ के नाम वाले टेम्पलेट के साथ
initचलाएँ। यहai-i18n-tools.config.jsonलिखता है। - प्रोजेक्ट को तैयार करें ताकि टूल टेक्स्ट देख सके।
ai-i18n-tools syncचलाएँ, फिरai-i18n-tools status।- आउटपुट लोड करें, एक लक्ष्य भाषा की जाँच करें, और जब स्रोत बदलता है तो
syncको फिर से चलाएँ। कैश केवल नया या बदला हुआ टेक्स्ट मॉडल को भेजता है।
इस अनुभाग में पृष्ठ
| आपके पास है | पृष्ठ | वह पृष्ठ क्या कवर करता है |
|---|---|---|
| एक JS/TS ऐप (React, Next.js, Node, CLI) जिसके बटन और संदेश अभी भी सादे टेक्स्ट में हैं | एक JS/TS ऐप में i18n जोड़ें | i18next स्थापित करें, बूटस्ट्रैप जोड़ें, t() में लिटरल को रैप करें, फिर extract और translate-ui |
| एक Python ऐप (Streamlit, FastAPI, Flask, Django, gettext) | एक Python ऐप में i18n जोड़ें | t() या _() को रैप करें, या GNU gettext रखें। CLI बिना Node.js इंस्टॉलेशन के एक स्टैंडअलोन निष्पादन योग्य से चल सकता है |
| एक दस्तावेज़ीकरण या मार्केटिंग साइट (VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro, plain HTML) | एक वेबसाइट या डॉक्स साइट में i18n जोड़ें | फ्रेमवर्क के अपने भाषा मार्गों को सक्षम करें, फिर पृष्ठों और थीम लेबल का अनुवाद करें |
| एक रिपॉजिटरी README और अन्य Markdown फ़ाइलें, आमतौर पर एक ऐप के बगल में | अपने README और Markdown डॉक्स में i18n जोड़ें | प्रति भाषा एक फ़ाइल (translated-docs/README.de.md) और README में एक भाषा पंक्ति। init --with-readme उस ब्लॉक को किसी भी टेम्पलेट में जोड़ता है |
| एक रिपॉजिटरी में उपरोक्त में से एक से अधिक | पाइपलाइन को संयोजित करना | एक कॉन्फ़िग और एक sync। सामान्य जोड़ी ऐप UI स्ट्रिंग और README है |
| Intlayer डिक्शनरी, और आप Intlayer को रखना चाहते हैं | Intlayer को यथास्थान अनुवाद करना | translate-intlayer *.content.ts के अंदर गुम और बासी पत्तियों को भरता है |
| Intlayer डिक्शनरी, और आप Intlayer से हट रहे हैं | Intlayer से माइग्रेट करना | migrate-intlayer डिक्शनरी से कैटलॉग को सीड करता है और सुरक्षित कॉल साइटों को t() में फिर से लिखता है |
एक ऐप जिसमें एक README भी है, ऐप पेज और README पेज का एक साथ उपयोग करता है। एक साइट जिसमें एक README भी है, वेबसाइट पेज का उपयोग करती है, और README ब्लॉक के लिए init … --with-readme का उपयोग करती है।
और गहराई में कहाँ जाएँ
वॉकथ्रू तब समाप्त होते हैं जब पहली भाषा स्थापित हो जाती है। संदर्भ पृष्ठ वहाँ से कार्यभार संभालते हैं:
- एक बार में एक पाइपलाइन के लिए UI स्ट्रिंग्स, दस्तावेज़, JSON, और SVG।
- फ़्रेमवर्क शेल स्ट्रिंग्स (नेविगेशन, साइडबार, थीम) के लिए इंटीग्रेशन।
- कमांड सूची और अनुशंसित
package.jsonस्क्रिप्ट के लिए क्विक स्टार्ट। - प्रीसेट और API कीज़ के लिए LLM प्रोवाइडर।
- रैंक की गई शॉर्टलिस्ट और फ़ॉलबैक चेन के लिए AI मॉडल।