🤴🏼 🧖🏽 🕧 BabelFish - जावास्क्रिप्ट दुनिया में एक बहुभुज 🏰 💌 👩‍⚖️

इंटरनेट हमारे जीवन में वैश्विकता लाता है। और कई वेब संसाधन एक देश में रहने वाले और एक ही भाषा बोलने वाले दर्शकों तक सीमित नहीं हैं। हालांकि, साइट के कई भाषा संस्करणों का मैनुअल समर्थन अप्रिय है और, एक निश्चित पैमाने से शुरू होता है, शायद ही वास्तविक।

उदाहरण के लिए, REG.RU में, आज शब्दकोशों में १५००० से अधिक वाक्यांश हैं, जिनमें से २०० उपयोग के बारे में है, और २००० से अधिक परिवर्तनशील प्रतिस्थापन का उपयोग करते हैं। हर दिन, कम से कम 10 वाक्यांश जोड़े जाते हैं। और इस तथ्य के बावजूद कि हमने अभी नई भाषाओं के लिए साइट और अपनी योजनाओं के आगे स्थानीयकरण करना शुरू कर दिया है।

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

डोनट पैनआईसी।

हाल ही में, BabelFish 1.0 पैकेज प्रकाशित किया गया है, जिसे जावास्क्रिप्ट अनुप्रयोगों का अंतर्राष्ट्रीयकरण करने के लिए डिज़ाइन किया गया है।

इस पर विचार करने वाले विचारों ने हमें इतना प्रसन्न किया कि हमने उन्हें CPAN मॉड्यूल लोकेल :: बेबेलिश के रूप में पर्ल में भी शामिल कर दिया और हम पर्ल एप्लिकेशन के लिए इसका उपयोग करते हैं। लेकिन जावास्क्रिप्ट कार्यान्वयन पर वापस।

सिंहावलोकन

इस पुस्तकालय की विशेषताएं क्या हैं?

बहुत सुविधाजनक और कॉम्पैक्ट सिंटैक्स रिक्तीकरण और क्रमपरिवर्तन के लिए।
सर्वर और क्लाइंट दोनों पर काम करने की क्षमता (पुराने ब्राउज़रों को es5- शिम सपोर्ट पैकेज की आवश्यकता होगी)।
एक "फ्लैट" देखो के लिए डेटा संरचनाओं की स्वचालित कास्टिंग।
पाठ के बजाय जटिल संरचनाओं को संग्रहीत और पुनर्प्राप्त करने की क्षमता।

आइए उदाहरणों का उपयोग करके मॉड्यूल क्षमताओं पर विचार करें। एक विशिष्ट वाक्यांश इस तरह दिखता है:

#{cachalotes_count} ((||)):cachalotes_count.

सटीक मिलान और चर प्रविष्टियों की नेस्टेड व्याख्या की संभावना का भी समर्थन किया जाता है। एक विशिष्ट उदाहरण है जब "0 शुक्राणु व्हेल" के बजाय हम "1 शुक्राणु व्हेल" नहीं लिखना चाहते हैं, तो "1 शुक्राणु व्हेल" के बजाय हम केवल "शुक्राणु व्हेल" लिखते हैं, जबकि वर्तनी "21 शुक्राणु व्हेल" छोड़ते हैं:

((=0 |=1 |#{count} |#{count} |#{count} ))

ध्यान दें कि यदि गणना नामक चर का उपयोग किया जाता है, तो वाक्यांश के अंत में बृहदान्त्र के माध्यम से उसका नाम छोड़ा जा सकता है।

Babelfish एपीआई एक विशिष्ट स्थान में एक कुंजी को तैयार पाठ या डेटा संरचना में हल करने के लिए t(, , )

विधि t(, , )

प्रदान करता है। कॉल इस तरह दिखता है:

 babelfish.t( 'ru-RU', 'some.complex.key', { a: "test" } ); babelfish.t( 'ru-RU', 'some.complex.key', 17 ); //  count  value   17

कोड की पठनीयता को कम करने और कम प्रिंट करने के लिए, इस फॉर्म (कॉफी) की एक विधि आमतौर पर बनाई जाती है:

  window.t = t = (key, params, locale) -> locale = _locale unless locale? babelfish.t.call babelfish, locale, key, params

यहाँ, लोकेल तर्क सूची के अंत में चला जाता है और वैकल्पिक हो जाता है। अब आप संक्षेप में लिख सकते हैं:

 t( 'some.complex.key', { a: "test" } ); //    : t( 'some.complex.key', 17 ); t( 'some.complex.key', { count => 17, value => 17 } );

वाक्य रचना की संक्षिप्तता का पक्ष यह है कि अनुवादकों (शब्दकोशों और टेम्पलेट्स के साथ काम करने वाले) को वाक्यविन्यास के लिए उपयोग करने की आवश्यकता होती है, हालांकि यह सरल है।

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

यह स्निपेट्स प्रदान करने के लिए भी उपयोगी है जो घोषणा और चर प्रतिस्थापन के लिए तैयार किए गए निर्माणों को सम्मिलित करते हैं।

ब्राउज़र की तरफ अपने आवेदन में Babelfish को एकीकृत करने की प्रक्रिया पर विचार करें।

स्थापना

Babelfish एक npm पैकेज और एक बोवर पैकेज के रूप में दोनों उपलब्ध है। यदि आपको एक ही समय में नोड.जेएस और ब्राउज़र दोनों के साथ काम करने की आवश्यकता है, तो हम एनपीएम पैकेज + ब्राउजर का उपयोग करने की सलाह देते हैं (एक उदाहरण बेबफ़िश डेमो में है ), लेकिन अधिकांश डेवलपर्स के लिए बोवर का उपयोग करना आसान होगा।

यहाँ हम मानते हैं कि वर्तमान लोकल को window.lang के रूप में परिभाषित किया गया है:

 # assets/coffee/babelfish-init.coffee do (window) -> "use strict" BabelFish = require 'babelfish' locale = switch window.lang when 'ru' then 'ru-RU' when 'en' then 'en-US' else window.lang window.l10n = l10n = BabelFish() l10n.setFallback 'be-BY', [ 'ru-RU', 'en-US' ] window.t = t = (args...) -> l10n.t.apply l10n, [ locale ].concat(args) null

शब्दकोशों का संग्रहण और संकलन

आंतरिक स्वरूप

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

वास्तव में, आप इस तरह से शब्दकोशों में वाक्यांश जोड़ सकते हैं:

 babelfish.addPhrase( 'ru-RU', 'some.complex.key', ' ' ); babelfish.addPhrase( 'ru-RU', 'some.complex.anotherkey', '  ' );

या तो:

 babelfish.addPhrase( 'ru-RU', 'some', { complex: { key: ' ', anotherkey: '  ' } });

जटिल डेटा संरचनाओं को जोड़ते समय, आप फ्लैटेनलेवल पैरामीटर (गलत या 0) निर्दिष्ट कर सकते हैं, इसके बाद:

 babelfish.addPhrase( 'ru-RU', 'myhash', { key: ' ', anotherkey: '  ' }, false);

और फिर जब t ('myhash') कहा जाता है, तो हमें चाबी की चाबी और किसी अन्य के साथ एक वस्तु मिलती है। बाहरी पुस्तकालयों को स्थानीयकृत करते समय यह बहुत सुविधाजनक है (उदाहरण के लिए, jQuery UI प्लगइन्स के लिए कॉन्फ़िगरेशन प्रदान करने के लिए)।

इस तरह के डेटा को क्रमबद्ध करने के लिए एकमात्र आवश्यकता इसे JSON प्रारूप में प्रस्तुत करने की क्षमता है।

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

YAML प्रारूप

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

इस स्थिति में, एम्बेडेड YAML कुंजी एक सपाट संरचना में परिवर्तित हो जाती हैं:

 कुछ:
     जटिल:
         कुंजी: "कुछ पाठ कम से कम # {गिनती}"

कुछ.complex.key कुंजी में कनवर्ट करता है।

वैसे, बबलफिश स्वचालित रूप से, प्रत्यक्ष निर्देशों के बिना, न केवल शब्दकोशों में वाक्यांशों को पहचान सकता है, बल्कि सूचियों (जटिल डेटा संरचनाओं के रूप में) को भी पहचान सकता है। इसलिए, यदि आप निर्दिष्ट करते हैं

 MyList:
     - ब्रिटिश
     - आयरिश

तब जब t('mylist')

कहा जाता है, तो हमें [ 'british', 'irish' ]

। यह बाद में काम आएगा।

स्थानीयकरण वाक्यांश रूपांतरण

आमतौर पर हमें वाक्यांशों को संकलित करने से पहले उन पर अतिरिक्त परिवर्तन करने की आवश्यकता होती है। उनमें से, हम इस तरह शामिल हैं:

मार्कडाउन प्रारूप से HTML में रूपांतरण;
टाइपोग्राफी,
बीईएम के हमारे कार्यान्वयन के लिए विशिष्ट वर्गों और विशेषताओं को जोड़ना।

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

हमने परिसंपत्तियों / स्थानों की निर्देशिका में मूल शब्दकोशों को डाल दिया, उन्हें कॉन्फ़िगर / स्थानों में तैयार-टू-उपयोग शब्दकोशों में और परिवर्तित कर दिया।

यह स्पष्ट है कि आपका रूपांतरण स्टैक हमारे से अलग होने की संभावना है।

और यहाँ मार्कल प्रोसेसर (ग्रंट) के माध्यम से रूपांतरण के साथ बेबफ़िश आंतरिक प्रारूप में YAML प्रारूप में शब्दकोशों के संकलन का एक उदाहरण है:

  # Gruntfile.coffee #   glob, marked, traverse marked = require 'marked' traverse = require 'traverse' grunt.registerTask 'babelfish', 'Compile config/locales/*.<locale>.yaml to Babelfish assets', -> fs = require 'fs' Babelfish = require 'babelfish' glob = require 'glob' files = glob.sync '**/*.yaml', { cwd: 'config/locales' } reFile = /(^|.+\/)(.+)\.([^\.]+)\.yaml$/ # do not wrap each line with <p> renderer = new marked.Renderer() renderer.paragraph = (text) -> text for file in files m = reFile.exec(file) continue unless m [folder, dict, locale] = [m[1], m[2], m[3], ''] b = Babelfish locale translations = grunt.file.readYAML "config/locales/#{folder}#{file}" # md traverse(translations).forEach (value) -> if typeof value is 'string' @update marked( value, { renderer: renderer } ) b.addPhrase locale, dict, translations res = "// #{file} translation\n" res += "window.l10n.load(" res += b.stringify locale res += ");\n" resPath = "assets/javascripts/l10n/#{folder}#{dict}.#{locale}.js" grunt.file.write resPath, res grunt.log.writeln "#{resPath} compiled."

अब तैयार लिपियों को चिपकाया जा सकता है और आपके लिए किसी भी तरह से सुविधाजनक रूप से आपके आवेदन से जुड़ा हो सकता है।

स्थान चयन

सर्वर साइड पर एक लोकेल का चयन करने के लिए, सबसे सही तरीका एक्सेप्ट-लैंग्वेज हैडर को पार्स करना है। एनपीएम मॉड्यूल लोकेल हमें इसमें मदद करेगा। आप nodeca.core के लिए स्रोत कोड भी देख सकते हैं।

दूसरे स्थान पर रोलबैक

बबलफिश उस घटना में अन्य स्थानों पर रोलबैक नियमों की एक सूची रखता है जो वांछित वाक्यांश वर्तमान लोकेल में नहीं है।

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

 babelfish.setFallback( 'be-BY', [ 'ru-RU', 'en-US' ] );

स्थानीयकरण

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

दिनांक स्थानीयकरण

हम पटरियों से तारीखों को प्रारूपित करने के लिए थोड़ा संशोधित डेटा का उपयोग करते हैं:

 # config/locales/formatting.ru-RU.yaml date: abbr_day_names: -  -  -  -  -  -  -  abbr_month_names: - - . - . -  - . -  -  -  - . - . - . - . - . day_names: -  -  -  -  -  -  -  formats: default: '%d.%m.%Y' long: '%-d %B %Y' short: '%-d %b' month_names: - -  -  -  -  -  -  -  -  -  -  -  -  order: - day - month - year time: am:   formats: default: '%a, %d %b %Y, %H:%M:%S %z' long: '%d %B %Y, %H:%M' short: '%d %b, %H:%M' pm:

 # assets/coffee/babelfish-init.coffee strftime = require 'strftime' l10n.datetime = ( dt, format, options ) -> return null unless dt && format dt = new Date(dt * 1000) if 'number' == typeof dt m = /^([^\.%]+)\.([^\.%]+)$/.exec format format = t("formatting.#{m[1]}.formats.#{m[2]}", options) if m format = format.replace /(%[aAbBpP])/g, (id) -> switch id when '%a' t("formatting.date.abbr_day_names", { format: format })[dt.getDay()] # wday when '%A' t("formatting.date.day_names", { format: format })[dt.getDay()] # wday when '%b' t("formatting.date.abbr_month_names", { format: format })[dt.getMonth() + 1] # mon when '%B' t("formatting.date.month_names", { format: format })[dt.getMonth() + 1] # mon when '%p' t((if dt.getHours() < 12 then "formatting.time.am" else "formatting.time.pm"), { format: format }).toUpperCase() when '%P' t((if dt.getHours() < 12 then "formatting.time.am" else "formatting.time.pm"), { format: format }).toLowerCase() strftime.strftime format, dt

अब हमारे पास एक सहायक है:

 window.l10n.datetime( unix timestamp or Date object, format_string_or_config ).

इसी तरह, आप मुद्राओं और अन्य स्थानीय मूल्यों के लिए सहायकों का निर्माण कर सकते हैं।

अन्य कार्यान्वयन

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

जैसा कि मैंने ऊपर उल्लेख किया है, हमने पर्ल भाषा के लिए बेबफ़िश 1.0 बोली को लागू किया।

निष्कर्ष

बबलफिश की संभावनाओं को स्पष्ट करने के लिए, हमने चिह्नित और जेड का उपयोग करके एक छोटा डेमो प्रोजेक्ट प्रकाशित किया।

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

जैसा कि आमतौर पर नोडेका के साथ होता है, उन्होंने एक विचारशील, उच्च-गुणवत्ता और होनहार पुस्तकालय जारी किया। बस आपको याद दिलाने के लिए कि उन्होंने js-yaml , mincer , argparse , pako और markdown-it जैसी हिट फ़िल्में विकसित की हैं।

विटाली पुजरीन मॉड्यूल ( @puzrin ) के लेखक के लिए विशेष धन्यवाद। यह लेख विशेष रूप से REG.RU विकास विभाग की सक्रिय भागीदारी के साथ तैयार किया गया था: इगोरमिरोनोव , ड्रीमवर्क , ने टिमरन को गले लगाया ।

BabelFish - जावास्क्रिप्ट दुनिया में एक बहुभुज