Opens in a new tab

Sharp Diagrams: Confluence और Jira के लिए Mermaid डायग्राम

डायग्राम को टेक्स्ट के रूप में लिखें और Confluence पेज व Jira टिकट में साफ़, ज़ूम करने लायक ड्रॉइंग पाएं। दो ऐप, हर प्रोडक्ट के लिए एक, जल्द ही Atlassian Marketplace पर आ रहे हैं।

डॉक्यूमेंटेशन पढ़ें (अंग्रेज़ी में)सपोर्ट (अंग्रेज़ी में)Confluence पेज पर Sharp Diagrams का बनाया Mermaid फ़्लोचार्ट

Sharp Diagrams क्या है?

Sharp Diagrams टेक्स्ट से Mermaid डायग्राम बनाता है: Confluence में पेज पर मैक्रो के रूप में और Jira में टिकट के पैनल में। Mermaid एक टेक्स्ट फ़ॉर्मैट है, जिसमें फ़्लोचार्ट, सीक्वेंस डायग्राम, गैंट चार्ट और दूसरे डायग्राम लिखे जाते हैं।

दो ऐप हैं और दोनों में एक ही डायग्राम इंजन है। Sharp Diagrams – Mermaid for Confluence एडिटर और लाइव प्रीव्यू वाला डायग्राम मैक्रो जोड़ता है। Sharp Diagrams – Mermaid for Jira टिकट के विवरण में मौजूद mermaid कोड ब्लॉक को एक पैनल में डायग्राम के रूप में बनाता है। जिस प्रोडक्ट का आप इस्तेमाल करते हैं, उसका ऐप इंस्टॉल करें, या दोनों।

कोई भी डेटा Atlassian से बाहर नहीं जाता। ये ऐप Atlassian के Forge प्लेटफ़ॉर्म पर चलते हैं, इनका कोई बाहरी कनेक्शन नहीं है और ये अपना कुछ भी सेव नहीं करते: डायग्राम का कोड आपके Confluence पेज या Jira टिकट में ही रहता है।

Confluence और Jira में Mermaid डायग्राम कैसे जोड़ें?

सभी डायग्राम टाइप और उन्हें लिखने का तरीका Mermaid के अपने डॉक्यूमेंटेशन में है: mermaid.js.org (अंग्रेज़ी में)।

Confluence

  1. पेज एडिट करें, /mermaid टाइप करें और Mermaid diagram चुनें।
  2. बाईं ओर Mermaid कोड लिखें, या Start from से कोई टेम्पलेट चुनें।
  3. दाईं ओर का प्रीव्यू टाइप करते समय अपडेट होता है। अगर कोड में गलती है, तो एरर मैसेज और लाइन नंबर कोड के नीचे दिखते हैं।
  4. Save चुनें और पेज पब्लिश करें। बाद में डायग्राम बदलने के लिए पेज एडिट करें, डायग्राम चुनें और एडिट (पेंसिल) बटन दबाएं।

Jira

  1. टिकट के विवरण में एक कोड ब्लॉक जोड़ें, उसकी भाषा mermaid चुनें और ब्लॉक में डायग्राम का कोड लिखें।
  2. टिकट खोलें और टिकट के शीर्षक के नीचे ऐप्स बटन से Mermaid diagrams चुनें। इसके बाद पैनल टिकट पर बना रहता है।
  3. विवरण का हर mermaid कोड ब्लॉक पैनल में अलग डायग्राम बन जाता है। विवरण बदलने के बाद नया डायग्राम देखने के लिए टिकट को फिर से लोड करें।

विशेषताएं

टाइप करते समय लाइव प्रीव्यू

बाईं ओर Mermaid कोड लिखें और दाईं ओर डायग्राम देखें। गलती होने पर एरर मैसेज और लाइन नंबर दिखते हैं, और आख़िरी सही डायग्राम दिखता रहता है।

11 तरह के डायग्राम के टेम्पलेट

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

सही साइज़ में साफ़ डायग्राम

डायग्राम पेज या पैनल की चौड़ाई के हिसाब से SVG में बनते हैं और ज़ूम करने पर भी साफ़ रहते हैं। बहुत चौड़ा डायग्राम सिर्फ़ 75 % तक छोटा किया जाता है, ताकि उसका टेक्स्ट पढ़ा जा सके।

ज़ूम, डाउनलोड और कॉपी

50 % से 300 % तक ज़ूम करें और डायग्राम को फिर से चौड़ाई में फ़िट करें। उसे SVG में, या स्लाइड और डॉक्यूमेंट के लिए दोगुने साइज़ के PNG में डाउनलोड करें, या उसका कोड कॉपी करें।

Jira टिकट के विवरण से डायग्राम

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

लाइट और डार्क मोड

डायग्राम Confluence और Jira के कलर मोड के हिसाब से दिखते हैं। डार्क मोड में वे Mermaid की डार्क थीम से बनते हैं।

PDF और Word एक्सपोर्ट

Confluence एक्सपोर्ट अपने सर्वर पर बनाता है, जहां डायग्राम नहीं बनाया जा सकता, इसलिए एक्सपोर्ट में डायग्राम का कोड आता है। डॉक्यूमेंट में ड्रॉइंग डालने के लिए उसे PNG या SVG में डाउनलोड करें।

डेटा Atlassian में ही रहता है

कोई बाहरी कनेक्शन नहीं और अपना कोई स्टोरेज नहीं। Jira में पैनल विवरण को टिकट देखने वाले व्यक्ति की अपनी अनुमतियों से पढ़ता है, इसलिए वह वही दिखाता है जो वह व्यक्ति पहले से देख सकता है।

कीमत

अधिकतम 10 यूज़र

मुफ़्त।

100 यूज़र

250 अमेरिकी डॉलर प्रति वर्ष।

कीमत हर ऐप पर अलग-अलग लागू होती है। बिलिंग Atlassian करता है। ऐप्स प्रकाशित होने के बाद दूसरे यूज़र टियर की कीमतें Atlassian Marketplace पर दिखाई जाएंगी। फ़्री टियर वाले ग्राहकों को भी वही सपोर्ट मिलता है जो पैसे देने वाले ग्राहकों को मिलता है।

स्क्रीनशॉट

Confluence में डायग्राम एडिटर: बाईं ओर Mermaid कोड और दाईं ओर लाइव प्रीव्यूConfluence पेज पर फ़्लोचार्ट, साथ में ज़ूम, डाउनलोड और कोड कॉपी करने का टूलबारडायग्राम एडिटर में चुना गया गैंट टेम्पलेटJira टिकट के विवरण में mermaid कोड ब्लॉक और Mermaid diagrams पैनल में उससे बना डायग्रामJira पैनल का टूलबार और 125 % तक ज़ूम किया गया डायग्रामएक Jira टिकट के विवरण से दो डायग्राम: सीक्वेंस डायग्राम और स्टेट डायग्राम

अक्सर पूछे जाने वाले सवाल

Sharp Diagrams की कीमत क्या है?
10 यूज़र तक यह मुफ़्त है। 100 यूज़र के लिए कीमत 250 अमेरिकी डॉलर प्रति वर्ष है। कीमत हर ऐप पर अलग-अलग लागू होती है, और बिलिंग Atlassian करता है।

क्या मुझे दोनों ऐप चाहिए?
नहीं। Confluence ऐप Confluence पेज पर डायग्राम बनाता है और Jira ऐप Jira टिकट के विवरण से। जिस प्रोडक्ट का आप इस्तेमाल करते हैं, उसका ऐप इंस्टॉल करें, या दोनों।

Sharp Diagrams किन डायग्राम टाइप को सपोर्ट करता है?
Mermaid के डायग्राम टाइप, जैसे फ़्लोचार्ट, सीक्वेंस, क्लास, स्टेट, एंटिटी रिलेशनशिप और गैंट डायग्राम, माइंड मैप, टाइमलाइन, पाई चार्ट, यूज़र जर्नी और Git ग्राफ़। Confluence एडिटर में इन 11 टाइप के टेम्पलेट हैं।

Jira टिकट में डायग्राम कैसे जोड़ें?
टिकट के विवरण में mermaid भाषा वाला कोड ब्लॉक जोड़ें और टिकट पर Mermaid diagrams पैनल खोलें। हर mermaid कोड ब्लॉक अलग डायग्राम बनता है। विवरण बदलने के बाद नया डायग्राम देखने के लिए टिकट को फिर से लोड करें।

क्या PDF और Word एक्सपोर्ट में डायग्राम आते हैं?
एक्सपोर्ट में डायग्राम का कोड कोड ब्लॉक के रूप में आता है, साथ में यह नोट कि ड्रॉइंग पेज पर है। Confluence एक्सपोर्ट अपने सर्वर पर बनाता है, जहां डायग्राम नहीं बनाया जा सकता। डॉक्यूमेंट में ड्रॉइंग डालने के लिए उसे PNG या SVG में डाउनलोड करें।

क्या कोई डेटा Atlassian से बाहर जाता है?
नहीं। ये ऐप Atlassian के Forge प्लेटफ़ॉर्म पर चलते हैं और इनका कोई बाहरी कनेक्शन नहीं है। ये अपना कुछ भी सेव नहीं करते: डायग्राम का कोड आपके Confluence पेज या Jira टिकट में ही रहता है।

क्या डायग्राम के लिंक और HTML चलाए जाते हैं?
नहीं। डायग्राम देखने वाले व्यक्ति के ब्राउज़र में Mermaid के सख़्त सुरक्षा स्तर (strict) के साथ बनते हैं, इसलिए डायग्राम के अंदर के लिंक, क्लिक हैंडलर और HTML नहीं चलाए जाते।

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

सपोर्ट और शर्तें

सपोर्ट: support@hdsoft.fi, सोमवार से शुक्रवार, फ़िनलैंड के समय के अनुसार 9:00–17:00, अंग्रेज़ी और फ़िनिश में। जवाब देने का समय और सुरक्षा रिपोर्ट की जानकारी सपोर्ट पेज (अंग्रेज़ी में) पर है।

डॉक्यूमेंटेशन: Sharp Diagrams को कैसे सेट अप और इस्तेमाल करें (अंग्रेज़ी में)।

प्राइवेसी: प्राइवेसी पॉलिसी (अंग्रेज़ी में)।

शर्तें और दूसरे ऐप्स: Jira और Confluence के लिए ऐप्स।

जल्द ही Atlassian Marketplace पर

Sharp Diagrams, Atlassian Marketplace के ज़रिए जल्द ही Confluence Cloud और Jira Cloud पर आ रहा है। डॉक्यूमेंटेशन में अभी से देखा जा सकता है कि यह कैसे काम करता है।

डॉक्यूमेंटेशन पढ़ें (अंग्रेज़ी में)

Atlassian, Jira और Confluence, Atlassian के ट्रेडमार्क हैं। ये ऐप्स HD SofT ने बनाए हैं और इनका सपोर्ट भी HD SofT देती है।