ASP.NET MVC अनुप्रयोगों का स्थानीयकरण

स्थानीयकरण के विषय पर, हैबे पर पहले से ही कई लेख हैं, उदाहरण के लिए, एक डेटाबेस या एमवीसी 2 का उपयोग करके ASP.NET MVC अनुप्रयोगों का स्थानीयकरण: स्थानीयकरण के लिए एक पूर्ण मार्गदर्शिका , लेकिन फिर भी समस्या अभी भी प्रासंगिक है।

हाल ही में, हमें साइट इंटरफ़ेस को किसी अन्य भाषा में स्थानीयकृत करने (अनुवाद करने) का कार्य मिला। हमारी परियोजना ASP.NET MVC पर विकसित की जा रही है और इस परियोजना में जावास्क्रिप्ट और jQuery टेम्पलेट्स में बहुत सारे ग्राहक कोड हैं। हमारे लिए एक और महत्वपूर्ण बिंदु अनुवादकों के संवादात्मक कार्य की संभावना है, वास्तव में मक्खी पर साइट का अनुवाद करना।

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

अवसरों

पुस्तकालय आपको स्थानीय बनाने की अनुमति देता है:

• अभ्यावेदन (दृश्य)
• कोड में स्ट्रिंग स्थिरांक
• मॉडल और डेटा सत्यापन विशेषताओं में पाठ
• जावास्क्रिप्ट पाठ
• JQuery के टेम्पलेट

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

कनेक्शन और कॉन्फ़िगरेशन

लाइब्रेरी को प्रोजेक्ट से जोड़ने के लिए, बस Nuget पैकेज Knoema.Localization.Mvc स्थापित करें। स्थानीय डेटा को संग्रहीत करने के लिए, आपको एक रिपॉजिटरी कार्यान्वयन की भी आवश्यकता है। सरलतम मामले में, यह Knoema.Localization.EFProvider पैकेज स्थापित करके EF के लिए एक तैयार किए गए कार्यान्वयन को जोड़ने के लिए पर्याप्त है। एक विकल्प अपने प्रदाता को काफी सरल ILocalizationRepository इंटरफ़ेस लागू करके विकसित करना है।

Global.asax में Application_Start (), बनाए गए भंडार को इनिशियलाइज़ करें:

Knoema.Localization.LocalizationManager.Repository = new Knoema.Localization.EFProvider.LocalizationRepository(); 

और RegisterRoutes विधि में लिखें:

 routes.IgnoreRoute("_localization/{*route}"); 

यदि आप Nuget का उपयोग करते हैं, तो विधानसभाओं को web.config में जोड़ते समय, निम्न मान स्वचालित रूप से जुड़ जाएंगे:

  <system.webServer> <modules> <add name="Knoema.Localization" type="Knoema.Localization.Web.LocalizationModule"/> </modules> <handlers> <add name="Knoema.Localization" verb="*" path="_localization/*" type="Knoema.Localization.Web.LocalizationHandler" allowPathInfo="true" resourceType="Unspecified" /> </handlers> </system.webServer> 

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

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

Web.config में विचारों को स्थानीय बनाने के लिए, आपको यह निर्दिष्ट करने की आवश्यकता है कि LocalizedWebViewPage का उपयोग पृष्ठों के आधार के रूप में किया जाएगा:

  <system.web.webPages.razor> ... <pages pageBaseType="Knoema.Localization.Mvc.LocalizedWebViewPage"> <namespaces> <add namespace="System.Web.Mvc" /> ... </namespaces> </pages> </system.web.webPages.razor> 

उसके बाद, व्यू कोड में, Html हेल्पर उपलब्ध होगा:

 public string R(string text, params object[] formatterArguments); 

उदाहरण

 <p>@R("Hello world!")</p> 

पाठ को मानकीकृत किया जा सकता है:

 <p>@R("Hello {0}!", username)</p> 

कोड में स्ट्रिंग स्थिरांक का स्थानीयकरण

एक्सटेंशन का उपयोग करके कोड में लाइनें स्थानीयकृत हैं:

 public static string Resource(this string value, object obj) 

या, यदि विधि स्थिर है, जहाँ यह ऑब्जेक्ट नहीं है, तो आप उपयोग कर सकते हैं:

 public static string Resource(this string value, Type type) 

उदाहरण

 "The given input does not refer to a valid Search.".Resource(this) 

मॉडल स्थानीयकरण

मॉडल को स्थानीय बनाने के लिए, आपको मानक सत्यापन प्रदाता और मेटाडेटा प्रदाता को फिर से परिभाषित करना होगा। ऐसा करने के लिए, Global.asax में Application_Start () जोड़ें:

 ModelValidatorProviders.Providers.Clear(); ModelValidatorProviders.Providers.Add(new ValidationLocalizer()); ModelMetadataProviders.Current = new MetadataLocalizer(); 

सभी मॉडल जिन्हें स्थानीयकृत किया जा सकता है उन्हें स्थानीयकृत विशेषता के साथ चिह्नित किया जाना चाहिए।

उदाहरण

 [Localized] public class SignInViewModel { [Required(ErrorMessage = "Please provide your e-mail")] [Display(Name = "E-mail")] public string EMail { get; set; } [Required(ErrorMessage = "Please type your password")] public string Password { get; set; } } 

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

जावास्क्रिप्ट और HTML टेम्पलेट्स का पता लगाना

जावास्क्रिप्ट कोड में स्ट्रिंग स्थिरांक को jQuery एक्सटेंशन का उपयोग करके स्थानीयकृत किया जाता है:

 $.localize(text, scriptSource); 

एक्सटेंशन को सहायक के उपयोग से पृष्ठ पर कहीं भी जोड़ा जा सकता है, यह तुरंत पूरे आवेदन के लिए बेहतर है:

 @RenderLocalizationIncludes(User.IsInRole("Admin")) 

इसके अलावा, RenderLocalizationIncludes साइट पर एक विजेट एम्बेड करेगा (बशर्ते कि आप एक व्यवस्थापक हैं), जहां आप स्थानीयकृत सब कुछ का अनुवाद कर सकते हैं।

उदाहरण

 $.localize("Layout options", "~/js/shared/site.js"); 

टिप्पणी

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

 public class CassetteConfiguration : ICassetteConfiguration { private void CustomizeScript(ScriptBundle bundle) { bundle.Processor = new ScriptPipeline().Prepend(new LocalizationResourceProcessor()); } public void Configure(BundleCollection bundles, CassetteSettings settings) { bundles.AddPerIndividualFile<ScriptBundle>("js/shared/site.js", customizeBundle: CustomizeScript); } } 

अब $ .localize ("लेआउट विकल्प", "~ / js / साझा / site.js") की लंबी कॉल को इसके द्वारा प्रतिस्थापित किया जा सकता है:

 __R("Layout options"); 

स्थानीयकरण। स्रोतप्रोसेसर __R को $ .localize से बदल देगा और फ़ाइल नाम को दूसरे पैरामीटर के रूप में जोड़ देगा।

अनुवाद जोड़ना

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

उन अभ्यावेदन या मॉडल जो पूरी तरह से अनुवादित हैं उन्हें ग्रे में हाइलाइट किया गया है।

संपादन:


आप एक नई भाषा जोड़ सकते हैं, मौजूदा एक को निर्यात / आयात कर सकते हैं।


अंत में, मैं कहना चाहता हूं कि पुस्तकालय को पहले आंतरिक उपयोग के लिए लिखा गया था, यह बहुत अच्छी तरह से निकला और इसलिए इसे प्रकाशित करने और एक लेख लिखने का फैसला किया।

संदर्भ:
GitHub स्रोत कोड
Knoema.Localization.Core
Knoema.Localization.MVC
Knoema.Localization.Cassette