वेरिएबल

blume.config.ts में कोई मान एक बार परिभाषित करें और पेज में जहाँ भी उसकी ज़रूरत हो, वहाँ {{name}} लिखें, चाहे वह गद्य, कोड, लिंक या कंपोनेंट प्रॉप्स हो।

कोई मान एक बार परिभाषित करें और उसे हर पेज पर उपयोग करें। वर्ज़न नंबर, API होस्ट या प्रोडक्ट का नाम blume.config.ts में रखा जाता है। पेज में लिखा {{name}} उसका मान पढ़ लेता है:

export default defineConfig({
  variables: {
    version: "2.1.0",
    "api-url": "https://api.example.com",
  },
});

Install version {{version}}, then call {{api-url}}.

## What's new in {{version}}

<Card title="Release {{version}}" href="{{api-url}}/changelog" />

रेफ़रेंस गद्य, हेडिंग, लिंक, कोड ब्लॉक, इनलाइन कोड और कंपोनेंट प्रॉप्स में काम करते हैं। ये .md और .mdx पेजों में और उन फ़ाइलों में भी काम करते हैं जिन्हें ये पेज शामिल करते हैं। ब्रेसेज़ के अंदर स्पेस दे सकते हैं ({{ version }})। कॉन्फ़िग में मान बदलने पर अगले बिल्ड में हर पेज पर नया मान दिखेगा।

नामों में अक्षर, अंक, _ और - हो सकते हैं। मान एक ही पंक्ति का सादा टेक्स्ट होता है।

ये कहाँ लागू होते हैं

पेज को कोई भी प्रक्रिया पढ़े, उससे पहले ही वेरिएबल की जगह उसका मान रख दिया जाता है। इसलिए रेंडर किए गए HTML, सर्च, पेज के .md मिरर और llms-full.txt, सभी में मान ही दिखाई देता है।

फ्रंट मैटर में कोई बदलाव नहीं किया जाता। अगर किसी title या description में {{version}} है, तो वहाँ ब्रेसेज़ ही दिखाई देंगे।

अपरिभाषित नाम

अगर गद्य में कोई ऐसा {{name}} है जो परिभाषित नहीं है, तो बिल्ड त्रुटि BLUME_UNDEFINED_VARIABLE आती है। यह त्रुटि उसी पंक्ति के साथ रिपोर्ट की जाती है, ताकि कोई टाइपो पाठकों तक न पहुँचे। कोड ब्लॉक या इनलाइन कोड के अंदर अपरिभाषित नाम में कोई बदलाव नहीं किया जाता, क्योंकि वहाँ Handlebars के {{title}} जैसे टेम्प्लेटिंग उदाहरण आम हैं।

अगर आप किसी रेफ़रेंस को परिभाषित किए बिना गद्य में दिखाना चाहते हैं, तो उसे इनलाइन कोड में लिखें: `{{name}}`।

जो साइट कोई वेरिएबल परिभाषित नहीं करती, उस पर इसका कोई असर नहीं पड़ता। उसके .md पेजों में {{…}} जैसा लिखा है, वैसा ही दिखता है। .mdx में ब्रेसेज़ एक JavaScript एक्सप्रेशन होते हैं, इसलिए अपरिभाषित {{name}} होने पर पेज रेंडर होते समय विफल हो जाता है। यह त्रुटि उसी पंक्ति के साथ BLUME_MDX_UNDEFINED_NAME के रूप में रिपोर्ट की जाती है। दोनों खुलने वाले ब्रेसेज़ को एस्केप करें (\{\{name}}) या उसे इनलाइन कोड में लिखें।

जिस {{…}} में केवल नाम से अधिक कुछ हो, जैसे Liquid का {{ site.title }} या {{ page.url | relative_url }}, वह कभी वेरिएबल नहीं होता। .md पेज में ऐसा होने पर Blume BLUME_TEMPLATE_TAG के रूप में चेतावनी देता है, क्योंकि पेज उसे जैसा लिखा है, वैसा ही दिखाएगा।