AI से अनुवादित Angular की आधिकारिक डॉक्यूमेंटेशन
(angular-kr-docs.web.app)नमस्ते! हाल ही में Angular प्रोजेक्ट में शामिल होने के बाद मुझे कोरियाई सामग्री की कमी के कारण काफी कठिनाई हुई।
इसीलिए मैंने एक open source AI translation project का उपयोग करके Angular की आधिकारिक डॉक्यूमेंटेशन को सिर्फ 5 घंटे में कोरियाई में अनुवाद करके डिप्लॉय भी कर दिया।
फिलहाल ज़्यादातर हिस्सों में AI से केवल शुरुआती ड्राफ्ट अनुवाद ही किया गया है!
अनुवाद की प्रगति
- लगभग 300 md फ़ाइलों का अनुवाद पूरा
- HTML फ़ाइलों आदि जैसे वे फ़ाइलें, जिनका अपने-आप अनुवाद नहीं हुआ, उनका अतिरिक्त अनुवाद जारी है
- कोड उदाहरणों के साथ मुख्य कॉन्सेप्ट्स को कोरियाई में समझा जा सकता है
- अंग्रेज़ी मूल पाठ जैसी ही संरचना होने से ज़रूरी सामग्री आसानी से खोजी जा सकती है
असल में, अनुवादित Angular डॉक्यूमेंटेशन का परिचय देने के लिए Show GN कैटेगरी का उपयोग करूँ या translation tool को परिचित कराने के लिए News कैटेगरी का, इस पर मैंने काफी सोचा।
हो सकता है Angular इस्तेमाल करने वाले बहुत ज़्यादा न हों, लेकिन शायद जिन लोगों को कोरियाई सामग्री चाहिए, उनके लिए यह मददगार हो सके—इसी सोच से मैंने Show GN चुना!
इस्तेमाल किए गए टूल
मुझे "ai-markdown-translator" नाम का एक छोटा प्रोजेक्ट मिला, और इसका परिणाम मेरी उम्मीद से बेहतर निकला।
यह मुझे काफी पसंद आया, इसलिए प्रोजेक्ट में योगदान देने के लिए मैंने repository fork की है और कोड में बदलाव भी कर रहा हूँ।
फ़ायदे
- Markdown डॉक्यूमेंट्स के अनुवाद के लिए विशेष रूप से बना open source project
- फ़ोल्डर के भीतर किसी खास extension वाली फ़ाइलों का recursively अनुवाद कर सकता है
npx ai-markdown-translator -i . -e md -l "Korean" --logकमांड का उपयोग करके एक बार में अनुवाद- व्याकरणिक संरचना और Markdown फ़ॉर्मैट को ज़्यादातर सुरक्षित रखते हुए अनुवाद
- MD content के आधार पर page बनाने वाली technical documentation के लिए उपयुक्त टूल
सीमाएँ
- कुछ technical terms का शाब्दिक अनुवाद, जैसे Signal को 'signal' की जगह दूसरे अर्थ में बदल देना, थोड़ा खटकता है
- कुछ फ़ाइल reference paths के गलत तरीके से बदल जाने की समस्या मिली
- कुछ हिस्से अभी शुरुआती ड्राफ्ट अनुवाद स्तर पर हैं, इसलिए और सुधार की ज़रूरत है
अनुवाद और डिप्लॉयमेंट प्रक्रिया
- Angular की आधिकारिक डॉक्यूमेंटेशन repository को clone किया
- कमांड चलाने के 2 घंटे बाद लगभग 300 फ़ाइलों का अनुवाद पूरा
- गलत फ़ाइल reference paths को ठीक किया
- मौजूदा Angular प्रोजेक्ट की Firebase settings का संदर्भ लेकर डिप्लॉय किया
अभी भी बहुत-सी चीज़ें हैं जिन्हें और तराशने, जाँचने और सुधारने की ज़रूरत है, लेकिन लगाए गए समय के मुकाबले नतीजा काफी अच्छा लगा।
जो लोग MD फ़ॉर्मैट में लिखी technical documentation का अनुवाद करना चाहते हैं, उन्हें मैं इसे टेस्ट करने की सलाह दूँगा!!
इतना लंबा लेख पढ़ने के लिए धन्यवाद! आपका दिन शुभ हो!! ❤️🔥
4 टिप्पणियां
वाह! Angular!
...! क्या आप Angular इस्तेमाल करते हैं?
आजकल लगता है कि कोरिया में इसके यूज़र लगभग नहीं के बराबर हैं, इसलिए आपका कमेंट देखकर बहुत अच्छा लगा! haha
मुझे React नहीं आता, और Angular ही बस थोड़ा-बहुत आता है, लेकिन कोरियाई कम्युनिटी में Angular पर लिखा हुआ देखकर खुशी हुई।
मैंने अब तक सिर्फ React इस्तेमाल किया था और फिर Angular पर आ गया, लेकिन यहाँ तो उल्टा है haha
कभी मौका मिला तो मैं फिर से Angular पर एक लेख लिखूँगा,,,haha