Variablen

Definiere einen Wert einmal in blume.config.ts und schreib {{name}} überall dort, wo eine Seite ihn braucht – im Fließtext, in Code, Links und Komponenten-Props.

Definiere einen Wert einmal und verwende ihn auf jeder Seite. Eine Versionsnummer, ein API-Host oder ein Produktname steht in blume.config.ts, und {{name}} liest den Wert auf einer Seite aus:

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" />

Referenzen funktionieren im Fließtext, in Überschriften, Links, Codeblöcken, Inline-Code und Komponenten-Props. Das gilt für .md- und .mdx-Seiten und für die Dateien, die sie einbinden. Leerzeichen innerhalb der geschweiften Klammern sind erlaubt ({{ version }}). Wenn du den Wert in der Config änderst, übernimmt ihn jede Seite beim nächsten Build.

Namen dürfen Buchstaben, Ziffern, _ und - enthalten. Werte sind einfacher Text in einer Zeile.

Wo sie gelten

Eine Variable wird ersetzt, bevor irgendetwas die Seite liest. Deshalb zeigen das gerenderte HTML, die Suche, der .md-Spiegel der Seite und llms-full.txt alle den Wert an.

Das Frontmatter bleibt unverändert: Wenn in title oder description {{version}} steht, werden die geschweiften Klammern angezeigt.

Undefinierte Namen

Ein {{name}} im Fließtext, der nicht definiert ist, löst den Build-Fehler BLUME_UNDEFINED_VARIABLE aus. Der Fehler nennt die betroffene Zeile, sodass ein Tippfehler nie bei deinen Leser*innen ankommt. In einem Codeblock oder in Inline-Code bleibt ein undefinierter Name unverändert, weil dort oft Template-Beispiele wie {{title}} aus Handlebars stehen.

Wenn du eine Referenz im Fließtext zeigen willst, ohne sie zu definieren, setz sie in Inline-Code: `{{name}}`.

Eine Website ohne definierte Variablen ist davon nicht betroffen: {{…}} bleibt auf ihren Seiten unverändert.