🕺🏾 🔓 🔛 मूल पैकेज के साथ गो में स्थानीयकरण 🤦🏾 🤚🏼 ⛹️

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

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

Go में, बल्कि एक युवा भाषा के रूप में, सभी आधुनिक वेब डेवलपमेंट ट्रेंड्स को मूल पैकेजों के स्तर पर लागू किया जाता है और इसके लिए अतिरिक्त "डांसिंग विद टैमबोराइन" की आवश्यकता नहीं होती है। (मैंने कुछ साल पहले गो को सीखना शुरू किया था, लेकिन मुझे अभी भी "खोजे गए सुपरपावर" की भावना याद है कि मैंने इस भाषा को सीखने के बाद पहले दिनों का अनुभव किया था। ऐसा लग रहा था कि अब मैं केवल कुछ पंक्तियों को लिखकर किसी भी कार्य को महसूस कर सकता हूं।)

बेशक, उन्होंने या तो गो में स्थानीयकरण को दरकिनार नहीं किया। इसमें स्थानीयकरण बुनियादी पैकेजों का उपयोग करके व्यावहारिक रूप से "बॉक्स से बाहर" उपलब्ध है: golang.org/x/text/language , golang.org/x/text/message और golang.org/x/text/feature/plural । आइए देखें कि केवल आधे घंटे में गो में कितना आसान है, इन पैकेजों का उपयोग करके, आप संदेश स्थानीयकरण जैसे गैर-तुच्छ कार्य को लागू कर सकते हैं।

आगे देखते हुए, मैं कहता हूँ कि इस लेख का उद्देश्य मुख्य रूप से गो की शक्ति और सुंदरता को दिखाना और स्थानीयकरणों के साथ काम करने के लिए संदेश संकुल की बुनियादी विशेषताओं को उजागर करना है। यदि आप एक उत्पादन अनुप्रयोग के लिए एक समाधान की तलाश कर रहे हैं, तो आप एक बेहतर ऑफ -शेल्फ होटल चाहते हैं। गो-आई 18 एन के फायदे गिथब पर कई सितारे हैं (उनमें से मेरा भी है) और महान लचीलापन है। हालांकि, इसके उपयोग के खिलाफ तर्क हैं: आपको उन सभी लचीलेपन और कार्यक्षमता की आवश्यकता नहीं हो सकती है; बाहरी लाइब्रेरी का उपयोग क्यों करें जब सब कुछ पहले से ही भाषा में लागू हो; यदि आपके पास पहले से ही अपने स्वयं के अनुवाद की व्यवस्था अपने स्वयं के प्रारूपों के साथ है, तो यह "जैसा है" पुस्तकालय पूरी तरह से काम नहीं करेगा और आपको इसे वैसे भी संशोधित करना होगा; और, अंत में, तीसरे पक्ष के पुस्तकालय का उपयोग करना उतना दिलचस्प और जानकारीपूर्ण नहीं है जितना कि खुद कुछ करना है।

हम कार्य को कार्यान्वित करने के लिए बुनियादी आवश्यकताओं को तैयार करते हैं। यमल प्रारूप में ए: लेबल हैं: "लेबल_नाम: अनुवाद पाठ" ; अनुवाद भाषा फ़ाइल नाम में निर्दिष्ट है, उदाहरण के लिए ru.yml; b) html में ईमेल टेम्प्लेट। यह आवश्यक है, इनपुट मापदंडों के आधार पर: स्थानीय और डेटा सरणी, संदेश के स्थानीयकृत पाठ को उत्पन्न करने के लिए।

और चलिए शुरू करते हैं ... लेकिन सबसे पहले, संदेश पैकेज के बारे में कुछ और शब्द (golang.org/x/text/message)। यह स्थानीयकृत तार के आउटपुट को प्रारूपित करने के लिए डिज़ाइन किया गया है। संदेश मानक fmt पैकेज के इंटरफ़ेस को लागू करता है और इसे प्रतिस्थापित कर सकता है। उपयोग उदाहरण:

message.SetString(language.Russian, "toxic", "") message.SetString(language.Japanese, "toxic", "毒性") message.NewPrinter(language.Russian).Println(“toxic”) message.NewPrinter(language.Japanese).Println(“toxic”) //: // //毒性

लेबल को "देखने" के लिए पैकेज के लिए, इसे पहले घोषित किया जाना चाहिए। उदाहरण में, इसके लिए सेटस्ट्रिंग फ़ंक्शन का उपयोग किया जाता है। इसके बाद, चयनित भाषा के लिए एक प्रिंटर बनाया जाता है और एक स्थानीयकृत स्ट्रिंग को सीधे प्रदर्शित किया जाता है।

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

शब्दकोश विकल्प हमें सूट करता है। सबसे पहले, हम शब्दकोश की संरचना को परिभाषित करते हैं और इसके लिए लुकअप इंटरफ़ेस लागू करते हैं:

 type dictionary struct { Data map[string]string } func (d *dictionary) Lookup(key string) (data string, ok bool) { if value, ok := d.Data[key]; ok { return "\x02" + value, true } return "", false }

यारल फाइलों के सभी लेबल को शब्दकोशों के एक संग्रह में, जो कि एक नक्शा है [लैंग] * शब्दकोश प्रारूप नक्शा , जहाँ लैंग BCP47 प्रारूप में एक भाषा टैग है।

 func parseYAMLDict() (map[string]catalog.Dictionary, error) { dir := "./translations" files, err := ioutil.ReadDir(dir) if err != nil { return nil, err } translations := map[string]catalog.Dictionary{} for _, f := range files { yamlFile, err := ioutil.ReadFile(dir + "/" + f.Name()) if err != nil { return nil, err } data := map[string]string{} err = yaml.Unmarshal(yamlFile, &data) if err != nil { return nil, err } lang := strings.Split(f.Name(), ".")[0] translations[lang] = &dictionary{Data: data} } return translations, nil }

हम इनिट फ़ंक्शन में शब्दकोशों का संग्रह स्थापित करते हैं ताकि एप्लिकेशन स्टार्टअप पर संदेश पैकेज द्वारा शब्दकोशों का उपयोग किया जा सके।

 func init() { dict, err := parseYAMLDict() if err != nil { panic(err) } cat, err := catalog.NewFromMap(dict) if err != nil { panic(err) } message.DefaultCatalog = cat }

इसलिए, फिलहाल, हमने प्रोग्राम में कहीं भी अपनी फाइलों से लेबल के स्थानीयकरण की उपलब्धता हासिल की है:

 message.NewPrinter(language.Russian).Println(“label_name”)

यह कार्य के दूसरे भाग पर जाने का समय है और हमारे स्थानीय लेबल को ईमेल टेम्प्लेट में स्थानापन्न करता है। उदाहरण के लिए, एक साधारण संदेश पर विचार करें - उपयोगकर्ता का पंजीकरण करते समय एक स्वागत योग्य पत्र:
हैलो, बिल स्मिथ!

पार्सिंग के लिए, हम एक और मानक पैकेज - html / टेम्पलेट का उपयोग करते हैं । जब टेम्पलेट में टेंपलेटिंग करते हैं, तो आप अपने कामों को .Funcs () के जरिए सेट कर सकते हैं:

 template.New(tplName).Funcs(fmap).ParseFiles(tplName)

टेम्प्लेट में एक फ़ंक्शन जोड़ें जो उन में लेबल और स्थानापन्न चर का अनुवाद करेगा और इसे अनुवाद कहेगा । टेम्पलेट पार्सिंग कोड:

 //  lang:=language.Russian //  tplName:=”./templates/hello.html” //   data := &struct { Name string LastName string }{Name: "Bill", LastName: "Smith"} fmap := template.FuncMap{ //   "translate": message.NewPrinter(lang).Sprintf, } t, err := template.New(tplName).Funcs(fmap).ParseFiles(tplName) if err != nil { panic(err) } buf := bytes.NewBuffer([]byte{}) if err := t.Execute(buf, data); err != nil { panic(err) } fmt.Println(buf.String())

परिणामी पत्र टेम्पलेट ।/templates/hello.html:

 <!DOCTYPE html> <head> <title>{{translate "hello_subject"}}</title> </head> <body> {{translate "hello_msg" .Name .LastName}} </body> </html>

चूंकि अनुवाद में हम स्थानीयकरण के लिए स्प्रिंटफ फ़ंक्शन का उपयोग करते हैं, इसलिए लेबल टेक्स्ट में चर इस फ़ंक्शन के सिंटैक्स का उपयोग करके सिलना होगा। उदाहरण के लिए, % s एक स्ट्रिंग है, % d एक पूर्णांक है।
टैग की गईं फाइलें
en.yml

 hello_subject: Greeting mail hello_msg: Hello, %s %s!

ru.yml

 hello_subject:   hello_msg: , %s %s!

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

यदि आपको यह उदाहरण पसंद आया है, तो आप % s के बजाय लेबल में चर के लिए चर नामों का उपयोग करके और लेबल में फ़ंक्शन का उपयोग करके, आगे और स्वतंत्र रूप से बहुवचन को लागू कर सकते हैं। मैंने जानबूझकर ऐसा नहीं किया था ताकि आपकी कल्पना के लिए जगह छोड़ दूं।

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

मूल पैकेज के साथ गो में स्थानीयकरण

More articles: