क्यों?

जो कोई भी "फिटिंग" JIRA , कॉन्फ्लुएंस, या खुद के लिए एक और एटलसियन उत्पाद के मुद्दे पर दिलचस्पी रखता है, वह जानता है कि इन उद्देश्यों के लिए एक एटलसियन एसडीके है।

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

यह एक विशेष परियोजना पर काम की ऊंचाई पर, समय की भयावह कमी के साथ, विशेष रूप से निराशाजनक है, क्लाइंट में से एक कंफ्लुएंस में किसी छोटी सी चीज को पेंच करने या JIRA में कुछ लिंक छिपाने के लिए कहता है। और ग्राहकों को इंतजार करने के लिए कहा जाना चाहिए कि उन्हें किस चीज से नाराज होने की आदत है। और समस्या इस तथ्य से बढ़ जाती है कि ग्राहक के पास अक्सर अपने स्वयं के पूर्णकालिक प्रोग्रामर होते हैं, जो दुर्भाग्य से, कुछ भी मदद नहीं कर सकते, क्योंकि उन्हें एटलसियन उत्पादों के लिए प्लगइन्स विकसित करने में ज्ञान नहीं है और यह कुछ दिनों में काम नहीं करता है।

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

स्पीकसी, एटलसियन एसडीके के विपरीत, आपको केवल वही अनुकूलित करने की अनुमति देता है जो उपयोगकर्ता देखता है - जावास्क्रिप्ट, मार्कअप या शैलियों को जोड़कर उन्हें पृष्ठ बदलें। लेकिन यह एसडीके का उपयोग करने की तुलना में बहुत आसान है। फ़ायरफ़ॉक्स ऐड-ऑन Greasemonkey कुछ ऐसा ही करता है, लेकिन यहां हम एक ब्राउज़र तक सीमित नहीं हैं और विशेष रूप से उपयोगकर्ता को कुछ और स्थापित करने के लिए मजबूर नहीं करते हैं।

इसकी जरूरत किसे है?

हालाँकि यह स्पीकसी को एक जन तकनीक कहलाने के लिए लुभा रहा है, जो किसी भी उपयोगकर्ता को JIRA और Confluence को अनुकूलित करने की अनुमति देगा, जाहिर है कि यह पूरी तरह सच नहीं है। ज्यादातर मामलों में (लेकिन हमेशा नहीं), आपको बुनियादी जावास्क्रिप्ट प्रोग्रामिंग कौशल और एचटीएमएल + सीएसएस लेआउट की आवश्यकता होगी। लेकिन इसके लिए आपको एटलसियन एसडीके पर डॉक पढ़ने की आवश्यकता नहीं है! और यह, एक मिनट के लिए, अंग्रेजी में सैकड़ों दिलचस्प और पेचीदा पृष्ठ।

इसलिए, उन लोगों के बीच जो स्पीकसी से लाभ प्राप्त कर सकते हैं, मैं रैंक करूंगा:

• डेवलपर्स, और इससे भी अधिक वेब डेवलपर्स। बिना किसी अतिरिक्त प्रशिक्षण के ये लोग लगभग तुरंत, स्पीकसी का उपयोग करके एक्सटेंशन बनाना शुरू कर सकते हैं।
• व्यवस्थापकों। व्यवस्थापक, अक्सर यह भी जानते हैं कि कैसे प्रोग्राम करना है और अपने पसंदीदा उपयोगकर्ताओं के लिए किसी प्रकार का विस्तार करने में सक्षम होगा। और यह देखते हुए कि स्पीकसी का उपयोग करते समय, उपयोगकर्ता स्वयं तय करते हैं कि किसी एक्सटेंशन का उपयोग करना है या नहीं, हमें उनकी परस्पर अनन्य इच्छाओं के बीच पैंतरेबाज़ी करने के लिए एक बड़ी जगह मिलती है।
• डेवलपर के वाक्यांश के बाद प्रबंधक अब दुखी नहीं होंगे "हाँ, मैं ऐसा काम करूंगा, लेकिन एसडीके को सीखने में दो सप्ताह लगेंगे और मैं एक और महीने के लिए प्रयोग करूंगा", और एक स्पष्ट (या लगभग साफ) विवेक के साथ वे कहेंगे "आपको कुछ भी सीखने की ज़रूरत नहीं है!" जाओ ठीक है, प्रिय!

और तुरंत लड़ाई के लिए!

चलो खरोंच से कुछ सरल लेकिन उपयोगी एक्सटेंशन बनाते हैं। सभी उदाहरण Confluence 3.5 के रूप में हैं नवीनतम संस्करण 4.0 अभी तक लोगों के लिए इतना नहीं गया है। लेकिन निम्नलिखित में से लगभग सभी 4 वें संस्करण के लिए पर्याप्त होंगे। तदनुसार, जेआईआरए के विस्तार के विकास में कोई बुनियादी अंतर नहीं होगा।

उदाहरण 0, जो कि एक उदाहरण नहीं है - स्पीकिंग इंस्टालेशन

इसके साथ शुरू करने के लिए, आपको सर्वर पर स्पीकसी को स्थापित करने और आवश्यक अधिकारों को वितरित करने के लिए व्यवस्थापक की आवश्यकता है।

स्पीकसी एक्सचेंज में ताज़े और बहुत नहीं संस्करणों को वितरित किया जाता है और इसी मावेन भंडार में ।

प्लगइन स्थापित होने के बाद, आपको यह तय करना चाहिए कि कौन से उपयोगकर्ता समूहों को अपना एक्सटेंशन बनाने का अधिकार होगा, और कौन से उपयोगकर्ता समूह अपने लिए इन एक्सटेंशनों को शामिल कर पाएंगे (प्रशासन - प्लगइन्स - प्रबंधित मौजूदा - स्पीसी प्लगिन - कॉन्फ़िगर करें)।

यह अलग से ध्यान दिया जाना चाहिए कि डिफ़ॉल्ट रूप से, व्यवस्थापक को Speakeasy पर एक्सटेंशन शामिल करने की अनुमति नहीं है। यह स्पष्ट रूप से सुरक्षा कारणों से किया जाता है। लेकिन परीक्षण प्रणाली पर, "प्रशासकों को एक्सटेंशन सक्षम करने की अनुमति दें" सेटिंग चालू की जा सकती है।

उदाहरण 1 - ऐतिहासिक

इस उदाहरण में, हम पृष्ठ के इतिहास के लिंक को एक प्रमुख स्थान पर जोड़ देंगे ताकि ड्रॉप-डाउन मेनू में हर बार इसके पीछे क्रॉल न किया जा सके।

हम Speakeasy एक्सटेंशन वाले पेज पर जाते हैं।

इंस्टॉल लिंक पर क्लिक करें और दिखाई देने वाले संवाद में, विज़ार्ड के उपयोग का चयन करें, और विज़ार्ड में ही, एक्सटेंशन, उसके नाम और विवरण के लिए एक अद्वितीय पहचानकर्ता दर्ज करें।

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

हम main.js फ़ाइल में रुचि रखते हैं, क्योंकि इसमें जावास्क्रिप्ट में मुख्य तर्क होना चाहिए।

/** * @context page */ var $ = require('speakeasy/jquery').jQuery; $(document).ready(function() { var href = $('a#action-view-history-link').attr('href'); $('a#view-change-link').after(", <a href='"+ href +"'>view history</a>"); }); 

ऐसी लाइनें लिखना किसी के लिए भी मुश्किल नहीं होगा जो JS और jQuery को जानते हैं, लेकिन जो जावास्क्रिप्ट के साथ दोस्त नहीं हैं, वे Google का उपयोग करके समान कोड लिख सकते हैं। अलग-अलग, मैं केवल टिप्पणियों में "@context पेज" प्रविष्टि का उल्लेख करता हूं। यह इंगित करता है कि इस स्क्रिप्ट को किस संदर्भ (पढ़ें, पृष्ठ प्रकार) में चलाया जाना चाहिए। अब हम केवल विकि पृष्ठों में रुचि रखते हैं, और इस पृष्ठ पर संदर्भों की एक सूची मिल सकती है।

और परिणाम के रूप में हमें यहाँ मिलता है:

उदाहरण 2 - सूचनात्मक

मानक UI में कुछ को संशोधित करना बहुत अच्छा है, और इससे भी बेहतर जब हम संशोधित UI को कुछ नई जानकारी से भर सकते हैं।

जानकारी के लिए, आप JavaScript / JQuery - REST, SOAP, XML-RPC सभी सुविधाओं का उपयोग कर सकते हैं। सौभाग्य से, Confluence और JIRA में ऐसे इंटरफेस हैं ।

आइए सबसे सरल आरईएसटी-इंटरफ़ेस का उपयोग करने का प्रयास करें, जिस पर आप केवल विभिन्न संस्थाओं के बारे में जानकारी प्राप्त कर सकते हैं। हम अनुरोध करते हैं कि पृष्ठ को अंतिम संपादन की तारीख के बगल में इसे मानक कॉन्फ्लुएंस इंटरफेस में व्यवस्थित करने के लिए बनाया गया था।

इस मामले में कोड इस तरह दिखता है:

 /** * @context page */ var $ = require('speakeasy/jquery').jQuery; $(document).ready(function() { var pageId = $('input#pageId').attr('value'); var serviceUrl = '/rest/prototype/1/content/' + pageId + '.json'; $.getJSON( serviceUrl, function(data) { $('li.page-metadata-modification-info a:first').after(" on " + data.createdDate.friendly); }); }); 

और यहाँ संशोधित UI है:

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

उदाहरण 3 - समय का पाबंद

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

ऐसा करने के लिए, एक्सटेंशन के अंदर वेब-आइटम.जसन फ़ाइल होती है, जिसमें आपके द्वारा आवश्यक मेनू आइटम का वर्णन होता है। चलो सीधे उदाहरण के लिए चलते हैं:

 [ { "section" : "system.content.action/primary", "label" : "Revert", "url" : "", "cssName" : "stiltsoft-web-item", "weight" : 25 } ] 

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

आइटम को खुद को जल्दी से पिछले पृष्ठ संशोधन में वापस लाने की आवश्यकता है, और जावास्क्रिप्ट कोड, तदनुसार, इस संशोधन की संख्या की गणना करता है:

 /** * @context atl.general */ var $ = require('speakeasy/jquery').jQuery; $(document).ready(function() { var pageId = $('input#pageId').attr('value'); var revision = $("meta[name='page-version']").attr('content'); $('a.revert-web-item').attr('href','/pages/revertpagebacktoversion.action?pageId='+pageId+'&version='+(revision-1)); }); 

यह आइटम इस तरह दिखता है:

उदाहरण 4 - इंटरएक्टिव

SpeakEasi Developers सुंदर इंटरफेस बनाने के लिए प्रेमियों के बारे में नहीं भूलते थे। Speakeasy में ही OpenOnePanelDialog पद्धति का उपयोग करके, Confluence / JIRA की शैली में एक सुंदर संवाद बनाने की क्षमता शामिल है। यह कोड में कैसा दिखता है:

 /** * The main module * * @context atl.general */ var $ = require('speakeasy/jquery').jQuery; var dialog = require('speakeasy/dialog'); $(document).ready(function() { $('span#title-text').after("<span class='stiltsoft-source'><a href='#' id='stiltsoft-view-source'>View source</a></span>"); $('a#stiltsoft-view-source').click(function(){ var url=$('a#action-view-source-link').attr('href'); $.get(url,function(data){ dialog.openOnePanelDialog( { 'header':'Page source', 'content':$(data).find('div#content'), 'submitLabel':'OK', 'cancelClass':'stiltsoft-cancel', 'submit':function(dialog,callback){ callback.success(); } }); } ); return false; }); }); 

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

कुछ इस तरह, यह स्क्रीन पर दिखता है:

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

इस तकनीक में तुरंत "डुबकी" लगाने के लिए, मैं आपको एयूआई डेमो , एयूआई सैंडबॉक्स की यात्रा करने और वहां के तत्वों के साथ थोड़ा खेलने की सलाह देता हूं।

उदाहरण 5 - जादू

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

और, बेशक, एक बार देखना बेहतर है। डेवलपर्स से वीडियो:

आगे क्या है?

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