Notepad ++ में Gist plugin

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



नोटपैड ++ के तहत, प्लगइन्स को कई भाषाओं में लिखा जा सकता है: C ++, Ada, Delphi, .NET, लेकिन मैं विकास की गति के कारण उत्तरार्द्ध पर बस गया और क्योंकि मैं इसे बेहतर जानता हूं।

निम्नलिखित का उपयोग विकास के लिए किया गया था:

1. NppPlugin.NET - .NET प्लेटफॉर्म के लिए नोटपैड ++ प्लगइन टेम्पलेट।
2. ServiceStack.Text - JSON ( उच्च प्रदर्शन और छोटे आकार) के क्रमांकन और डीरियलाइज़ेशन।
3. बाधा , GET, POST, DELETE और अन्य अनुरोधों के संकलन और परीक्षण के लिए एक सुविधाजनक ऑनलाइन उपकरण है।
4. NUnit - इकाई परीक्षण।

जो लोग नोटपैड ++ के तहत प्लगइन्स लिखने का तरीका जानने में रुचि रखते हैं, उनके लिए बिल्ली का स्वागत है।

प्लगिन इनिशियलाइज़ेशन

नोटपैड ++ के साथ सहभागिता Win32 संदेशों के माध्यम से होती है। लेकिन, सौभाग्य से, सभी संदेशों, वर्गों और संरचनाओं के साथ एक तैयार-निर्मित प्लग-इन टेम्पलेट ( NppPlugin.NET.v0.5 ) पहले से ही .NET के तहत लिखा गया है। यह ध्यान देने योग्य है कि प्लेटफार्म टैग को डिफ़ॉल्ट रूप से किसी भी सीपीयू के बजाय x86 में स्थापित करने की आवश्यकता है, और .NET 4.0 का भी उपयोग करें, अन्यथा प्लगइन काम नहीं करेगा।

प्लगइन CommandMenuInit और SetToolBarIcon विधियों में आरंभिक है । पहला आइटम इस प्रकार है जो प्लगइन मेनू में दिखाई देगा:

PluginBase.SetCommand(OpenCommandId, "Open Gist", OpenGistCommand, new ShortcutKey(false, false, false, Keys.None)); 

वहां आप कुछ आदेशों के लिए कुंजी संयोजन भी दे सकते हैं (वे विकसित प्लगइन में उपयोग नहीं किए जाते हैं)।

OpenGistCommand विधि पहले से ही डेवलपर द्वारा वर्णित है, और आप पहले से ही इसमें कुछ भी कर सकते हैं। इस कमांड के लिए - एक विंडो खोलना।

SetToolBarIcon विधि में, आप नोटपैड ++ टूलबार में प्लगइन कमांड के साथ आइकन जोड़ सकते हैं।

 toolbarIcons tbIcons = new toolbarIcons(); tbIcons.hToolbarBmp = tbLoad.GetHbitmap(); IntPtr pTbIcons = Marshal.AllocHGlobal(Marshal.SizeOf(tbIcons)); Marshal.StructureToPtr(tbIcons, pTbIcons, false); Win32.SendMessage(PluginBase.nppData._nppHandle, NppMsg.NPPM_ADDTOOLBARICON, PluginBase._funcItems.Items[OpenCommandId]._cmdID, pTbIcons); Marshal.FreeHGlobal(pTbIcons); 

सेटिंग सहेजना और लोड करना

प्लग-इन मापदंडों को सहेजने और लोड करने के लिए, निम्नलिखित विधियों का उपयोग किया जाता है। लाइनों को भी बचाया जा सकता है।

 saveLocally = Convert.ToBoolean(Win32.GetPrivateProfileInt("Settings", "saveLocally", 1, IniFileName)); ... Win32.WritePrivateProfileString("Settings", "SaveLocally", (Convert.ToInt32(saveLocally)).ToString(), Main.IniFileName); 

नोटपैड ++ में निष्पादन कमांड

वास्तव में, नोटपैड ++ सिंटिला घटक का उपयोग करता है, जिसका उपयोग अन्य पाठ संपादकों में भी किया जाता है। इस प्रकार, बातचीत के लिए संदेश नोटपैड ++ और सिंटिला में विभाजित हैं। संदेशों के सभी संभावित कोड NppPluginNETHelper.cs फ़ाइल में सूचीबद्ध हैं। नोटपैड ++ संदेशों में एनपीपीएम उपसर्ग होता है और इसका उपयोग फ़ाइलों, मेनू, टैब, भाषाओं आदि के साथ काम करने से संबंधित कमांड के लिए किया जाता है। बदले में, सिंटिला संदेश सीधे पाठ संपादक (सम्मिलित करें, हटाएं, हाइलाइट, दृश्य शैलियों, तह, स्क्रॉलिंग, आदि) से संबंधित हैं।

नोटपैड ++ घटना हुक

नोटपैड ++ में ईवेंट संदेशों को इंटरसेप्ट करने के लिए, UnmanagedExports.cs फ़ाइल में नोटिफाइड विधि का उपयोग किया जाता है । ये संदेश नोटपैड ++ इवेंट्स के लिए एनपीपीएन के साथ उपसर्ग किए गए हैं (एक फ़ाइल को बंद करना, टैब स्विच करना) और एससीएन को सिंटिला इवेंट्स (टेक्स्ट को बदलना) के लिए। सच है, इस प्लगइन का उपयोग नहीं किया जाता है।

नोटपैड ++ कमांड की एक पूरी सूची और विस्तृत विवरण यहां है: संदेश और सूचनाएं । और यहां सिंटिला के लिए: सिंटिलाडोक ।

नोटपैड ++ से सही ढंग से UTF8 टेक्स्ट प्राप्त करना

किसी कारण से, .NET प्लगइन शेल में UTF8 प्रारूप में पाठ प्राप्त करना असंभव है, हालांकि यह एन्कोडिंग सबसे आम है। इसलिए, निम्नलिखित संपत्ति को जोड़ा गया, जिसने रूसी पाठ सहित सही ढंग से पढ़ने के लिए संभव बना दिया, जिसका उपयोग हिस्ट को बचाने के लिए किया जाता है।

 public string lpstrTextUtf8 { get { _readNativeStruct(); int len = 0; while (Marshal.ReadByte(_sciTextRange.lpstrText, len) != 0) ++len; if (len == 0) return string.Empty; byte[] buffer = new byte[len]; Marshal.Copy(_sciTextRange.lpstrText, buffer, 0, buffer.Length); return Encoding.UTF8.GetString(buffer); } } 

विधानसभाओं का निर्माण

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

तो, इतना है कि प्लगइन केवल एक dll लेता है, तृतीय-पक्ष असेंबलियों को एंबेडेड संसाधन के रूप में चिह्नित किया जाता है, और फिर इसे गतिशील रूप से जोड़ा जाता है:

 static Main() { AppDomain.CurrentDomain.AssemblyResolve += ResolveEventHandler; } private static Assembly ResolveEventHandler(object sender, ResolveEventArgs args) { string resource = string.Format("{0}.{1}.dll", PluginName, args.Name.Remove(args.Name.IndexOf(','))); Assembly currentAssembly = Assembly.GetExecutingAssembly(); using (Stream stream = currentAssembly.GetManifestResourceStream(resource)) { var bytes = new byte[(int)stream.Length]; stream.Read(bytes, 0, (int)stream.Length); return Assembly.Load(bytes); } } 

कोडप्रोजेक्ट लेख में यह कैसे किया जाता है इसके बारे में अधिक पढ़ें: एंबेडेड संसाधन से DLL लोड करें ।

बेशक , आप एक उदाहरण के लिए विधानसभाओं को एक में सम्मिलित करने के लिए एक तृतीय-पक्ष कार्यक्रम का उपयोग कर सकते हैं, उदाहरण के लिए, लेकिन प्रत्येक निर्माण के बाद इसे लागू करना होगा।

यह ध्यान देने योग्य है कि, चूंकि ServiceStack.Text एक NuGet असेंबली है और रिपॉजिटरी को क्लोन करने के बाद पहली बिल्ड के दौरान लोड किया गया है, हमने इसे NppGist प्रोजेक्ट के रूट फ़ोल्डर में कॉपी करने के लिए Prebuild इवेंट का उपयोग किया।

जीठूब आपी

GitHub Api के साथ बातचीत के कार्यान्वयन में कुछ भी दिलचस्प नहीं है, जब तक कि यह उल्लेखनीय है कि AccessToken को प्राधिकरण के लिए उपयोग किया जाता है, जो साइट पर प्राप्त किया जा सकता है, जो तब access_oken पैरामीटर के रूप में सभी अनुरोधों में प्रेषित होता है। विकसित प्लगइन में अनाम इतिहास समर्थित नहीं हैं। उपयोग की जाने वाली एपीआई विधियों की एक पूरी सूची यहां सूचीबद्ध है: जीथब जिस्ट आपी ।

निष्कर्ष

हिस्टोग्राम सेव विंडो इस तरह दिखती है (उद्घाटन विंडो समान है):


लेकिन सबसे पहले आपको अपना एक्सेस टोकन डालना होगा।

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