Windows Live Writer Support (Meta Weblog API) को Django Blog में जोड़ें

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



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

तो हमें क्या चाहिए? के साथ शुरू करने के लिए, एक XML-RPC सर्वर (MetaWeblog API XML-RPC पर आधारित है)। पायथन के डिफ़ॉल्ट पैकेज में xmlrpclib शामिल है, जो पर्याप्त हो सकता है, लेकिन मुझे यह प्रतीत होता है कि Django के साथ सीधे संपर्क करने वाला सर्वर अधिक सुविधाजनक था। खोज के कुछ समय बाद, django-xmlrpc पाया गया - एक सुविधाजनक सर्वर - एक XML-RPC अनुरोध प्रोसेसर। यहां हम इसका इस्तेमाल करेंगे। स्थापना सरल है, और प्रश्न पैदा नहीं करना चाहिए। स्थापना के अंत में, http: // डोमेन / xmlrpc पर / आप पंजीकृत विधियों की सूची देख सकते हैं। मुख्य सेटिंग एक चर है
XMLRPC_METHODS, जिसकी परिभाषा सेटिंग में कहीं रखी जानी चाहिए, और यह कारतूस का एक कार्ट है, जिसमें फंक्शन का रास्ता होता है - हैंडलर, और विधि का नाम। उदाहरण के लिए:

XMLRPC_METHODS = (('myproject.myapp.views.get_users_blogs', 'blogger.getUsersBlogs'),) 

इस प्रकार, हमने blogger.getUsersBlogs नामक एक विधि पंजीकृत की, जिसके लिए फ़ंक्शन हैंडलर है। क्योंकि हमें भविष्य में ठीक उसी नाम के साथ एक विधि की आवश्यकता होगी - मेरा सुझाव है कि आप इसे भी पंजीकृत करें।

अब हम निर्दिष्ट पते पर सीधे कार्य करते हैं। डिफ़ॉल्ट रूप से, मेटा वेबलॉग एपीआई में कई तरीके हैं जिन्हें आपको लागू करने की आवश्यकता होगी, और विशेष रूप से:

• metaebeblog.newPost ()
• metaWeblog.getPost ()
• metaebeblog.editPost ()
• metaWeblog.getCategories ()
• metaWeblog.getRecentPosts ()
• metaebeblog.newMediaObject ()

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

• blogger.getUserBlogs ()
• blogger.deletePost ()
• blogger.getUserInfo ()

लेकिन अगर अंतिम दो की आवश्यकता होती है, और अभी तक वैकल्पिक है, तो पहले विंडोज लाइव राइटर के बिना बस अपनी साइट को पंजीकृत करने से इनकार करते हैं। यह इस कारण से है कि हम blogger.getUserBlogs () से शुरू करेंगे। और इसलिए - यहां हैंडलर का फ़ंक्शन कोड है:

 from django_xmlrpc.decorators import xmlrpc_func @xmlrpc_func(returns='string', args=['string', 'string', 'string',]) def get_users_blogs(appKey, username, password): user = u_authenticate(username, password) return [{'isAdmin': user.is_superuser, 'url': 'http://127.0.0.1:8000/', 'blogid': '1', 'blogName': 'MyWebBlog'}] 

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

फ़ंक्शन स्वयं 3 पैरामीटर लेता है:

1. appKey - अनुप्रयोग की एक अद्वितीय कुंजी - ग्राहक, हम इसका उपयोग नहीं करेंगे।
2. उपयोगकर्ता नाम - सेवा में उपयोगकर्ता नाम
3. पासवर्ड - उपयोगकर्ता पासवर्ड, क्रमशः।

U_authenticate फ़ंक्शन डेटाबेस से उपयोगकर्ता को लौटाता है, यदि कोई हो, डेटाबेस में और पासवर्ड सही है। आप अपनी सत्यापन आवश्यकताओं के आधार पर इस तरह के एक समारोह को स्वयं लिख सकते हैं, लेकिन आप जो मेरे पास हैं उसका उपयोग कर सकते हैं:

 from xmlrpclib import Fault def u_authenticate(username, password): try: user = User.objects.get(username__exact=username) except User.DoesNotExist: raise Fault('1', 'Username is incorrect.') if not user.check_password(password): raise Fault('1', 'Password is invalid.') if not user.is_staff or not user.is_active: raise Fault('2', 'User account unavailable.') return user 

दोष XML-RPC त्रुटि उत्पन्न करता है, जिसका पहला पैरामीटर त्रुटि कोड (मनमाना, आपके विवेक पर), और इसका पाठीय प्रतिनिधित्व है। यह कोड और पाठ है जो क्लाइंट एप्लिकेशन समस्याओं के मामले में दिखाएगा।

चलिए हमारे get_users_blogs फ़ंक्शन पर लौटते हैं, और डेटा इसमें वापस लौटता है। जैसा कि हम देख सकते हैं, यह एक सूची है जिसमें निम्नलिखित तत्वों के साथ एक शब्दकोश है:

1. isAdmin - इंगित करता है कि उपयोगकर्ता प्रशासक है या नहीं।
2. url - सीधे नेटवर्क पर अपने ब्लॉग का पता
3. ब्लॉगिड सेवा में आपके ब्लॉग की विशिष्ट आईडी है। आपकी साइट पर कई ब्लॉग होने की स्थिति में यह आवश्यक है। यदि आपके पास केवल एक है, तो कोई भी संख्या पर्याप्त है, उदाहरण के लिए, शून्य।
4. ब्लॉगनाम - आपके ब्लॉग का नाम, क्लाइंट एप्लिकेशन में एक नाम के रूप में उपयोग किया जाएगा।

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

यह वास्तव में सभी है। आप पहले से ही विंडोज लाइव राइटर में एक ब्लॉग को जोड़ने की कोशिश कर सकते हैं, कुछ को निर्दिष्ट कर सकते हैं जैसे http://127.0.0.1:8000/xmlrpc/ इंटरेक्शन के लिए पते के रूप में, और मेटा वेबलॉग एपीआई एक इंटरफेस के रूप में। यदि सब कुछ सही ढंग से किया जाता है, तो विंडोज लाइव राइटर स्वयं के साथ ब्लॉग को पंजीकृत करेगा, और प्रकाशन से पहले पूर्वावलोकन फ़ंक्शन के लिए ब्लॉग (एचटीएमएल, सीएसएस) के दृश्य विषय को डाउनलोड करने की भी पेशकश करेगा, लेकिन अब हमें मना करना होगा - विषय निर्धारित करने के लिए, विंडोज राइटर एक अस्थायी ब्लॉग प्रकाशित करता है रिकॉर्ड, जबकि रिकॉर्ड के प्रकाशन के लिए विधि metaWeblog.newPost () अभी तक हमारे साथ लागू नहीं हुई है। खैर, हम किसका इंतजार कर रहे हैं?

इसी तरह, सबसे पहले, XMLRPC_METHODS में एक विधि जोड़ें:

 ('myproject.myapp.views.new_post', 'metaWeblog.newPost') 

अब समारोह शुरू करते हैं - हैंडलर:

 from datetime import datetime @xmlrpc_func(returns='string', args=['string', 'string', 'string', 'struct', 'boolean']) def new_post(blog_id, username, password, post, publish): user = u_authenticate(username, password) item = News() item.title = post['title'] item.text_news = post['description'] if post.get('dateCreated'): item.date = datetime.strptime(str(post['dateCreated']), '%Y%m%dT%H:%M:%S') else: item.date = datetime.now() item.author = user item.public = publish item.save() return item.pk 

कोड भी बहुत सरल है, लेकिन मैं सिर्फ मामले में टिप्पणी करूंगा:
पहले तीन स्वीकृत मूल्य स्पष्ट होने चाहिए, मैं शेष दो पर ध्यान दूंगा:

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

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

आइटम ऑब्जेक्ट को पूरा करने पर, इसे डेटाबेस में संग्रहीत किया जाता है, और फ़ंक्शन आइटम को वापस करता है। pk. यहां यह अधिक विस्तार से रहने के लायक भी है। नईपोस्ट () विधि क्लाइंट को प्रकाशित रिकॉर्ड के विशिष्ट पहचानकर्ता के पास लौटने की आवश्यकता है ताकि भविष्य में संभव संपादन / विलोपन के लिए इस रिकॉर्ड को ढूंढना संभव हो सके। आप आइटम के लिए अद्वितीय पहचानकर्ता के रूप में पीके का उपयोग कर सकते हैं, लेकिन सामान्य तौर पर यह फिर से बहुत अच्छा नहीं है। तथ्य यह है कि पीके अनिवार्य रूप से प्रकाशन के समय डेटाबेस में एक रिकॉर्ड का एक सीरियल नंबर है। अब सोचें कि अगर आप विंडोज लाइव राइटर के माध्यम से रिकॉर्डिंग प्रकाशित करते हैं तो क्या होता है, तो इसे Django व्यवस्थापक पैनल में हटा दें, इससे एक नई रिकॉर्डिंग पोस्ट करें, और फिर विंडोज लाइव राइटर के माध्यम से हटाए गए रिकॉर्डिंग को फिर से प्रकाशित करने का प्रयास करें? लेकिन एक साधारण बात होगी: विंडोज लाइव राइटर को यह पता नहीं है कि प्रकाशन के क्षण से रिकॉर्ड पहले ही हटा दिया गया था, और दूसरा उसके स्थान पर दिखाई दिया, लेकिन पिछले पीके के समान ही। इस प्रकार, व्यवस्थापक पैनल के माध्यम से प्रकाशित एक रिकॉर्ड को कॉर्न फिर से लिखा जाएगा जिसे विंडोज लाइव राइटर से प्रकाशित किया जाएगा। यह स्पष्ट है कि जीवन में आपको हर दिन ऐसी स्थिति से जूझना नहीं पड़ता है, लेकिन फिर भी, यह pk की तुलना में कुछ अधिक अद्वितीय है। फिर भी, पीके प्रदर्शित करने के लिए हमारे पास आंखों के लिए पर्याप्त है।

बस इतना ही, आप विंडोज लाइव राइटर पर जा सकते हैं, और नई प्रविष्टियों को प्रकाशित करने के अवसर का आनंद ले सकते हैं :)।

मैं नीचे metaWeblog.editPost () और blogger.deletePost () विधियों का कार्यान्वयन भी दूंगा। कोड में कुछ विशिष्ट नहीं है, इसलिए मैं इस पर विस्तार से ध्यान नहीं दूंगा।

 @xmlrpc_func(returns='boolean', args=['string', 'string', 'string', 'struct', 'boolean']) def edit_post(post_id, username, password, post, publish): user = u_authenticate(username, password) item = News.objects.get(id=post_id, author=user) item.title = post['title'] item.text_news = post['description'] if post.get('dateCreated'): item.date = datetime.strptime(str(post['dateCreated']), '%Y%m%dT%H:%M:%S') else: item.date = datetime.now().date() item.author = user item.public = publish item.save() return True @xmlrpc_func(returns='boolean', args=['string', 'string', 'string', 'string', 'string']) def delete_post(apikey, post_id, username, password, publish): print post_id user = u_authenticate(username, password) News.objects.get(id=post_id, author=user).delete() return True 

यदि सफल हो तो दोनों कार्य सरल रूप से वापस आ जाते हैं। अब हम अपने ब्लॉग के विषय को बिना किसी समस्या के विंडोज लाइव राइटर में डाउनलोड करने का प्रयास कर सकते हैं - उपरोक्त विधियाँ पर्याप्त हैं।

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