परिनियोजन

शून्य कॉन्फ़िगरेशन के साथ स्टैटिक डॉक्स को किसी भी होस्ट पर परिनियोजित करें, या जब आपको डायनामिक व्यवहार की आवश्यकता हो तो एडाप्टर के साथ सर्वर-साइड रेंडरिंग पर स्विच करें।

कहीं भी परिनियोजित करें (स्टैटिक)

blume build आपके डॉक्स को सादे HTML, CSS, और dist/ में एक स्थानीय खोज इंडेक्स में संकलित करता है। चलाने के लिए कोई सर्वर नहीं है — बस किसी भी स्टैटिक होस्ट को उस फ़ोल्डर की ओर इंगित करें।

ये सेटिंग्स Vercel, Netlify, Cloudflare Pages, GitHub Pages, Amazon S3 + CloudFront, या किसी भी बकेट या CDN पर काम करती हैं। सुनिश्चित करें कि blume एक डिपेंडेंसी है ताकि होस्ट बिल्ड चला सके।

एक स्टैटिक बिल्ड में शामिल है:

• हर डॉक्स और कस्टम पेज स्टैटिक HTML के रूप में
• एक स्थानीय खोज इंडेक्स (डिफ़ॉल्ट रूप से Orama, Pagefind वैकल्पिक)
• जब deployment.site सेट हो तो एक sitemap.xml और robots.txt
• AI टूल्स के लिए llms.txt और llms-full.txt
• रीडायरेक्ट पेज
• जब seo.og.enabled चालू हो तो प्रीरेंडर की गई Open Graph छवियाँ

अपना साइट URL सेट करें

साइटमैप, कैनोनिकल टैग, RSS, और Open Graph छवियों को एक निरपेक्ष ऑरिजिन की आवश्यकता होती है। Vercel, Netlify, और Cloudflare Pages पर, Blume इसे बिल्ड समय पर प्लेटफ़ॉर्म के परिवेश से पहचान लेता है — किसी कॉन्फ़िग की आवश्यकता नहीं।

पहचाने गए मान को ओवरराइड करने के लिए, या उन होस्ट्स पर मान उपलब्ध कराने के लिए जो इसे उजागर नहीं करते (GitHub Pages, S3, एक कस्टम CDN), deployment.site सेट करें:

deployment: {
  site: "https://docs.example.com",
}

स्वचालित रूप से पहचान करते समय, Blume प्रति-डिप्लॉय प्रीव्यू URL की तुलना में आपके स्थिर प्रोडक्शन डोमेन को प्राथमिकता देता है, ताकि कैनोनिकल ऑरिजिन डिप्लॉय-दर-डिप्लॉय एक जैसा बना रहे।

blume dev के दौरान, जब कोई सेट न हो तो साइट URL आपके स्थानीय डेव सर्वर (जैसे http://localhost:4321) पर वापस चला जाता है, ताकि साइट-आधारित सुविधाएँ — Open Graph छवियाँ, कैनोनिकल, साइटमैप — बिना किसी अतिरिक्त सेटअप के काम करें। बिल्ड कभी इस फ़ॉलबैक का उपयोग नहीं करते, इसलिए प्रोडक्शन आउटपुट कभी localhost की ओर इंगित नहीं होता।

स्थानीय रूप से पूर्वावलोकन करें

शिप करने से पहले, प्रोडक्शन बिल्ड का ठीक वैसे ही पूर्वावलोकन करें जैसे एक स्टैटिक होस्ट इसे परोसेगा:

blume build
blume preview

सबपाथ परिनियोजन

डॉक्स को example.com/docs जैसे पथ के अंतर्गत परोस रहे हैं? deployment.base सेट करें — GitHub Pages प्रोजेक्ट साइटों के लिए यह सामान्य है। पूरी साइट, रूट सहित, बेस के अंतर्गत चली जाती है, और आंतरिक लिंक व एसेट्स को इसे शामिल करने के लिए पुनर्लिखित किया जाता है।

deployment: {
  base: "/docs",
}

डॉक्स को किसी पथ के अंतर्गत माउंट करें

basePath हर जनरेट किए गए रूट को एक सेगमेंट (/docs/getting-started) के अंतर्गत माउंट करता है जबकि साइडबार को अछूता छोड़ देता है — शीर्ष स्तर आपके सेक्शन हैं, कोई रैपर समूह नहीं। इसका उपयोग तब करें जब डॉक्स /docs/* पर रहें लेकिन साइट रूट आपका ही बना रहे (जैसे Docusaurus का routeBasePath या Fumadocs का baseUrl)।

basePath: "/docs",

लिंक ऐसे लिखें मानो वे रूट पर माउंट हों (/getting-started); Blume उन्हें, साथ ही रीडायरेक्ट, साइटमैप, कैनोनिकल URL, Open Graph छवियाँ, llms.txt, और खोज इंडेक्स को पुनर्लिखित करता है। सार्वजनिक एसेट्स (छवियाँ, public/ के अंतर्गत फ़ाइलें) साइट रूट पर ही रहती हैं।

यह ऊपर दी गई दो अवधारणाओं से अलग है:

• प्रति-स्रोत prefix एक स्रोत को नेमस्पेस देता है और एक साइडबार समूह जोड़ता है।
• deployment.base वह होस्ट सबडायरेक्टरी है जहाँ से पूरा ऐप परोसा जाता है। दोनों साथ मिलकर काम करते हैं — दोनों सेट होने पर, एक पेज {deployment.base}/{basePath}/page पर पहुँचता है।

सर्वर रेंडरिंग

स्टैटिक आउटपुट अधिकांश डॉक्स के लिए पर्याप्त है। जब आपको अनुरोध-समय की सुविधाओं की आवश्यकता हो तो सर्वर आउटपुट पर स्विच करें — विशेष रूप से Ask AI एंडपॉइंट के लिए:

deployment: {
  output: "server",
  adapter: "vercel",
}

vercel और node एडाप्टर Blume के साथ आते हैं — इनमें से किसी एक को चुनना ही काफ़ी है। netlify और cloudflare एडाप्टर आपके प्रोजेक्ट में इंस्टॉल करने होंगे (जैसे bun add -d @astrojs/netlify); पैकेज गायब होने पर CLI आपको चेतावनी देता है:

Vercel, Netlify, और Cloudflare Pages पर, Blume सर्वर आउटपुट के लिए मेल खाने वाला एडाप्टर स्वतः चुन लेता है — बस output: "server" सेट करें और परिनियोजित करें (Netlify और Cloudflare पर, एडाप्टर पैकेज भी इंस्टॉल करें)। पहचाने गए मान को ओवरराइड करने के लिए, या node के साथ स्वयं-होस्टिंग करते समय, adapter को स्पष्ट रूप से सेट करें।

एक सर्वर बिल्ड में वह सब कुछ शामिल होता है जो एक स्टैटिक बिल्ड में होता है, साथ ही आपके द्वारा जोड़े गए कोई भी Astro एंडपॉइंट या मिडलवेयर। node एडाप्टर एक स्वतंत्र सर्वर बनाता है जिसे आप सीधे चला सकते हैं।

Vercel और Cloudflare पर, एक सर्वर बिल्ड Accept: text/markdown कंटेंट नेगोशिएशन को भी चालू कर देता है, ताकि उस हेडर के साथ किसी भी कंटेंट पेज का अनुरोध करने वाले एजेंट को उसी URL पर उसका रॉ-Markdown मिरर मिले। Vercel पर, Blume डिप्लॉय के रूटिंग कॉन्फ़िग में हेडर-सशर्त रीराइट्स जोड़ देता है; Cloudflare पर, यह Astro वाले Worker के आगे एक छोटा Worker उत्पन्न करता है और assets.run_worker_first को कंटेंट रूट्स तक सीमित कर देता है, क्योंकि अन्यथा प्लेटफ़ॉर्म कोई भी सर्वर कोड चलने से पहले ही प्रीरेंडर किए गए पेज परोस देता — अन्य एसेट्स अपना शून्य-Worker तेज़ रास्ता बनाए रखते हैं।

रीडायरेक्ट

blume.config.ts में पुराने URL को नए URL से मैप करें:

redirects: [{ from: "/old", to: "/new", status: 301 }];

status 301, 302, 307, या 308 स्वीकार करता है (डिफ़ॉल्ट 301)। सर्वर बिल्ड रीडायरेक्ट को अनुरोध-समय पर संभालते हैं। स्टैटिक बिल्ड रीडायरेक्ट पेज और प्लेटफ़ॉर्म फ़ाइलें दोनों उत्पन्न करते हैं ताकि आपका होस्ट एक वास्तविक HTTP रीडायरेक्ट जारी करे: _redirects (Netlify, Cloudflare Pages), vercel.json (Vercel), और blume-redirects.json — बाकी सब कुछ के लिए एक संरचित मैनिफ़ेस्ट (nginx/Apache नियम, एक एज वर्कर)। public/ में आपके द्वारा शिप की गई _redirects या vercel.json फ़ाइल अछूती छोड़ दी जाती है।

कंटेंट प्रकार

एक स्टैटिक बिल्ड एक _headers फ़ाइल भी उत्पन्न करता है जो रॉ AI-तैयार एंडपॉइंट्स — /<route>.md, /<route>.mdx, और .txt फ़ाइलों (llms.txt, llms-full.txt) — पर charset=utf-8 निर्धारित करती है। वे प्रतिक्रियाएँ वैध UTF-8 होती हैं, लेकिन कई स्टैटिक होस्ट उन्हें बिना किसी charset के text/markdown / text/plain के रूप में परोसते हैं, और तब ब्राउज़र Windows-1252 पर वापस चले जाते हैं — इसलिए गैर-ASCII डॉक्स (जापानी, उच्चारण-चिह्न वाली लैटिन, …) रॉ URL सीधे खोलने पर मोजिबाके के रूप में दिखते हैं। HTML पेज इससे अप्रभावित रहते हैं क्योंकि उनमें <meta charset> होता है। Netlify और Cloudflare (Pages/Workers स्टैटिक एसेट्स) _headers पढ़ते हैं; जो होस्ट नहीं पढ़ते (Vercel, S3) वे इस फ़ाइल को हानिरहित रूप से अनदेखा कर देते हैं। public/ में आपके द्वारा शिप की गई _headers फ़ाइल अछूती छोड़ दी जाती है।

परिवेश चर

जब किसी सुविधा को रनटाइम सीक्रेट की आवश्यकता होती है, तो Blume blume dev/build पर चेतावनी देता है यदि वह गायब है — ताकि समस्या पहले अनुरोध के बजाय पहले ही सामने आ जाए:

स्थानीय डेव के लिए इन्हें .env.local में और प्रोडक्शन के लिए अपने होस्ट के परिवेश में सेट करें। खोज-इंडेक्स सिंक (Algolia, Orama Cloud, Typesense) के लिए बिल्ड-समय के सीक्रेट्स के बारे में सिंक चरण के दौरान अलग से चेतावनी दी जाती है।

बिल्ड सारांश

हर बिल्ड एक सारांश प्रिंट करता है — आउटपुट मोड, एडाप्टर, हल किया गया साइट URL, खोज प्रदाता, रीडायरेक्ट संख्या, साइटमैप और llms.txt की स्थिति, और कोई भी सक्षम सर्वर सुविधाएँ — ताकि परिनियोजित करने से पहले आप पुष्टि कर सकें कि क्या शिप हुआ (स्वतः पहचानी गई हर चीज़ सहित)।