कॉन्फ़िगरेशन फ़ाइल

blume.config.ts का हर विकल्प — साइट मेटाडेटा और कंटेंट स्रोतों से लेकर उन लिंक्स तक जो हर अलग-अलग फ़ीचर कॉन्फ़िगरेशन गाइड तक ले जाते हैं।

Blume आपके प्रोजेक्ट रूट से blume.config.ts पढ़ता है। ऑटोकम्पलीट और टाइप-चेकिंग के लिए अपने कॉन्फ़िग को defineConfig में लपेटें — हर फ़ील्ड वैकल्पिक है, और उसका एक समझदार डिफ़ॉल्ट होता है।

import { defineConfig } from "blume";

export default defineConfig({
  title: "My Docs",
  description: "Documentation for my project.",
});

एक सम्पूर्ण उदाहरण

सबसे आम विकल्पों को छूता हुआ एक व्यापक उदाहरण (बाकी के लिए हर फ़ीचर की गाइड देखें):

import sitemap from "@astrojs/sitemap";
import { defineConfig } from "blume";

export default defineConfig({
  // Site
  title: "My Docs",
  description: "Documentation for my project.",
  logo: "/logo.svg",

  // Astro integrations — installed and versioned by this site
  integrations: [sitemap()],

  // Content
  content: {
    root: "docs",
  },

  // Theme — see the Theming guide
  theme: {
    accent: "teal",
    radius: "md",
    mode: "system",
  },

  // Search — see the Search guide
  search: {
    provider: "orama",
  },

  // Markdown features
  markdown: {
    imageZoom: true,
    code: {
      icons: true, // language icon in the code-block header
      wrap: false, // wrap long lines instead of scrolling
    },
    codeBlocks: {
      theme: {
        light: "github-light", // bundled name or custom Shiki theme object
        dark: "github-dark",
      },
    },
  },

  // AI — see the AI guide
  ai: {
    llmsTxt: true,
    // MCP server (needs server output)
    mcp: {
      enabled: false,
      route: "/mcp",
    },
  },

  // SEO — OG images, feeds, sitemap, structured data; see the SEO guide
  seo: {
    og: { enabled: true },
    rss: { enabled: true, types: ["blog", "changelog"] },
    sitemap: true,
    robots: true,
    structuredData: true,
  },

  // Deployment — see the Deployment guide
  deployment: {
    output: "static",
    site: "https://docs.example.com",
  },
});

साइट

लोगो

logo को किसी SVG की ओर इंगित करें और Blume उसे इनलाइन कर देता है, जिससे currentColor वाला लोगो अपने आप लाइट और डार्क थीम का अनुसरण करता है:

logo: "/logo.svg",

SVG आपके प्रोजेक्ट रूट में या public/ में रह सकता है। ब्रांड एक चिह्न (image) और एक वर्डमार्क (text) से बनता है; ऑब्जेक्ट रूप आपको इन्हें अलग-अलग सेट करने देता है:

logo: {
  image: "/logo.svg", // string, or { light, dark, alt } for themed raster art
  text: "Acme",       // wordmark beside the mark
  href: "/",          // overrides the brand link (defaults to "/")
},

image वही मान लेता है जो शॉर्टहैंड लेता है — एक अकेला पाथ, या अलग-अलग लाइट/डार्क आर्टवर्क के लिए { light, dark, alt } (रास्टर इमेज public/ में ही होनी चाहिए)।

text वर्डमार्क को चिह्न से स्वतंत्र रूप से नियंत्रित करता है:

• text को छोड़ दें और ब्रांड आपकी साइट के title का उपयोग करेगा (डिफ़ॉल्ट)।
• text: "" सेट करें ताकि केवल चिह्न दिखे — तब उपयोगी जब लोगो इमेज में पहले से ही वर्डमार्क शामिल हो।
• image के बिना text सेट करें केवल-टेक्स्ट वाले लोगो के लिए।

फ़ेविकॉन

कोई फ़ेविकॉन विकल्प नहीं है — Blume उसे फ़ाइलनाम से अपने आप पहचान लेता है, ठीक वैसे ही जैसे Next.js करता है। अपने प्रोजेक्ट रूट या public/ डायरेक्टरी में एक icon या favicon फ़ाइल (.svg, .png, या .ico) रखें और वह ब्राउज़र टैब का आइकॉन बन जाती है:

my-docs/
├─ blume.config.ts
├─ icon.png          ← picked up automatically
└─ docs/

जब कई मौजूद हों, तो SVG की प्राथमिकता PNG से ऊपर और PNG की ICO से ऊपर होती है, और public/ की फ़ाइल को रूट वाली फ़ाइल पर वरीयता मिलती है। अगर Blume को कोई आइकॉन नहीं मिलता, तो वह अपने ही चिह्न पर लौट आता है।

Apple टच आइकॉन

जब कोई आपकी साइट को अपनी होम स्क्रीन पर जोड़ता है तो iOS जिस आइकॉन का उपयोग करता है, उसे भी इसी तरह पहचाना जाता है। अपने प्रोजेक्ट रूट या public/ डायरेक्टरी में एक apple-icon फ़ाइल (.png, .jpg, या .jpeg) — या apple-touch-icon.png, वह नाम जो ज़्यादातर फ़ेविकॉन जेनरेटर बनाते हैं — रखें और Blume आपके लिए <link rel="apple-touch-icon"> जोड़ देता है। कोई डिफ़ॉल्ट नहीं है; अगर कोई फ़ाइल नहीं मिलती, तो कोई टैग नहीं निकाला जाता।

my-docs/
├─ blume.config.ts
├─ apple-icon.png     ← picked up automatically
└─ docs/

फ़ाइल को प्रोजेक्ट रूट के बजाय public/ में रखें: रूट-स्तर के आइकॉन के लिए Blume जिस इनलाइन डेटा URI का उपयोग करता है, iOS उसे अनदेखा कर देता है, इसलिए केवल public/ की फ़ाइल (जो /apple-icon.png पर सर्व होती है) ही भरोसेमंद तरीके से होम स्क्रीन तक पहुँचती है।

बैनर

हेडर के ऊपर साइट-व्यापी घोषणा पट्टी दिखाएँ। एक स्ट्रिंग पास करें, या एक लिंक और डिसमिस बटन वाला ऑब्जेक्ट:

banner: "Docs are in beta — expect changes.",

banner: {
  content: "Blume v1 is here!",
  link: { text: "Read more", href: "/blog/v1" },
  dismissible: true,
  id: "v1",
},

जब dismissible चालू होता है, तो पट्टी एक क्लोज़ बटन दिखाती है और उसके बाद उस विज़िटर के लिए छिपी रहती है। डिसमिस की कुंजी डिफ़ॉल्ट रूप से कंटेंट टेक्स्ट होती है, इसलिए संदेश संपादित करने पर बैनर वापस आ जाता है; संपादनों के बाद भी उसे डिसमिस बनाए रखने के लिए एक स्थिर id सेट करें।

कंटेंट

आपका कंटेंट कहाँ रहता है और Blume उसे कैसे खोजता है। फ़ाइलें रूट्स कैसे बनती हैं, इसके लिए पेज देखें।

content: {
  root: "docs",
}

स्टैटिक एसेट्स public/ में रहती हैं — public/logo.png पर मौजूद फ़ाइल /logo.png पर सर्व होती है, इसलिए ![](/images/create.png) जैसा संदर्भ public/images/create.png के सापेक्ष हल होता है। सापेक्ष पाथ से संदर्भित इमेज (![](./diagram.png)) इसके बजाय आपके कंटेंट के बगल में रहती हैं, और बिल्ड समय पर ऑप्टिमाइज़ की जाती हैं।

इमेज

सापेक्ष पाथ से संदर्भित लोकल इमेज बिल्ड समय पर अपने आप ऑप्टिमाइज़ हो जाती हैं — कंप्रेस की जाती हैं, WebP में बदली जाती हैं, और उन्हें अंतर्निहित width/height एट्रिब्यूट्स दिए जाते हैं ताकि लोड होते समय लेआउट न खिसके। कॉन्फ़िगर करने को कुछ नहीं है; लेखन संबंधी मार्गदर्शन के लिए लिंक और इमेज देखें।

रिमोट इमेज डिफ़ॉल्ट रूप से बिना छेड़े सर्व की जाती हैं। Blume उन्हें भी बिल्ड समय पर डाउनलोड और ऑप्टिमाइज़ करे, इसके लिए उनके होस्ट्स को अधिकृत करें:

image: {
  domains: ["cdn.example.com"],
  remotePatterns: [{ protocol: "https", hostname: "**.example.com" }],
}

फ़्रंटमैटर

पेज फ़्रंटमैटर की सख़्ती से जाँच होती है — कोई अनजान कुंजी बिल्ड को विफल कर देती है, इसलिए टाइपो जल्दी पकड़ में आ जाते हैं। प्रोजेक्ट-विशिष्ट मेटाडेटा (एक ओनर, एक समीक्षा तिथि) रखने के लिए, अतिरिक्त कुंजियों को frontmatter.extend के अंतर्गत घोषित करें, हर एक को आपके द्वारा दिए गए स्कीमा से मैप करके:

import { defineConfig } from "blume";
import { z } from "zod";

export default defineConfig({
  frontmatter: {
    extend: {
      owner: z.string(),
      reviewedAt: z.coerce.date().optional(),
    },
  },
});

कोई भी Standard Schema लाइब्रेरी काम करती है — Zod (आपका प्रोजेक्ट जो भी संस्करण इंस्टॉल करे), Valibot, ArkType। एक्सटेंशन से बाहर की कुंजियाँ सख़्ती से जाँची जाती रहती हैं, इसलिए टाइपो पकड़ने में कोई बदलाव नहीं आता। जाँच के अर्थ-नियमों के लिए कस्टम कुंजियाँ देखें।

extend के अंतर्गत दी गई कुंजियाँ साइट-व्यापी लागू होती हैं। कुंजियों को केवल एक कंटेंट प्रकार के पेजों पर आवश्यक बनाने के लिए — किसी RFC का status, किसी रनबुक का service — उन्हें इसके बजाय content.types के अंतर्गत प्रति-प्रकार घोषित करें:

import { defineConfig } from "blume";
import { z } from "zod";

export default defineConfig({
  content: {
    types: {
      rfc: {
        facets: ["domain", "status"],
        frontmatter: {
          domain: z.string(),
          status: z.enum(["draft", "review", "enforced"]),
        },
      },
    },
  },
});

कोई कुंजी या तो साइट-व्यापी घोषित की जा सकती है या प्रति-प्रकार, दोनों नहीं। स्कोपिंग कैसे हल होती है, इसके लिए प्रति-प्रकार कुंजियाँ देखें।

facets उन कस्टम कुंजियों के नाम देता है जिनके मान फ़िल्टर करने योग्य मेटाडेटा बन जाते हैं: वे खोज दस्तावेज़ों (blume-search.json और MCP इंडेक्स) के साथ चलती हैं, और MCP टूल्स एक filters इनपुट स्वीकार करते हैं जो उनसे मेल खाता है, ताकि कोई एजेंट, मान लीजिए, architecture डोमेन में केवल enforced RFC ही प्राप्त कर सके। हर फ़ैसेट एक घोषित कस्टम कुंजी होनी चाहिए — प्रति-प्रकार या साइट-व्यापी — और केवल स्ट्रिंग (या स्ट्रिंग में बदले गए संख्या/बूलियन) मान ही फ़ैसेट बनते हैं।

GitHub

github के ज़रिए Blume को अपनी रिपॉज़िटरी की ओर इंगित करें। यह हेडर के रिपॉज़िटरी लिंक और Edit on GitHub तथा Give feedback पेज एक्शन को संचालित करता है:

github: {
  owner: "acme",
  repo: "docs",
}

अंतिम बार संशोधित

हर पेज के नीचे “Last updated on …” पंक्ति दिखाएँ। डिफ़ॉल्ट रूप से बंद; हर पेज की तिथि उसके git इतिहास से निकालने के लिए lastModified को true सेट करें:

lastModified: true,

git स्रोत हर फ़ाइल को छूने वाला सबसे हालिया कमिट पढ़ता है, इसलिए यह किसी भी git रिपॉज़िटरी में काम करता है — मोनोरिपो सहित — और बिल्ड समय पर रिपो का इतिहास चाहिए (CI में उथला --depth 1 चेकआउट न करें)। पेज का अपना lastModified फ़्रंटमैटर हमेशा जीतता है, जो किसी तिथि को पिन करने या अभी तक कमिट न हुई फ़ाइलों के लिए उपयोगी है:

---
title: My page
lastModified: 2026-06-20
---

सक्षम होने पर, तिथि पेज के स्ट्रक्चर्ड डेटा में schema.org dateModified के रूप में भी उत्सर्जित होती है।

तिथि प्रारूप

“Last updated” स्टैम्प और चेंजलॉग टाइमलाइन दोनों अपनी तिथियाँ एक ही dateFormat के ज़रिए रेंडर करते हैं, ताकि वे एक जैसी पढ़ी जाएँ। तिथियाँ हमेशा साइट की लोकेल में रेंडर होती हैं; dateFormat उनका स्वरूप नियंत्रित करता है। यह डिफ़ॉल्ट रूप से लंबे रूप में होता है (July 21, 2026, 2026年7月21日):

dateFormat: { dateStyle: "long" },

dateFormat Intl.DateTimeFormat विकल्पों के लिए एक पास-थ्रू है। किसी लंबाई के लिए dateStyle प्रीसेट का उपयोग करें:

dateFormat: { dateStyle: "medium" },

या 2026/07/21 जैसी संख्यात्मक शैली के लिए अलग-अलग घटक फ़ील्ड्स:

dateFormat: { year: "numeric", month: "2-digit", day: "2-digit" },

SEO

Open Graph इमेज, RSS फ़ीड्स, और JSON-LD स्ट्रक्चर्ड डेटा, seo के अंतर्गत समूहित। मेटाडेटा, फ़्रंटमैटर ओवरराइड्स, और पूरे संदर्भ के लिए SEO गाइड देखें।

seo: {
  og: { enabled: true },
  rss: { enabled: true, types: ["blog", "changelog"] },
  sitemap: true,
  robots: true,
  structuredData: true,
}

ये पूर्ण URL के लिए एक निरपेक्ष deployment.site के साथ सबसे अच्छा काम करते हैं।

विषय-सूची

इस-पेज-पर वाली रूपरेखा डिफ़ॉल्ट रूप से चालू रहती है और H2–H3 शीर्षकों को सूचीबद्ध करती है। toc के साथ इसे बंद करें, या शीर्षक-सीमा बदलें:

export default defineConfig({
  toc: false, // hide it everywhere
});

या इसके बजाय शीर्षक-सीमा को संकीर्ण करें:

export default defineConfig({
  toc: { minHeadingLevel: 2, maxHeadingLevel: 4 },
});

फ़ीचर विकल्प

इनमें से हर एक की अपनी गाइड है। कॉन्फ़िग फ़ील्ड प्रवेश-बिंदु है:

प्राथमिकता

सेटिंग्स सबसे कम से सबसे अधिक प्राथमिकता के क्रम में हल होती हैं, इसलिए आपको केवल वही ओवरराइड करना पड़ता है जिसकी ज़रूरत हो: