Tiramisu Docs

Konfiguration

Überblick über die zentrale Konfigurationsdatei von Tiramisu Docs und alle verfügbaren Optionen.

Konfigurationsübersicht

Tiramisu Docs wird über eine einzige Datei konfiguriert: src/lib/tiramisu.config.ts. Diese Datei definiert den Titel, die Beschreibung, die Sektionen, das Sidebar-Verhalten, die i18n-Einstellungen und mehr für Ihre Website.

Die Konfigurationsdatei

Verwenden Sie den defineConfig()-Helfer für typsichere Konfiguration:

typescript 
import { defineConfig } from "@tiramisu-docs/kit";

export default defineConfig({
  title: "My Docs",
  description: "Documentation for my project",
  logo: { light: "/logo.svg", dark: "/logo-dark.svg" },
  url: "https://docs.example.com",
  nav: [{ label: "Docs", href: "/docs" }],
  github: {
    repo: "user/repo",
    branch: "main",
    dir: "src/docs",
  },
  sections: [
    { label: "Guide", path: "guide" },
    { label: "API", path: "api" },
  ],
  sidebar: {
    groupOrder: ["Getting Started", "Advanced"],
  },
  instantOg: {
    siteId: "site_xxxxxxxx",
    template: "generic/standard",
  },
  footer: {
    socials: {
      github: "https://github.com/user/repo",
    },
    copyright: "© 2026 My Project",
  },
});

Konfiguration in Komponenten verwenden

Um auf die aufgelöste Konfiguration in Ihren Svelte-Komponenten zuzugreifen, verwenden Sie resolveConfig():

typescript 
import { resolveConfig } from "@tiramisu-docs/kit";

const config = resolveConfig(rawConfig);

Vite-Plugin

Das Vite-Plugin liest Ihre Konfiguration, um das virtuelle Modul zu erstellen, das dateibasiertes Routing und Sidebar-Generierung ermöglicht:

typescript 
import config from "./src/lib/tiramisu.config";
import { tiramisuPlugin } from "@tiramisu-docs/kit";

export default defineConfig({
  plugins: [tiramisuPlugin({ config }), sveltekit()],
});