उबंटू के लिए एकता लेंस बनाने का आसान तरीका (अनुवाद)

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

आवश्यकताओं

इसलिए, एक लेंस बनाने के लिए, हमें आवश्यकता है:

* Ubuntu 12.04 LTS - उबंटू प्राप्त करें >
* जल्दी - जल्दी मुक्त स्थापित करें >
* जल्दी लेंस टेम्पलेट - सेट जल्दी लेंस टेम्पलेट >

लेंस बनाना

शुरू करने के लिए, आइए एक लेंस लिखें जो विकिपीडिया लेखों के बीच खोज करता है। एक लेंस बनाना एक सरल कदम से शुरू होता है - एक प्रोजेक्ट बनाना। ऐसा करने के लिए, Ctrl + Alt + T दबाएं और दिखाई देने वाली टर्मिनल विंडो में, निम्न कमांड दर्ज करें:

quickly create unity-lens wikipedia cd wikipedia 

चलो शुरू हो जाओ!

 quickly edit 

यह कमांड आपके डिफ़ॉल्ट टेक्स्ट एडिटर में तीन फाइलें खोलेगी, हम केवल __init__.py में रुचि रखते हैं

पहली चीज जो हमें चाहिए वह है मेटा क्लास। इसमें हमारे लेंस का विवरण होता है। देखें:

     class Meta:    name = 'Wikipedia'    description = 'Wikipedia Lens'    search_hint = 'Search Wikipedia'    icon = 'wikipedia.svg'    search_on_blank=True 

शुरू करने के लिए, चूंकि हम एक साधारण लेंस बनाते हैं, इसलिए यहां सब कुछ अपरिवर्तित रह सकता है।

लेंस को विभिन्न प्रकार के परिणामों को नेत्रहीन रूप से अलग करने के लिए श्रेणियों की आवश्यकता होती है। विकिपीडिया के लिए, हमें केवल एक श्रेणी चाहिए, जिसे हम "लेख" कहेंगे
मेटा क्लास के बाद, हम कोड की निम्न पंक्तियाँ देखते हैं:

     example_category = ListViewCategory("Examples", 'help') 

हम इसे अपनी आवश्यकताओं के लिए संशोधित करेंगे।
* सबसे पहले, हम श्रेणी का नाम बदलकर articles_category करेंगे
* फिर, हमारे पास एक श्रेणी के भीतर परिणामों की विभिन्न प्रस्तुति के लिए ListView और IconView के बीच एक विकल्प है। हम चुनते हैं: सूची दृश्य
* हमें अपनी श्रेणी के लिए एक प्रदर्शन नाम भी देना होगा। सरल: लेख
* और अंत में, हमें अपनी श्रेणी के लिए एक आइकन का चयन करने की आवश्यकता है और हम इसे सिस्टम के कार्यक्षेत्र से ले जाएंगे, अर्थात्: संवाद-सूचना-प्रतीकात्मक
नतीजतन, हमें लाइन मिलती है:

     articles_category = ListViewCategory("Articles", "dialog-information-symbolic") 

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

     def search(self, search, results):    # TODO: Add your search results    results.append('https://wiki.ubuntu.com/Unity/Lenses/Singlet',    'ubuntu-logo',    self.example_category,    "text/html",    'Learn More',    'Find out how to write your Unity Lens',    'https://wiki.ubuntu.com/Unity/Lenses/Singlet')    pass 

... लेकिन हम विकिपीडिया से पूछना चाहते हैं ...

विकिपीडिया खोज

चलो एक नया फ़ंक्शन बनाते हैं जिसे खोज करने के लिए डिज़ाइन किया गया है। हम इसे निम्नानुसार करेंगे।

हम अपने फ़ंक्शन को wikipedia_query कहेंगे। यह तर्क के रूप में उपयोगकर्ता से खोज स्ट्रिंग लेगा। हम अपनी आवश्यकताओं के लिए दो और पायथन मॉड्यूल भी लेंगे: विकिपीडिया से डेटा को संसाधित करने के लिए नेटवर्क और सिम्पलसन के लिए HTTP अनुरोध भेजने के लिए urllib2।

हमारी फ़ाइल की शुरुआत में, हम आयात कमांड का उपयोग करके आवश्यक मॉड्यूल कनेक्ट करते हैं

     import urllib2    import simplejson 

फिर, हमारे मुख्य वर्ग विकिपीडिया (सिंगलस्कॉपलेंस) वर्ग में, हम विकि चर जोड़ते हैं, जो हमारे कोड को सरल करेगा:

     wiki = "http://en.wikipedia.org" 

और एक फंक्शन बनाएं

     def wikipedia_query(self, search): 

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

     search = search.replace(" ", "|") 

हम खुले विकिपीडिया एपीआई का उपयोग करके अपना अनुरोध बनाते हैं।

     url = ("%s/w/api.php?action=opensearch&limit=25&format=json&search=%s" % (self.wiki, search)) 

और हम परिणाम को परिणाम चर, जो कि json में स्थित है, इसके लिए हम simplejson मॉड्यूल का उपयोग करते हैं

     results = simplejson.loads(urllib2.urlopen(url).read()) 

हम डिबग आउटपुट को यह समझने के लिए जोड़ते हैं कि हम क्या कर रहे हैं:

     print "Searching Wikipedia for %s" % (search) 

और हम परिणाम के अनुसार कार्य करके अपने कार्य को पूरा करते हैं

     return results[1] 

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

     def wikipedia_query(self,search):    try:    search = search.replace(" ", "|")    url = ("%s/w/api.php?action=opensearch&limit=25&format=json&search=%s" % (self.wiki, search))    results = simplejson.loads(urllib2.urlopen(url).read())    print "Searching Wikipedia"    return results[1]    except (IOError, KeyError, urllib2.URLError, urllib2.HTTPError, simplejson.JSONDecodeError):    print "Error : Unable to search Wikipedia"    return [] 

अब हमें नए लिखित फ़ंक्शन को लंबे समय से मौजूद खोज से कनेक्ट करना होगा

     def search(self, search, results):    for article in self.wikipedia_query(search):    results.append("%s/wiki/%s" % (self.wiki, article),    "http://upload.wikimedia.org/wikipedia/commons/6/63/Wikipedia-logo.png",    self.articles_category,    "text/html",    article,    "Wikipedia Article",    "%s/wiki/%s" % (self.wiki, article))    pass 

यह कुछ इस तरह से काम करता है: खोज क्वेरी विकिपीडिया_क्वरी में आती है, विकिपीडिया पर भेजी जाती है, JSON में प्रतिक्रिया को wikipedia_query पर लौटाया जाता है, खोज के लिए पास किया जाता है और लेंस में प्रदर्शित किया जाता है। परिणामों में क्या हो रहा है यह समझने के लिए। लेंस में आउटपुट को देखना बहुत महत्वपूर्ण है। इसे टेम्प्लेट द्वारा एकता के लिए पारित किया गया है:

     results.append (url,    icon,    category,    mime-type,    text,    comment,    drag and drop url) 

वह सब हो गया!

लेंस का उपयोग करें

अब सबसे लंबे समय से प्रतीक्षित क्षण आ गया है - हम लेंस का उपयोग करना शुरू कर रहे हैं!
हम टर्मिनल में कमांड दर्ज करते हैं:

 sudo quickly install quickly run 

लेंस स्थापना

लेंस के सफलतापूर्वक परीक्षण और डिबगिंग के बाद, इसे सिस्टम में स्थायी रूप से स्थापित किया जा सकता है। ऐसा करने के लिए, मैं इसकी आंतरिक संरचना के बारे में संक्षेप में बात करूंगा। एक लेंस को इसके संचालन के लिए कम से कम तीन फ़ाइलों की आवश्यकता होती है: लेंस के बारे में बुनियादी जानकारी वाली एक .lens फ़ाइल; एक निष्पादन योग्य फ़ाइल (डेमॉन) जो सभी काम करती है और एक .service फ़ाइल जिसमें लेंस का नाम और निष्पादन फ़ाइल का पथ होता है। सिस्टम पर उन्हें स्थापित करने के लिए, प्रोजेक्ट फोल्डर में setup.py फ़ाइल बनाई गई थी
मैंने स्थापना के लिए निम्न आदेशों का उपयोग किया:

 chmod 777 setup.py ./setup.py build sudo ./setup.py install 

संदर्भ

* लेंस की संरचना और उनके निर्माण (रस) पर एक विस्तृत लेख पढ़ें ।
* एकता और संबंधित प्रौद्योगिकियों के बारे में अधिक जानें ।
* एकता लेंस के बारे में अधिक जानें ।
* एकता एपीआई
* विकिपीडिया खुलने का समय एपीआई
* इस गाइड के लिए बने लेंस
* डैश के लिए लेंस का चयन