मेरमाइड.जीएस ट्रीमैप डायग्राम सिंटैक्स & लेआउट गाइड

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

बेसिक सिंटैक्स संरचना

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

ट्रीमैप-बीटा
"मुख्य श्रेणी का नाम"
  "उप-श्रेणी ए": 45
  "उप-श्रेणी बी": 30
  "उप-श्रेणी सी": 25

सिंटैक्स संदर्भ

नीचे दी गई तालिका मेरमाइड.जीएस में ट्रीमैप लेआउट बनाने के लिए उपयोग किए जाने वाले प्राथमिक फॉर्मेटिंग आवश्यकताओं को विभाजित करती है।

उन्नत डेटा फॉर्मेटिंग (निर्देश)

डिफ़ॉल्ट रूप से, मेरमाइड रॉ न्यूमेरिक गिनती दिखाता है। हालांकि, आप निर्देश के उपयोग से फ्रंटमैटर कॉन्फ़िगरेशन ब्लॉक पास कर सकते हैंमूल्य फॉर्मेट संपत्ति संख्याओं को मुद्रा, दशमलव या प्रतिशत के रूप में प्रारूपित करने के लिए।

सामान्य प्रारूप पैटर्न

वित्तीय डेटा ब्लूप्रिंट

यह ब्लूप्रिंट यह दिखाता है कि कस्टम वित्तीय स्ट्रिंग पैरामीटर का उपयोग करके ऑपरेशनल कॉर्पोरेट बजट को कैसे प्रारूपित किया जाए:

---
विन्यास:
  ट्रीमैप:
    मूल्यप्रारूप: '$0,0'
---
treemap-beta
"कॉर्पोरेट बजट"
  "इंजीनियरिंग संचालन"
    "कोर इंफ्रास्ट्रक्चर": 500000
    "डेवलपर टूल्स": 150000
  "ग्रोथ मार्केटिंग"
    "पेड एड कैंपेन": 350000
    "ईवेंट स्पॉन्सरशिप्स": 80000

कस्टम नोड स्टाइलिंग (क्लासेस)

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

treemap-beta
"सिस्टम संसाधन उपयोग"
  "वेब सेवाएं"
    "API गेटवे": 45
    "प्रमाणीकरण सेवा": 95:::critical
  "डेटाबेस स्टोरेज"
    "प्राथमिक डीबी कैश": 60
    "रिप्लिका सिंक नोड्स": 25

classDef critical fill:#ffcccc,stroke:#ff0000,stroke-width:2px;

सिंटैक्स टिप: एक लीफ नोड पर क्लास परिभाषा लागू करने के लिए जिसमें संख्यात्मक मान हो, तीन बिंदुओं के उपयोग से क्लास का नाम जोड़ें (:::className) लेबल नाम के तुरंत बाद लेकिन *कोलन मान सेपरेटर से पहले*।

सामान्य सिंटैक्स त्रुटियाँ और सीमाएँ

क्योंकि ट्रीमैप स्कीमा संरचनात्मक पाठ इंडेंटेशन का उपयोग करता है, छोटी फॉर्मेटिंग गलतियाँ लेआउट रेंडरिंग समस्याओं का कारण बन सकती हैं। इन पैरामीटर्स को ध्यान में रखें:

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