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

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

स्थानीयकरण के लिए तैयार होने का क्या मतलब है?

इसका मतलब है कि अनुवादक या अनुवाद टूल को आपकी कॉपी सौंपी जाए, तो वह अंदाज़ा लगाए बिना सटीक अनुवाद तैयार कर सके। इसके लिए तीन शर्तें ज़रूरी हैं: हर स्ट्रिंग ठीक एक तय जगह पर मौजूद हो, हर स्ट्रिंग एक ही बात साफ़ तौर पर कहे, और अनुवाद करने वाला जान सके कि स्ट्रिंग का इस्तेमाल कहाँ और कैसे होता है।

इन तीनों को बाद में ठीक करना बराबर आसान नहीं है। साफ़ शब्द-चयन एक-एक स्ट्रिंग करके सुधारा जा सकता है। संदर्भ नोट्स के रूप में जोड़ा जा सकता है। लेकिन "ठीक एक तय जगह" एक संरचनात्मक बात है। अगर यह न हो, तो बाकी दोनों के पास टिकने के लिए कोई स्थिर आधार नहीं बचता: आप ऐसी स्ट्रिंग को नहीं सुधार सकते जिसकी जुड़वाँ किसी दूसरी फ़ाइल में बैठी हो, और ऐसे संदेश पर नोट नहीं जोड़ सकते जिसका कोई एक पता ही न हो।

स्रोत अनुवाद की गुणवत्ता की सीमा क्यों तय करता है?

क्योंकि अनुवाद एक व्युत्पन्न काम है, और व्युत्पन्न काम अपने मूल की हर खामी विरासत में लेता है। अनुवाद स्रोत की अस्पष्टता को हर लक्ष्य भाषा में ले जाता है, और असंगति को भी। अगर स्रोत एक स्क्रीन पर "Sign in", दूसरी पर "Log in" और तीसरी पर "Login" कहता है, तो अब हर भाषा में तीन शब्द हैं, जिनका अनुवाद अलग-अलग हुआ है, और यह बताने का कोई तरीका नहीं कि इनमें से कौन-सा सही है।

इसीलिए आम इलाज, यानी अनुवादों को चमकाना, गलत सिरे को पकड़ता है। आप जो भी नई भाषा जोड़ते हैं, वह बिना सुधरे स्रोत की कीमत को और बढ़ा देती है। स्रोत को एक बार ठीक करने से वह हर जगह ठीक हो जाता है, उन भाषाओं में भी जो आपने अभी जोड़ी ही नहीं हैं।

इस बुनियादी विफलता का एक नाम है। कॉपी ड्रिफ़्ट (copy drift) वह स्थिति है जिसमें यूज़र को दिखने वाला टेक्स्ट अलग-अलग सतहों पर और समय के साथ अपने मंज़ूर किए गए स्रोत से भटक जाता है, क्योंकि कोई एक सिंगल सोर्स ऑफ़ ट्रुथ नहीं होता। इसके कारणों की जानकारी कॉपी ड्रिफ़्ट क्या है में है। स्थानीयकरण में यह महँगा पड़ता है, क्योंकि यह ड्रिफ़्ट हर भाषा में कॉपी हो जाता है।

बिखरी हुई कॉपी को स्थानीयकरण के लिए तैयार क्यों नहीं किया जा सकता?

क्योंकि सौंपने के लिए कुछ है ही नहीं। कॉम्पोनेंट के अंदर का लिटरल ऐसी इकाई नहीं है जिसे अनुवाद चरण उठा सके। वह मार्कअप और लॉजिक के साथ घुला-मिला होता है, उसे टुकड़ों से जोड़कर बनाया गया हो सकता है, और वही वाक्य कई फ़ाइलों में छोटे-छोटे अंतरों के साथ मौजूद हो सकता है, जो अंतर किसी ने चुने ही नहीं थे।

इन लिटरल को जहाँ-के-तहाँ दोबारा लिखने से यह स्थिति नहीं बदलती। आप हर एक को ज़्यादा स्पष्ट बना सकते हैं, फिर भी आपके पास कोई कैटलॉग नहीं होगा, यह बताने वाली कोई तय सूची नहीं होगी कि प्रोडक्ट क्या-क्या कहता है, और यह जानने का कोई तरीका नहीं होगा कि आपने सब ढूँढ लिए या नहीं। नतीजा वही बिखरी जगहें होंगी, बस टेक्स्ट थोड़ा सुघड़ होगा।

इसलिए पहला चरण संपादन का काम नहीं है। यह इकट्ठा करने का काम है: यूज़र को दिखने वाली हर स्ट्रिंग को एक कैटलॉग में लाएँ, एक स्रोत-भाषा में, रिपॉज़िटरी के अंदर, और कॉम्पोनेंट्स से उसे key के ज़रिए रेफ़र करें। यह काम शब्द-चयन बदले बिना करें। इस पास का मकसद यह तय करना है कि प्रोडक्ट अभी क्या कहता है, उन हिस्सों समेत जो एक-दूसरे का खंडन करते हैं।

स्ट्रिंग्स कैसे इकट्ठा करें?

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

व्यावहारिक रूप से:

  • रिपॉज़िटरी में हर स्रोत-भाषा के लिए एक कैटलॉग चुनें। यानी कॉपी का ऐसा रिकॉर्ड जिसे लोग और टूल दोनों पढ़ सकें। इसे कैसे सजाएँ और key के नाम कैसे रखें, यह कोडबेस में UI कॉपी को एकरूप कैसे रखें में बताया गया है; यह वही कैटलॉग है, इसलिए लेआउट के लिए वही पेज संदर्भ है और यहाँ उसे दोहराया नहीं गया है।
  • लिटरल की जगह key रेफ़रेंस लगाएँ। हर वह स्ट्रिंग जो यूज़र पढ़ सकता है, जिसमें बटन लेबल, एरर मैसेज, एम्प्टी स्टेट, टूलटिप और एक्सेसिबिलिटी टेक्स्ट भी शामिल हैं, जो आम तौर पर छूट जाते हैं।
  • वाक्य पूरे रखें। अगर कोई संदेश टुकड़ों को जोड़कर बनता है, तो उसे वेरिएबल के साथ एक ही एंट्री बना दें, ताकि अनुवादक जो इकाई देखे वही इकाई यूज़र पढ़े। भाषाओं में शब्दों का क्रम अलग होता है, और कोड में जोड़कर बनाया गया वाक्य उसका पालन नहीं कर सकता।
  • अभी शब्द न बदलें। इस इच्छा को रोकें। आपको अटपटी स्ट्रिंग्स मिलेंगी, उन्हें नोट कर लें और आगे बढ़ें।

अगर यह सूची किसी बड़े कोडबेस में एक महीने के सावधान काम जैसी लगती है, तो यही इस चरण की ईमानदार कीमत है, और यही वजह है कि ज़्यादातर टीमें यहीं अटक जाती हैं।

स्ट्रिंग्स एक कैटलॉग में आ जाएँ, तो आगे क्या करें?

अब जानी-पहचानी सलाहों के पास आख़िरकार अमल करने के लिए कुछ है। एक कैटलॉग होने पर इनमें से हर काम खोज-बीन की जगह एक ही पास बन जाता है:

  1. डुप्लिकेट और लगभग-डुप्लिकेट हटाएँ। हर संदेश के लिए मंज़ूर शब्द-चयन चुनें और हर इस्तेमाल को उसी की ओर इंगित करें।
  2. जो शब्द कभी नहीं बदलने चाहिए, उन्हें तय करें। फ़ीचर के नाम, मुख्य कार्यों के लिए क्रियाएँ, और वे शब्द जिन्हें आपने न इस्तेमाल करने का फ़ैसला किया है। इन्हें एक बार लिख दें। यही आपकी शब्दावली (glossary) है, और यह छोटी होती है।
  3. सरल भाषा में लिखें। कर्ता-वाच्य (active voice), कोई मुहावरा नहीं, ऐसा कोई मज़ाक नहीं जो किसी एक भाषा के शब्द-खेल पर टिका हो, और जहाँ ग़लत समझे जाने का डर हो वहाँ संक्षिप्त रूप पूरे लिखे हुए। हर स्ट्रिंग एक ही बात कहे।
  4. अनुवादकों को संदर्भ दें। एक नोट कि स्ट्रिंग कहाँ दिखती है और वेरिएबल किसका प्रतीक है। "Post" या "Order" जैसी छोटी स्ट्रिंग्स क्लासिक जाल हैं: संज्ञा या क्रिया, और लक्ष्य भाषा को दोनों के लिए अलग शब्द चाहिए हो सकता है।
  5. लंबाई की गुंजाइश रखें। अनुवादित टेक्स्ट अक्सर स्रोत से लंबा होता है, इसलिए ऐसे लेआउट डिज़ाइन करें जो लेबल बढ़ने पर न टूटें। इसे किसी आँकड़े के आसपास योजना बनाने की जगह डिज़ाइन की एक बाध्यता मानें।

हर चरण तेज़ी से हो जाता है, क्योंकि वह काम कैटलॉग नाम की एक ही जगह होता है। कैटलॉग के बिना यही पाँच चरण कोडबेस में पाँच अलग-अलग खोज-अभियान बन जाते हैं, और आपको कभी पता नहीं चलता कि काम कब पूरा हुआ।

अनुवाद वेंडर या टूल चुनने से पहले आपको क्या तय कर लेना चाहिए?

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

पहले तीन बातें तय करें। कौन-सी फ़ाइल सत्य का एकमात्र स्रोत (single source of truth) है। शब्द-चयन में बदलाव कौन मंज़ूर करेगा। और बदली हुई या नई स्ट्रिंग अनुवाद तक कैसे पहुँचेगी: हाथ से, स्क्रिप्ट से, या ऐसे pull request से जो अनुवादों के साथ ही आता है। आख़िरी तरीक़ा ही अनुवादों को स्रोत से पिछड़ने से रोकता है, यानी वह समस्या जिसका वर्णन अनुवाद फ़ाइलें सिंक से बाहर क्यों हो जाती हैं में है।

जब कॉपी पहले से रिपॉज़िटरी में हो, तो क्या बदल जाता है?

स्थानीयकरण अलग प्रोजेक्ट नहीं रह जाता। जब कैटलॉग रिपॉज़िटरी में होता है, तो नई या बदली हुई स्ट्रिंग diff की एक पंक्ति के रूप में दिखती है, उसके अनुवाद उसी pull request फ़्लो से तैयार और रिव्यू किए जा सकते हैं जिससे कोड होता है, और किसी को स्प्रेडशीट एक्सपोर्ट करके यह उम्मीद नहीं करनी पड़ती कि वह ठीक-ठाक लौट आएगी।

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

globalize.now कहाँ फ़िट बैठता है

globalize.now स्थानीयकरण के साथ बना एक कोड-नेटिव कॉपी मैनेजमेंट सिस्टम है, और ऊपर बताया गया एकल-स्रोत (single-sourcing) चरण वह हिस्सा है जो यह आपके लिए करता है। आप ऐप में अपनी GitHub या GitLab रिपॉज़िटरी कनेक्ट करते हैं। एक स्कैन पता लगाता है कि वहाँ क्या-क्या है। अगर स्ट्रिंग्स कॉम्पोनेंट्स के अंदर लिटरल हैं, तो एक बार का कन्वर्ज़न उन्हें keys से जोड़कर कैटलॉग में ले जाता है, और अगर i18n सेटअप नहीं है तो उसे जोड़ देता है; अगर आप पहले से next-intl, react-i18next, i18next या Lingui जैसी लाइब्रेरी इस्तेमाल करते हैं, तो यह आपके मौजूदा सेटअप के साथ ही काम करता है। नतीजा अपनी अलग ब्रांच पर एक pull request के रूप में आता है, इसलिए पहला कैटलॉग ठीक उसी रिव्यू से गुज़रता है जिसका ऊपर वर्णन है। इसके बाद आपकी जोड़ी गई नई स्रोत स्ट्रिंग्स का अनुवाद push जॉब्स करते हैं, जो नतीजे के साथ एक pull request खोल देते हैं। रिपॉज़िटरी ही सत्य का एकमात्र स्रोत बनी रहती है, और मौजूदा i18n सेटअप की गाइड बताती है कि जब सेटअप पहले से मौजूद हो, तब स्कैन को क्या मिलता है।

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

संक्षेप में: चरणों का क्रम

  1. यूज़र को दिखने वाली हर स्ट्रिंग को रिपॉज़िटरी के एक कैटलॉग में इकट्ठा करें। शब्द न बदलें।
  2. वाक्य पूरे रखें और हर स्ट्रिंग को key से रेफ़र करें।
  3. डुप्लिकेट हटाएँ और मंज़ूर शब्द-चयन एक बार चुनें।
  4. उन शब्दों की छोटी शब्दावली लिखें जो कभी नहीं बदलते।
  5. सरल भाषा के लिए संपादन करें और अनुवादकों के लिए संदर्भ नोट्स जोड़ें।
  6. तय करें कि शब्द-चयन कौन मंज़ूर करेगा और बदली हुई स्ट्रिंग्स अनुवाद तक कैसे पहुँचेंगी।
  7. उसके बाद ही अनुवाद वेंडर या टूल चुनें, या बदलें।

अगर पहला चरण ही एक महीने के काम जैसा दिखता है, तो रिपॉज़िटरी कनेक्ट करें, उसकी सुझाई गई योजना पढ़ें, और जो pull request वह खोलता है उसे रिव्यू करें।

globalize.now आपके ऐप्लिकेशन की हार्डकोडेड कॉपी को अनुवाद-तैयार locale फ़ाइलों में बदल देता है और जैसे-जैसे आप नई रिलीज़ करते हैं, उन्हें अपडेट रखता है।

globalize.now को निःशुल्क आजमाएं