🦍 🙎🏼 ⛳️ .NET पर एक फंक्शन दुभाषिया के साथ परियोजनाओं का स्थानीयकरण 🍄 💂🏼 🤴

प्रस्तावना

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

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

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

पुस्तकालय रचना

SourceForge प्रोजेक्ट से लिंक: https://sourceforge.net/projects/open-genesis/?source=navbar

उदाहरण: स्थानीयकरण दृश्य

विधानसभा में निम्नलिखित परियोजनाएं शामिल हैं:

Genesis.Localization मुख्य स्थानीयकरण पुस्तकालय है।
आरयू - रूसी स्थानीयकरण (उदाहरण) के कार्यान्वयन।
अंग्रेजी स्थानीयकरण (उदाहरण) का कार्यान्वयन।
LocalizationViewer - स्थानीयकरणों को संपादित करने की क्षमता के साथ पुस्तकालय की क्षमताओं को प्रदर्शित करने के लिए एक कार्यक्रम।

मूल सिद्धांत

स्थानीयकरण प्रबंधक

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

//    LocalizationManager = new LocalizationManager(); LocalizationManager.BasePath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Localization"); LocalizationManager.Initialize(); try { LocalizationManager.DetectAllLocalizations(); } catch (LocalizationException ex) { MessageBox.Show(ex.Message, " ", MessageBoxButtons.OK, MessageBoxIcon.Error); return; }

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

सभी स्थानीयकरणों की एक सूची प्रबंधक से प्राप्त की जा सकती है:

 manager.Localizations

उदाहरण के लिए, हम रूसी स्थानीयकरण को जोड़ना चाहते थे, इसके लिए हमें इसे सीधे प्रबंधक में लोड करने की आवश्यकता है:

 LocalizationPackage package = manager.Load("ru");

लोड करने के बाद, आप स्थानीयकरण के साथ काम कर सकते हैं - इससे लाइनें, संसाधन आदि प्राप्त करें, और यदि इसकी आवश्यकता नहीं है, तो आप इसे लोड कर सकते हैं:

 manager.Unload("ru");

महत्वपूर्ण! आप स्थानीयकरणों की असीमित संख्या को लोड और अनलोड कर सकते हैं, जैसा कि वे सभी अपने स्वयं के डोमेन (AppDomain) में बनाए गए हैं।

स्थानीयकरण पैकेज

प्रत्येक स्थानीयकरण एक अलग निर्देशिका में फ़ाइलों का एक सेट है, सभी के लिए मूल वह है जो स्थानीयकरण प्रबंधक को लोड करते समय चुना गया था। ऊपर दिए गए उदाहरण में, यह [ProjectDir] \ स्थानीयकरण निर्देशिका होगी, और स्थानीयकरण पैकेज सीधे [ProjectDir] \ Localization \ ru , [ProjectDir] \ Localization \ en निर्देशिकाओं आदि में स्थित होंगे।

प्रत्येक मानक पैकेज में निम्नलिखित फाइलें होनी चाहिए:

localization.info - पैकेज का एक संक्षिप्त विवरण के साथ एक xml फ़ाइल, इन फ़ाइलों को शुरू में स्थानीयकरण प्रबंधक द्वारा डाउनलोड किया जाता है।

रूसी स्थानीयकरण के लिए एक उदाहरण:
```
 <?xml version="1.0"?> <LocalizationInfo xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Name></Name> <Culture>ru</Culture> </LocalizationInfo> 
```
जैसा कि आप देख सकते हैं, केवल दो फ़ील्ड हैं, शायद बाद में एक विशेष पैकेज की पहचान करने के लिए नए फ़ील्ड जोड़े जाएंगे।
flag.png - स्थानीयकरण का प्रतीक एक छवि। मेरे उदाहरण में, ये 16x16 पिक्सेल के आकार वाले राज्य झंडे हैं।
strings.xml - स्थानीय स्ट्रिंग्स युक्त xml फ़ाइल। पैकेज के तर्क को ओवरराइड करते समय, आप अपने स्वयं के स्रोत का निर्माण कर सकते हैं, उदाहरण के लिए, एक बाइनरी या डेटाबेस।
package.dll - पैकेज का निष्पादन योग्य मॉड्यूल एक छोटा पुस्तकालय है जिसमें स्थानीयकरणपैक से विरासत में मिला एक वर्ग मौजूद होना चाहिए।

रूसी स्थानीयकरण के लिए निष्पादन योग्य कोड का उदाहरण:
```
 using System; using Genesis.Localization; namespace Ru { public class Package : LocalizationPackage { protected override object Plural(int count, params object[] forms) { int m10 = count % 10; int m100 = count % 100; if (m10 == 1 && m100 != 11) { return forms[0]; } else if (m10 >= 2 && m10 <= 4 && (m100 < 10 || m100 >= 20)) { return forms[1]; } else { return forms[2]; } } } } 
```
नीचे एक स्पष्टीकरण दिया जाएगा कि बहुवचन विधि क्या है।

स्थानीयकरण पैकेज का उपयोग करना

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

इसकी कुंजी (क्लासिक विधि) द्वारा एक विशिष्ट स्ट्रिंग प्राप्त करना। कुंजी एक स्ट्रिंग या कई प्रकार का हो सकता है Int32।

उपयोग उदाहरण:
```
 LocalizationPackage package = manager.Load(culture); string strByName = package["name"]; string strByID = package[150]; 
```
गुजरती तर्कों के साथ एक स्वरूपित स्ट्रिंग प्राप्त करना। यह वह विधि है जिसके लिए पुस्तकालय बनाया गया था।

उपयोग उदाहरण:
```
 LocalizationPackage package = manager.Load(culture); string formattedString = package["name", arg1, args2, ...]; 
```
किसी भी वस्तु का उपयोग तर्कों के रूप में किया जा सकता है। इस विधि पर और अधिक नीचे वर्णित किया जाएगा।
स्थानीयकृत संसाधन के लिए पथ प्राप्त करना। ऐसा करने के लिए, वहां से छवि लोड करने के लिए स्थानीयकरण निर्देशिका या GetImage (स्ट्रिंग फ़ाइल नाम) विधि में एक मनमानी फ़ाइल के लिए पथ प्राप्त करने के लिए GetResourceFilePath (स्ट्रिंग फ़ाइल नाम) विधि का उपयोग करें।

स्ट्रिंग दुभाषिया

पुस्तकालय की ताकत उसके स्ट्रिंग दुभाषिया में निहित है। वह क्या पसंद है?
संक्षेप में, यह स्थानीयकृत तार में शामिल निर्देशों का एक सेट है जिसके साथ आप किसी विशेष संस्कृति में अनुवाद को अनुकूलित कर सकते हैं।

स्ट्रिंग इंटरप्रेटर को स्ट्रिंग को प्राप्त करने की विधि से ऊपर वर्णित तर्कों के साथ कहा जाता है (सामान्य कुंजी हैंडलिंग के मामले में, स्थानीय स्ट्रिंग "शुद्ध" रूप में वापस आ जाती है) या विशेष GetFormattedString विधि (स्ट्रिंग प्रारूप, params ऑब्जेक्ट [] args) द्वारा, जो बिल्कुल उसी तरह से काम करता है, लेकिन एक मनमाना प्रारूप स्ट्रिंग पहले तर्क के रूप में पारित किया जाता है।

अब इन निर्देशों के बारे में अधिक। उनमें से दो हैं:

एक स्ट्रिंग में एक तर्क का समावेश।

प्रारूप निर्देश:
```
 %index% 
```
परिणाम: स्ट्रिंग में तर्क संख्या सूचकांक को एम्बेड करना

उपयोग उदाहरण:
```
 package.GetFormattedString("%1% = %0%%%", 80, ""); 
```
परिणाम:
```
  = 80% 
```
कृपया ध्यान दें कि % चरित्र, एक सेवा चरित्र होने के नाते, एक अन्य चरित्र से बच जाना चाहिए जो इस उदाहरण में समान है।
फ़ीचर सक्षम करें

प्रारूप निर्देश:
```
 %Func(arg1, arg2, ..., argN)% 
```
दलीलें संख्याओं , दोहरे-उद्धृत स्ट्रिंग्स (खुद उद्धरण से बच जाती हैं, जैसे%, डबल-रीप्ले द्वारा), उनकी संख्या (% इंडेक्स) द्वारा स्ट्रिंग तर्क , या अन्य कार्यों के लिए कॉल हो सकती हैं ।

उपयोग उदाहरण:
```
 package.GetFormattedString(" %1%    %Upper(Random(\"\", \"\", \"\"))% ,  %0% %Plural(%0, \"\", \"\", \"\")% .", 55, "MegaDeath2000"); 
```
परिणाम:
```
  MegaDeath2000     ,  55  . 
```

बिल्ट-इन फीचर्स और इंटीग्रेशन

LocalizationPackage वर्ग में कई अंतर्निहित "मानक" फ़ंक्शन हैं, जिनमें से भाग का उपयोग ऊपर दिए गए उदाहरण में किया गया था:

बहुवचन (int, var1, var2, ..., varN) - संख्या के आधार पर शब्द रूप को एम्बेड करना, यह विधि प्रत्येक संस्कृति के लिए अद्वितीय है और इसे फिर से परिभाषित किया जाना चाहिए। विशेष रूप से, रूसी भाषा में संख्या के तीन रूप हैं (उदाहरण के लिए: "1 इकाई", "2 इकाइयाँ", "8 इकाइयाँ")।
रैंडम (var1, var2, ..., varN) - दिए गए लोगों के बीच एक यादृच्छिक मूल्य का चयन।
अपर (स्ट्रिंग) - अपरकेस के लिए डाली।
लोअर (स्ट्रिंग) - निचली स्थिति में डाली जाती है।
अपरएफ (स्ट्रिंग) - ऊपरी मामले में केवल पहला अक्षर ("शब्द" => "शब्द")।
लोअरफ़ (स्ट्रिंग) - केवल प्रथम अक्षर के निचले मामले में डाली जाती है।

यदि आपको नई सुविधाएँ जोड़ने की आवश्यकता है, तो ऐसा करने के दो तरीके हैं।

पैकेज के पुनर्निर्धारित वर्ग में, आप नए कार्यों की घोषणा कर सकते हैं और उन्हें [फंक्शन] विशेषता के साथ चिह्नित कर सकते हैं, फिर वे एक विशिष्ट स्थानीयकरण के लिए दुभाषिया में स्वचालित रूप से शामिल हो जाएंगे। अंतर्निहित कार्यों को इस तरह से परिभाषित किया गया है, उदाहरण के लिए, बहुवचन और यादृच्छिक कार्य इस तरह दिखते हैं:
```
 [Function("P")] protected abstract object Plural(int count, params object[] forms); [Function] protected virtual object Random(params object[] variants) { if (variants.Length == 0) { return null; } else { return variants[_rnd.Next(variants.Length)]; } } 
```
कृपया ध्यान दें कि किसी फ़ंक्शन के लिए अपने उपनामों की एक सूची (छोटे रिकॉर्ड के लिए) निर्दिष्ट करने की अनुमति है, उदाहरण के लिए, बहुवचन को मुख्य नाम ( बहुवचन ) और एक उपनाम ( पी ) के माध्यम से दोनों कहा जा सकता है, जबकि फ़ंक्शन के नामों में कोई फर्क नहीं पड़ता।
अपने स्वयं के कार्यों का एकीकरण, इसके लिए, InjectFormatterFunction विधि का उपयोग किया जाता है , उपयोग का एक उदाहरण:
```
 var package = LocalizationManager.Load("ru"); package.InjectFormatterFunction(new Func<int, int, int>((a, b) => Math.Min(a, b)), "Min"); package.InjectFormatterFunction(new Func<int, int, int>((a, b) => Math.Max(a, b)), "Max"); package.GetFormattedString("%min(%0, max(%1, %2))%", 10, 8, 5); 
```
परिणाम:
```
 8 
```
एक विधि (MethodInfo) या एक प्रतिनिधि को एक InjectFormatterFunction के तर्क के रूप में पारित किया जा सकता है (प्रतिनिधियों को ऊपर के उदाहरण में पारित किया गया है)।

अतिरिक्त विशेषताएं

बुनियादी कार्यों के अलावा, पुस्तकालय दो और अतिरिक्त प्रदान करता है।

डिबग मोड

लाइब्रेरी के डिबग संस्करण में न केवल ऊपर वर्णित तरीकों से स्थानीयकृत तार प्राप्त करने की क्षमता शामिल है, बल्कि उन्हें सीधे लिखने के लिए भी है:

 var package = LocalizationManager.Load("ru"); package["New Key"] = " "; package.Save();

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

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

मानचित्रण

यह हमारी मिठाई है। उद्देश्य - रूपों, नियंत्रणों और अन्य जटिल वस्तुओं का त्वरित स्थानीयकरण।
इस फ़ंक्शन का उपयोग स्थानीयकरण दृश्य डेमो परियोजना में किया जाता है।

यहाँ मुख्य रूप के वर्णन का एक अंश दिया गया है:

 [LocalizableClass("Text", "CAPTION")] public partial class frmMain : Form { ... [LocalizableClass] private System.Windows.Forms.ToolStripButton cmdExit; [LocalizableClass] private System.Windows.Forms.ToolStripButton cmdSave; [LocalizableClass] private System.Windows.Forms.ToolStripLabel lblSearch; ... /// <summary> ///   /// </summary> private void Localize() { LocalizationMapper mapper = new LocalizationMapper(); mapper.Current = manager["ru"]; mapper.Localize(this); } ... }

LocalizationMapper , आपको स्थानीयकृत फ़ंक्शन का उपयोग करके स्थानीयकृत फ़ंक्शन में किसी भी ऑब्जेक्ट को स्थानीयकृत करने की अनुमति देता है और स्थानीयकृत ऑब्जेक्ट के फ़ील्ड्स और गुणों (इस मामले में, रूपों) पर स्थानीय विशेषताओं का उपयोग करता है। उदाहरण के लिए, [LocalizableClass] मापदंडों के बिना विशेषता का मतलब है कि आपको डिफ़ॉल्ट संपत्ति (पाठ), और प्रपत्र की एक स्वचालित कुंजी <वर्ग> <उपवर्ग> <फ़ील्ड> का स्थानीयकरण करने की आवश्यकता होगी। CmdExit बटन के टेक्स्ट फ़ील्ड के लिए, कुंजी इस प्रकार होगी:

 LocalizationViewer.frmMain.cmdExit_Text

निष्कर्ष

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

पुनश्च

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

मेरे अन्य प्रकाशन

मॉडल-आधारित डेटा के साथ पाठ पैटर्न भरना। .NET कार्यान्वयन गतिशील बाइटकोड (IL) फ़ंक्शन का उपयोग करते हुए

.NET पर एक फंक्शन दुभाषिया के साथ परियोजनाओं का स्थानीयकरण