अनुप्रयोग स्थानीयकरण Node.js. भाग 2: उपकरण और प्रक्रिया

एक अनुवादक से: यह मोज़िला आइडेंटिटी टीम से Node.js श्रृंखला में दसवां लेख है, जो पर्सोना प्रोजेक्ट में शामिल है।

---

Node.js अनुप्रयोगों को स्थानीय बनाने के पिछले लेख में, हमने सीखा कि हमारे कोड में i18n-abide मॉड्यूल का उपयोग कैसे करें। प्रोग्रामर के रूप में हमारा काम वास्तव में इस तथ्य पर समाप्त हो गया कि हमने gettext() कॉल में टेम्प्लेट और एप्लिकेशन कोड में लाइनों को लपेट दिया है। लेकिन स्थानीयकरण और आवेदन का अनुवाद करने का काम अभी शुरू हो रहा है।

उपकरण

मोज़िला पर्सोना टीम का स्थानीयकरण टूलकिट, मोज़िला समुदाय के बाकी हिस्सों द्वारा उपयोग किए गए उपकरणों के साथ संगत है, जबकि नोड की मित्रता और लचीलेपन को बरकरार रखता है।

मोज़िला परियोजना लगभग 15 साल पुरानी है, और स्थानीय लोगों और अनुवादकों की हमारी टीम ओपन सोर्स की दुनिया में सबसे बड़ी (और शांत) में से एक है। इसलिए, हमने लंबे समय से परिचित के लिए व्यापक रूप से उपयोग किया है, एक भी पुराने और फैंसी उपकरण कह सकता है।

gettext

जीएनयू गेटटेक्स्ट एक टूलकिट है जिसे डेस्कटॉप और वेब एप्लिकेशन को स्थानीय बनाने के लिए डिज़ाइन किया गया है। जब आप नोड के लिए कोड और टेम्पलेट लिखते हैं, तो आप हर जगह अंग्रेजी वाक्यांशों का उपयोग करते हैं, लेकिन उनमें से प्रत्येक को gettext() कॉल में लपेटते हैं।

गेटटेक्स्ट दो काम करता है:

• असेंबली के दौरान, एप्लिकेशन में मौजूद सभी लाइनों की निर्देशिका संकलित करता है;
• रन टाइम में उन्हें स्थानीय विकल्पों के साथ बदल देता है।

सभी निकाले गए लाइनों को एक्सटेंशन .po साथ पाठ फ़ाइलों में संग्रहीत किया जाता है भविष्य में, हम उन्हें पीओ-फाइलें कहेंगे।

पो फाइलें

पीओ फाइलें एक निश्चित प्रारूप की पाठ फाइलें होती हैं जो गेटटेक्स्ट पढ़, लिख और जोड़ सकते हैं।

यहाँ zhTW / LCMESSAGES / messages.po po फ़ाइल की सामग्री का एक उदाहरण दिया गया है:

 #: resources/views/about.ejs:46 msgid "Persona preserves your privacy" msgstr "Persona 保護您的隱私" 

हम इसे बाद में और अधिक विस्तार से विचार करेंगे, लेकिन अब हमारे लिए यह समझना जरूरी है कि अंग्रेजी स्ट्रिंग है। और इसका चीनी में अनुवाद है। # साथ शुरू होने वाला सब कुछ एक टिप्पणी है। इस उदाहरण में टिप्पणी कोड में इस रेखा के स्थान को इंगित करती है।

गेटटेक्स्ट तार और पीओ-फाइलों के साथ काम करने के लिए कई अन्य उपकरण प्रदान करता है। हम उन्हें भी छूते हैं।

वास्तव में यह टूलकिट क्यों?

इससे पहले कि हम गेटेक्स के साथ काम करने के लिए Node.js मॉड्यूल के अधिक विस्तृत अध्ययन में गोता लगाएँ, हमें खुद से यह पूछने की ज़रूरत है कि हमने इस विशेष उपकरण के सेट को क्यों चुना?

एक साल पहले, मैंने अंतर्राष्ट्रीयकरण और स्थानीयकरण के लिए मौजूदा Node.js मॉड्यूल की विस्तार से जांच की। उनमें से अधिकांश ने तार संचय के लिए अपनी बाइक और JSON- आधारित प्रारूपों का आविष्कार किया।

दूसरी ओर, मोज़िला के पास POEdit , Verbatim , Translate Toolkit, और Pootle जैसे लंबे और सफलतापूर्वक उपयोग किए जाने वाले उपकरण हैं। लोगों को राहत देने के लिए मजबूर करने के बजाय, हमने उनके लिए ऐसे उपकरण विकसित करने का फैसला किया जो परिचित मानकों और प्रक्रियाओं के अनुकूल हों।

Po-files हमारे अनुवादकों के आदान-प्रदान और सहयोग के लिए एक सामान्य प्रारूप है। यह इस प्रारूप में है कि वे अनुवाद के लिए हमसे लाइनें प्राप्त करें, और हमें तैयार पाठ दें।

PHP और Python में Mozilla में विकास का बहुत अनुभव होने के बाद, मुझे गेटटेक्स्ट बहुत सुविधाजनक लगता है। जैसे-जैसे वेब एप्लिकेशन बढ़ता है और अधिक पाठ होता है, अधिक से अधिक बारीकियां दिखाई देती हैं, जिन्हें अच्छी तरह से परीक्षण किए गए टूल और गेटटेक्स्ट एपीआई के उपयोग की आवश्यकता होती है।

हम अनुवादकों के लिए पीओ-फाइल बनाते हैं

इसलिए, हमने अपने कोड को गेटेक्स्ट कॉल के साथ चिह्नित किया। आगे क्या है? जिसे हम "स्ट्रिंग ड्राइवर" कहते हैं वह हरकत में आता है। यह आप स्वयं, अनुवादक या प्रशासक हो सकते हैं। स्ट्रिंग ड्राइवर क्या करता है?

• उन लाइनों को पुनः प्राप्त करता है जो पहली बार आवेदन में दिखाई दी थीं।
• बाद की रिलीज़ में हटाए गए नए, परिवर्तित लाइनों या चिह्नों को ढूंढता है।
• अनुवादकों की प्रत्येक टीम के लिए पो-फाइल्स तैयार करता है।
• हल किए गए या हटाए गए अनुवाद स्ट्रिंग्स का विरोध करता है।

यह थोड़ा भ्रामक लग सकता है, लेकिन, सौभाग्य से, इनमें से अधिकांश कार्य अच्छी तरह से स्वचालित हैं। समस्या आने पर लाइनमैन को ही हस्तक्षेप करना पड़ता है।

msginit, xgettext, msgfmt और अन्य GNU गेटटेक्स्ट टूल लाइन निर्देशिकाओं के साथ काम करने के लिए एक शक्तिशाली सेट हैं। इन उपकरणों के साथ, केवल स्ट्रिंग कोड काम करता है। अधिकांश डेवलपर्स उनसे अनजान बने रह सकते हैं।

स्थान के लिए फ़ाइल ट्री बनाना:

 $ mkdir -p locale/templates/LC_MESSAGES 

यह निर्देशिका पो-फाइल टेम्पलेट्स को स्टोर करती है - .pot फाइलें। भविष्य में गेटटेक्स्ट द्वारा इनका उपयोग किया जाएगा।

पंक्तियाँ लाना

पिछले लेख में, हमने i18n-abide स्थापित किया था:

 $ npm install i18n-abide 

अन्य कमांड लाइन टूल में, एबाइड एक्सट्रैक्ट-पॉट प्रदान करता है। इस कमांड का उपयोग लोकल डायरेक्टरी में स्ट्रिंग्स को पुनः प्राप्त करने के लिए किया जाता है:

 mkdir -p locale/templates/LC_MESSAGES $ ./node_modules/.bin/extract-pot --locale locale 

स्क्रिप्ट एप्लिकेशन के पूरे स्रोत कोड के माध्यम से जाएगी, लाइनों को ढूंढें और उन्हें कवि टेम्पलेट फ़ाइल में लिखें।

पॉट-फाइल बनाने के लिए आप पारंपरिक गेटटेक्स्ट उपयोगिताओं का उपयोग कर सकते हैं, लेकिन हमने एक विशेष jsxgettext मॉड्यूल, सुविधाजनक और क्रॉस-प्लेटफ़ॉर्म लिखा है। हुड के तहत, अर्क-पॉट इसका उपयोग करता है।

Jsxgettext कोड में गेटटेक्स्ट gettext() कॉल को देखता है और उनसे एक स्ट्रिंग तर्क निकालता है, फिर यह गेटटेक्स्ट टूलकिट के साथ संगत प्रारूप में स्ट्रिंग्स को प्रारूपित करता है। ऐसी पॉट फ़ाइल का एक अंश यहां दिया गया है:

 #: resources/views/about.ejs:46 msgid "Persona preserves your privacy" msgstr "" #: resources/views/about.ejs:47 msgid "" "Persona does not track your activity around the Web. It creates a wall " "between signing you in and what you do once you're there. The history of " "what sites you visit is stored only on your own computer." msgstr "" "" #: resources/views/about.ejs:51 msgid "Persona for developers" msgstr "" 

बाद में, इस टेम्पलेट के आधार पर अनुवाद वाली पो-फाइल्स बनाई जाएंगी। वे इस तरह दिखेंगे:

 #: resources/views/about.ejs:46 msgid "Persona preserves your privacy" msgstr "Persona 保護您的隱私" #: resources/views/about.ejs:47 msgid "" "Persona does not track your activity around the Web. It creates a wall " "between signing you in and what you do once you're there. The history of " "what sites you visit is stored only on your own computer." msgstr "" "Persona 只是連結您登入過程的一座橋樑，不會追蹤您在網路上的行為。您的網頁瀏覽" "紀錄只會留在您自己的電腦當中。" #: resources/views/about.ejs:51 msgid "Persona for developers" msgstr "Persona 的開發人員資訊" 

विषय के लिए बेहतर महसूस करने के लिए, आप चीनी के लिए पो-फाइल के पूर्ण संस्करण पर एक नज़र डाल सकते हैं।

लोक निर्माण

गेटटेक्स्ट सेट से msginit कमांड का उपयोग टेम्पलेट फ़ाइल के आधार पर एक विशिष्ट लोकेल के लिए एक पो फ़ाइल बनाने के लिए किया जाता है:

 $ for l in en_US de es; do mkdir -p locale/${l}/LC_MESSAGES/ msginit --input=./locale/templates/LC_MESSAGES/messages.pot \ --output-file=./locale/${l}/LC_MESSAGES/messages.po \ -l ${l} done 

हमने सिर्फ अमेरिकी अंग्रेजी, जर्मन और स्पेनिश के लिए पीओ-फाइलें बनाईं।

पो फाइलें

इसलिए, हमने लाइनें निकालीं और स्थानीय फ़ोल्डर बनाए। यह हमारी फ़ाइल ट्री जैसा दिखता है:

 locale/ el/ LC_MESSAGES/ messages.po en_US LC_MESSAGES/ messages.po es LC_MESSAGES/ messages.po templates LC_MESSAGES/ messages.pot 

आपके एप्लिकेशन के इन हिस्सों को अनुवादकों तक पहुंच दी जा सकती है। उदाहरण के लिए, स्पैनिश टीम के पास locale/es/LC_MESSAGES/messages.po तक पहुंच होगी। यदि आपके पास बहुत बड़ी परियोजना है, तो स्पैनिश और स्पैनिश भाषा के स्पैनिश संस्करण के लिए दो अलग-अलग स्थान भी हो सकते हैं: es-ES और es-AR।

समय के साथ, नए स्थान जोड़े जा सकते हैं।

मर्ज पंक्ति में परिवर्तन

रिलीज़ द्वारा रिलीज़ आप नए जोड़ेंगे, पुरानी लाइनों को बदलेंगे और हटाएंगे। आपको इन परिवर्तनों के अनुसार सभी पीओ-फाइलों को अपडेट करना होगा। गेटटेक्स्ट के पास इसके लिए शक्तिशाली उपकरण हैं। खुद के लिए, हमने एक मर्ज-po.sh स्क्रिप्ट रैपर बनाया जो GNU गेटटेक्स्ट पैकेज से msgmerge कमांड का उपयोग करता है।

सिस्टम पथों में i18n-abide टूल जोड़ें:

 $ export PATH=$PATH:node_modules/i18n-abide/bin 

और लाइन विलय प्रक्रिया शुरू करें:

 $ ./node_modules/.bin/extract-pot --locale locale . $ merge_po.sh ./locale 

पहली बार की तरह, एक्सट-पॉट सभी लाइनों को इकट्ठा करता है और एक टेम्पलेट बनाता है। फिर सभी पो-फाइल्स को मर्ज करें। एप्लिकेशन के वर्तमान संस्करण के अनुरूप लाएं। उसके बाद, अनुवाद टीम फिर से काम कर सकती है।

गेटटेक्स्ट बनाम इन्वेंटेड नॉट हियर सिंड्रोम

गेटटेक्स्ट के बजाय अपनी खुद की JSON- आधारित बाइक का आविष्कार करना कोई बड़ी बात नहीं है। नोड मॉड्यूल के अधिकांश लेखकों ने इस पथ को चुना है। लेकिन जैसे-जैसे एप्लिकेशन बढ़ते हैं और नई भाषाएँ जोड़ी जाती हैं, छोटी-छोटी परेशानियाँ स्नोबॉल की तरह बढ़ती जाएँगी। उदाहरण के लिए, मर्ज किए बिना- p.sh, जितनी जल्दी या बाद में आपको अपने मर्ज टूल को लिखना और डीबग करना होगा। 30 स्थानों के लिए 30 फ़ाइलों को मैन्युअल रूप से अपडेट करें, बिना कुछ खोए या भ्रमित किए - जो अभी भी एक गड़बड़ है।

और गेटटेक्स्ट में पहले से ही आपकी जरूरत की हर चीज मौजूद है और यह हमें बहुत समय और नसों को बचाता है।

निष्कर्ष

अब जब हमने आखिरकार यह पता लगा लिया है कि पो-फाइल्स को कैसे बनाया और अपडेट किया जाए, हम उन्हें अनुवादकों की देखभाल के लिए सौंप सकते हैं। सामान्य तौर पर, अग्रिम में उनसे बात करना और चर्चा करना बेहतर होता है कि स्थानांतरण कब शुरू करना संभव होगा, क्या मात्रा अपेक्षित है और कब समाप्त करना वांछनीय है। गेटेक्स्ट डॉक्यूमेंटेशन का अध्ययन करना भी उपयोगी होगा।

तो, लाइनों का अनुवाद किया जाता है, और अगले लेख में हम जानेंगे कि आवेदन निष्पादन के दौरान स्थानीयकरण कैसे काम करता है।

---